# WARNING ABOUT GENERATED CODE # # This file is generated. See the contributing guide for more information: # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md # # WARNING ABOUT GENERATED CODE module Aws::StorageGateway module Types # A JSON object containing one or more of the following fields: # # * ActivateGatewayInput$ActivationKey # # * ActivateGatewayInput$GatewayName # # * ActivateGatewayInput$GatewayRegion # # * ActivateGatewayInput$GatewayTimezone # # * ActivateGatewayInput$GatewayType # # * ActivateGatewayInput$TapeDriveType # # * ActivateGatewayInput$MediumChangerType # # @note When making an API call, you may pass ActivateGatewayInput # data as a hash: # # { # activation_key: "ActivationKey", # required # gateway_name: "GatewayName", # required # gateway_timezone: "GatewayTimezone", # required # gateway_region: "RegionId", # required # gateway_type: "GatewayType", # tape_drive_type: "TapeDriveType", # medium_changer_type: "MediumChangerType", # tags: [ # { # key: "TagKey", # required # value: "TagValue", # required # }, # ], # } # # @!attribute [rw] activation_key # Your gateway activation key. You can obtain the activation key by # sending an HTTP GET request with redirects enabled to the gateway IP # address (port 80). The redirect URL returned in the response # provides you the activation key for your gateway in the query string # parameter `activationKey`. It may also include other # activation-related parameters, however, these are merely defaults -- # the arguments you pass to the `ActivateGateway` API call determine # the actual configuration of your gateway. # # For more information, see # https://docs.aws.amazon.com/storagegateway/latest/userguide/get-activation-key.html # in the Storage Gateway User Guide. # @return [String] # # @!attribute [rw] gateway_name # The name you configured for your gateway. # @return [String] # # @!attribute [rw] gateway_timezone # A value that indicates the time zone you want to set for the # gateway. The time zone is of the format "GMT-hr:mm" or # "GMT+hr:mm". For example, GMT-4:00 indicates the time is 4 hours # behind GMT. GMT+2:00 indicates the time is 2 hours ahead of GMT. The # time zone is used, for example, for scheduling snapshots and your # gateway's maintenance schedule. # @return [String] # # @!attribute [rw] gateway_region # A value that indicates the region where you want to store your data. # The gateway region specified must be the same region as the region # in your `Host` header in the request. For more information about # available regions and endpoints for AWS Storage Gateway, see # [Regions and Endpoints][1] in the *Amazon Web Services Glossary*. # # Valid Values: See [AWS Storage Gateway Regions and Endpoints][1] in # the AWS General Reference. # # # # [1]: https://docs.aws.amazon.com/general/latest/gr/rande.html#sg_region # @return [String] # # @!attribute [rw] gateway_type # A value that defines the type of gateway to activate. The type # specified is critical to all later functions of the gateway and # cannot be changed after activation. The default value is `CACHED`. # # Valid Values: "STORED", "CACHED", "VTL", "FILE\_S3" # @return [String] # # @!attribute [rw] tape_drive_type # The value that indicates the type of tape drive to use for tape # gateway. This field is optional. # # Valid Values: "IBM-ULT3580-TD5" # @return [String] # # @!attribute [rw] medium_changer_type # The value that indicates the type of medium changer to use for tape # gateway. This field is optional. # # Valid Values: "STK-L700", "AWS-Gateway-VTL" # @return [String] # # @!attribute [rw] tags # A list of up to 50 tags that can be assigned to the gateway. Each # tag is a key-value pair. # # Valid characters for key and value are letters, spaces, and numbers # representable in UTF-8 format, and the following special characters: # + - = . \_ : / @. The maximum length of a tag's key is 128 # characters, and the maximum length for a tag's value is 256. # # # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/ActivateGatewayInput AWS API Documentation # class ActivateGatewayInput < Struct.new( :activation_key, :gateway_name, :gateway_timezone, :gateway_region, :gateway_type, :tape_drive_type, :medium_changer_type, :tags) include Aws::Structure end # AWS Storage Gateway returns the Amazon Resource Name (ARN) of the # activated gateway. It is a string made of information such as your # account, gateway name, and region. This ARN is used to reference the # gateway in other API operations as well as resource-based # authorization. # # For gateways activated prior to September 02, 2015, the gateway ARN # contains the gateway name rather than the gateway ID. Changing the # name of the gateway has no effect on the gateway ARN. # # # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/ActivateGatewayOutput AWS API Documentation # class ActivateGatewayOutput < Struct.new( :gateway_arn) include Aws::Structure end # @note When making an API call, you may pass AddCacheInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # disk_ids: ["DiskId"], # required # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] disk_ids # An array of strings that identify disks that are to be configured as # working storage. Each string have a minimum length of 1 and maximum # length of 300. You can get the disk IDs from the ListLocalDisks API. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/AddCacheInput AWS API Documentation # class AddCacheInput < Struct.new( :gateway_arn, :disk_ids) include Aws::Structure end # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/AddCacheOutput AWS API Documentation # class AddCacheOutput < Struct.new( :gateway_arn) include Aws::Structure end # AddTagsToResourceInput # # @note When making an API call, you may pass AddTagsToResourceInput # data as a hash: # # { # resource_arn: "ResourceARN", # required # tags: [ # required # { # key: "TagKey", # required # value: "TagValue", # required # }, # ], # } # # @!attribute [rw] resource_arn # The Amazon Resource Name (ARN) of the resource you want to add tags # to. # @return [String] # # @!attribute [rw] tags # The key-value pair that represents the tag you want to add to the # resource. The value can be an empty string. # # Valid characters for key and value are letters, spaces, and numbers # representable in UTF-8 format, and the following special characters: # + - = . \_ : / @. The maximum length of a tag's key is 128 # characters, and the maximum length for a tag's value is 256. # # # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/AddTagsToResourceInput AWS API Documentation # class AddTagsToResourceInput < Struct.new( :resource_arn, :tags) include Aws::Structure end # AddTagsToResourceOutput # # @!attribute [rw] resource_arn # The Amazon Resource Name (ARN) of the resource you want to add tags # to. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/AddTagsToResourceOutput AWS API Documentation # class AddTagsToResourceOutput < Struct.new( :resource_arn) include Aws::Structure end # @note When making an API call, you may pass AddUploadBufferInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # disk_ids: ["DiskId"], # required # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] disk_ids # An array of strings that identify disks that are to be configured as # working storage. Each string have a minimum length of 1 and maximum # length of 300. You can get the disk IDs from the ListLocalDisks API. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/AddUploadBufferInput AWS API Documentation # class AddUploadBufferInput < Struct.new( :gateway_arn, :disk_ids) include Aws::Structure end # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/AddUploadBufferOutput AWS API Documentation # class AddUploadBufferOutput < Struct.new( :gateway_arn) include Aws::Structure end # A JSON object containing one or more of the following fields: # # * AddWorkingStorageInput$DiskIds # # ^ # # @note When making an API call, you may pass AddWorkingStorageInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # disk_ids: ["DiskId"], # required # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] disk_ids # An array of strings that identify disks that are to be configured as # working storage. Each string have a minimum length of 1 and maximum # length of 300. You can get the disk IDs from the ListLocalDisks API. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/AddWorkingStorageInput AWS API Documentation # class AddWorkingStorageInput < Struct.new( :gateway_arn, :disk_ids) include Aws::Structure end # A JSON object containing the of the gateway for which working storage # was configured. # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/AddWorkingStorageOutput AWS API Documentation # class AddWorkingStorageOutput < Struct.new( :gateway_arn) include Aws::Structure end # AttachVolumeInput # # @note When making an API call, you may pass AttachVolumeInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # target_name: "TargetName", # volume_arn: "VolumeARN", # required # network_interface_id: "NetworkInterfaceId", # required # disk_id: "DiskId", # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway that you want to # attach the volume to. # @return [String] # # @!attribute [rw] target_name # The name of the iSCSI target used by an initiator to connect to a # volume and used as a suffix for the target ARN. For example, # specifying `TargetName` as *myvolume* results in the target ARN of # `arn:aws:storagegateway:us-east-2:111122223333:gateway/sgw-12A3456B/target/iqn.1997-05.com.amazon:myvolume`. # The target name must be unique across all volumes on a gateway. # # If you don't specify a value, Storage Gateway uses the value that # was previously used for this volume as the new target name. # @return [String] # # @!attribute [rw] volume_arn # The Amazon Resource Name (ARN) of the volume to attach to the # specified gateway. # @return [String] # # @!attribute [rw] network_interface_id # The network interface of the gateway on which to expose the iSCSI # target. Only IPv4 addresses are accepted. Use # DescribeGatewayInformation to get a list of the network interfaces # available on a gateway. # # Valid Values: A valid IP address. # @return [String] # # @!attribute [rw] disk_id # The unique device ID or other distinguishing data that identifies # the local disk used to create the volume. This value is only # required when you are attaching a stored volume. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/AttachVolumeInput AWS API Documentation # class AttachVolumeInput < Struct.new( :gateway_arn, :target_name, :volume_arn, :network_interface_id, :disk_id) include Aws::Structure end # AttachVolumeOutput # # @!attribute [rw] volume_arn # The Amazon Resource Name (ARN) of the volume that was attached to # the gateway. # @return [String] # # @!attribute [rw] target_arn # The Amazon Resource Name (ARN) of the volume target, which includes # the iSCSI name for the initiator that was used to connect to the # target. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/AttachVolumeOutput AWS API Documentation # class AttachVolumeOutput < Struct.new( :volume_arn, :target_arn) include Aws::Structure end # Describes an iSCSI cached volume. # # @!attribute [rw] volume_arn # The Amazon Resource Name (ARN) of the storage volume. # @return [String] # # @!attribute [rw] volume_id # The unique identifier of the volume, e.g. vol-AE4B946D. # @return [String] # # @!attribute [rw] volume_type # One of the VolumeType enumeration values that describes the type of # the volume. # @return [String] # # @!attribute [rw] volume_status # One of the VolumeStatus values that indicates the state of the # storage volume. # @return [String] # # @!attribute [rw] volume_attachment_status # A value that indicates whether a storage volume is attached to or # detached from a gateway. For more information, see [Moving Your # Volumes to a Different Gateway][1]. # # # # [1]: https://docs.aws.amazon.com/storagegateway/latest/userguide/managing-volumes.html#attach-detach-volume # @return [String] # # @!attribute [rw] volume_size_in_bytes # The size, in bytes, of the volume capacity. # @return [Integer] # # @!attribute [rw] volume_progress # Represents the percentage complete if the volume is restoring or # bootstrapping that represents the percent of data transferred. This # field does not appear in the response if the cached volume is not # restoring or bootstrapping. # @return [Float] # # @!attribute [rw] source_snapshot_id # If the cached volume was created from a snapshot, this field # contains the snapshot ID used, e.g. snap-78e22663. Otherwise, this # field is not included. # @return [String] # # @!attribute [rw] volume_iscsi_attributes # An VolumeiSCSIAttributes object that represents a collection of # iSCSI attributes for one stored volume. # @return [Types::VolumeiSCSIAttributes] # # @!attribute [rw] created_date # The date the volume was created. Volumes created prior to March 28, # 2017 don’t have this time stamp. # @return [Time] # # @!attribute [rw] volume_used_in_bytes # The size of the data stored on the volume in bytes. This value is # calculated based on the number of blocks that are touched, instead # of the actual amount of data written. This value can be useful for # sequential write patterns but less accurate for random write # patterns. `VolumeUsedInBytes` is different from the compressed size # of the volume, which is the value that is used to calculate your # bill. # # This value is not available for volumes created prior to May 13, # 2015, until you store data on the volume. # # # @return [Integer] # # @!attribute [rw] kms_key # The Amazon Resource Name (ARN) of the AWS KMS key used for Amazon S3 # server side encryption. This value can only be set when KMSEncrypted # is true. Optional. # @return [String] # # @!attribute [rw] target_name # The name of the iSCSI target used by an initiator to connect to a # volume and used as a suffix for the target ARN. For example, # specifying `TargetName` as *myvolume* results in the target ARN of # `arn:aws:storagegateway:us-east-2:111122223333:gateway/sgw-12A3456B/target/iqn.1997-05.com.amazon:myvolume`. # The target name must be unique across all volumes on a gateway. # # If you don't specify a value, Storage Gateway uses the value that # was previously used for this volume as the new target name. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/CachediSCSIVolume AWS API Documentation # class CachediSCSIVolume < Struct.new( :volume_arn, :volume_id, :volume_type, :volume_status, :volume_attachment_status, :volume_size_in_bytes, :volume_progress, :source_snapshot_id, :volume_iscsi_attributes, :created_date, :volume_used_in_bytes, :kms_key, :target_name) include Aws::Structure end # CancelArchivalInput # # @note When making an API call, you may pass CancelArchivalInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # tape_arn: "TapeARN", # required # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] tape_arn # The Amazon Resource Name (ARN) of the virtual tape you want to # cancel archiving for. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/CancelArchivalInput AWS API Documentation # class CancelArchivalInput < Struct.new( :gateway_arn, :tape_arn) include Aws::Structure end # CancelArchivalOutput # # @!attribute [rw] tape_arn # The Amazon Resource Name (ARN) of the virtual tape for which # archiving was canceled. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/CancelArchivalOutput AWS API Documentation # class CancelArchivalOutput < Struct.new( :tape_arn) include Aws::Structure end # CancelRetrievalInput # # @note When making an API call, you may pass CancelRetrievalInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # tape_arn: "TapeARN", # required # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] tape_arn # The Amazon Resource Name (ARN) of the virtual tape you want to # cancel retrieval for. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/CancelRetrievalInput AWS API Documentation # class CancelRetrievalInput < Struct.new( :gateway_arn, :tape_arn) include Aws::Structure end # CancelRetrievalOutput # # @!attribute [rw] tape_arn # The Amazon Resource Name (ARN) of the virtual tape for which # retrieval was canceled. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/CancelRetrievalOutput AWS API Documentation # class CancelRetrievalOutput < Struct.new( :tape_arn) include Aws::Structure end # Describes Challenge-Handshake Authentication Protocol (CHAP) # information that supports authentication between your gateway and # iSCSI initiators. # # @!attribute [rw] target_arn # The Amazon Resource Name (ARN) of the volume. # # Valid Values: 50 to 500 lowercase letters, numbers, periods (.), and # hyphens (-). # @return [String] # # @!attribute [rw] secret_to_authenticate_initiator # The secret key that the initiator (for example, the Windows client) # must provide to participate in mutual CHAP with the target. # @return [String] # # @!attribute [rw] initiator_name # The iSCSI initiator that connects to the target. # @return [String] # # @!attribute [rw] secret_to_authenticate_target # The secret key that the target must provide to participate in mutual # CHAP with the initiator (e.g. Windows client). # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/ChapInfo AWS API Documentation # class ChapInfo < Struct.new( :target_arn, :secret_to_authenticate_initiator, :initiator_name, :secret_to_authenticate_target) include Aws::Structure end # @note When making an API call, you may pass CreateCachediSCSIVolumeInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # volume_size_in_bytes: 1, # required # snapshot_id: "SnapshotId", # target_name: "TargetName", # required # source_volume_arn: "VolumeARN", # network_interface_id: "NetworkInterfaceId", # required # client_token: "ClientToken", # required # kms_encrypted: false, # kms_key: "KMSKey", # tags: [ # { # key: "TagKey", # required # value: "TagValue", # required # }, # ], # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] volume_size_in_bytes # The size of the volume in bytes. # @return [Integer] # # @!attribute [rw] snapshot_id # The snapshot ID (e.g. "snap-1122aabb") of the snapshot to restore # as the new cached volume. Specify this field if you want to create # the iSCSI storage volume from a snapshot otherwise do not include # this field. To list snapshots for your account use # [DescribeSnapshots][1] in the *Amazon Elastic Compute Cloud API # Reference*. # # # # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/ApiReference-query-DescribeSnapshots.html # @return [String] # # @!attribute [rw] target_name # The name of the iSCSI target used by an initiator to connect to a # volume and used as a suffix for the target ARN. For example, # specifying `TargetName` as *myvolume* results in the target ARN of # `arn:aws:storagegateway:us-east-2:111122223333:gateway/sgw-12A3456B/target/iqn.1997-05.com.amazon:myvolume`. # The target name must be unique across all volumes on a gateway. # # If you don't specify a value, Storage Gateway uses the value that # was previously used for this volume as the new target name. # @return [String] # # @!attribute [rw] source_volume_arn # The ARN for an existing volume. Specifying this ARN makes the new # volume into an exact copy of the specified existing volume's latest # recovery point. The `VolumeSizeInBytes` value for this new volume # must be equal to or larger than the size of the existing volume, in # bytes. # @return [String] # # @!attribute [rw] network_interface_id # The network interface of the gateway on which to expose the iSCSI # target. Only IPv4 addresses are accepted. Use # DescribeGatewayInformation to get a list of the network interfaces # available on a gateway. # # Valid Values: A valid IP address. # @return [String] # # @!attribute [rw] client_token # A unique identifier that you use to retry a request. If you retry a # request, use the same `ClientToken` you specified in the initial # request. # @return [String] # # @!attribute [rw] kms_encrypted # True to use Amazon S3 server side encryption with your own AWS KMS # key, or false to use a key managed by Amazon S3. Optional. # @return [Boolean] # # @!attribute [rw] kms_key # The Amazon Resource Name (ARN) of the AWS KMS key used for Amazon S3 # server side encryption. This value can only be set when KMSEncrypted # is true. Optional. # @return [String] # # @!attribute [rw] tags # A list of up to 50 tags that can be assigned to a cached volume. # Each tag is a key-value pair. # # Valid characters for key and value are letters, spaces, and numbers # representable in UTF-8 format, and the following special characters: # + - = . \_ : / @. The maximum length of a tag's key is 128 # characters, and the maximum length for a tag's value is 256. # # # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/CreateCachediSCSIVolumeInput AWS API Documentation # class CreateCachediSCSIVolumeInput < Struct.new( :gateway_arn, :volume_size_in_bytes, :snapshot_id, :target_name, :source_volume_arn, :network_interface_id, :client_token, :kms_encrypted, :kms_key, :tags) include Aws::Structure end # @!attribute [rw] volume_arn # The Amazon Resource Name (ARN) of the configured volume. # @return [String] # # @!attribute [rw] target_arn # The Amazon Resource Name (ARN) of the volume target, which includes # the iSCSI name that initiators can use to connect to the target. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/CreateCachediSCSIVolumeOutput AWS API Documentation # class CreateCachediSCSIVolumeOutput < Struct.new( :volume_arn, :target_arn) include Aws::Structure end # CreateNFSFileShareInput # # @note When making an API call, you may pass CreateNFSFileShareInput # data as a hash: # # { # client_token: "ClientToken", # required # nfs_file_share_defaults: { # file_mode: "PermissionMode", # directory_mode: "PermissionMode", # group_id: 1, # owner_id: 1, # }, # gateway_arn: "GatewayARN", # required # kms_encrypted: false, # kms_key: "KMSKey", # role: "Role", # required # location_arn: "LocationARN", # required # default_storage_class: "StorageClass", # object_acl: "private", # accepts private, public-read, public-read-write, authenticated-read, bucket-owner-read, bucket-owner-full-control, aws-exec-read # client_list: ["IPV4AddressCIDR"], # squash: "Squash", # read_only: false, # guess_mime_type_enabled: false, # requester_pays: false, # tags: [ # { # key: "TagKey", # required # value: "TagValue", # required # }, # ], # } # # @!attribute [rw] client_token # A unique string value that you supply that is used by file gateway # to ensure idempotent file share creation. # @return [String] # # @!attribute [rw] nfs_file_share_defaults # File share default values. Optional. # @return [Types::NFSFileShareDefaults] # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the file gateway on which you want # to create a file share. # @return [String] # # @!attribute [rw] kms_encrypted # True to use Amazon S3 server side encryption with your own AWS KMS # key, or false to use a key managed by Amazon S3. Optional. # @return [Boolean] # # @!attribute [rw] kms_key # The Amazon Resource Name (ARN) AWS KMS key used for Amazon S3 server # side encryption. This value can only be set when KMSEncrypted is # true. Optional. # @return [String] # # @!attribute [rw] role # The ARN of the AWS Identity and Access Management (IAM) role that a # file gateway assumes when it accesses the underlying storage. # @return [String] # # @!attribute [rw] location_arn # The ARN of the backed storage used for storing file data. # @return [String] # # @!attribute [rw] default_storage_class # The default storage class for objects put into an Amazon S3 bucket # by the file gateway. Possible values are `S3_STANDARD`, # `S3_STANDARD_IA`, or `S3_ONEZONE_IA`. If this field is not # populated, the default value `S3_STANDARD` is used. Optional. # @return [String] # # @!attribute [rw] object_acl # A value that sets the access control list permission for objects in # the S3 bucket that a file gateway puts objects into. The default # value is "private". # @return [String] # # @!attribute [rw] client_list # The list of clients that are allowed to access the file gateway. The # list must contain either valid IP addresses or valid CIDR blocks. # @return [Array] # # @!attribute [rw] squash # A value that maps a user to anonymous user. Valid options are the # following: # # * `RootSquash` - Only root is mapped to anonymous user. # # * `NoSquash` - No one is mapped to anonymous user # # * `AllSquash` - Everyone is mapped to anonymous user. # @return [String] # # @!attribute [rw] read_only # A value that sets the write status of a file share. This value is # true if the write status is read-only, and otherwise false. # @return [Boolean] # # @!attribute [rw] guess_mime_type_enabled # A value that enables guessing of the MIME type for uploaded objects # based on file extensions. Set this value to true to enable MIME type # guessing, and otherwise to false. The default value is true. # @return [Boolean] # # @!attribute [rw] requester_pays # A value that sets who pays the cost of the request and the cost # associated with data download from the S3 bucket. If this value is # set to true, the requester pays the costs. Otherwise the S3 bucket # owner pays. However, the S3 bucket owner always pays the cost of # storing data. # # `RequesterPays` is a configuration for the S3 bucket that backs the # file share, so make sure that the configuration on the file share is # the same as the S3 bucket configuration. # # # @return [Boolean] # # @!attribute [rw] tags # A list of up to 50 tags that can be assigned to the NFS file share. # Each tag is a key-value pair. # # Valid characters for key and value are letters, spaces, and numbers # representable in UTF-8 format, and the following special characters: # + - = . \_ : / @. The maximum length of a tag's key is 128 # characters, and the maximum length for a tag's value is 256. # # # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/CreateNFSFileShareInput AWS API Documentation # class CreateNFSFileShareInput < Struct.new( :client_token, :nfs_file_share_defaults, :gateway_arn, :kms_encrypted, :kms_key, :role, :location_arn, :default_storage_class, :object_acl, :client_list, :squash, :read_only, :guess_mime_type_enabled, :requester_pays, :tags) include Aws::Structure end # CreateNFSFileShareOutput # # @!attribute [rw] file_share_arn # The Amazon Resource Name (ARN) of the newly created file share. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/CreateNFSFileShareOutput AWS API Documentation # class CreateNFSFileShareOutput < Struct.new( :file_share_arn) include Aws::Structure end # CreateSMBFileShareInput # # @note When making an API call, you may pass CreateSMBFileShareInput # data as a hash: # # { # client_token: "ClientToken", # required # gateway_arn: "GatewayARN", # required # kms_encrypted: false, # kms_key: "KMSKey", # role: "Role", # required # location_arn: "LocationARN", # required # default_storage_class: "StorageClass", # object_acl: "private", # accepts private, public-read, public-read-write, authenticated-read, bucket-owner-read, bucket-owner-full-control, aws-exec-read # read_only: false, # guess_mime_type_enabled: false, # requester_pays: false, # smbacl_enabled: false, # admin_user_list: ["FileShareUser"], # valid_user_list: ["FileShareUser"], # invalid_user_list: ["FileShareUser"], # authentication: "Authentication", # tags: [ # { # key: "TagKey", # required # value: "TagValue", # required # }, # ], # } # # @!attribute [rw] client_token # A unique string value that you supply that is used by file gateway # to ensure idempotent file share creation. # @return [String] # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the file gateway on which you want # to create a file share. # @return [String] # # @!attribute [rw] kms_encrypted # True to use Amazon S3 server side encryption with your own AWS KMS # key, or false to use a key managed by Amazon S3. Optional. # @return [Boolean] # # @!attribute [rw] kms_key # The Amazon Resource Name (ARN) of the AWS KMS key used for Amazon S3 # server side encryption. This value can only be set when KMSEncrypted # is true. Optional. # @return [String] # # @!attribute [rw] role # The ARN of the AWS Identity and Access Management (IAM) role that a # file gateway assumes when it accesses the underlying storage. # @return [String] # # @!attribute [rw] location_arn # The ARN of the backed storage used for storing file data. # @return [String] # # @!attribute [rw] default_storage_class # The default storage class for objects put into an Amazon S3 bucket # by the file gateway. Possible values are `S3_STANDARD`, # `S3_STANDARD_IA`, or `S3_ONEZONE_IA`. If this field is not # populated, the default value `S3_STANDARD` is used. Optional. # @return [String] # # @!attribute [rw] object_acl # A value that sets the access control list permission for objects in # the S3 bucket that a file gateway puts objects into. The default # value is "private". # @return [String] # # @!attribute [rw] read_only # A value that sets the write status of a file share. This value is # true if the write status is read-only, and otherwise false. # @return [Boolean] # # @!attribute [rw] guess_mime_type_enabled # A value that enables guessing of the MIME type for uploaded objects # based on file extensions. Set this value to true to enable MIME type # guessing, and otherwise to false. The default value is true. # @return [Boolean] # # @!attribute [rw] requester_pays # A value that sets who pays the cost of the request and the cost # associated with data download from the S3 bucket. If this value is # set to true, the requester pays the costs. Otherwise the S3 bucket # owner pays. However, the S3 bucket owner always pays the cost of # storing data. # # `RequesterPays` is a configuration for the S3 bucket that backs the # file share, so make sure that the configuration on the file share is # the same as the S3 bucket configuration. # # # @return [Boolean] # # @!attribute [rw] smbacl_enabled # Set this value to "true to enable ACL (access control list) on the # SMB file share. Set it to "false" to map file and directory # permissions to the POSIX permissions. # # For more information, see # https://docs.aws.amazon.com/storagegateway/latest/userguide/smb-acl.html # in the Storage Gateway User Guide. # @return [Boolean] # # @!attribute [rw] admin_user_list # A list of users or groups in the Active Directory that have # administrator rights to the file share. A group must be prefixed # with the @ character. For example `@group1`. Can only be set if # Authentication is set to `ActiveDirectory`. # @return [Array] # # @!attribute [rw] valid_user_list # A list of users or groups in the Active Directory that are allowed # to access the file share. A group must be prefixed with the @ # character. For example `@group1`. Can only be set if Authentication # is set to `ActiveDirectory`. # @return [Array] # # @!attribute [rw] invalid_user_list # A list of users or groups in the Active Directory that are not # allowed to access the file share. A group must be prefixed with the # @ character. For example `@group1`. Can only be set if # Authentication is set to `ActiveDirectory`. # @return [Array] # # @!attribute [rw] authentication # The authentication method that users use to access the file share. # # Valid values are `ActiveDirectory` or `GuestAccess`. The default is # `ActiveDirectory`. # @return [String] # # @!attribute [rw] tags # A list of up to 50 tags that can be assigned to the NFS file share. # Each tag is a key-value pair. # # Valid characters for key and value are letters, spaces, and numbers # representable in UTF-8 format, and the following special characters: # + - = . \_ : / @. The maximum length of a tag's key is 128 # characters, and the maximum length for a tag's value is 256. # # # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/CreateSMBFileShareInput AWS API Documentation # class CreateSMBFileShareInput < Struct.new( :client_token, :gateway_arn, :kms_encrypted, :kms_key, :role, :location_arn, :default_storage_class, :object_acl, :read_only, :guess_mime_type_enabled, :requester_pays, :smbacl_enabled, :admin_user_list, :valid_user_list, :invalid_user_list, :authentication, :tags) include Aws::Structure end # CreateSMBFileShareOutput # # @!attribute [rw] file_share_arn # The Amazon Resource Name (ARN) of the newly created file share. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/CreateSMBFileShareOutput AWS API Documentation # class CreateSMBFileShareOutput < Struct.new( :file_share_arn) include Aws::Structure end # @note When making an API call, you may pass CreateSnapshotFromVolumeRecoveryPointInput # data as a hash: # # { # volume_arn: "VolumeARN", # required # snapshot_description: "SnapshotDescription", # required # } # # @!attribute [rw] volume_arn # The Amazon Resource Name (ARN) of the iSCSI volume target. Use the # DescribeStorediSCSIVolumes operation to return to retrieve the # TargetARN for specified VolumeARN. # @return [String] # # @!attribute [rw] snapshot_description # Textual description of the snapshot that appears in the Amazon EC2 # console, Elastic Block Store snapshots panel in the **Description** # field, and in the AWS Storage Gateway snapshot **Details** pane, # **Description** field # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/CreateSnapshotFromVolumeRecoveryPointInput AWS API Documentation # class CreateSnapshotFromVolumeRecoveryPointInput < Struct.new( :volume_arn, :snapshot_description) include Aws::Structure end # @!attribute [rw] snapshot_id # The ID of the snapshot. # @return [String] # # @!attribute [rw] volume_arn # The Amazon Resource Name (ARN) of the iSCSI volume target. Use the # DescribeStorediSCSIVolumes operation to return to retrieve the # TargetARN for specified VolumeARN. # @return [String] # # @!attribute [rw] volume_recovery_point_time # The time the volume was created from the recovery point. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/CreateSnapshotFromVolumeRecoveryPointOutput AWS API Documentation # class CreateSnapshotFromVolumeRecoveryPointOutput < Struct.new( :snapshot_id, :volume_arn, :volume_recovery_point_time) include Aws::Structure end # A JSON object containing one or more of the following fields: # # * CreateSnapshotInput$SnapshotDescription # # * CreateSnapshotInput$VolumeARN # # @note When making an API call, you may pass CreateSnapshotInput # data as a hash: # # { # volume_arn: "VolumeARN", # required # snapshot_description: "SnapshotDescription", # required # tags: [ # { # key: "TagKey", # required # value: "TagValue", # required # }, # ], # } # # @!attribute [rw] volume_arn # The Amazon Resource Name (ARN) of the volume. Use the ListVolumes # operation to return a list of gateway volumes. # @return [String] # # @!attribute [rw] snapshot_description # Textual description of the snapshot that appears in the Amazon EC2 # console, Elastic Block Store snapshots panel in the **Description** # field, and in the AWS Storage Gateway snapshot **Details** pane, # **Description** field # @return [String] # # @!attribute [rw] tags # A list of up to 50 tags that can be assigned to a snapshot. Each tag # is a key-value pair. # # Valid characters for key and value are letters, spaces, and numbers # representable in UTF-8 format, and the following special characters: # + - = . \_ : / @. The maximum length of a tag's key is 128 # characters, and the maximum length for a tag's value is 256. # # # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/CreateSnapshotInput AWS API Documentation # class CreateSnapshotInput < Struct.new( :volume_arn, :snapshot_description, :tags) include Aws::Structure end # A JSON object containing the following fields: # # @!attribute [rw] volume_arn # The Amazon Resource Name (ARN) of the volume of which the snapshot # was taken. # @return [String] # # @!attribute [rw] snapshot_id # The snapshot ID that is used to refer to the snapshot in future # operations such as describing snapshots (Amazon Elastic Compute # Cloud API `DescribeSnapshots`) or creating a volume from a snapshot # (CreateStorediSCSIVolume). # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/CreateSnapshotOutput AWS API Documentation # class CreateSnapshotOutput < Struct.new( :volume_arn, :snapshot_id) include Aws::Structure end # A JSON object containing one or more of the following fields: # # * CreateStorediSCSIVolumeInput$DiskId # # * CreateStorediSCSIVolumeInput$NetworkInterfaceId # # * CreateStorediSCSIVolumeInput$PreserveExistingData # # * CreateStorediSCSIVolumeInput$SnapshotId # # * CreateStorediSCSIVolumeInput$TargetName # # @note When making an API call, you may pass CreateStorediSCSIVolumeInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # disk_id: "DiskId", # required # snapshot_id: "SnapshotId", # preserve_existing_data: false, # required # target_name: "TargetName", # required # network_interface_id: "NetworkInterfaceId", # required # kms_encrypted: false, # kms_key: "KMSKey", # tags: [ # { # key: "TagKey", # required # value: "TagValue", # required # }, # ], # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] disk_id # The unique identifier for the gateway local disk that is configured # as a stored volume. Use [ListLocalDisks][1] to list disk IDs for a # gateway. # # # # [1]: https://docs.aws.amazon.com/storagegateway/latest/userguide/API_ListLocalDisks.html # @return [String] # # @!attribute [rw] snapshot_id # The snapshot ID (e.g. "snap-1122aabb") of the snapshot to restore # as the new stored volume. Specify this field if you want to create # the iSCSI storage volume from a snapshot otherwise do not include # this field. To list snapshots for your account use # [DescribeSnapshots][1] in the *Amazon Elastic Compute Cloud API # Reference*. # # # # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/ApiReference-query-DescribeSnapshots.html # @return [String] # # @!attribute [rw] preserve_existing_data # Specify this field as true if you want to preserve the data on the # local disk. Otherwise, specifying this field as false creates an # empty volume. # # Valid Values: true, false # @return [Boolean] # # @!attribute [rw] target_name # The name of the iSCSI target used by an initiator to connect to a # volume and used as a suffix for the target ARN. For example, # specifying `TargetName` as *myvolume* results in the target ARN of # `arn:aws:storagegateway:us-east-2:111122223333:gateway/sgw-12A3456B/target/iqn.1997-05.com.amazon:myvolume`. # The target name must be unique across all volumes on a gateway. # # If you don't specify a value, Storage Gateway uses the value that # was previously used for this volume as the new target name. # @return [String] # # @!attribute [rw] network_interface_id # The network interface of the gateway on which to expose the iSCSI # target. Only IPv4 addresses are accepted. Use # DescribeGatewayInformation to get a list of the network interfaces # available on a gateway. # # Valid Values: A valid IP address. # @return [String] # # @!attribute [rw] kms_encrypted # True to use Amazon S3 server side encryption with your own AWS KMS # key, or false to use a key managed by Amazon S3. Optional. # @return [Boolean] # # @!attribute [rw] kms_key # The Amazon Resource Name (ARN) of the KMS key used for Amazon S3 # server side encryption. This value can only be set when KMSEncrypted # is true. Optional. # @return [String] # # @!attribute [rw] tags # A list of up to 50 tags that can be assigned to a stored volume. # Each tag is a key-value pair. # # Valid characters for key and value are letters, spaces, and numbers # representable in UTF-8 format, and the following special characters: # + - = . \_ : / @. The maximum length of a tag's key is 128 # characters, and the maximum length for a tag's value is 256. # # # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/CreateStorediSCSIVolumeInput AWS API Documentation # class CreateStorediSCSIVolumeInput < Struct.new( :gateway_arn, :disk_id, :snapshot_id, :preserve_existing_data, :target_name, :network_interface_id, :kms_encrypted, :kms_key, :tags) include Aws::Structure end # A JSON object containing the following fields: # # @!attribute [rw] volume_arn # The Amazon Resource Name (ARN) of the configured volume. # @return [String] # # @!attribute [rw] volume_size_in_bytes # The size of the volume in bytes. # @return [Integer] # # @!attribute [rw] target_arn # The Amazon Resource Name (ARN) of the volume target, which includes # the iSCSI name that initiators can use to connect to the target. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/CreateStorediSCSIVolumeOutput AWS API Documentation # class CreateStorediSCSIVolumeOutput < Struct.new( :volume_arn, :volume_size_in_bytes, :target_arn) include Aws::Structure end # CreateTapeWithBarcodeInput # # @note When making an API call, you may pass CreateTapeWithBarcodeInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # tape_size_in_bytes: 1, # required # tape_barcode: "TapeBarcode", # required # kms_encrypted: false, # kms_key: "KMSKey", # pool_id: "PoolId", # tags: [ # { # key: "TagKey", # required # value: "TagValue", # required # }, # ], # } # # @!attribute [rw] gateway_arn # The unique Amazon Resource Name (ARN) that represents the gateway to # associate the virtual tape with. Use the ListGateways operation to # return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] tape_size_in_bytes # The size, in bytes, of the virtual tape that you want to create. # # The size must be aligned by gigabyte (1024*1024*1024 byte). # # # @return [Integer] # # @!attribute [rw] tape_barcode # The barcode that you want to assign to the tape. # # Barcodes cannot be reused. This includes barcodes used for tapes # that have been deleted. # # # @return [String] # # @!attribute [rw] kms_encrypted # True to use Amazon S3 server side encryption with your own AWS KMS # key, or false to use a key managed by Amazon S3. Optional. # @return [Boolean] # # @!attribute [rw] kms_key # The Amazon Resource Name (ARN) of the AWS KMS Key used for Amazon S3 # server side encryption. This value can only be set when KMSEncrypted # is true. Optional. # @return [String] # # @!attribute [rw] pool_id # The ID of the pool that you want to add your tape to for archiving. # The tape in this pool is archived in the S3 storage class that is # associated with the pool. When you use your backup application to # eject the tape, the tape is archived directly into the storage class # (Glacier or Deep Archive) that corresponds to the pool. # # Valid values: "GLACIER", "DEEP\_ARCHIVE" # @return [String] # # @!attribute [rw] tags # A list of up to 50 tags that can be assigned to a virtual tape that # has a barcode. Each tag is a key-value pair. # # Valid characters for key and value are letters, spaces, and numbers # representable in UTF-8 format, and the following special characters: # + - = . \_ : / @. The maximum length of a tag's key is 128 # characters, and the maximum length for a tag's value is 256. # # # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/CreateTapeWithBarcodeInput AWS API Documentation # class CreateTapeWithBarcodeInput < Struct.new( :gateway_arn, :tape_size_in_bytes, :tape_barcode, :kms_encrypted, :kms_key, :pool_id, :tags) include Aws::Structure end # CreateTapeOutput # # @!attribute [rw] tape_arn # A unique Amazon Resource Name (ARN) that represents the virtual tape # that was created. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/CreateTapeWithBarcodeOutput AWS API Documentation # class CreateTapeWithBarcodeOutput < Struct.new( :tape_arn) include Aws::Structure end # CreateTapesInput # # @note When making an API call, you may pass CreateTapesInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # tape_size_in_bytes: 1, # required # client_token: "ClientToken", # required # num_tapes_to_create: 1, # required # tape_barcode_prefix: "TapeBarcodePrefix", # required # kms_encrypted: false, # kms_key: "KMSKey", # pool_id: "PoolId", # tags: [ # { # key: "TagKey", # required # value: "TagValue", # required # }, # ], # } # # @!attribute [rw] gateway_arn # The unique Amazon Resource Name (ARN) that represents the gateway to # associate the virtual tapes with. Use the ListGateways operation to # return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] tape_size_in_bytes # The size, in bytes, of the virtual tapes that you want to create. # # The size must be aligned by gigabyte (1024*1024*1024 byte). # # # @return [Integer] # # @!attribute [rw] client_token # A unique identifier that you use to retry a request. If you retry a # request, use the same `ClientToken` you specified in the initial # request. # # Using the same `ClientToken` prevents creating the tape multiple # times. # # # @return [String] # # @!attribute [rw] num_tapes_to_create # The number of virtual tapes that you want to create. # @return [Integer] # # @!attribute [rw] tape_barcode_prefix # A prefix that you append to the barcode of the virtual tape you are # creating. This prefix makes the barcode unique. # # The prefix must be 1 to 4 characters in length and must be one of # the uppercase letters from A to Z. # # # @return [String] # # @!attribute [rw] kms_encrypted # True to use Amazon S3 server side encryption with your own AWS KMS # key, or false to use a key managed by Amazon S3. Optional. # @return [Boolean] # # @!attribute [rw] kms_key # The Amazon Resource Name (ARN) of the AWS KMS key used for Amazon S3 # server side encryption. This value can only be set when KMSEncrypted # is true. Optional. # @return [String] # # @!attribute [rw] pool_id # The ID of the pool that you want to add your tape to for archiving. # The tape in this pool is archived in the S3 storage class that is # associated with the pool. When you use your backup application to # eject the tape, the tape is archived directly into the storage class # (Glacier or Deep Archive) that corresponds to the pool. # # Valid values: "GLACIER", "DEEP\_ARCHIVE" # @return [String] # # @!attribute [rw] tags # A list of up to 50 tags that can be assigned to a virtual tape. Each # tag is a key-value pair. # # Valid characters for key and value are letters, spaces, and numbers # representable in UTF-8 format, and the following special characters: # + - = . \_ : / @. The maximum length of a tag's key is 128 # characters, and the maximum length for a tag's value is 256. # # # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/CreateTapesInput AWS API Documentation # class CreateTapesInput < Struct.new( :gateway_arn, :tape_size_in_bytes, :client_token, :num_tapes_to_create, :tape_barcode_prefix, :kms_encrypted, :kms_key, :pool_id, :tags) include Aws::Structure end # CreateTapeOutput # # @!attribute [rw] tape_arns # A list of unique Amazon Resource Names (ARNs) that represents the # virtual tapes that were created. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/CreateTapesOutput AWS API Documentation # class CreateTapesOutput < Struct.new( :tape_arns) include Aws::Structure end # A JSON object containing the following fields: # # * DeleteBandwidthRateLimitInput$BandwidthType # # ^ # # @note When making an API call, you may pass DeleteBandwidthRateLimitInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # bandwidth_type: "BandwidthType", # required # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] bandwidth_type # One of the BandwidthType values that indicates the gateway bandwidth # rate limit to delete. # # Valid Values: `Upload`, `Download`, `All`. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DeleteBandwidthRateLimitInput AWS API Documentation # class DeleteBandwidthRateLimitInput < Struct.new( :gateway_arn, :bandwidth_type) include Aws::Structure end # A JSON object containing the of the gateway whose bandwidth rate # information was deleted. # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DeleteBandwidthRateLimitOutput AWS API Documentation # class DeleteBandwidthRateLimitOutput < Struct.new( :gateway_arn) include Aws::Structure end # A JSON object containing one or more of the following fields: # # * DeleteChapCredentialsInput$InitiatorName # # * DeleteChapCredentialsInput$TargetARN # # @note When making an API call, you may pass DeleteChapCredentialsInput # data as a hash: # # { # target_arn: "TargetARN", # required # initiator_name: "IqnName", # required # } # # @!attribute [rw] target_arn # The Amazon Resource Name (ARN) of the iSCSI volume target. Use the # DescribeStorediSCSIVolumes operation to return to retrieve the # TargetARN for specified VolumeARN. # @return [String] # # @!attribute [rw] initiator_name # The iSCSI initiator that connects to the target. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DeleteChapCredentialsInput AWS API Documentation # class DeleteChapCredentialsInput < Struct.new( :target_arn, :initiator_name) include Aws::Structure end # A JSON object containing the following fields: # # @!attribute [rw] target_arn # The Amazon Resource Name (ARN) of the target. # @return [String] # # @!attribute [rw] initiator_name # The iSCSI initiator that connects to the target. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DeleteChapCredentialsOutput AWS API Documentation # class DeleteChapCredentialsOutput < Struct.new( :target_arn, :initiator_name) include Aws::Structure end # DeleteFileShareInput # # @note When making an API call, you may pass DeleteFileShareInput # data as a hash: # # { # file_share_arn: "FileShareARN", # required # force_delete: false, # } # # @!attribute [rw] file_share_arn # The Amazon Resource Name (ARN) of the file share to be deleted. # @return [String] # # @!attribute [rw] force_delete # If this value is set to true, the operation deletes a file share # immediately and aborts all data uploads to AWS. Otherwise, the file # share is not deleted until all data is uploaded to AWS. This process # aborts the data upload process, and the file share enters the # FORCE\_DELETING status. # @return [Boolean] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DeleteFileShareInput AWS API Documentation # class DeleteFileShareInput < Struct.new( :file_share_arn, :force_delete) include Aws::Structure end # DeleteFileShareOutput # # @!attribute [rw] file_share_arn # The Amazon Resource Name (ARN) of the deleted file share. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DeleteFileShareOutput AWS API Documentation # class DeleteFileShareOutput < Struct.new( :file_share_arn) include Aws::Structure end # A JSON object containing the ID of the gateway to delete. # # @note When making an API call, you may pass DeleteGatewayInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DeleteGatewayInput AWS API Documentation # class DeleteGatewayInput < Struct.new( :gateway_arn) include Aws::Structure end # A JSON object containing the ID of the deleted gateway. # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DeleteGatewayOutput AWS API Documentation # class DeleteGatewayOutput < Struct.new( :gateway_arn) include Aws::Structure end # @note When making an API call, you may pass DeleteSnapshotScheduleInput # data as a hash: # # { # volume_arn: "VolumeARN", # required # } # # @!attribute [rw] volume_arn # The volume which snapshot schedule to delete. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DeleteSnapshotScheduleInput AWS API Documentation # class DeleteSnapshotScheduleInput < Struct.new( :volume_arn) include Aws::Structure end # @!attribute [rw] volume_arn # The volume which snapshot schedule was deleted. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DeleteSnapshotScheduleOutput AWS API Documentation # class DeleteSnapshotScheduleOutput < Struct.new( :volume_arn) include Aws::Structure end # DeleteTapeArchiveInput # # @note When making an API call, you may pass DeleteTapeArchiveInput # data as a hash: # # { # tape_arn: "TapeARN", # required # } # # @!attribute [rw] tape_arn # The Amazon Resource Name (ARN) of the virtual tape to delete from # the virtual tape shelf (VTS). # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DeleteTapeArchiveInput AWS API Documentation # class DeleteTapeArchiveInput < Struct.new( :tape_arn) include Aws::Structure end # DeleteTapeArchiveOutput # # @!attribute [rw] tape_arn # The Amazon Resource Name (ARN) of the virtual tape that was deleted # from the virtual tape shelf (VTS). # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DeleteTapeArchiveOutput AWS API Documentation # class DeleteTapeArchiveOutput < Struct.new( :tape_arn) include Aws::Structure end # DeleteTapeInput # # @note When making an API call, you may pass DeleteTapeInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # tape_arn: "TapeARN", # required # } # # @!attribute [rw] gateway_arn # The unique Amazon Resource Name (ARN) of the gateway that the # virtual tape to delete is associated with. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] tape_arn # The Amazon Resource Name (ARN) of the virtual tape to delete. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DeleteTapeInput AWS API Documentation # class DeleteTapeInput < Struct.new( :gateway_arn, :tape_arn) include Aws::Structure end # DeleteTapeOutput # # @!attribute [rw] tape_arn # The Amazon Resource Name (ARN) of the deleted virtual tape. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DeleteTapeOutput AWS API Documentation # class DeleteTapeOutput < Struct.new( :tape_arn) include Aws::Structure end # A JSON object containing the DeleteVolumeInput$VolumeARN to delete. # # @note When making an API call, you may pass DeleteVolumeInput # data as a hash: # # { # volume_arn: "VolumeARN", # required # } # # @!attribute [rw] volume_arn # The Amazon Resource Name (ARN) of the volume. Use the ListVolumes # operation to return a list of gateway volumes. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DeleteVolumeInput AWS API Documentation # class DeleteVolumeInput < Struct.new( :volume_arn) include Aws::Structure end # A JSON object containing the of the storage volume that was deleted # # @!attribute [rw] volume_arn # The Amazon Resource Name (ARN) of the storage volume that was # deleted. It is the same ARN you provided in the request. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DeleteVolumeOutput AWS API Documentation # class DeleteVolumeOutput < Struct.new( :volume_arn) include Aws::Structure end # A JSON object containing the of the gateway. # # @note When making an API call, you may pass DescribeBandwidthRateLimitInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeBandwidthRateLimitInput AWS API Documentation # class DescribeBandwidthRateLimitInput < Struct.new( :gateway_arn) include Aws::Structure end # A JSON object containing the following fields: # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] average_upload_rate_limit_in_bits_per_sec # The average upload bandwidth rate limit in bits per second. This # field does not appear in the response if the upload rate limit is # not set. # @return [Integer] # # @!attribute [rw] average_download_rate_limit_in_bits_per_sec # The average download bandwidth rate limit in bits per second. This # field does not appear in the response if the download rate limit is # not set. # @return [Integer] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeBandwidthRateLimitOutput AWS API Documentation # class DescribeBandwidthRateLimitOutput < Struct.new( :gateway_arn, :average_upload_rate_limit_in_bits_per_sec, :average_download_rate_limit_in_bits_per_sec) include Aws::Structure end # @note When making an API call, you may pass DescribeCacheInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeCacheInput AWS API Documentation # class DescribeCacheInput < Struct.new( :gateway_arn) include Aws::Structure end # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] disk_ids # An array of strings that identify disks that are to be configured as # working storage. Each string have a minimum length of 1 and maximum # length of 300. You can get the disk IDs from the ListLocalDisks API. # @return [Array] # # @!attribute [rw] cache_allocated_in_bytes # The amount of cache in bytes allocated to the a gateway. # @return [Integer] # # @!attribute [rw] cache_used_percentage # Percent use of the gateway's cache storage. This metric applies # only to the gateway-cached volume setup. The sample is taken at the # end of the reporting period. # @return [Float] # # @!attribute [rw] cache_dirty_percentage # The file share's contribution to the overall percentage of the # gateway's cache that has not been persisted to AWS. The sample is # taken at the end of the reporting period. # @return [Float] # # @!attribute [rw] cache_hit_percentage # Percent of application read operations from the file shares that are # served from cache. The sample is taken at the end of the reporting # period. # @return [Float] # # @!attribute [rw] cache_miss_percentage # Percent of application read operations from the file shares that are # not served from cache. The sample is taken at the end of the # reporting period. # @return [Float] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeCacheOutput AWS API Documentation # class DescribeCacheOutput < Struct.new( :gateway_arn, :disk_ids, :cache_allocated_in_bytes, :cache_used_percentage, :cache_dirty_percentage, :cache_hit_percentage, :cache_miss_percentage) include Aws::Structure end # @note When making an API call, you may pass DescribeCachediSCSIVolumesInput # data as a hash: # # { # volume_arns: ["VolumeARN"], # required # } # # @!attribute [rw] volume_arns # An array of strings where each string represents the Amazon Resource # Name (ARN) of a cached volume. All of the specified cached volumes # must from the same gateway. Use ListVolumes to get volume ARNs for a # gateway. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeCachediSCSIVolumesInput AWS API Documentation # class DescribeCachediSCSIVolumesInput < Struct.new( :volume_arns) include Aws::Structure end # A JSON object containing the following fields: # # @!attribute [rw] cached_iscsi_volumes # An array of objects where each object contains metadata about one # cached volume. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeCachediSCSIVolumesOutput AWS API Documentation # class DescribeCachediSCSIVolumesOutput < Struct.new( :cached_iscsi_volumes) include Aws::Structure end # A JSON object containing the Amazon Resource Name (ARN) of the iSCSI # volume target. # # @note When making an API call, you may pass DescribeChapCredentialsInput # data as a hash: # # { # target_arn: "TargetARN", # required # } # # @!attribute [rw] target_arn # The Amazon Resource Name (ARN) of the iSCSI volume target. Use the # DescribeStorediSCSIVolumes operation to return to retrieve the # TargetARN for specified VolumeARN. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeChapCredentialsInput AWS API Documentation # class DescribeChapCredentialsInput < Struct.new( :target_arn) include Aws::Structure end # A JSON object containing a . # # @!attribute [rw] chap_credentials # An array of ChapInfo objects that represent CHAP credentials. Each # object in the array contains CHAP credential information for one # target-initiator pair. If no CHAP credentials are set, an empty # array is returned. CHAP credential information is provided in a JSON # object with the following fields: # # * **InitiatorName**\: The iSCSI initiator that connects to the # target. # # * **SecretToAuthenticateInitiator**\: The secret key that the # initiator (for example, the Windows client) must provide to # participate in mutual CHAP with the target. # # * **SecretToAuthenticateTarget**\: The secret key that the target # must provide to participate in mutual CHAP with the initiator # (e.g. Windows client). # # * **TargetARN**\: The Amazon Resource Name (ARN) of the storage # volume. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeChapCredentialsOutput AWS API Documentation # class DescribeChapCredentialsOutput < Struct.new( :chap_credentials) include Aws::Structure end # A JSON object containing the ID of the gateway. # # @note When making an API call, you may pass DescribeGatewayInformationInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeGatewayInformationInput AWS API Documentation # class DescribeGatewayInformationInput < Struct.new( :gateway_arn) include Aws::Structure end # A JSON object containing the following fields: # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] gateway_id # The unique identifier assigned to your gateway during activation. # This ID becomes part of the gateway Amazon Resource Name (ARN), # which you use as input for other operations. # @return [String] # # @!attribute [rw] gateway_name # The name you configured for your gateway. # @return [String] # # @!attribute [rw] gateway_timezone # A value that indicates the time zone configured for the gateway. # @return [String] # # @!attribute [rw] gateway_state # A value that indicates the operating state of the gateway. # @return [String] # # @!attribute [rw] gateway_network_interfaces # A NetworkInterface array that contains descriptions of the gateway # network interfaces. # @return [Array] # # @!attribute [rw] gateway_type # The type of the gateway. # @return [String] # # @!attribute [rw] next_update_availability_date # The date on which an update to the gateway is available. This date # is in the time zone of the gateway. If the gateway is not available # for an update this field is not returned in the response. # @return [String] # # @!attribute [rw] last_software_update # The date on which the last software update was applied to the # gateway. If the gateway has never been updated, this field does not # return a value in the response. # @return [String] # # @!attribute [rw] ec2_instance_id # The ID of the Amazon EC2 instance that was used to launch the # gateway. # @return [String] # # @!attribute [rw] ec2_instance_region # The AWS Region where the Amazon EC2 instance is located. # @return [String] # # @!attribute [rw] tags # A list of up to 50 tags assigned to the gateway, sorted # alphabetically by key name. Each tag is a key-value pair. For a # gateway with more than 10 tags assigned, you can view all tags using # the `ListTagsForResource` API operation. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeGatewayInformationOutput AWS API Documentation # class DescribeGatewayInformationOutput < Struct.new( :gateway_arn, :gateway_id, :gateway_name, :gateway_timezone, :gateway_state, :gateway_network_interfaces, :gateway_type, :next_update_availability_date, :last_software_update, :ec2_instance_id, :ec2_instance_region, :tags) include Aws::Structure end # A JSON object containing the of the gateway. # # @note When making an API call, you may pass DescribeMaintenanceStartTimeInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeMaintenanceStartTimeInput AWS API Documentation # class DescribeMaintenanceStartTimeInput < Struct.new( :gateway_arn) include Aws::Structure end # A JSON object containing the following fields: # # * DescribeMaintenanceStartTimeOutput$DayOfMonth # # * DescribeMaintenanceStartTimeOutput$DayOfWeek # # * DescribeMaintenanceStartTimeOutput$HourOfDay # # * DescribeMaintenanceStartTimeOutput$MinuteOfHour # # * DescribeMaintenanceStartTimeOutput$Timezone # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] hour_of_day # The hour component of the maintenance start time represented as # *hh*, where *hh* is the hour (0 to 23). The hour of the day is in # the time zone of the gateway. # @return [Integer] # # @!attribute [rw] minute_of_hour # The minute component of the maintenance start time represented as # *mm*, where *mm* is the minute (0 to 59). The minute of the hour is # in the time zone of the gateway. # @return [Integer] # # @!attribute [rw] day_of_week # An ordinal number between 0 and 6 that represents the day of the # week, where 0 represents Sunday and 6 represents Saturday. The day # of week is in the time zone of the gateway. # @return [Integer] # # @!attribute [rw] day_of_month # The day of the month component of the maintenance start time # represented as an ordinal number from 1 to 28, where 1 represents # the first day of the month and 28 represents the last day of the # month. # # This value is only available for tape and volume gateways. # # # @return [Integer] # # @!attribute [rw] timezone # A value that indicates the time zone that is set for the gateway. # The start time and day of week specified should be in the time zone # of the gateway. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeMaintenanceStartTimeOutput AWS API Documentation # class DescribeMaintenanceStartTimeOutput < Struct.new( :gateway_arn, :hour_of_day, :minute_of_hour, :day_of_week, :day_of_month, :timezone) include Aws::Structure end # DescribeNFSFileSharesInput # # @note When making an API call, you may pass DescribeNFSFileSharesInput # data as a hash: # # { # file_share_arn_list: ["FileShareARN"], # required # } # # @!attribute [rw] file_share_arn_list # An array containing the Amazon Resource Name (ARN) of each file # share to be described. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeNFSFileSharesInput AWS API Documentation # class DescribeNFSFileSharesInput < Struct.new( :file_share_arn_list) include Aws::Structure end # DescribeNFSFileSharesOutput # # @!attribute [rw] nfs_file_share_info_list # An array containing a description for each requested file share. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeNFSFileSharesOutput AWS API Documentation # class DescribeNFSFileSharesOutput < Struct.new( :nfs_file_share_info_list) include Aws::Structure end # DescribeSMBFileSharesInput # # @note When making an API call, you may pass DescribeSMBFileSharesInput # data as a hash: # # { # file_share_arn_list: ["FileShareARN"], # required # } # # @!attribute [rw] file_share_arn_list # An array containing the Amazon Resource Name (ARN) of each file # share to be described. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeSMBFileSharesInput AWS API Documentation # class DescribeSMBFileSharesInput < Struct.new( :file_share_arn_list) include Aws::Structure end # DescribeSMBFileSharesOutput # # @!attribute [rw] smb_file_share_info_list # An array containing a description for each requested file share. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeSMBFileSharesOutput AWS API Documentation # class DescribeSMBFileSharesOutput < Struct.new( :smb_file_share_info_list) include Aws::Structure end # @note When making an API call, you may pass DescribeSMBSettingsInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeSMBSettingsInput AWS API Documentation # class DescribeSMBSettingsInput < Struct.new( :gateway_arn) include Aws::Structure end # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] domain_name # The name of the domain that the gateway is joined to. # @return [String] # # @!attribute [rw] smb_guest_password_set # This value is true if a password for the guest user “smbguest” is # set, and otherwise false. # @return [Boolean] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeSMBSettingsOutput AWS API Documentation # class DescribeSMBSettingsOutput < Struct.new( :gateway_arn, :domain_name, :smb_guest_password_set) include Aws::Structure end # A JSON object containing the DescribeSnapshotScheduleInput$VolumeARN # of the volume. # # @note When making an API call, you may pass DescribeSnapshotScheduleInput # data as a hash: # # { # volume_arn: "VolumeARN", # required # } # # @!attribute [rw] volume_arn # The Amazon Resource Name (ARN) of the volume. Use the ListVolumes # operation to return a list of gateway volumes. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeSnapshotScheduleInput AWS API Documentation # class DescribeSnapshotScheduleInput < Struct.new( :volume_arn) include Aws::Structure end # @!attribute [rw] volume_arn # The Amazon Resource Name (ARN) of the volume that was specified in # the request. # @return [String] # # @!attribute [rw] start_at # The hour of the day at which the snapshot schedule begins # represented as *hh*, where *hh* is the hour (0 to 23). The hour of # the day is in the time zone of the gateway. # @return [Integer] # # @!attribute [rw] recurrence_in_hours # The number of hours between snapshots. # @return [Integer] # # @!attribute [rw] description # The snapshot description. # @return [String] # # @!attribute [rw] timezone # A value that indicates the time zone of the gateway. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeSnapshotScheduleOutput AWS API Documentation # class DescribeSnapshotScheduleOutput < Struct.new( :volume_arn, :start_at, :recurrence_in_hours, :description, :timezone) include Aws::Structure end # A JSON object containing a list of # DescribeStorediSCSIVolumesInput$VolumeARNs. # # @note When making an API call, you may pass DescribeStorediSCSIVolumesInput # data as a hash: # # { # volume_arns: ["VolumeARN"], # required # } # # @!attribute [rw] volume_arns # An array of strings where each string represents the Amazon Resource # Name (ARN) of a stored volume. All of the specified stored volumes # must from the same gateway. Use ListVolumes to get volume ARNs for a # gateway. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeStorediSCSIVolumesInput AWS API Documentation # class DescribeStorediSCSIVolumesInput < Struct.new( :volume_arns) include Aws::Structure end # @!attribute [rw] stored_iscsi_volumes # Describes a single unit of output from DescribeStorediSCSIVolumes. # The following fields are returned: # # * **ChapEnabled**\: Indicates whether mutual CHAP is enabled for the # iSCSI target. # # * **LunNumber**\: The logical disk number. # # * **NetworkInterfaceId**\: The network interface ID of the stored # volume that initiator use to map the stored volume as an iSCSI # target. # # * **NetworkInterfacePort**\: The port used to communicate with iSCSI # targets. # # * **PreservedExistingData**\: Indicates if when the stored volume # was created, existing data on the underlying local disk was # preserved. # # * **SourceSnapshotId**\: If the stored volume was created from a # snapshot, this field contains the snapshot ID used, e.g. # snap-1122aabb. Otherwise, this field is not included. # # * **StorediSCSIVolumes**\: An array of StorediSCSIVolume objects # where each object contains metadata about one stored volume. # # * **TargetARN**\: The Amazon Resource Name (ARN) of the volume # target. # # * **VolumeARN**\: The Amazon Resource Name (ARN) of the stored # volume. # # * **VolumeDiskId**\: The disk ID of the local disk that was # specified in the CreateStorediSCSIVolume operation. # # * **VolumeId**\: The unique identifier of the storage volume, e.g. # vol-1122AABB. # # * **VolumeiSCSIAttributes**\: An VolumeiSCSIAttributes object that # represents a collection of iSCSI attributes for one stored volume. # # * **VolumeProgress**\: Represents the percentage complete if the # volume is restoring or bootstrapping that represents the percent # of data transferred. This field does not appear in the response if # the stored volume is not restoring or bootstrapping. # # * **VolumeSizeInBytes**\: The size of the volume in bytes. # # * **VolumeStatus**\: One of the `VolumeStatus` values that indicates # the state of the volume. # # * **VolumeType**\: One of the enumeration values describing the type # of the volume. Currently, on STORED volumes are supported. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeStorediSCSIVolumesOutput AWS API Documentation # class DescribeStorediSCSIVolumesOutput < Struct.new( :stored_iscsi_volumes) include Aws::Structure end # DescribeTapeArchivesInput # # @note When making an API call, you may pass DescribeTapeArchivesInput # data as a hash: # # { # tape_arns: ["TapeARN"], # marker: "Marker", # limit: 1, # } # # @!attribute [rw] tape_arns # Specifies one or more unique Amazon Resource Names (ARNs) that # represent the virtual tapes you want to describe. # @return [Array] # # @!attribute [rw] marker # An opaque string that indicates the position at which to begin # describing virtual tapes. # @return [String] # # @!attribute [rw] limit # Specifies that the number of virtual tapes descried be limited to # the specified number. # @return [Integer] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeTapeArchivesInput AWS API Documentation # class DescribeTapeArchivesInput < Struct.new( :tape_arns, :marker, :limit) include Aws::Structure end # DescribeTapeArchivesOutput # # @!attribute [rw] tape_archives # An array of virtual tape objects in the virtual tape shelf (VTS). # The description includes of the Amazon Resource Name (ARN) of the # virtual tapes. The information returned includes the Amazon Resource # Names (ARNs) of the tapes, size of the tapes, status of the tapes, # progress of the description and tape barcode. # @return [Array] # # @!attribute [rw] marker # An opaque string that indicates the position at which the virtual # tapes that were fetched for description ended. Use this marker in # your next request to fetch the next set of virtual tapes in the # virtual tape shelf (VTS). If there are no more virtual tapes to # describe, this field does not appear in the response. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeTapeArchivesOutput AWS API Documentation # class DescribeTapeArchivesOutput < Struct.new( :tape_archives, :marker) include Aws::Structure end # DescribeTapeRecoveryPointsInput # # @note When making an API call, you may pass DescribeTapeRecoveryPointsInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # marker: "Marker", # limit: 1, # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] marker # An opaque string that indicates the position at which to begin # describing the virtual tape recovery points. # @return [String] # # @!attribute [rw] limit # Specifies that the number of virtual tape recovery points that are # described be limited to the specified number. # @return [Integer] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeTapeRecoveryPointsInput AWS API Documentation # class DescribeTapeRecoveryPointsInput < Struct.new( :gateway_arn, :marker, :limit) include Aws::Structure end # DescribeTapeRecoveryPointsOutput # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] tape_recovery_point_infos # An array of TapeRecoveryPointInfos that are available for the # specified gateway. # @return [Array] # # @!attribute [rw] marker # An opaque string that indicates the position at which the virtual # tape recovery points that were listed for description ended. # # Use this marker in your next request to list the next set of virtual # tape recovery points in the list. If there are no more recovery # points to describe, this field does not appear in the response. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeTapeRecoveryPointsOutput AWS API Documentation # class DescribeTapeRecoveryPointsOutput < Struct.new( :gateway_arn, :tape_recovery_point_infos, :marker) include Aws::Structure end # DescribeTapesInput # # @note When making an API call, you may pass DescribeTapesInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # tape_arns: ["TapeARN"], # marker: "Marker", # limit: 1, # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] tape_arns # Specifies one or more unique Amazon Resource Names (ARNs) that # represent the virtual tapes you want to describe. If this parameter # is not specified, Tape gateway returns a description of all virtual # tapes associated with the specified gateway. # @return [Array] # # @!attribute [rw] marker # A marker value, obtained in a previous call to `DescribeTapes`. This # marker indicates which page of results to retrieve. # # If not specified, the first page of results is retrieved. # @return [String] # # @!attribute [rw] limit # Specifies that the number of virtual tapes described be limited to # the specified number. # # Amazon Web Services may impose its own limit, if this field is not # set. # # # @return [Integer] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeTapesInput AWS API Documentation # class DescribeTapesInput < Struct.new( :gateway_arn, :tape_arns, :marker, :limit) include Aws::Structure end # DescribeTapesOutput # # @!attribute [rw] tapes # An array of virtual tape descriptions. # @return [Array] # # @!attribute [rw] marker # An opaque string which can be used as part of a subsequent # DescribeTapes call to retrieve the next page of results. # # If a response does not contain a marker, then there are no more # results to be retrieved. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeTapesOutput AWS API Documentation # class DescribeTapesOutput < Struct.new( :tapes, :marker) include Aws::Structure end # @note When making an API call, you may pass DescribeUploadBufferInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeUploadBufferInput AWS API Documentation # class DescribeUploadBufferInput < Struct.new( :gateway_arn) include Aws::Structure end # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] disk_ids # An array of the gateway's local disk IDs that are configured as # working storage. Each local disk ID is specified as a string # (minimum length of 1 and maximum length of 300). If no local disks # are configured as working storage, then the DiskIds array is empty. # @return [Array] # # @!attribute [rw] upload_buffer_used_in_bytes # The total number of bytes being used in the gateway's upload # buffer. # @return [Integer] # # @!attribute [rw] upload_buffer_allocated_in_bytes # The total number of bytes allocated in the gateway's as upload # buffer. # @return [Integer] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeUploadBufferOutput AWS API Documentation # class DescribeUploadBufferOutput < Struct.new( :gateway_arn, :disk_ids, :upload_buffer_used_in_bytes, :upload_buffer_allocated_in_bytes) include Aws::Structure end # DescribeVTLDevicesInput # # @note When making an API call, you may pass DescribeVTLDevicesInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # vtl_device_arns: ["VTLDeviceARN"], # marker: "Marker", # limit: 1, # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] vtl_device_arns # An array of strings, where each string represents the Amazon # Resource Name (ARN) of a VTL device. # # All of the specified VTL devices must be from the same gateway. If # no VTL devices are specified, the result will contain all devices on # the specified gateway. # # # @return [Array] # # @!attribute [rw] marker # An opaque string that indicates the position at which to begin # describing the VTL devices. # @return [String] # # @!attribute [rw] limit # Specifies that the number of VTL devices described be limited to the # specified number. # @return [Integer] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeVTLDevicesInput AWS API Documentation # class DescribeVTLDevicesInput < Struct.new( :gateway_arn, :vtl_device_arns, :marker, :limit) include Aws::Structure end # DescribeVTLDevicesOutput # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] vtl_devices # An array of VTL device objects composed of the Amazon Resource # Name(ARN) of the VTL devices. # @return [Array] # # @!attribute [rw] marker # An opaque string that indicates the position at which the VTL # devices that were fetched for description ended. Use the marker in # your next request to fetch the next set of VTL devices in the list. # If there are no more VTL devices to describe, this field does not # appear in the response. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeVTLDevicesOutput AWS API Documentation # class DescribeVTLDevicesOutput < Struct.new( :gateway_arn, :vtl_devices, :marker) include Aws::Structure end # A JSON object containing the of the gateway. # # @note When making an API call, you may pass DescribeWorkingStorageInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeWorkingStorageInput AWS API Documentation # class DescribeWorkingStorageInput < Struct.new( :gateway_arn) include Aws::Structure end # A JSON object containing the following fields: # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] disk_ids # An array of the gateway's local disk IDs that are configured as # working storage. Each local disk ID is specified as a string # (minimum length of 1 and maximum length of 300). If no local disks # are configured as working storage, then the DiskIds array is empty. # @return [Array] # # @!attribute [rw] working_storage_used_in_bytes # The total working storage in bytes in use by the gateway. If no # working storage is configured for the gateway, this field returns 0. # @return [Integer] # # @!attribute [rw] working_storage_allocated_in_bytes # The total working storage in bytes allocated for the gateway. If no # working storage is configured for the gateway, this field returns 0. # @return [Integer] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DescribeWorkingStorageOutput AWS API Documentation # class DescribeWorkingStorageOutput < Struct.new( :gateway_arn, :disk_ids, :working_storage_used_in_bytes, :working_storage_allocated_in_bytes) include Aws::Structure end # AttachVolumeInput # # @note When making an API call, you may pass DetachVolumeInput # data as a hash: # # { # volume_arn: "VolumeARN", # required # force_detach: false, # } # # @!attribute [rw] volume_arn # The Amazon Resource Name (ARN) of the volume to detach from the # gateway. # @return [String] # # @!attribute [rw] force_detach # Set to `true` to forcibly remove the iSCSI connection of the target # volume and detach the volume. The default is `false`. If this value # is set to `false`, you must manually disconnect the iSCSI connection # from the target volume. # @return [Boolean] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DetachVolumeInput AWS API Documentation # class DetachVolumeInput < Struct.new( :volume_arn, :force_detach) include Aws::Structure end # AttachVolumeOutput # # @!attribute [rw] volume_arn # The Amazon Resource Name (ARN) of the volume that was detached. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DetachVolumeOutput AWS API Documentation # class DetachVolumeOutput < Struct.new( :volume_arn) include Aws::Structure end # Lists iSCSI information about a VTL device. # # @!attribute [rw] target_arn # Specifies the unique Amazon Resource Name (ARN) that encodes the # iSCSI qualified name(iqn) of a tape drive or media changer target. # @return [String] # # @!attribute [rw] network_interface_id # The network interface identifier of the VTL device. # @return [String] # # @!attribute [rw] network_interface_port # The port used to communicate with iSCSI VTL device targets. # @return [Integer] # # @!attribute [rw] chap_enabled # Indicates whether mutual CHAP is enabled for the iSCSI target. # @return [Boolean] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DeviceiSCSIAttributes AWS API Documentation # class DeviceiSCSIAttributes < Struct.new( :target_arn, :network_interface_id, :network_interface_port, :chap_enabled) include Aws::Structure end # DisableGatewayInput # # @note When making an API call, you may pass DisableGatewayInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DisableGatewayInput AWS API Documentation # class DisableGatewayInput < Struct.new( :gateway_arn) include Aws::Structure end # DisableGatewayOutput # # @!attribute [rw] gateway_arn # The unique Amazon Resource Name (ARN) of the disabled gateway. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DisableGatewayOutput AWS API Documentation # class DisableGatewayOutput < Struct.new( :gateway_arn) include Aws::Structure end # Represents a gateway's local disk. # # @!attribute [rw] disk_id # The unique device ID or other distinguishing data that identifies a # local disk. # @return [String] # # @!attribute [rw] disk_path # The path of a local disk in the gateway virtual machine (VM). # @return [String] # # @!attribute [rw] disk_node # The device node of a local disk as assigned by the virtualization # environment. # @return [String] # # @!attribute [rw] disk_status # A value that represents the status of a local disk. # @return [String] # # @!attribute [rw] disk_size_in_bytes # The local disk size in bytes. # @return [Integer] # # @!attribute [rw] disk_allocation_type # One of the `DiskAllocationType` enumeration values that identifies # how a local disk is used. Valid values: `UPLOAD_BUFFER`, # `CACHE_STORAGE` # @return [String] # # @!attribute [rw] disk_allocation_resource # The iSCSI qualified name (IQN) that is defined for a disk. This # field is not included in the response if the local disk is not # defined as an iSCSI target. The format of this field is # *targetIqn::LUNNumber::region-volumeId*. # @return [String] # # @!attribute [rw] disk_attribute_list # A list of values that represents attributes of a local disk. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/Disk AWS API Documentation # class Disk < Struct.new( :disk_id, :disk_path, :disk_node, :disk_status, :disk_size_in_bytes, :disk_allocation_type, :disk_allocation_resource, :disk_attribute_list) include Aws::Structure end # Describes a file share. # # @!attribute [rw] file_share_type # The type of the file share. # @return [String] # # @!attribute [rw] file_share_arn # The Amazon Resource Name (ARN) of the file share. # @return [String] # # @!attribute [rw] file_share_id # The ID of the file share. # @return [String] # # @!attribute [rw] file_share_status # The status of the file share. Possible values are `CREATING`, # `UPDATING`, `AVAILABLE` and `DELETING`. # @return [String] # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/FileShareInfo AWS API Documentation # class FileShareInfo < Struct.new( :file_share_type, :file_share_arn, :file_share_id, :file_share_status, :gateway_arn) include Aws::Structure end # Describes a gateway object. # # @!attribute [rw] gateway_id # The unique identifier assigned to your gateway during activation. # This ID becomes part of the gateway Amazon Resource Name (ARN), # which you use as input for other operations. # @return [String] # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] gateway_type # The type of the gateway. # @return [String] # # @!attribute [rw] gateway_operational_state # The state of the gateway. # # Valid Values: DISABLED or ACTIVE # @return [String] # # @!attribute [rw] gateway_name # The name of the gateway. # @return [String] # # @!attribute [rw] ec2_instance_id # The ID of the Amazon EC2 instance that was used to launch the # gateway. # @return [String] # # @!attribute [rw] ec2_instance_region # The AWS Region where the Amazon EC2 instance is located. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/GatewayInfo AWS API Documentation # class GatewayInfo < Struct.new( :gateway_id, :gateway_arn, :gateway_type, :gateway_operational_state, :gateway_name, :ec2_instance_id, :ec2_instance_region) include Aws::Structure end # JoinDomainInput # # @note When making an API call, you may pass JoinDomainInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # domain_name: "DomainName", # required # organizational_unit: "OrganizationalUnit", # domain_controllers: ["Host"], # user_name: "DomainUserName", # required # password: "DomainUserPassword", # required # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the # `ListGateways` operation to return a list of gateways for your # account and region. # @return [String] # # @!attribute [rw] domain_name # The name of the domain that you want the gateway to join. # @return [String] # # @!attribute [rw] organizational_unit # The organizational unit (OU) is a container with an Active Directory # that can hold users, groups, computers, and other OUs and this # parameter specifies the OU that the gateway will join within the AD # domain. # @return [String] # # @!attribute [rw] domain_controllers # List of IPv4 addresses, NetBIOS names, or host names of your domain # server. If you need to specify the port number include it after the # colon (“:”). For example, `mydc.mydomain.com:389`. # @return [Array] # # @!attribute [rw] user_name # Sets the user name of user who has permission to add the gateway to # the Active Directory domain. # @return [String] # # @!attribute [rw] password # Sets the password of the user who has permission to add the gateway # to the Active Directory domain. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/JoinDomainInput AWS API Documentation # class JoinDomainInput < Struct.new( :gateway_arn, :domain_name, :organizational_unit, :domain_controllers, :user_name, :password) include Aws::Structure end # JoinDomainOutput # # @!attribute [rw] gateway_arn # The unique Amazon Resource Name (ARN) of the gateway that joined the # domain. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/JoinDomainOutput AWS API Documentation # class JoinDomainOutput < Struct.new( :gateway_arn) include Aws::Structure end # ListFileShareInput # # @note When making an API call, you may pass ListFileSharesInput # data as a hash: # # { # gateway_arn: "GatewayARN", # limit: 1, # marker: "Marker", # } # # @!attribute [rw] gateway_arn # The Amazon resource Name (ARN) of the gateway whose file shares you # want to list. If this field is not present, all file shares under # your account are listed. # @return [String] # # @!attribute [rw] limit # The maximum number of file shares to return in the response. The # value must be an integer with a value greater than zero. Optional. # @return [Integer] # # @!attribute [rw] marker # Opaque pagination token returned from a previous ListFileShares # operation. If present, `Marker` specifies where to continue the list # from after a previous call to ListFileShares. Optional. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/ListFileSharesInput AWS API Documentation # class ListFileSharesInput < Struct.new( :gateway_arn, :limit, :marker) include Aws::Structure end # ListFileShareOutput # # @!attribute [rw] marker # If the request includes `Marker`, the response returns that value in # this field. # @return [String] # # @!attribute [rw] next_marker # If a value is present, there are more file shares to return. In a # subsequent request, use `NextMarker` as the value for `Marker` to # retrieve the next set of file shares. # @return [String] # # @!attribute [rw] file_share_info_list # An array of information about the file gateway's file shares. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/ListFileSharesOutput AWS API Documentation # class ListFileSharesOutput < Struct.new( :marker, :next_marker, :file_share_info_list) include Aws::Structure end # A JSON object containing zero or more of the following fields: # # * ListGatewaysInput$Limit # # * ListGatewaysInput$Marker # # @note When making an API call, you may pass ListGatewaysInput # data as a hash: # # { # marker: "Marker", # limit: 1, # } # # @!attribute [rw] marker # An opaque string that indicates the position at which to begin the # returned list of gateways. # @return [String] # # @!attribute [rw] limit # Specifies that the list of gateways returned be limited to the # specified number of items. # @return [Integer] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/ListGatewaysInput AWS API Documentation # class ListGatewaysInput < Struct.new( :marker, :limit) include Aws::Structure end # @!attribute [rw] gateways # An array of GatewayInfo objects. # @return [Array] # # @!attribute [rw] marker # Use the marker in your next request to fetch the next set of # gateways in the list. If there are no more gateways to list, this # field does not appear in the response. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/ListGatewaysOutput AWS API Documentation # class ListGatewaysOutput < Struct.new( :gateways, :marker) include Aws::Structure end # A JSON object containing the of the gateway. # # @note When making an API call, you may pass ListLocalDisksInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/ListLocalDisksInput AWS API Documentation # class ListLocalDisksInput < Struct.new( :gateway_arn) include Aws::Structure end # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] disks # A JSON object containing the following fields: # # * ListLocalDisksOutput$Disks # # ^ # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/ListLocalDisksOutput AWS API Documentation # class ListLocalDisksOutput < Struct.new( :gateway_arn, :disks) include Aws::Structure end # ListTagsForResourceInput # # @note When making an API call, you may pass ListTagsForResourceInput # data as a hash: # # { # resource_arn: "ResourceARN", # required # marker: "Marker", # limit: 1, # } # # @!attribute [rw] resource_arn # The Amazon Resource Name (ARN) of the resource for which you want to # list tags. # @return [String] # # @!attribute [rw] marker # An opaque string that indicates the position at which to begin # returning the list of tags. # @return [String] # # @!attribute [rw] limit # Specifies that the list of tags returned be limited to the specified # number of items. # @return [Integer] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/ListTagsForResourceInput AWS API Documentation # class ListTagsForResourceInput < Struct.new( :resource_arn, :marker, :limit) include Aws::Structure end # ListTagsForResourceOutput # # @!attribute [rw] resource_arn # he Amazon Resource Name (ARN) of the resource for which you want to # list tags. # @return [String] # # @!attribute [rw] marker # An opaque string that indicates the position at which to stop # returning the list of tags. # @return [String] # # @!attribute [rw] tags # An array that contains the tags for the specified resource. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/ListTagsForResourceOutput AWS API Documentation # class ListTagsForResourceOutput < Struct.new( :resource_arn, :marker, :tags) include Aws::Structure end # A JSON object that contains one or more of the following fields: # # * ListTapesInput$Limit # # * ListTapesInput$Marker # # * ListTapesInput$TapeARNs # # @note When making an API call, you may pass ListTapesInput # data as a hash: # # { # tape_arns: ["TapeARN"], # marker: "Marker", # limit: 1, # } # # @!attribute [rw] tape_arns # The Amazon Resource Name (ARN) of each of the tapes you want to # list. If you don't specify a tape ARN, the response lists all tapes # in both your VTL and VTS. # @return [Array] # # @!attribute [rw] marker # A string that indicates the position at which to begin the returned # list of tapes. # @return [String] # # @!attribute [rw] limit # An optional number limit for the tapes in the list returned by this # call. # @return [Integer] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/ListTapesInput AWS API Documentation # class ListTapesInput < Struct.new( :tape_arns, :marker, :limit) include Aws::Structure end # A JSON object containing the following fields: # # * ListTapesOutput$Marker # # * ListTapesOutput$VolumeInfos # # @!attribute [rw] tape_infos # An array of TapeInfo objects, where each object describes an a # single tape. If there not tapes in the tape library or VTS, then the # `TapeInfos` is an empty array. # @return [Array] # # @!attribute [rw] marker # A string that indicates the position at which to begin returning the # next list of tapes. Use the marker in your next request to continue # pagination of tapes. If there are no more tapes to list, this # element does not appear in the response body. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/ListTapesOutput AWS API Documentation # class ListTapesOutput < Struct.new( :tape_infos, :marker) include Aws::Structure end # ListVolumeInitiatorsInput # # @note When making an API call, you may pass ListVolumeInitiatorsInput # data as a hash: # # { # volume_arn: "VolumeARN", # required # } # # @!attribute [rw] volume_arn # The Amazon Resource Name (ARN) of the volume. Use the ListVolumes # operation to return a list of gateway volumes for the gateway. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/ListVolumeInitiatorsInput AWS API Documentation # class ListVolumeInitiatorsInput < Struct.new( :volume_arn) include Aws::Structure end # ListVolumeInitiatorsOutput # # @!attribute [rw] initiators # The host names and port numbers of all iSCSI initiators that are # connected to the gateway. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/ListVolumeInitiatorsOutput AWS API Documentation # class ListVolumeInitiatorsOutput < Struct.new( :initiators) include Aws::Structure end # @note When making an API call, you may pass ListVolumeRecoveryPointsInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/ListVolumeRecoveryPointsInput AWS API Documentation # class ListVolumeRecoveryPointsInput < Struct.new( :gateway_arn) include Aws::Structure end # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] volume_recovery_point_infos # An array of VolumeRecoveryPointInfo objects. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/ListVolumeRecoveryPointsOutput AWS API Documentation # class ListVolumeRecoveryPointsOutput < Struct.new( :gateway_arn, :volume_recovery_point_infos) include Aws::Structure end # A JSON object that contains one or more of the following fields: # # * ListVolumesInput$Limit # # * ListVolumesInput$Marker # # @note When making an API call, you may pass ListVolumesInput # data as a hash: # # { # gateway_arn: "GatewayARN", # marker: "Marker", # limit: 1, # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] marker # A string that indicates the position at which to begin the returned # list of volumes. Obtain the marker from the response of a previous # List iSCSI Volumes request. # @return [String] # # @!attribute [rw] limit # Specifies that the list of volumes returned be limited to the # specified number of items. # @return [Integer] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/ListVolumesInput AWS API Documentation # class ListVolumesInput < Struct.new( :gateway_arn, :marker, :limit) include Aws::Structure end # A JSON object containing the following fields: # # * ListVolumesOutput$Marker # # * ListVolumesOutput$VolumeInfos # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] marker # Use the marker in your next request to continue pagination of iSCSI # volumes. If there are no more volumes to list, this field does not # appear in the response body. # @return [String] # # @!attribute [rw] volume_infos # An array of VolumeInfo objects, where each object describes an iSCSI # volume. If no volumes are defined for the gateway, then # `VolumeInfos` is an empty array "\[\]". # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/ListVolumesOutput AWS API Documentation # class ListVolumesOutput < Struct.new( :gateway_arn, :marker, :volume_infos) include Aws::Structure end # Describes Network File System (NFS) file share default values. Files # and folders stored as Amazon S3 objects in S3 buckets don't, by # default, have Unix file permissions assigned to them. Upon discovery # in an S3 bucket by Storage Gateway, the S3 objects that represent # files and folders are assigned these default Unix permissions. This # operation is only supported for file gateways. # # @note When making an API call, you may pass NFSFileShareDefaults # data as a hash: # # { # file_mode: "PermissionMode", # directory_mode: "PermissionMode", # group_id: 1, # owner_id: 1, # } # # @!attribute [rw] file_mode # The Unix file mode in the form "nnnn". For example, "0666" # represents the default file mode inside the file share. The default # value is 0666. # @return [String] # # @!attribute [rw] directory_mode # The Unix directory mode in the form "nnnn". For example, "0666" # represents the default access mode for all directories inside the # file share. The default value is 0777. # @return [String] # # @!attribute [rw] group_id # The default group ID for the file share (unless the files have # another group ID specified). The default value is nfsnobody. # @return [Integer] # # @!attribute [rw] owner_id # The default owner ID for files in the file share (unless the files # have another owner ID specified). The default value is nfsnobody. # @return [Integer] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/NFSFileShareDefaults AWS API Documentation # class NFSFileShareDefaults < Struct.new( :file_mode, :directory_mode, :group_id, :owner_id) include Aws::Structure end # The Unix file permissions and ownership information assigned, by # default, to native S3 objects when file gateway discovers them in S3 # buckets. This operation is only supported in file gateways. # # @!attribute [rw] nfs_file_share_defaults # Describes Network File System (NFS) file share default values. Files # and folders stored as Amazon S3 objects in S3 buckets don't, by # default, have Unix file permissions assigned to them. Upon discovery # in an S3 bucket by Storage Gateway, the S3 objects that represent # files and folders are assigned these default Unix permissions. This # operation is only supported for file gateways. # @return [Types::NFSFileShareDefaults] # # @!attribute [rw] file_share_arn # The Amazon Resource Name (ARN) of the file share. # @return [String] # # @!attribute [rw] file_share_id # The ID of the file share. # @return [String] # # @!attribute [rw] file_share_status # The status of the file share. Possible values are `CREATING`, # `UPDATING`, `AVAILABLE` and `DELETING`. # @return [String] # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] kms_encrypted # True to use Amazon S3 server side encryption with your own AWS KMS # key, or false to use a key managed by Amazon S3. Optional. # @return [Boolean] # # @!attribute [rw] kms_key # The Amazon Resource Name (ARN) of the AWS KMS key used for Amazon S3 # server side encryption. This value can only be set when KMSEncrypted # is true. Optional. # @return [String] # # @!attribute [rw] path # The file share path used by the NFS client to identify the mount # point. # @return [String] # # @!attribute [rw] role # The ARN of the IAM role that file gateway assumes when it accesses # the underlying storage. # @return [String] # # @!attribute [rw] location_arn # The ARN of the backend storage used for storing file data. # @return [String] # # @!attribute [rw] default_storage_class # The default storage class for objects put into an Amazon S3 bucket # by the file gateway. Possible values are `S3_STANDARD`, # `S3_STANDARD_IA`, or `S3_ONEZONE_IA`. If this field is not # populated, the default value `S3_STANDARD` is used. Optional. # @return [String] # # @!attribute [rw] object_acl # A value that sets the access control list permission for objects in # the S3 bucket that a file gateway puts objects into. The default # value is "private". # @return [String] # # @!attribute [rw] client_list # The list of clients that are allowed to access the file gateway. The # list must contain either valid IP addresses or valid CIDR blocks. # @return [Array] # # @!attribute [rw] squash # The user mapped to anonymous user. Valid options are the following: # # * `RootSquash` - Only root is mapped to anonymous user. # # * `NoSquash` - No one is mapped to anonymous user # # * `AllSquash` - Everyone is mapped to anonymous user. # @return [String] # # @!attribute [rw] read_only # A value that sets the write status of a file share. This value is # true if the write status is read-only, and otherwise false. # @return [Boolean] # # @!attribute [rw] guess_mime_type_enabled # A value that enables guessing of the MIME type for uploaded objects # based on file extensions. Set this value to true to enable MIME type # guessing, and otherwise to false. The default value is true. # @return [Boolean] # # @!attribute [rw] requester_pays # A value that sets who pays the cost of the request and the cost # associated with data download from the S3 bucket. If this value is # set to true, the requester pays the costs. Otherwise the S3 bucket # owner pays. However, the S3 bucket owner always pays the cost of # storing data. # # `RequesterPays` is a configuration for the S3 bucket that backs the # file share, so make sure that the configuration on the file share is # the same as the S3 bucket configuration. # # # @return [Boolean] # # @!attribute [rw] tags # A list of up to 50 tags assigned to the NFS file share, sorted # alphabetically by key name. Each tag is a key-value pair. For a # gateway with more than 10 tags assigned, you can view all tags using # the `ListTagsForResource` API operation. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/NFSFileShareInfo AWS API Documentation # class NFSFileShareInfo < Struct.new( :nfs_file_share_defaults, :file_share_arn, :file_share_id, :file_share_status, :gateway_arn, :kms_encrypted, :kms_key, :path, :role, :location_arn, :default_storage_class, :object_acl, :client_list, :squash, :read_only, :guess_mime_type_enabled, :requester_pays, :tags) include Aws::Structure end # Describes a gateway's network interface. # # @!attribute [rw] ipv_4_address # The Internet Protocol version 4 (IPv4) address of the interface. # @return [String] # # @!attribute [rw] mac_address # The Media Access Control (MAC) address of the interface. # # This is currently unsupported and will not be returned in output. # # # @return [String] # # @!attribute [rw] ipv_6_address # The Internet Protocol version 6 (IPv6) address of the interface. # *Currently not supported*. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/NetworkInterface AWS API Documentation # class NetworkInterface < Struct.new( :ipv_4_address, :mac_address, :ipv_6_address) include Aws::Structure end # @note When making an API call, you may pass NotifyWhenUploadedInput # data as a hash: # # { # file_share_arn: "FileShareARN", # required # } # # @!attribute [rw] file_share_arn # The Amazon Resource Name (ARN) of the file share. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/NotifyWhenUploadedInput AWS API Documentation # class NotifyWhenUploadedInput < Struct.new( :file_share_arn) include Aws::Structure end # @!attribute [rw] file_share_arn # The Amazon Resource Name (ARN) of the file share. # @return [String] # # @!attribute [rw] notification_id # The randomly generated ID of the notification that was sent. This ID # is in UUID format. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/NotifyWhenUploadedOutput AWS API Documentation # class NotifyWhenUploadedOutput < Struct.new( :file_share_arn, :notification_id) include Aws::Structure end # RefreshCacheInput # # @note When making an API call, you may pass RefreshCacheInput # data as a hash: # # { # file_share_arn: "FileShareARN", # required # folder_list: ["Folder"], # recursive: false, # } # # @!attribute [rw] file_share_arn # The Amazon Resource Name (ARN) of the file share you want to # refresh. # @return [String] # # @!attribute [rw] folder_list # A comma-separated list of the paths of folders to refresh in the # cache. The default is \[`"/"`\]. The default refreshes objects and # folders at the root of the Amazon S3 bucket. If `Recursive` is set # to "true", the entire S3 bucket that the file share has access to # is refreshed. # @return [Array] # # @!attribute [rw] recursive # A value that specifies whether to recursively refresh folders in the # cache. The refresh includes folders that were in the cache the last # time the gateway listed the folder's contents. If this value set to # "true", each folder that is listed in `FolderList` is recursively # updated. Otherwise, subfolders listed in `FolderList` are not # refreshed. Only objects that are in folders listed directly under # `FolderList` are found and used for the update. The default is # "true". # @return [Boolean] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/RefreshCacheInput AWS API Documentation # class RefreshCacheInput < Struct.new( :file_share_arn, :folder_list, :recursive) include Aws::Structure end # RefreshCacheOutput # # @!attribute [rw] file_share_arn # The Amazon Resource Name (ARN) of the file share. # @return [String] # # @!attribute [rw] notification_id # The randomly generated ID of the notification that was sent. This ID # is in UUID format. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/RefreshCacheOutput AWS API Documentation # class RefreshCacheOutput < Struct.new( :file_share_arn, :notification_id) include Aws::Structure end # RemoveTagsFromResourceInput # # @note When making an API call, you may pass RemoveTagsFromResourceInput # data as a hash: # # { # resource_arn: "ResourceARN", # required # tag_keys: ["TagKey"], # required # } # # @!attribute [rw] resource_arn # The Amazon Resource Name (ARN) of the resource you want to remove # the tags from. # @return [String] # # @!attribute [rw] tag_keys # The keys of the tags you want to remove from the specified resource. # A tag is composed of a key/value pair. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/RemoveTagsFromResourceInput AWS API Documentation # class RemoveTagsFromResourceInput < Struct.new( :resource_arn, :tag_keys) include Aws::Structure end # RemoveTagsFromResourceOutput # # @!attribute [rw] resource_arn # The Amazon Resource Name (ARN) of the resource that the tags were # removed from. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/RemoveTagsFromResourceOutput AWS API Documentation # class RemoveTagsFromResourceOutput < Struct.new( :resource_arn) include Aws::Structure end # @note When making an API call, you may pass ResetCacheInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/ResetCacheInput AWS API Documentation # class ResetCacheInput < Struct.new( :gateway_arn) include Aws::Structure end # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/ResetCacheOutput AWS API Documentation # class ResetCacheOutput < Struct.new( :gateway_arn) include Aws::Structure end # RetrieveTapeArchiveInput # # @note When making an API call, you may pass RetrieveTapeArchiveInput # data as a hash: # # { # tape_arn: "TapeARN", # required # gateway_arn: "GatewayARN", # required # } # # @!attribute [rw] tape_arn # The Amazon Resource Name (ARN) of the virtual tape you want to # retrieve from the virtual tape shelf (VTS). # @return [String] # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway you want to retrieve # the virtual tape to. Use the ListGateways operation to return a list # of gateways for your account and region. # # You retrieve archived virtual tapes to only one gateway and the # gateway must be a tape gateway. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/RetrieveTapeArchiveInput AWS API Documentation # class RetrieveTapeArchiveInput < Struct.new( :tape_arn, :gateway_arn) include Aws::Structure end # RetrieveTapeArchiveOutput # # @!attribute [rw] tape_arn # The Amazon Resource Name (ARN) of the retrieved virtual tape. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/RetrieveTapeArchiveOutput AWS API Documentation # class RetrieveTapeArchiveOutput < Struct.new( :tape_arn) include Aws::Structure end # RetrieveTapeRecoveryPointInput # # @note When making an API call, you may pass RetrieveTapeRecoveryPointInput # data as a hash: # # { # tape_arn: "TapeARN", # required # gateway_arn: "GatewayARN", # required # } # # @!attribute [rw] tape_arn # The Amazon Resource Name (ARN) of the virtual tape for which you # want to retrieve the recovery point. # @return [String] # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/RetrieveTapeRecoveryPointInput AWS API Documentation # class RetrieveTapeRecoveryPointInput < Struct.new( :tape_arn, :gateway_arn) include Aws::Structure end # RetrieveTapeRecoveryPointOutput # # @!attribute [rw] tape_arn # The Amazon Resource Name (ARN) of the virtual tape for which the # recovery point was retrieved. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/RetrieveTapeRecoveryPointOutput AWS API Documentation # class RetrieveTapeRecoveryPointOutput < Struct.new( :tape_arn) include Aws::Structure end # The Windows file permissions and ownership information assigned, by # default, to native S3 objects when file gateway discovers them in S3 # buckets. This operation is only supported for file gateways. # # @!attribute [rw] file_share_arn # The Amazon Resource Name (ARN) of the file share. # @return [String] # # @!attribute [rw] file_share_id # The ID of the file share. # @return [String] # # @!attribute [rw] file_share_status # The status of the file share. Possible values are `CREATING`, # `UPDATING`, `AVAILABLE` and `DELETING`. # @return [String] # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] kms_encrypted # True to use Amazon S3 server-side encryption with your own AWS KMS # key, or false to use a key managed by Amazon S3. Optional. # @return [Boolean] # # @!attribute [rw] kms_key # The Amazon Resource Name (ARN) of the AWS KMS key used for Amazon S3 # server side encryption. This value can only be set when KMSEncrypted # is true. Optional. # @return [String] # # @!attribute [rw] path # The file share path used by the SMB client to identify the mount # point. # @return [String] # # @!attribute [rw] role # The ARN of the IAM role that file gateway assumes when it accesses # the underlying storage. # @return [String] # # @!attribute [rw] location_arn # The ARN of the backend storage used for storing file data. # @return [String] # # @!attribute [rw] default_storage_class # The default storage class for objects put into an Amazon S3 bucket # by the file gateway. Possible values are `S3_STANDARD`, # `S3_STANDARD_IA`, or `S3_ONEZONE_IA`. If this field is not # populated, the default value `S3_STANDARD` is used. Optional. # @return [String] # # @!attribute [rw] object_acl # A value that sets the access control list permission for objects in # the S3 bucket that a file gateway puts objects into. The default # value is "private". # @return [String] # # @!attribute [rw] read_only # A value that sets the write status of a file share. This value is # true if the write status is read-only, and otherwise false. # @return [Boolean] # # @!attribute [rw] guess_mime_type_enabled # A value that enables guessing of the MIME type for uploaded objects # based on file extensions. Set this value to true to enable MIME type # guessing, and otherwise to false. The default value is true. # @return [Boolean] # # @!attribute [rw] requester_pays # A value that sets who pays the cost of the request and the cost # associated with data download from the S3 bucket. If this value is # set to true, the requester pays the costs. Otherwise the S3 bucket # owner pays. However, the S3 bucket owner always pays the cost of # storing data. # # `RequesterPays` is a configuration for the S3 bucket that backs the # file share, so make sure that the configuration on the file share is # the same as the S3 bucket configuration. # # # @return [Boolean] # # @!attribute [rw] smbacl_enabled # If this value is set to "true", indicates that ACL (access control # list) is enabled on the SMB file share. If it is set to "false", # it indicates that file and directory permissions are mapped to the # POSIX permission. # # For more information, see # https://docs.aws.amazon.com/storagegateway/latest/userguide/smb-acl.html # in the Storage Gateway User Guide. # @return [Boolean] # # @!attribute [rw] admin_user_list # A list of users or groups in the Active Directory that have # administrator rights to the file share. A group must be prefixed # with the @ character. For example `@group1`. Can only be set if # Authentication is set to `ActiveDirectory`. # @return [Array] # # @!attribute [rw] valid_user_list # A list of users or groups in the Active Directory that are allowed # to access the file share. A group must be prefixed with the @ # character. For example `@group1`. Can only be set if Authentication # is set to `ActiveDirectory`. # @return [Array] # # @!attribute [rw] invalid_user_list # A list of users or groups in the Active Directory that are not # allowed to access the file share. A group must be prefixed with the # @ character. For example `@group1`. Can only be set if # Authentication is set to `ActiveDirectory`. # @return [Array] # # @!attribute [rw] authentication # The authentication method of the file share. # # Valid values are `ActiveDirectory` or `GuestAccess`. The default is # `ActiveDirectory`. # @return [String] # # @!attribute [rw] tags # A list of up to 50 tags assigned to the SMB file share, sorted # alphabetically by key name. Each tag is a key-value pair. For a # gateway with more than 10 tags assigned, you can view all tags using # the `ListTagsForResource` API operation. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/SMBFileShareInfo AWS API Documentation # class SMBFileShareInfo < Struct.new( :file_share_arn, :file_share_id, :file_share_status, :gateway_arn, :kms_encrypted, :kms_key, :path, :role, :location_arn, :default_storage_class, :object_acl, :read_only, :guess_mime_type_enabled, :requester_pays, :smbacl_enabled, :admin_user_list, :valid_user_list, :invalid_user_list, :authentication, :tags) include Aws::Structure end # SetLocalConsolePasswordInput # # @note When making an API call, you may pass SetLocalConsolePasswordInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # local_console_password: "LocalConsolePassword", # required # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] local_console_password # The password you want to set for your VM local console. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/SetLocalConsolePasswordInput AWS API Documentation # class SetLocalConsolePasswordInput < Struct.new( :gateway_arn, :local_console_password) include Aws::Structure end # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/SetLocalConsolePasswordOutput AWS API Documentation # class SetLocalConsolePasswordOutput < Struct.new( :gateway_arn) include Aws::Structure end # SetSMBGuestPasswordInput # # @note When making an API call, you may pass SetSMBGuestPasswordInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # password: "SMBGuestPassword", # required # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the file gateway the SMB file # share is associated with. # @return [String] # # @!attribute [rw] password # The password that you want to set for your SMB Server. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/SetSMBGuestPasswordInput AWS API Documentation # class SetSMBGuestPasswordInput < Struct.new( :gateway_arn, :password) include Aws::Structure end # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/SetSMBGuestPasswordOutput AWS API Documentation # class SetSMBGuestPasswordOutput < Struct.new( :gateway_arn) include Aws::Structure end # A JSON object containing the of the gateway to shut down. # # @note When making an API call, you may pass ShutdownGatewayInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/ShutdownGatewayInput AWS API Documentation # class ShutdownGatewayInput < Struct.new( :gateway_arn) include Aws::Structure end # A JSON object containing the of the gateway that was shut down. # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/ShutdownGatewayOutput AWS API Documentation # class ShutdownGatewayOutput < Struct.new( :gateway_arn) include Aws::Structure end # A JSON object containing the of the gateway to start. # # @note When making an API call, you may pass StartGatewayInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/StartGatewayInput AWS API Documentation # class StartGatewayInput < Struct.new( :gateway_arn) include Aws::Structure end # A JSON object containing the of the gateway that was restarted. # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/StartGatewayOutput AWS API Documentation # class StartGatewayOutput < Struct.new( :gateway_arn) include Aws::Structure end # Provides additional information about an error that was returned by # the service as an or. See the `errorCode` and `errorDetails` members # for more information about the error. # # @!attribute [rw] error_code # Additional information about the error. # @return [String] # # @!attribute [rw] error_details # Human-readable text that provides detail about the error that # occurred. # @return [Hash] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/StorageGatewayError AWS API Documentation # class StorageGatewayError < Struct.new( :error_code, :error_details) include Aws::Structure end # Describes an iSCSI stored volume. # # @!attribute [rw] volume_arn # The Amazon Resource Name (ARN) of the storage volume. # @return [String] # # @!attribute [rw] volume_id # The unique identifier of the volume, e.g. vol-AE4B946D. # @return [String] # # @!attribute [rw] volume_type # One of the VolumeType enumeration values describing the type of the # volume. # @return [String] # # @!attribute [rw] volume_status # One of the VolumeStatus values that indicates the state of the # storage volume. # @return [String] # # @!attribute [rw] volume_attachment_status # A value that indicates whether a storage volume is attached to, # detached from, or is in the process of detaching from a gateway. For # more information, see [Moving Your Volumes to a Different # Gateway][1]. # # # # [1]: https://docs.aws.amazon.com/storagegateway/latest/userguide/managing-volumes.html#attach-detach-volume # @return [String] # # @!attribute [rw] volume_size_in_bytes # The size of the volume in bytes. # @return [Integer] # # @!attribute [rw] volume_progress # Represents the percentage complete if the volume is restoring or # bootstrapping that represents the percent of data transferred. This # field does not appear in the response if the stored volume is not # restoring or bootstrapping. # @return [Float] # # @!attribute [rw] volume_disk_id # The ID of the local disk that was specified in the # CreateStorediSCSIVolume operation. # @return [String] # # @!attribute [rw] source_snapshot_id # If the stored volume was created from a snapshot, this field # contains the snapshot ID used, e.g. snap-78e22663. Otherwise, this # field is not included. # @return [String] # # @!attribute [rw] preserved_existing_data # Indicates if when the stored volume was created, existing data on # the underlying local disk was preserved. # # Valid Values: true, false # @return [Boolean] # # @!attribute [rw] volume_iscsi_attributes # An VolumeiSCSIAttributes object that represents a collection of # iSCSI attributes for one stored volume. # @return [Types::VolumeiSCSIAttributes] # # @!attribute [rw] created_date # The date the volume was created. Volumes created prior to March 28, # 2017 don’t have this time stamp. # @return [Time] # # @!attribute [rw] volume_used_in_bytes # The size of the data stored on the volume in bytes. This value is # calculated based on the number of blocks that are touched, instead # of the actual amount of data written. This value can be useful for # sequential write patterns but less accurate for random write # patterns. `VolumeUsedInBytes` is different from the compressed size # of the volume, which is the value that is used to calculate your # bill. # # This value is not available for volumes created prior to May 13, # 2015, until you store data on the volume. # # # @return [Integer] # # @!attribute [rw] kms_key # The Amazon Resource Name (ARN) of the AWS KMS key used for Amazon S3 # server side encryption. This value can only be set when KMSEncrypted # is true. Optional. # @return [String] # # @!attribute [rw] target_name # The name of the iSCSI target used by an initiator to connect to a # volume and used as a suffix for the target ARN. For example, # specifying `TargetName` as *myvolume* results in the target ARN of # `arn:aws:storagegateway:us-east-2:111122223333:gateway/sgw-12A3456B/target/iqn.1997-05.com.amazon:myvolume`. # The target name must be unique across all volumes on a gateway. # # If you don't specify a value, Storage Gateway uses the value that # was previously used for this volume as the new target name. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/StorediSCSIVolume AWS API Documentation # class StorediSCSIVolume < Struct.new( :volume_arn, :volume_id, :volume_type, :volume_status, :volume_attachment_status, :volume_size_in_bytes, :volume_progress, :volume_disk_id, :source_snapshot_id, :preserved_existing_data, :volume_iscsi_attributes, :created_date, :volume_used_in_bytes, :kms_key, :target_name) include Aws::Structure end # A key-value pair that helps you manage, filter, and search for your # resource. Allowed characters: letters, white space, and numbers, # representable in UTF-8, and the following characters: + - = . \_ : / # # @note When making an API call, you may pass Tag # data as a hash: # # { # key: "TagKey", # required # value: "TagValue", # required # } # # @!attribute [rw] key # Tag key (String). The key can't start with aws:. # @return [String] # # @!attribute [rw] value # Value of the tag key. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/Tag AWS API Documentation # class Tag < Struct.new( :key, :value) include Aws::Structure end # Describes a virtual tape object. # # @!attribute [rw] tape_arn # The Amazon Resource Name (ARN) of the virtual tape. # @return [String] # # @!attribute [rw] tape_barcode # The barcode that identifies a specific virtual tape. # @return [String] # # @!attribute [rw] tape_created_date # The date the virtual tape was created. # @return [Time] # # @!attribute [rw] tape_size_in_bytes # The size, in bytes, of the virtual tape capacity. # @return [Integer] # # @!attribute [rw] tape_status # The current state of the virtual tape. # @return [String] # # @!attribute [rw] vtl_device # The virtual tape library (VTL) device that the virtual tape is # associated with. # @return [String] # # @!attribute [rw] progress # For archiving virtual tapes, indicates how much data remains to be # uploaded before archiving is complete. # # Range: 0 (not started) to 100 (complete). # @return [Float] # # @!attribute [rw] tape_used_in_bytes # The size, in bytes, of data stored on the virtual tape. # # This value is not available for tapes created prior to May 13, 2015. # # # @return [Integer] # # @!attribute [rw] kms_key # The Amazon Resource Name (ARN) of the AWS KMS key used for Amazon S3 # server side encryption. This value can only be set when KMSEncrypted # is true. Optional. # @return [String] # # @!attribute [rw] pool_id # The ID of the pool that contains tapes that will be archived. The # tapes in this pool are archived in the S3 storage class that is # associated with the pool. When you use your backup application to # eject the tape, the tape is archived directly into the storage class # (Glacier or Deep Archive) that corresponds to the pool. # # Valid values: "GLACIER", "DEEP\_ARCHIVE" # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/Tape AWS API Documentation # class Tape < Struct.new( :tape_arn, :tape_barcode, :tape_created_date, :tape_size_in_bytes, :tape_status, :vtl_device, :progress, :tape_used_in_bytes, :kms_key, :pool_id) include Aws::Structure end # Represents a virtual tape that is archived in the virtual tape shelf # (VTS). # # @!attribute [rw] tape_arn # The Amazon Resource Name (ARN) of an archived virtual tape. # @return [String] # # @!attribute [rw] tape_barcode # The barcode that identifies the archived virtual tape. # @return [String] # # @!attribute [rw] tape_created_date # The date the virtual tape was created. # @return [Time] # # @!attribute [rw] tape_size_in_bytes # The size, in bytes, of the archived virtual tape. # @return [Integer] # # @!attribute [rw] completion_time # The time that the archiving of the virtual tape was completed. # # The default time stamp format is in the ISO8601 extended # YYYY-MM-DD'T'HH:MM:SS'Z' format. # @return [Time] # # @!attribute [rw] retrieved_to # The Amazon Resource Name (ARN) of the tape gateway that the virtual # tape is being retrieved to. # # The virtual tape is retrieved from the virtual tape shelf (VTS). # @return [String] # # @!attribute [rw] tape_status # The current state of the archived virtual tape. # @return [String] # # @!attribute [rw] tape_used_in_bytes # The size, in bytes, of data stored on the virtual tape. # # This value is not available for tapes created prior to May 13, 2015. # # # @return [Integer] # # @!attribute [rw] kms_key # The Amazon Resource Name (ARN) of the AWS KMS key used for Amazon S3 # server side encryption. This value can only be set when KMSEncrypted # is true. Optional. # @return [String] # # @!attribute [rw] pool_id # The ID of the pool that was used to archive the tape. The tapes in # this pool are archived in the S3 storage class that is associated # with the pool. # # Valid values: "GLACIER", "DEEP\_ARCHIVE" # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/TapeArchive AWS API Documentation # class TapeArchive < Struct.new( :tape_arn, :tape_barcode, :tape_created_date, :tape_size_in_bytes, :completion_time, :retrieved_to, :tape_status, :tape_used_in_bytes, :kms_key, :pool_id) include Aws::Structure end # Describes a virtual tape. # # @!attribute [rw] tape_arn # The Amazon Resource Name (ARN) of a virtual tape. # @return [String] # # @!attribute [rw] tape_barcode # The barcode that identifies a specific virtual tape. # @return [String] # # @!attribute [rw] tape_size_in_bytes # The size, in bytes, of a virtual tape. # @return [Integer] # # @!attribute [rw] tape_status # The status of the tape. # @return [String] # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] pool_id # The ID of the pool that you want to add your tape to for archiving. # The tape in this pool is archived in the S3 storage class that is # associated with the pool. When you use your backup application to # eject the tape, the tape is archived directly into the storage class # (Glacier or Deep Archive) that corresponds to the pool. # # Valid values: "GLACIER", "DEEP\_ARCHIVE" # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/TapeInfo AWS API Documentation # class TapeInfo < Struct.new( :tape_arn, :tape_barcode, :tape_size_in_bytes, :tape_status, :gateway_arn, :pool_id) include Aws::Structure end # Describes a recovery point. # # @!attribute [rw] tape_arn # The Amazon Resource Name (ARN) of the virtual tape. # @return [String] # # @!attribute [rw] tape_recovery_point_time # The time when the point-in-time view of the virtual tape was # replicated for later recovery. # # The default time stamp format of the tape recovery point time is in # the ISO8601 extended YYYY-MM-DD'T'HH:MM:SS'Z' format. # @return [Time] # # @!attribute [rw] tape_size_in_bytes # The size, in bytes, of the virtual tapes to recover. # @return [Integer] # # @!attribute [rw] tape_status # The status of the virtual tapes. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/TapeRecoveryPointInfo AWS API Documentation # class TapeRecoveryPointInfo < Struct.new( :tape_arn, :tape_recovery_point_time, :tape_size_in_bytes, :tape_status) include Aws::Structure end # A JSON object containing one or more of the following fields: # # * UpdateBandwidthRateLimitInput$AverageDownloadRateLimitInBitsPerSec # # * UpdateBandwidthRateLimitInput$AverageUploadRateLimitInBitsPerSec # # @note When making an API call, you may pass UpdateBandwidthRateLimitInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # average_upload_rate_limit_in_bits_per_sec: 1, # average_download_rate_limit_in_bits_per_sec: 1, # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] average_upload_rate_limit_in_bits_per_sec # The average upload bandwidth rate limit in bits per second. # @return [Integer] # # @!attribute [rw] average_download_rate_limit_in_bits_per_sec # The average download bandwidth rate limit in bits per second. # @return [Integer] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/UpdateBandwidthRateLimitInput AWS API Documentation # class UpdateBandwidthRateLimitInput < Struct.new( :gateway_arn, :average_upload_rate_limit_in_bits_per_sec, :average_download_rate_limit_in_bits_per_sec) include Aws::Structure end # A JSON object containing the of the gateway whose throttle information # was updated. # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/UpdateBandwidthRateLimitOutput AWS API Documentation # class UpdateBandwidthRateLimitOutput < Struct.new( :gateway_arn) include Aws::Structure end # A JSON object containing one or more of the following fields: # # * UpdateChapCredentialsInput$InitiatorName # # * UpdateChapCredentialsInput$SecretToAuthenticateInitiator # # * UpdateChapCredentialsInput$SecretToAuthenticateTarget # # * UpdateChapCredentialsInput$TargetARN # # @note When making an API call, you may pass UpdateChapCredentialsInput # data as a hash: # # { # target_arn: "TargetARN", # required # secret_to_authenticate_initiator: "ChapSecret", # required # initiator_name: "IqnName", # required # secret_to_authenticate_target: "ChapSecret", # } # # @!attribute [rw] target_arn # The Amazon Resource Name (ARN) of the iSCSI volume target. Use the # DescribeStorediSCSIVolumes operation to return the TargetARN for # specified VolumeARN. # @return [String] # # @!attribute [rw] secret_to_authenticate_initiator # The secret key that the initiator (for example, the Windows client) # must provide to participate in mutual CHAP with the target. # # The secret key must be between 12 and 16 bytes when encoded in # UTF-8. # # # @return [String] # # @!attribute [rw] initiator_name # The iSCSI initiator that connects to the target. # @return [String] # # @!attribute [rw] secret_to_authenticate_target # The secret key that the target must provide to participate in mutual # CHAP with the initiator (e.g. Windows client). # # Byte constraints: Minimum bytes of 12. Maximum bytes of 16. # # The secret key must be between 12 and 16 bytes when encoded in # UTF-8. # # # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/UpdateChapCredentialsInput AWS API Documentation # class UpdateChapCredentialsInput < Struct.new( :target_arn, :secret_to_authenticate_initiator, :initiator_name, :secret_to_authenticate_target) include Aws::Structure end # A JSON object containing the following fields: # # @!attribute [rw] target_arn # The Amazon Resource Name (ARN) of the target. This is the same # target specified in the request. # @return [String] # # @!attribute [rw] initiator_name # The iSCSI initiator that connects to the target. This is the same # initiator name specified in the request. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/UpdateChapCredentialsOutput AWS API Documentation # class UpdateChapCredentialsOutput < Struct.new( :target_arn, :initiator_name) include Aws::Structure end # @note When making an API call, you may pass UpdateGatewayInformationInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # gateway_name: "GatewayName", # gateway_timezone: "GatewayTimezone", # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] gateway_name # The name you configured for your gateway. # @return [String] # # @!attribute [rw] gateway_timezone # A value that indicates the time zone of the gateway. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/UpdateGatewayInformationInput AWS API Documentation # class UpdateGatewayInformationInput < Struct.new( :gateway_arn, :gateway_name, :gateway_timezone) include Aws::Structure end # A JSON object containing the ARN of the gateway that was updated. # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] gateway_name # The name you configured for your gateway. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/UpdateGatewayInformationOutput AWS API Documentation # class UpdateGatewayInformationOutput < Struct.new( :gateway_arn, :gateway_name) include Aws::Structure end # A JSON object containing the of the gateway to update. # # @note When making an API call, you may pass UpdateGatewaySoftwareNowInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/UpdateGatewaySoftwareNowInput AWS API Documentation # class UpdateGatewaySoftwareNowInput < Struct.new( :gateway_arn) include Aws::Structure end # A JSON object containing the of the gateway that was updated. # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/UpdateGatewaySoftwareNowOutput AWS API Documentation # class UpdateGatewaySoftwareNowOutput < Struct.new( :gateway_arn) include Aws::Structure end # A JSON object containing the following fields: # # * UpdateMaintenanceStartTimeInput$DayOfMonth # # * UpdateMaintenanceStartTimeInput$DayOfWeek # # * UpdateMaintenanceStartTimeInput$HourOfDay # # * UpdateMaintenanceStartTimeInput$MinuteOfHour # # @note When making an API call, you may pass UpdateMaintenanceStartTimeInput # data as a hash: # # { # gateway_arn: "GatewayARN", # required # hour_of_day: 1, # required # minute_of_hour: 1, # required # day_of_week: 1, # day_of_month: 1, # } # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] hour_of_day # The hour component of the maintenance start time represented as # *hh*, where *hh* is the hour (00 to 23). The hour of the day is in # the time zone of the gateway. # @return [Integer] # # @!attribute [rw] minute_of_hour # The minute component of the maintenance start time represented as # *mm*, where *mm* is the minute (00 to 59). The minute of the hour is # in the time zone of the gateway. # @return [Integer] # # @!attribute [rw] day_of_week # The day of the week component of the maintenance start time week # represented as an ordinal number from 0 to 6, where 0 represents # Sunday and 6 Saturday. # @return [Integer] # # @!attribute [rw] day_of_month # The day of the month component of the maintenance start time # represented as an ordinal number from 1 to 28, where 1 represents # the first day of the month and 28 represents the last day of the # month. # # This value is only available for tape and volume gateways. # # # @return [Integer] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/UpdateMaintenanceStartTimeInput AWS API Documentation # class UpdateMaintenanceStartTimeInput < Struct.new( :gateway_arn, :hour_of_day, :minute_of_hour, :day_of_week, :day_of_month) include Aws::Structure end # A JSON object containing the of the gateway whose maintenance start # time is updated. # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/UpdateMaintenanceStartTimeOutput AWS API Documentation # class UpdateMaintenanceStartTimeOutput < Struct.new( :gateway_arn) include Aws::Structure end # UpdateNFSFileShareInput # # @note When making an API call, you may pass UpdateNFSFileShareInput # data as a hash: # # { # file_share_arn: "FileShareARN", # required # kms_encrypted: false, # kms_key: "KMSKey", # nfs_file_share_defaults: { # file_mode: "PermissionMode", # directory_mode: "PermissionMode", # group_id: 1, # owner_id: 1, # }, # default_storage_class: "StorageClass", # object_acl: "private", # accepts private, public-read, public-read-write, authenticated-read, bucket-owner-read, bucket-owner-full-control, aws-exec-read # client_list: ["IPV4AddressCIDR"], # squash: "Squash", # read_only: false, # guess_mime_type_enabled: false, # requester_pays: false, # } # # @!attribute [rw] file_share_arn # The Amazon Resource Name (ARN) of the file share to be updated. # @return [String] # # @!attribute [rw] kms_encrypted # True to use Amazon S3 server side encryption with your own AWS KMS # key, or false to use a key managed by Amazon S3. Optional. # @return [Boolean] # # @!attribute [rw] kms_key # The Amazon Resource Name (ARN) of the AWS KMS key used for Amazon S3 # server side encryption. This value can only be set when KMSEncrypted # is true. Optional. # @return [String] # # @!attribute [rw] nfs_file_share_defaults # The default values for the file share. Optional. # @return [Types::NFSFileShareDefaults] # # @!attribute [rw] default_storage_class # The default storage class for objects put into an Amazon S3 bucket # by the file gateway. Possible values are `S3_STANDARD`, # `S3_STANDARD_IA`, or `S3_ONEZONE_IA`. If this field is not # populated, the default value `S3_STANDARD` is used. Optional. # @return [String] # # @!attribute [rw] object_acl # A value that sets the access control list permission for objects in # the S3 bucket that a file gateway puts objects into. The default # value is "private". # @return [String] # # @!attribute [rw] client_list # The list of clients that are allowed to access the file gateway. The # list must contain either valid IP addresses or valid CIDR blocks. # @return [Array] # # @!attribute [rw] squash # The user mapped to anonymous user. Valid options are the following: # # * `RootSquash` - Only root is mapped to anonymous user. # # * `NoSquash` - No one is mapped to anonymous user # # * `AllSquash` - Everyone is mapped to anonymous user. # @return [String] # # @!attribute [rw] read_only # A value that sets the write status of a file share. This value is # true if the write status is read-only, and otherwise false. # @return [Boolean] # # @!attribute [rw] guess_mime_type_enabled # A value that enables guessing of the MIME type for uploaded objects # based on file extensions. Set this value to true to enable MIME type # guessing, and otherwise to false. The default value is true. # @return [Boolean] # # @!attribute [rw] requester_pays # A value that sets who pays the cost of the request and the cost # associated with data download from the S3 bucket. If this value is # set to true, the requester pays the costs. Otherwise the S3 bucket # owner pays. However, the S3 bucket owner always pays the cost of # storing data. # # `RequesterPays` is a configuration for the S3 bucket that backs the # file share, so make sure that the configuration on the file share is # the same as the S3 bucket configuration. # # # @return [Boolean] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/UpdateNFSFileShareInput AWS API Documentation # class UpdateNFSFileShareInput < Struct.new( :file_share_arn, :kms_encrypted, :kms_key, :nfs_file_share_defaults, :default_storage_class, :object_acl, :client_list, :squash, :read_only, :guess_mime_type_enabled, :requester_pays) include Aws::Structure end # UpdateNFSFileShareOutput # # @!attribute [rw] file_share_arn # The Amazon Resource Name (ARN) of the updated file share. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/UpdateNFSFileShareOutput AWS API Documentation # class UpdateNFSFileShareOutput < Struct.new( :file_share_arn) include Aws::Structure end # UpdateSMBFileShareInput # # @note When making an API call, you may pass UpdateSMBFileShareInput # data as a hash: # # { # file_share_arn: "FileShareARN", # required # kms_encrypted: false, # kms_key: "KMSKey", # default_storage_class: "StorageClass", # object_acl: "private", # accepts private, public-read, public-read-write, authenticated-read, bucket-owner-read, bucket-owner-full-control, aws-exec-read # read_only: false, # guess_mime_type_enabled: false, # requester_pays: false, # smbacl_enabled: false, # admin_user_list: ["FileShareUser"], # valid_user_list: ["FileShareUser"], # invalid_user_list: ["FileShareUser"], # } # # @!attribute [rw] file_share_arn # The Amazon Resource Name (ARN) of the SMB file share that you want # to update. # @return [String] # # @!attribute [rw] kms_encrypted # True to use Amazon S3 server side encryption with your own AWS KMS # key, or false to use a key managed by Amazon S3. Optional. # @return [Boolean] # # @!attribute [rw] kms_key # The Amazon Resource Name (ARN) of the AWS KMS key used for Amazon S3 # server side encryption. This value can only be set when KMSEncrypted # is true. Optional. # @return [String] # # @!attribute [rw] default_storage_class # The default storage class for objects put into an Amazon S3 bucket # by the file gateway. Possible values are `S3_STANDARD`, # `S3_STANDARD_IA`, or `S3_ONEZONE_IA`. If this field is not # populated, the default value `S3_STANDARD` is used. Optional. # @return [String] # # @!attribute [rw] object_acl # A value that sets the access control list permission for objects in # the S3 bucket that a file gateway puts objects into. The default # value is "private". # @return [String] # # @!attribute [rw] read_only # A value that sets the write status of a file share. This value is # true if the write status is read-only, and otherwise false. # @return [Boolean] # # @!attribute [rw] guess_mime_type_enabled # A value that enables guessing of the MIME type for uploaded objects # based on file extensions. Set this value to true to enable MIME type # guessing, and otherwise to false. The default value is true. # @return [Boolean] # # @!attribute [rw] requester_pays # A value that sets who pays the cost of the request and the cost # associated with data download from the S3 bucket. If this value is # set to true, the requester pays the costs. Otherwise the S3 bucket # owner pays. However, the S3 bucket owner always pays the cost of # storing data. # # `RequesterPays` is a configuration for the S3 bucket that backs the # file share, so make sure that the configuration on the file share is # the same as the S3 bucket configuration. # # # @return [Boolean] # # @!attribute [rw] smbacl_enabled # Set this value to "true to enable ACL (access control list) on the # SMB file share. Set it to "false" to map file and directory # permissions to the POSIX permissions. # # For more information, see # https://docs.aws.amazon.com/storagegateway/latest/userguide/smb-acl.htmlin # the Storage Gateway User Guide. # @return [Boolean] # # @!attribute [rw] admin_user_list # A list of users or groups in the Active Directory that have # administrator rights to the file share. A group must be prefixed # with the @ character. For example `@group1`. Can only be set if # Authentication is set to `ActiveDirectory`. # @return [Array] # # @!attribute [rw] valid_user_list # A list of users or groups in the Active Directory that are allowed # to access the file share. A group must be prefixed with the @ # character. For example `@group1`. Can only be set if Authentication # is set to `ActiveDirectory`. # @return [Array] # # @!attribute [rw] invalid_user_list # A list of users or groups in the Active Directory that are not # allowed to access the file share. A group must be prefixed with the # @ character. For example `@group1`. Can only be set if # Authentication is set to `ActiveDirectory`. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/UpdateSMBFileShareInput AWS API Documentation # class UpdateSMBFileShareInput < Struct.new( :file_share_arn, :kms_encrypted, :kms_key, :default_storage_class, :object_acl, :read_only, :guess_mime_type_enabled, :requester_pays, :smbacl_enabled, :admin_user_list, :valid_user_list, :invalid_user_list) include Aws::Structure end # UpdateSMBFileShareOutput # # @!attribute [rw] file_share_arn # The Amazon Resource Name (ARN) of the updated SMB file share. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/UpdateSMBFileShareOutput AWS API Documentation # class UpdateSMBFileShareOutput < Struct.new( :file_share_arn) include Aws::Structure end # A JSON object containing one or more of the following fields: # # * UpdateSnapshotScheduleInput$Description # # * UpdateSnapshotScheduleInput$RecurrenceInHours # # * UpdateSnapshotScheduleInput$StartAt # # * UpdateSnapshotScheduleInput$VolumeARN # # @note When making an API call, you may pass UpdateSnapshotScheduleInput # data as a hash: # # { # volume_arn: "VolumeARN", # required # start_at: 1, # required # recurrence_in_hours: 1, # required # description: "Description", # tags: [ # { # key: "TagKey", # required # value: "TagValue", # required # }, # ], # } # # @!attribute [rw] volume_arn # The Amazon Resource Name (ARN) of the volume. Use the ListVolumes # operation to return a list of gateway volumes. # @return [String] # # @!attribute [rw] start_at # The hour of the day at which the snapshot schedule begins # represented as *hh*, where *hh* is the hour (0 to 23). The hour of # the day is in the time zone of the gateway. # @return [Integer] # # @!attribute [rw] recurrence_in_hours # Frequency of snapshots. Specify the number of hours between # snapshots. # @return [Integer] # # @!attribute [rw] description # Optional description of the snapshot that overwrites the existing # description. # @return [String] # # @!attribute [rw] tags # A list of up to 50 tags that can be assigned to a snapshot. Each tag # is a key-value pair. # # Valid characters for key and value are letters, spaces, and numbers # representable in UTF-8 format, and the following special characters: # + - = . \_ : / @. The maximum length of a tag's key is 128 # characters, and the maximum length for a tag's value is 256. # # # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/UpdateSnapshotScheduleInput AWS API Documentation # class UpdateSnapshotScheduleInput < Struct.new( :volume_arn, :start_at, :recurrence_in_hours, :description, :tags) include Aws::Structure end # A JSON object containing the of the updated storage volume. # # @!attribute [rw] volume_arn # The Amazon Resource Name (ARN) of the volume. Use the ListVolumes # operation to return a list of gateway volumes. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/UpdateSnapshotScheduleOutput AWS API Documentation # class UpdateSnapshotScheduleOutput < Struct.new( :volume_arn) include Aws::Structure end # @note When making an API call, you may pass UpdateVTLDeviceTypeInput # data as a hash: # # { # vtl_device_arn: "VTLDeviceARN", # required # device_type: "DeviceType", # required # } # # @!attribute [rw] vtl_device_arn # The Amazon Resource Name (ARN) of the medium changer you want to # select. # @return [String] # # @!attribute [rw] device_type # The type of medium changer you want to select. # # Valid Values: "STK-L700", "AWS-Gateway-VTL" # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/UpdateVTLDeviceTypeInput AWS API Documentation # class UpdateVTLDeviceTypeInput < Struct.new( :vtl_device_arn, :device_type) include Aws::Structure end # UpdateVTLDeviceTypeOutput # # @!attribute [rw] vtl_device_arn # The Amazon Resource Name (ARN) of the medium changer you have # selected. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/UpdateVTLDeviceTypeOutput AWS API Documentation # class UpdateVTLDeviceTypeOutput < Struct.new( :vtl_device_arn) include Aws::Structure end # Represents a device object associated with a tape gateway. # # @!attribute [rw] vtl_device_arn # Specifies the unique Amazon Resource Name (ARN) of the device (tape # drive or media changer). # @return [String] # # @!attribute [rw] vtl_device_type # Specifies the type of device that the VTL device emulates. # @return [String] # # @!attribute [rw] vtl_device_vendor # Specifies the vendor of the device that the VTL device object # emulates. # @return [String] # # @!attribute [rw] vtl_device_product_identifier # Specifies the model number of device that the VTL device emulates. # @return [String] # # @!attribute [rw] device_iscsi_attributes # A list of iSCSI information about a VTL device. # @return [Types::DeviceiSCSIAttributes] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/VTLDevice AWS API Documentation # class VTLDevice < Struct.new( :vtl_device_arn, :vtl_device_type, :vtl_device_vendor, :vtl_device_product_identifier, :device_iscsi_attributes) include Aws::Structure end # Describes a storage volume object. # # @!attribute [rw] volume_arn # The Amazon Resource Name (ARN) for the storage volume. For example, # the following is a valid ARN: # # `arn:aws:storagegateway:us-east-2:111122223333:gateway/sgw-12A3456B/volume/vol-1122AABB` # # Valid Values: 50 to 500 lowercase letters, numbers, periods (.), and # hyphens (-). # @return [String] # # @!attribute [rw] volume_id # The unique identifier assigned to the volume. This ID becomes part # of the volume Amazon Resource Name (ARN), which you use as input for # other operations. # # Valid Values: 50 to 500 lowercase letters, numbers, periods (.), and # hyphens (-). # @return [String] # # @!attribute [rw] gateway_arn # The Amazon Resource Name (ARN) of the gateway. Use the ListGateways # operation to return a list of gateways for your account and region. # @return [String] # # @!attribute [rw] gateway_id # The unique identifier assigned to your gateway during activation. # This ID becomes part of the gateway Amazon Resource Name (ARN), # which you use as input for other operations. # # Valid Values: 50 to 500 lowercase letters, numbers, periods (.), and # hyphens (-). # @return [String] # # @!attribute [rw] volume_type # One of the VolumeType enumeration values describing the type of the # volume. # @return [String] # # @!attribute [rw] volume_size_in_bytes # The size of the volume in bytes. # # Valid Values: 50 to 500 lowercase letters, numbers, periods (.), and # hyphens (-). # @return [Integer] # # @!attribute [rw] volume_attachment_status # One of the VolumeStatus values that indicates the state of the # storage volume. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/VolumeInfo AWS API Documentation # class VolumeInfo < Struct.new( :volume_arn, :volume_id, :gateway_arn, :gateway_id, :volume_type, :volume_size_in_bytes, :volume_attachment_status) include Aws::Structure end # Describes a storage volume recovery point object. # # @!attribute [rw] volume_arn # The Amazon Resource Name (ARN) of the volume target. # @return [String] # # @!attribute [rw] volume_size_in_bytes # The size of the volume in bytes. # @return [Integer] # # @!attribute [rw] volume_usage_in_bytes # The size of the data stored on the volume in bytes. # # This value is not available for volumes created prior to May 13, # 2015, until you store data on the volume. # # # @return [Integer] # # @!attribute [rw] volume_recovery_point_time # The time the recovery point was taken. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/VolumeRecoveryPointInfo AWS API Documentation # class VolumeRecoveryPointInfo < Struct.new( :volume_arn, :volume_size_in_bytes, :volume_usage_in_bytes, :volume_recovery_point_time) include Aws::Structure end # Lists iSCSI information about a volume. # # @!attribute [rw] target_arn # The Amazon Resource Name (ARN) of the volume target. # @return [String] # # @!attribute [rw] network_interface_id # The network interface identifier. # @return [String] # # @!attribute [rw] network_interface_port # The port used to communicate with iSCSI targets. # @return [Integer] # # @!attribute [rw] lun_number # The logical disk number. # @return [Integer] # # @!attribute [rw] chap_enabled # Indicates whether mutual CHAP is enabled for the iSCSI target. # @return [Boolean] # # @see http://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/VolumeiSCSIAttributes AWS API Documentation # class VolumeiSCSIAttributes < Struct.new( :target_arn, :network_interface_id, :network_interface_port, :lun_number, :chap_enabled) include Aws::Structure end end end