Skip to content

Describe Volumes

fsx_describe_volumes R Documentation

Describes one or more Amazon FSx for NetApp ONTAP or Amazon FSx for OpenZFS volumes

Description

Describes one or more Amazon FSx for NetApp ONTAP or Amazon FSx for OpenZFS volumes.

Usage

fsx_describe_volumes(VolumeIds, Filters, MaxResults, NextToken)

Arguments

VolumeIds

The IDs of the volumes whose descriptions you want to retrieve.

Filters

Enter a filter Name and Values pair to view a select set of volumes.

MaxResults
NextToken

Value

A list with the following syntax:

list(
  Volumes = list(
    list(
      CreationTime = as.POSIXct(
        "2015-01-01"
      ),
      FileSystemId = "string",
      Lifecycle = "CREATING"|"CREATED"|"DELETING"|"FAILED"|"MISCONFIGURED"|"PENDING"|"AVAILABLE",
      Name = "string",
      OntapConfiguration = list(
        FlexCacheEndpointType = "NONE"|"ORIGIN"|"CACHE",
        JunctionPath = "string",
        SecurityStyle = "UNIX"|"NTFS"|"MIXED",
        SizeInMegabytes = 123,
        StorageEfficiencyEnabled = TRUE|FALSE,
        StorageVirtualMachineId = "string",
        StorageVirtualMachineRoot = TRUE|FALSE,
        TieringPolicy = list(
          CoolingPeriod = 123,
          Name = "SNAPSHOT_ONLY"|"AUTO"|"ALL"|"NONE"
        ),
        UUID = "string",
        OntapVolumeType = "RW"|"DP"|"LS",
        SnapshotPolicy = "string",
        CopyTagsToBackups = TRUE|FALSE,
        SnaplockConfiguration = list(
          AuditLogVolume = TRUE|FALSE,
          AutocommitPeriod = list(
            Type = "MINUTES"|"HOURS"|"DAYS"|"MONTHS"|"YEARS"|"NONE",
            Value = 123
          ),
          PrivilegedDelete = "DISABLED"|"ENABLED"|"PERMANENTLY_DISABLED",
          RetentionPeriod = list(
            DefaultRetention = list(
              Type = "SECONDS"|"MINUTES"|"HOURS"|"DAYS"|"MONTHS"|"YEARS"|"INFINITE"|"UNSPECIFIED",
              Value = 123
            ),
            MinimumRetention = list(
              Type = "SECONDS"|"MINUTES"|"HOURS"|"DAYS"|"MONTHS"|"YEARS"|"INFINITE"|"UNSPECIFIED",
              Value = 123
            ),
            MaximumRetention = list(
              Type = "SECONDS"|"MINUTES"|"HOURS"|"DAYS"|"MONTHS"|"YEARS"|"INFINITE"|"UNSPECIFIED",
              Value = 123
            )
          ),
          SnaplockType = "COMPLIANCE"|"ENTERPRISE",
          VolumeAppendModeEnabled = TRUE|FALSE
        ),
        VolumeStyle = "FLEXVOL"|"FLEXGROUP",
        AggregateConfiguration = list(
          Aggregates = list(
            "string"
          ),
          TotalConstituents = 123
        ),
        SizeInBytes = 123
      ),
      ResourceARN = "string",
      Tags = list(
        list(
          Key = "string",
          Value = "string"
        )
      ),
      VolumeId = "string",
      VolumeType = "ONTAP"|"OPENZFS",
      LifecycleTransitionReason = list(
        Message = "string"
      ),
      AdministrativeActions = list(
        list(
          AdministrativeActionType = "FILE_SYSTEM_UPDATE"|"STORAGE_OPTIMIZATION"|"FILE_SYSTEM_ALIAS_ASSOCIATION"|"FILE_SYSTEM_ALIAS_DISASSOCIATION"|"VOLUME_UPDATE"|"SNAPSHOT_UPDATE"|"RELEASE_NFS_V3_LOCKS"|"VOLUME_RESTORE"|"THROUGHPUT_OPTIMIZATION"|"IOPS_OPTIMIZATION"|"STORAGE_TYPE_OPTIMIZATION"|"MISCONFIGURED_STATE_RECOVERY"|"VOLUME_UPDATE_WITH_SNAPSHOT"|"VOLUME_INITIALIZE_WITH_SNAPSHOT"|"DOWNLOAD_DATA_FROM_BACKUP",
          ProgressPercent = 123,
          RequestTime = as.POSIXct(
            "2015-01-01"
          ),
          Status = "FAILED"|"IN_PROGRESS"|"PENDING"|"COMPLETED"|"UPDATED_OPTIMIZING"|"OPTIMIZING",
          TargetFileSystemValues = list(
            OwnerId = "string",
            CreationTime = as.POSIXct(
              "2015-01-01"
            ),
            FileSystemId = "string",
            FileSystemType = "WINDOWS"|"LUSTRE"|"ONTAP"|"OPENZFS",
            Lifecycle = "AVAILABLE"|"CREATING"|"FAILED"|"DELETING"|"MISCONFIGURED"|"UPDATING"|"MISCONFIGURED_UNAVAILABLE",
            FailureDetails = list(
              Message = "string"
            ),
            StorageCapacity = 123,
            StorageType = "SSD"|"HDD",
            VpcId = "string",
            SubnetIds = list(
              "string"
            ),
            NetworkInterfaceIds = list(
              "string"
            ),
            DNSName = "string",
            KmsKeyId = "string",
            ResourceARN = "string",
            Tags = list(
              list(
                Key = "string",
                Value = "string"
              )
            ),
            WindowsConfiguration = list(
              ActiveDirectoryId = "string",
              SelfManagedActiveDirectoryConfiguration = list(
                DomainName = "string",
                OrganizationalUnitDistinguishedName = "string",
                FileSystemAdministratorsGroup = "string",
                UserName = "string",
                DnsIps = list(
                  "string"
                )
              ),
              DeploymentType = "MULTI_AZ_1"|"SINGLE_AZ_1"|"SINGLE_AZ_2",
              RemoteAdministrationEndpoint = "string",
              PreferredSubnetId = "string",
              PreferredFileServerIp = "string",
              ThroughputCapacity = 123,
              MaintenanceOperationsInProgress = list(
                "PATCHING"|"BACKING_UP"
              ),
              WeeklyMaintenanceStartTime = "string",
              DailyAutomaticBackupStartTime = "string",
              AutomaticBackupRetentionDays = 123,
              CopyTagsToBackups = TRUE|FALSE,
              Aliases = list(
                list(
                  Name = "string",
                  Lifecycle = "AVAILABLE"|"CREATING"|"DELETING"|"CREATE_FAILED"|"DELETE_FAILED"
                )
              ),
              AuditLogConfiguration = list(
                FileAccessAuditLogLevel = "DISABLED"|"SUCCESS_ONLY"|"FAILURE_ONLY"|"SUCCESS_AND_FAILURE",
                FileShareAccessAuditLogLevel = "DISABLED"|"SUCCESS_ONLY"|"FAILURE_ONLY"|"SUCCESS_AND_FAILURE",
                AuditLogDestination = "string"
              ),
              DiskIopsConfiguration = list(
                Mode = "AUTOMATIC"|"USER_PROVISIONED",
                Iops = 123
              )
            ),
            LustreConfiguration = list(
              WeeklyMaintenanceStartTime = "string",
              DataRepositoryConfiguration = list(
                Lifecycle = "CREATING"|"AVAILABLE"|"MISCONFIGURED"|"UPDATING"|"DELETING"|"FAILED",
                ImportPath = "string",
                ExportPath = "string",
                ImportedFileChunkSize = 123,
                AutoImportPolicy = "NONE"|"NEW"|"NEW_CHANGED"|"NEW_CHANGED_DELETED",
                FailureDetails = list(
                  Message = "string"
                )
              ),
              DeploymentType = "SCRATCH_1"|"SCRATCH_2"|"PERSISTENT_1"|"PERSISTENT_2",
              PerUnitStorageThroughput = 123,
              MountName = "string",
              DailyAutomaticBackupStartTime = "string",
              AutomaticBackupRetentionDays = 123,
              CopyTagsToBackups = TRUE|FALSE,
              DriveCacheType = "NONE"|"READ",
              DataCompressionType = "NONE"|"LZ4",
              LogConfiguration = list(
                Level = "DISABLED"|"WARN_ONLY"|"ERROR_ONLY"|"WARN_ERROR",
                Destination = "string"
              ),
              RootSquashConfiguration = list(
                RootSquash = "string",
                NoSquashNids = list(
                  "string"
                )
              ),
              MetadataConfiguration = list(
                Iops = 123,
                Mode = "AUTOMATIC"|"USER_PROVISIONED"
              )
            ),
            AdministrativeActions = list(),
            OntapConfiguration = list(
              AutomaticBackupRetentionDays = 123,
              DailyAutomaticBackupStartTime = "string",
              DeploymentType = "MULTI_AZ_1"|"SINGLE_AZ_1"|"SINGLE_AZ_2"|"MULTI_AZ_2",
              EndpointIpAddressRange = "string",
              Endpoints = list(
                Intercluster = list(
                  DNSName = "string",
                  IpAddresses = list(
                    "string"
                  )
                ),
                Management = list(
                  DNSName = "string",
                  IpAddresses = list(
                    "string"
                  )
                )
              ),
              DiskIopsConfiguration = list(
                Mode = "AUTOMATIC"|"USER_PROVISIONED",
                Iops = 123
              ),
              PreferredSubnetId = "string",
              RouteTableIds = list(
                "string"
              ),
              ThroughputCapacity = 123,
              WeeklyMaintenanceStartTime = "string",
              FsxAdminPassword = "string",
              HAPairs = 123,
              ThroughputCapacityPerHAPair = 123
            ),
            FileSystemTypeVersion = "string",
            OpenZFSConfiguration = list(
              AutomaticBackupRetentionDays = 123,
              CopyTagsToBackups = TRUE|FALSE,
              CopyTagsToVolumes = TRUE|FALSE,
              DailyAutomaticBackupStartTime = "string",
              DeploymentType = "SINGLE_AZ_1"|"SINGLE_AZ_2"|"SINGLE_AZ_HA_1"|"SINGLE_AZ_HA_2"|"MULTI_AZ_1",
              ThroughputCapacity = 123,
              WeeklyMaintenanceStartTime = "string",
              DiskIopsConfiguration = list(
                Mode = "AUTOMATIC"|"USER_PROVISIONED",
                Iops = 123
              ),
              RootVolumeId = "string",
              PreferredSubnetId = "string",
              EndpointIpAddressRange = "string",
              RouteTableIds = list(
                "string"
              ),
              EndpointIpAddress = "string"
            )
          ),
          FailureDetails = list(
            Message = "string"
          ),
          TargetVolumeValues = list(),
          TargetSnapshotValues = list(
            ResourceARN = "string",
            SnapshotId = "string",
            Name = "string",
            VolumeId = "string",
            CreationTime = as.POSIXct(
              "2015-01-01"
            ),
            Lifecycle = "PENDING"|"CREATING"|"DELETING"|"AVAILABLE",
            LifecycleTransitionReason = list(
              Message = "string"
            ),
            Tags = list(
              list(
                Key = "string",
                Value = "string"
              )
            ),
            AdministrativeActions = list()
          ),
          TotalTransferBytes = 123,
          RemainingTransferBytes = 123
        )
      ),
      OpenZFSConfiguration = list(
        ParentVolumeId = "string",
        VolumePath = "string",
        StorageCapacityReservationGiB = 123,
        StorageCapacityQuotaGiB = 123,
        RecordSizeKiB = 123,
        DataCompressionType = "NONE"|"ZSTD"|"LZ4",
        CopyTagsToSnapshots = TRUE|FALSE,
        OriginSnapshot = list(
          SnapshotARN = "string",
          CopyStrategy = "CLONE"|"FULL_COPY"|"INCREMENTAL_COPY"
        ),
        ReadOnly = TRUE|FALSE,
        NfsExports = list(
          list(
            ClientConfigurations = list(
              list(
                Clients = "string",
                Options = list(
                  "string"
                )
              )
            )
          )
        ),
        UserAndGroupQuotas = list(
          list(
            Type = "USER"|"GROUP",
            Id = 123,
            StorageCapacityQuotaGiB = 123
          )
        ),
        RestoreToSnapshot = "string",
        DeleteIntermediateSnaphots = TRUE|FALSE,
        DeleteClonedVolumes = TRUE|FALSE,
        DeleteIntermediateData = TRUE|FALSE,
        SourceSnapshotARN = "string",
        DestinationSnapshot = "string",
        CopyStrategy = "CLONE"|"FULL_COPY"|"INCREMENTAL_COPY"
      )
    )
  ),
  NextToken = "string"
)

Request syntax

svc$describe_volumes(
  VolumeIds = list(
    "string"
  ),
  Filters = list(
    list(
      Name = "file-system-id"|"storage-virtual-machine-id",
      Values = list(
        "string"
      )
    )
  ),
  MaxResults = 123,
  NextToken = "string"
)