Skip to content

OntapVolumeConfiguration

Source code in docs_src/capo_fsx/types/ontap_volume_configuration.py
class OntapVolumeConfiguration(TypedDict, closed=True):
    flex_cache_endpoint_type: NotRequired[
        "capo_fsx.types.flex_cache_endpoint_type.FlexCacheEndpointType"
    ]
    """<p>Specifies the FlexCache endpoint type of the volume. Valid values are the following:</p> <ul> <li> <p> <code>NONE</code> specifies that the volume doesn't have a FlexCache configuration. <code>NONE</code> is the default.</p> </li> <li> <p> <code>ORIGIN</code> specifies that the volume is the origin volume for a FlexCache volume.</p> </li> <li> <p> <code>CACHE</code> specifies that the volume is a FlexCache volume.</p> </li> </ul>"""
    junction_path: NotRequired["capo_fsx.types.junction_path.JunctionPath"]
    """<p>Specifies the directory that network-attached storage (NAS) clients use to mount the volume, along with the storage virtual machine (SVM) Domain Name System (DNS) name or IP address. You can create a <code>JunctionPath</code> directly below a parent volume junction or on a directory within a volume. A <code>JunctionPath</code> for a volume named <code>vol3</code> might be <code>/vol1/vol2/vol3</code>, or <code>/vol1/dir2/vol3</code>, or even <code>/dir1/dir2/vol3</code>.</p>"""
    security_style: NotRequired["capo_fsx.types.security_style.SecurityStyle"]
    """<p>The security style for the volume, which can be <code>UNIX</code>, <code>NTFS</code>, or <code>MIXED</code>.</p>"""
    size_in_megabytes: NotRequired["capo_fsx.types.volume_capacity.VolumeCapacity"]
    """<p>The configured size of the volume, in megabytes (MBs).</p>"""
    storage_efficiency_enabled: NotRequired["capo_fsx.types.flag.Flag"]
    """<p>The volume's storage efficiency setting.</p>"""
    storage_virtual_machine_id: NotRequired[
        "capo_fsx.types.storage_virtual_machine_id.StorageVirtualMachineId"
    ]
    """<p>The ID of the volume's storage virtual machine.</p>"""
    storage_virtual_machine_root: NotRequired["capo_fsx.types.flag.Flag"]
    """<p>A Boolean flag indicating whether this volume is the root volume for its storage virtual machine (SVM). Only one volume on an SVM can be the root volume. This value defaults to <code>false</code>. If this value is <code>true</code>, then this is the SVM root volume.</p> <p>This flag is useful when you're deleting an SVM, because you must first delete all non-root volumes. This flag, when set to <code>false</code>, helps you identify which volumes to delete before you can delete the SVM.</p>"""
    tiering_policy: NotRequired["capo_fsx.types.tiering_policy.TieringPolicy"]
    """<p>The volume's <code>TieringPolicy</code> setting.</p>"""
    uuid: NotRequired["capo_fsx.types.uuid.UUID"]
    """<p>The volume's universally unique identifier (UUID).</p>"""
    ontap_volume_type: NotRequired["capo_fsx.types.ontap_volume_type.OntapVolumeType"]
    """<p>Specifies the type of volume. Valid values are the following:</p> <ul> <li> <p> <code>RW</code> specifies a read/write volume. <code>RW</code> is the default.</p> </li> <li> <p> <code>DP</code> specifies a data-protection volume. You can protect data by replicating it to data-protection mirror copies. If a disaster occurs, you can use these data-protection mirror copies to recover data.</p> </li> <li> <p> <code>LS</code> specifies a load-sharing mirror volume. A load-sharing mirror reduces the network traffic to a FlexVol volume by providing additional read-only access to clients.</p> </li> </ul>"""
    snapshot_policy: NotRequired["capo_fsx.types.snapshot_policy.SnapshotPolicy"]
    """<p>Specifies the snapshot policy for the volume. There are three built-in snapshot policies:</p> <ul> <li> <p> <code>default</code>: This is the default policy. A maximum of six hourly snapshots taken five minutes past the hour. A maximum of two daily snapshots taken Monday through Saturday at 10 minutes after midnight. A maximum of two weekly snapshots taken every Sunday at 15 minutes after midnight.</p> </li> <li> <p> <code>default-1weekly</code>: This policy is the same as the <code>default</code> policy except that it only retains one snapshot from the weekly schedule.</p> </li> <li> <p> <code>none</code>: This policy does not take any snapshots. This policy can be assigned to volumes to prevent automatic snapshots from being taken.</p> </li> </ul> <p>You can also provide the name of a custom policy that you created with the ONTAP CLI or REST API.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/snapshots-ontap.html#snapshot-policies">Snapshot policies</a> in the Amazon FSx for NetApp ONTAP User Guide.</p>"""
    copy_tags_to_backups: NotRequired["capo_fsx.types.flag.Flag"]
    """<p>A boolean flag indicating whether tags for the volume should be copied to backups. This value defaults to false. If it's set to true, all tags for the volume are copied to all automatic and user-initiated backups where the user doesn't specify tags. If this value is true, and you specify one or more tags, only the specified tags are copied to backups. If you specify one or more tags when creating a user-initiated backup, no tags are copied from the volume, regardless of this value.</p>"""
    snaplock_configuration: NotRequired[
        "capo_fsx.types.snaplock_configuration.SnaplockConfiguration"
    ]
    """<p>The SnapLock configuration object for an FSx for ONTAP SnapLock volume. </p>"""
    volume_style: NotRequired["capo_fsx.types.volume_style.VolumeStyle"]
    """<p>Use to specify the style of an ONTAP volume. For more information about FlexVols and FlexGroups, see <a href="https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/volume-types.html">Volume types</a> in Amazon FSx for NetApp ONTAP User Guide.</p>"""
    aggregate_configuration: NotRequired[
        "capo_fsx.types.aggregate_configuration.AggregateConfiguration"
    ]
    """<p>This structure specifies configuration options for a volume’s storage aggregate or aggregates.</p>"""
    size_in_bytes: NotRequired[
        "capo_fsx.types.volume_capacity_bytes.VolumeCapacityBytes"
    ]
    """<p>The configured size of the volume, in bytes.</p>"""

