Expand description
AWS Storage Gateway is the service that connects an on-premises software appliance with cloud-based storage to provide seamless and secure integration between an organization's on-premises IT environment and the AWS storage infrastructure. The service enables you to securely upload data to the AWS Cloud for cost effective backup and rapid disaster recovery.
Use the following links to get started using the AWS Storage Gateway Service API Reference:
-
AWS Storage Gateway required request headers: Describes the required headers that you must send with every POST request to AWS Storage Gateway.
-
Signing requests: AWS Storage Gateway requires that you authenticate every request you send; this topic describes how sign such a request.
-
Error responses: Provides reference information about AWS Storage Gateway errors.
-
Operations in AWS Storage Gateway: Contains detailed descriptions of all AWS Storage Gateway operations, their request parameters, response elements, possible errors, and examples of requests and responses.
-
AWS Storage Gateway endpoints and quotas: Provides a list of each AWS Region and the endpoints available for use with AWS Storage Gateway.
AWS Storage Gateway resource IDs are in uppercase. When you use these resource IDs with the Amazon EC2 API, EC2 expects resource IDs in lowercase. You must change your resource ID to lowercase to use it with the EC2 API. For example, in Storage Gateway the ID for a volume might be vol-AA22BB012345DAF670
. When you use this ID with the EC2 API, you must change it to vol-aa22bb012345daf670
. Otherwise, the EC2 API might not behave as expected.
IDs for Storage Gateway volumes and Amazon EBS snapshots created from gateway volumes are changing to a longer format. Starting in December 2016, all new volumes and snapshots will be created with a 17-character string. Starting in April 2016, you will be able to use these longer IDs so you can test your systems with the new format. For more information, see Longer EC2 and EBS resource IDs.
For example, a volume Amazon Resource Name (ARN) with the longer volume ID format looks like the following:
arn:aws:storagegateway:us-west-2:111122223333:gateway/sgw-12A3456B/volume/vol-1122AABBCCDDEEFFG
.
A snapshot ID with the longer ID format looks like the following: snap-78e226633445566ee
.
For more information, see Announcement: Heads-up – Longer AWS Storage Gateway volume and snapshot IDs coming in 2016.
If you’re using the service, you’re probably looking for StorageGatewayClient and StorageGateway.
Structs§
- Activate
Gateway Input A JSON object containing one or more of the following fields:
- Activate
Gateway Output 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 AWS 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.
- AddCache
Input - AddCache
Output - AddTags
ToResource Input AddTagsToResourceInput
- AddTags
ToResource Output AddTagsToResourceOutput
- AddUpload
Buffer Input - AddUpload
Buffer Output - AddWorking
Storage Input A JSON object containing one or more of the following fields:
- AddWorking
Storage Output A JSON object containing the Amazon Resource Name (ARN) of the gateway for which working storage was configured.
- Assign
Tape Pool Input - Assign
Tape Pool Output - Attach
Volume Input AttachVolumeInput
- Attach
Volume Output AttachVolumeOutput
- Automatic
Tape Creation Policy Info Information about the gateway's automatic tape creation policies, including the automatic tape creation rules and the gateway that is using the policies.
- Automatic
Tape Creation Rule An automatic tape creation policy consists of automatic tape creation rules where each rule defines when and how to create new tapes.
- Cache
Attributes Lists refresh cache information.
- CachediSCSI
Volume Describes an iSCSI cached volume.
- Cancel
Archival Input CancelArchivalInput
- Cancel
Archival Output CancelArchivalOutput
- Cancel
Retrieval Input CancelRetrievalInput
- Cancel
Retrieval Output CancelRetrievalOutput
- Chap
Info Describes Challenge-Handshake Authentication Protocol (CHAP) information that supports authentication between your gateway and iSCSI initiators.
- Create
CachediSCSI Volume Input - Create
CachediSCSI Volume Output - CreateNFS
File Share Input CreateNFSFileShareInput
- CreateNFS
File Share Output CreateNFSFileShareOutput
- CreateSMB
File Share Input CreateSMBFileShareInput
- CreateSMB
File Share Output CreateSMBFileShareOutput
- Create
Snapshot From Volume Recovery Point Input - Create
Snapshot From Volume Recovery Point Output - Create
Snapshot Input A JSON object containing one or more of the following fields:
- Create
Snapshot Output A JSON object containing the following fields:
- Create
StorediSCSI Volume Input A JSON object containing one or more of the following fields:
- Create
StorediSCSI Volume Output A JSON object containing the following fields:
- Create
Tape With Barcode Input CreateTapeWithBarcodeInput
- Create
Tape With Barcode Output CreateTapeOutput
- Create
Tapes Input CreateTapesInput
- Create
Tapes Output CreateTapeOutput
- Delete
Automatic Tape Creation Policy Input - Delete
Automatic Tape Creation Policy Output - Delete
Bandwidth Rate Limit Input A JSON object containing the following fields:
- Delete
Bandwidth Rate Limit Output A JSON object containing the Amazon Resource Name (ARN) of the gateway whose bandwidth rate information was deleted.
- Delete
Chap Credentials Input A JSON object containing one or more of the following fields:
- Delete
Chap Credentials Output A JSON object containing the following fields:
- Delete
File Share Input DeleteFileShareInput
- Delete
File Share Output DeleteFileShareOutput
- Delete
Gateway Input A JSON object containing the ID of the gateway to delete.
- Delete
Gateway Output A JSON object containing the ID of the deleted gateway.
- Delete
Snapshot Schedule Input - Delete
Snapshot Schedule Output - Delete
Tape Archive Input DeleteTapeArchiveInput
- Delete
Tape Archive Output DeleteTapeArchiveOutput
- Delete
Tape Input DeleteTapeInput
- Delete
Tape Output DeleteTapeOutput
- Delete
Volume Input A JSON object containing the DeleteVolumeInput$VolumeARN to delete.
- Delete
Volume Output A JSON object containing the Amazon Resource Name (ARN) of the storage volume that was deleted.
- Describe
Availability Monitor Test Input - Describe
Availability Monitor Test Output - Describe
Bandwidth Rate Limit Input A JSON object containing the Amazon Resource Name (ARN) of the gateway.
- Describe
Bandwidth Rate Limit Output A JSON object containing the following fields:
- Describe
Cache Input - Describe
Cache Output - Describe
CachediSCSI Volumes Input - Describe
CachediSCSI Volumes Output A JSON object containing the following fields:
- Describe
Chap Credentials Input A JSON object containing the Amazon Resource Name (ARN) of the iSCSI volume target.
- Describe
Chap Credentials Output A JSON object containing the following fields:
- Describe
Gateway Information Input A JSON object containing the ID of the gateway.
- Describe
Gateway Information Output A JSON object containing the following fields:
- Describe
Maintenance Start Time Input A JSON object containing the Amazon Resource Name (ARN) of the gateway.
- Describe
Maintenance Start Time Output A JSON object containing the following fields:
- DescribeNFS
File Shares Input DescribeNFSFileSharesInput
- DescribeNFS
File Shares Output DescribeNFSFileSharesOutput
- DescribeSMB
File Shares Input DescribeSMBFileSharesInput
- DescribeSMB
File Shares Output DescribeSMBFileSharesOutput
- DescribeSMB
Settings Input - DescribeSMB
Settings Output - Describe
Snapshot Schedule Input A JSON object containing the DescribeSnapshotScheduleInput$VolumeARN of the volume.
- Describe
Snapshot Schedule Output - Describe
StorediSCSI Volumes Input A JSON object containing a list of DescribeStorediSCSIVolumesInput$VolumeARNs.
- Describe
StorediSCSI Volumes Output - Describe
Tape Archives Input DescribeTapeArchivesInput
- Describe
Tape Archives Output DescribeTapeArchivesOutput
- Describe
Tape Recovery Points Input DescribeTapeRecoveryPointsInput
- Describe
Tape Recovery Points Output DescribeTapeRecoveryPointsOutput
- Describe
Tapes Input DescribeTapesInput
- Describe
Tapes Output DescribeTapesOutput
- Describe
Upload Buffer Input - Describe
Upload Buffer Output - DescribeVTL
Devices Input DescribeVTLDevicesInput
- DescribeVTL
Devices Output DescribeVTLDevicesOutput
- Describe
Working Storage Input A JSON object containing the Amazon Resource Name (ARN) of the gateway.
- Describe
Working Storage Output A JSON object containing the following fields:
- Detach
Volume Input AttachVolumeInput
- Detach
Volume Output AttachVolumeOutput
- DeviceiSCSI
Attributes Lists iSCSI information about a VTL device.
- Disable
Gateway Input DisableGatewayInput
- Disable
Gateway Output DisableGatewayOutput
- Disk
Represents a gateway's local disk.
- File
Share Info Describes a file share.
- Gateway
Info Describes a gateway object.
- Join
Domain Input JoinDomainInput
- Join
Domain Output JoinDomainOutput
- List
Automatic Tape Creation Policies Input - List
Automatic Tape Creation Policies Output - List
File Shares Input ListFileShareInput
- List
File Shares Output ListFileShareOutput
- List
Gateways Input A JSON object containing zero or more of the following fields:
- List
Gateways Output - List
Local Disks Input A JSON object containing the Amazon Resource Name (ARN) of the gateway.
- List
Local Disks Output - List
Tags ForResource Input ListTagsForResourceInput
- List
Tags ForResource Output ListTagsForResourceOutput
- List
Tapes Input A JSON object that contains one or more of the following fields:
- List
Tapes Output A JSON object containing the following fields:
- List
Volume Initiators Input ListVolumeInitiatorsInput
- List
Volume Initiators Output ListVolumeInitiatorsOutput
- List
Volume Recovery Points Input - List
Volume Recovery Points Output - List
Volumes Input A JSON object that contains one or more of the following fields:
- List
Volumes Output A JSON object containing the following fields:
- NFSFile
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.
- NFSFile
Share Info 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.
- Network
Interface Describes a gateway's network interface.
- Notify
When Uploaded Input - Notify
When Uploaded Output - Refresh
Cache Input RefreshCacheInput
- Refresh
Cache Output RefreshCacheOutput
- Remove
Tags From Resource Input RemoveTagsFromResourceInput
- Remove
Tags From Resource Output RemoveTagsFromResourceOutput
- Reset
Cache Input - Reset
Cache Output - Retrieve
Tape Archive Input RetrieveTapeArchiveInput
- Retrieve
Tape Archive Output RetrieveTapeArchiveOutput
- Retrieve
Tape Recovery Point Input RetrieveTapeRecoveryPointInput
- Retrieve
Tape Recovery Point Output RetrieveTapeRecoveryPointOutput
- SMBFile
Share Info 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.
- SetLocal
Console Password Input SetLocalConsolePasswordInput
- SetLocal
Console Password Output - SetSMB
Guest Password Input SetSMBGuestPasswordInput
- SetSMB
Guest Password Output - Shutdown
Gateway Input A JSON object containing the Amazon Resource Name (ARN) of the gateway to shut down.
- Shutdown
Gateway Output A JSON object containing the Amazon Resource Name (ARN) of the gateway that was shut down.
- Start
Availability Monitor Test Input - Start
Availability Monitor Test Output - Start
Gateway Input A JSON object containing the Amazon Resource Name (ARN) of the gateway to start.
- Start
Gateway Output A JSON object containing the Amazon Resource Name (ARN) of the gateway that was restarted.
- Storage
Gateway Client - A client for the AWS Storage Gateway API.
- Storage
Gateway Error Provides additional information about an error that was returned by the service. See the
errorCode
anderrorDetails
members for more information about the error.- StorediSCSI
Volume Describes an iSCSI stored volume.
- Tag
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: + - = . _ : /.
- Tape
Describes a virtual tape object.
- Tape
Archive Represents a virtual tape that is archived in the virtual tape shelf (VTS).
- Tape
Info Describes a virtual tape.
- Tape
Recovery Point Info Describes a recovery point.
- Update
Automatic Tape Creation Policy Input - Update
Automatic Tape Creation Policy Output - Update
Bandwidth Rate Limit Input A JSON object containing one or more of the following fields:
- Update
Bandwidth Rate Limit Output A JSON object containing the Amazon Resource Name (ARN) of the gateway whose throttle information was updated.
- Update
Chap Credentials Input A JSON object containing one or more of the following fields:
- Update
Chap Credentials Output A JSON object containing the following fields:
- Update
Gateway Information Input - Update
Gateway Information Output A JSON object containing the Amazon Resource Name (ARN) of the gateway that was updated.
- Update
Gateway Software NowInput A JSON object containing the Amazon Resource Name (ARN) of the gateway to update.
- Update
Gateway Software NowOutput A JSON object containing the Amazon Resource Name (ARN) of the gateway that was updated.
- Update
Maintenance Start Time Input A JSON object containing the following fields:
- Update
Maintenance Start Time Output A JSON object containing the Amazon Resource Name (ARN) of the gateway whose maintenance start time is updated.
- UpdateNFS
File Share Input UpdateNFSFileShareInput
- UpdateNFS
File Share Output UpdateNFSFileShareOutput
- UpdateSMB
File Share Input UpdateSMBFileShareInput
- UpdateSMB
File Share Output UpdateSMBFileShareOutput
- UpdateSMB
Security Strategy Input - UpdateSMB
Security Strategy Output - Update
Snapshot Schedule Input A JSON object containing one or more of the following fields:
- Update
Snapshot Schedule Output A JSON object containing the Amazon Resource Name (ARN) of the updated storage volume.
- UpdateVTL
Device Type Input - UpdateVTL
Device Type Output UpdateVTLDeviceTypeOutput
- VTLDevice
Represents a device object associated with a tape gateway.
- Volume
Info Describes a storage volume object.
- Volume
Recovery Point Info Describes a storage volume recovery point object.
- VolumeiSCSI
Attributes Lists iSCSI information about a volume.
Enums§
- Activate
Gateway Error - Errors returned by ActivateGateway
- AddCache
Error - Errors returned by AddCache
- AddTags
ToResource Error - Errors returned by AddTagsToResource
- AddUpload
Buffer Error - Errors returned by AddUploadBuffer
- AddWorking
Storage Error - Errors returned by AddWorkingStorage
- Assign
Tape Pool Error - Errors returned by AssignTapePool
- Attach
Volume Error - Errors returned by AttachVolume
- Cancel
Archival Error - Errors returned by CancelArchival
- Cancel
Retrieval Error - Errors returned by CancelRetrieval
- Create
CachediSCSI Volume Error - Errors returned by CreateCachediSCSIVolume
- CreateNFS
File Share Error - Errors returned by CreateNFSFileShare
- CreateSMB
File Share Error - Errors returned by CreateSMBFileShare
- Create
Snapshot Error - Errors returned by CreateSnapshot
- Create
Snapshot From Volume Recovery Point Error - Errors returned by CreateSnapshotFromVolumeRecoveryPoint
- Create
StorediSCSI Volume Error - Errors returned by CreateStorediSCSIVolume
- Create
Tape With Barcode Error - Errors returned by CreateTapeWithBarcode
- Create
Tapes Error - Errors returned by CreateTapes
- Delete
Automatic Tape Creation Policy Error - Errors returned by DeleteAutomaticTapeCreationPolicy
- Delete
Bandwidth Rate Limit Error - Errors returned by DeleteBandwidthRateLimit
- Delete
Chap Credentials Error - Errors returned by DeleteChapCredentials
- Delete
File Share Error - Errors returned by DeleteFileShare
- Delete
Gateway Error - Errors returned by DeleteGateway
- Delete
Snapshot Schedule Error - Errors returned by DeleteSnapshotSchedule
- Delete
Tape Archive Error - Errors returned by DeleteTapeArchive
- Delete
Tape Error - Errors returned by DeleteTape
- Delete
Volume Error - Errors returned by DeleteVolume
- Describe
Availability Monitor Test Error - Errors returned by DescribeAvailabilityMonitorTest
- Describe
Bandwidth Rate Limit Error - Errors returned by DescribeBandwidthRateLimit
- Describe
Cache Error - Errors returned by DescribeCache
- Describe
CachediSCSI Volumes Error - Errors returned by DescribeCachediSCSIVolumes
- Describe
Chap Credentials Error - Errors returned by DescribeChapCredentials
- Describe
Gateway Information Error - Errors returned by DescribeGatewayInformation
- Describe
Maintenance Start Time Error - Errors returned by DescribeMaintenanceStartTime
- DescribeNFS
File Shares Error - Errors returned by DescribeNFSFileShares
- DescribeSMB
File Shares Error - Errors returned by DescribeSMBFileShares
- DescribeSMB
Settings Error - Errors returned by DescribeSMBSettings
- Describe
Snapshot Schedule Error - Errors returned by DescribeSnapshotSchedule
- Describe
StorediSCSI Volumes Error - Errors returned by DescribeStorediSCSIVolumes
- Describe
Tape Archives Error - Errors returned by DescribeTapeArchives
- Describe
Tape Recovery Points Error - Errors returned by DescribeTapeRecoveryPoints
- Describe
Tapes Error - Errors returned by DescribeTapes
- Describe
Upload Buffer Error - Errors returned by DescribeUploadBuffer
- DescribeVTL
Devices Error - Errors returned by DescribeVTLDevices
- Describe
Working Storage Error - Errors returned by DescribeWorkingStorage
- Detach
Volume Error - Errors returned by DetachVolume
- Disable
Gateway Error - Errors returned by DisableGateway
- Join
Domain Error - Errors returned by JoinDomain
- List
Automatic Tape Creation Policies Error - Errors returned by ListAutomaticTapeCreationPolicies
- List
File Shares Error - Errors returned by ListFileShares
- List
Gateways Error - Errors returned by ListGateways
- List
Local Disks Error - Errors returned by ListLocalDisks
- List
Tags ForResource Error - Errors returned by ListTagsForResource
- List
Tapes Error - Errors returned by ListTapes
- List
Volume Initiators Error - Errors returned by ListVolumeInitiators
- List
Volume Recovery Points Error - Errors returned by ListVolumeRecoveryPoints
- List
Volumes Error - Errors returned by ListVolumes
- Notify
When Uploaded Error - Errors returned by NotifyWhenUploaded
- Refresh
Cache Error - Errors returned by RefreshCache
- Remove
Tags From Resource Error - Errors returned by RemoveTagsFromResource
- Reset
Cache Error - Errors returned by ResetCache
- Retrieve
Tape Archive Error - Errors returned by RetrieveTapeArchive
- Retrieve
Tape Recovery Point Error - Errors returned by RetrieveTapeRecoveryPoint
- SetLocal
Console Password Error - Errors returned by SetLocalConsolePassword
- SetSMB
Guest Password Error - Errors returned by SetSMBGuestPassword
- Shutdown
Gateway Error - Errors returned by ShutdownGateway
- Start
Availability Monitor Test Error - Errors returned by StartAvailabilityMonitorTest
- Start
Gateway Error - Errors returned by StartGateway
- Update
Automatic Tape Creation Policy Error - Errors returned by UpdateAutomaticTapeCreationPolicy
- Update
Bandwidth Rate Limit Error - Errors returned by UpdateBandwidthRateLimit
- Update
Chap Credentials Error - Errors returned by UpdateChapCredentials
- Update
Gateway Information Error - Errors returned by UpdateGatewayInformation
- Update
Gateway Software NowError - Errors returned by UpdateGatewaySoftwareNow
- Update
Maintenance Start Time Error - Errors returned by UpdateMaintenanceStartTime
- UpdateNFS
File Share Error - Errors returned by UpdateNFSFileShare
- UpdateSMB
File Share Error - Errors returned by UpdateSMBFileShare
- UpdateSMB
Security Strategy Error - Errors returned by UpdateSMBSecurityStrategy
- Update
Snapshot Schedule Error - Errors returned by UpdateSnapshotSchedule
- UpdateVTL
Device Type Error - Errors returned by UpdateVTLDeviceType
Traits§
- Storage
Gateway - Trait representing the capabilities of the AWS Storage Gateway API. AWS Storage Gateway clients implement this trait.