Understanding Storage Gateway resources and resource IDs - AWS Storage Gateway
Working with Resource IDs

Understanding Storage Gateway resources and resource IDs

In Storage Gateway, the primary resource is a gateway but other resource types is file share. File shares are referred to as subresources and they don't exist unless they are associated with a gateway.

These resources and subresources have unique Amazon Resource Names (ARNs) associated with them as shown in this table.

Resource Type ARN Format

Gateway ARN

arn:aws:storagegateway:region:account-id:gateway/gateway-id
File Share ARN

arn:aws:storagegateway:region:account-id:share/share-id

Working with Resource IDs

When you create a resource, Storage Gateway assigns the resource a unique resource ID. This resource ID is part of the resource ARN. A resource ID takes the form of a resource identifier, followed by a hyphen, and a unique combination of eight letters and numbers. For example, a gateway ID is of the form sgw-12A3456B where sgw is the resource identifier for gateways.

Storage Gateway resource IDs are in uppercase. However, if you use these resource IDs with the Amazon EC2 API, Amazon 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 gateway might be sgw-12A3456B. If you use this ID with the EC2 API, you must change it to sgw-12a3456b. Otherwise, the EC2 API might not behave as expected.