aggregate_configuration instance-attribute

aggregate_configuration: NotRequired[AggregateConfiguration]

This structure specifies configuration options for a volume’s storage aggregate or aggregates.

copy_tags_to_backups instance-attribute

copy_tags_to_backups: NotRequired[Flag]

A boolean flag indicating whether tags for the volume should be copied to backups. This value defaults to false. If it's set to true, all tags for the volume are copied to all automatic and user-initiated backups where the user doesn't specify tags. If this value is true, and you specify one or more tags, only the specified tags are copied to backups. If you specify one or more tags when creating a user-initiated backup, no tags are copied from the volume, regardless of this value.

flex_cache_endpoint_type instance-attribute

flex_cache_endpoint_type: NotRequired[FlexCacheEndpointType]

Specifies the FlexCache endpoint type of the volume. Valid values are the following:

  • NONE specifies that the volume doesn't have a FlexCache configuration. NONE is the default.

  • ORIGIN specifies that the volume is the origin volume for a FlexCache volume.

  • CACHE specifies that the volume is a FlexCache volume.

junction_path instance-attribute

junction_path: NotRequired[JunctionPath]

Specifies the directory that network-attached storage (NAS) clients use to mount the volume, along with the storage virtual machine (SVM) Domain Name System (DNS) name or IP address. You can create a JunctionPath directly below a parent volume junction or on a directory within a volume. A JunctionPath for a volume named vol3 might be /vol1/vol2/vol3, or /vol1/dir2/vol3, or even /dir1/dir2/vol3.

ontap_volume_type instance-attribute

ontap_volume_type: NotRequired[OntapVolumeType]

Specifies the type of volume. Valid values are the following:

  • RW specifies a read/write volume. RW is the default.

  • DP specifies a data-protection volume. You can protect data by replicating it to data-protection mirror copies. If a disaster occurs, you can use these data-protection mirror copies to recover data.

  • LS specifies a load-sharing mirror volume. A load-sharing mirror reduces the network traffic to a FlexVol volume by providing additional read-only access to clients.

security_style instance-attribute

security_style: NotRequired[SecurityStyle]

The security style for the volume, which can be UNIX, NTFS, or MIXED.

size_in_bytes instance-attribute

size_in_bytes: NotRequired[VolumeCapacityBytes]

The configured size of the volume, in bytes.

size_in_megabytes instance-attribute

size_in_megabytes: NotRequired[VolumeCapacity]

The configured size of the volume, in megabytes (MBs).

snaplock_configuration instance-attribute

snaplock_configuration: NotRequired[SnaplockConfiguration]

The SnapLock configuration object for an FSx for ONTAP SnapLock volume.

snapshot_policy instance-attribute

snapshot_policy: NotRequired[SnapshotPolicy]

Specifies the snapshot policy for the volume. There are three built-in snapshot policies:

  • default: This is the default policy. A maximum of six hourly snapshots taken five minutes past the hour. A maximum of two daily snapshots taken Monday through Saturday at 10 minutes after midnight. A maximum of two weekly snapshots taken every Sunday at 15 minutes after midnight.

  • default-1weekly: This policy is the same as the default policy except that it only retains one snapshot from the weekly schedule.

  • none: This policy does not take any snapshots. This policy can be assigned to volumes to prevent automatic snapshots from being taken.

You can also provide the name of a custom policy that you created with the ONTAP CLI or REST API.

For more information, see Snapshot policies in the Amazon FSx for NetApp ONTAP User Guide.

storage_efficiency_enabled instance-attribute

storage_efficiency_enabled: NotRequired[Flag]

The volume's storage efficiency setting.

storage_virtual_machine_id instance-attribute

storage_virtual_machine_id: NotRequired[StorageVirtualMachineId]

The ID of the volume's storage virtual machine.

storage_virtual_machine_root instance-attribute

storage_virtual_machine_root: NotRequired[Flag]

A Boolean flag indicating whether this volume is the root volume for its storage virtual machine (SVM). Only one volume on an SVM can be the root volume. This value defaults to false. If this value is true, then this is the SVM root volume.

This flag is useful when you're deleting an SVM, because you must first delete all non-root volumes. This flag, when set to false, helps you identify which volumes to delete before you can delete the SVM.

tiering_policy instance-attribute

tiering_policy: NotRequired[TieringPolicy]

The volume's TieringPolicy setting.

uuid instance-attribute

uuid: NotRequired[UUID]

The volume's universally unique identifier (UUID).

volume_style instance-attribute

volume_style: NotRequired[VolumeStyle]

Use to specify the style of an ONTAP volume. For more information about FlexVols and FlexGroups, see Volume types in Amazon FSx for NetApp ONTAP User Guide.