AWS Storage Gateway User Guide
Working with Resource IDs
Resource
Type
ARN Format
Target ARN
( iSCSI target)
arn:aws:storagegateway:
region
:
account-id
:gateway/
gateway-id
/
target/
iSCSItarget
VTL Device
ARN
arn:aws:storagegateway:
region
:
account-id
:gateway/
gateway-id
/
device/
vtldevice
AWS Storage Gateway also supports the use of EC2 instances and EBS volumes and snapshots. These
resources are Amazon EC2 resources that are used in AWS Storage Gateway.
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. A volume ID takes the form
vol-3344CCDD
where
vol
is the resource identifier for volumes.
For virtual tapes, you can prepend a up to a four character prefix to the barcode ID to help you organize
your tapes.
AWS Storage Gateway resource IDs are in uppercase. However, when 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 volume might
be
vol-1122AABB
. When you use this ID with the EC2 API, you must change it to
vol-1122aabb
.
Otherwise, the EC2 API might not behave as expected.
Important
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
For example, a volume ARN with the longer volume ID format will look like this:
arn:aws:storagegateway:us-west-2:111122223333:gateway/sgw-12A3456B/
volume/vol-1122AABBCCDDEEFFG
.
A snapshot ID with the longer ID format will look like this:
snap-78e226633445566ee
.
For more information, see
Announcement: Heads-up – Longer AWS Storage Gateway volume
and snapshot IDs coming in 2016
Tagging Storage Gateway Resources
In AWS Storage Gateway, you can use tags to manage your resources. Tags let you add metadata to your
resources and categorize your resources to make them easier to manage. Each tag consists of a key-value
pair, which you define. You can add tags to gateways, volumes, and virtual tapes. You can search and
filter these resources based on the tags you add.
As an example, you can use tags to identify Storage Gateway resources used by each department in
your organization. You might tag gateways and volumes used by your accounting department like this:
(
key=department
and
value=accounting
). You can then filter with this tag to identify all gateways
and volumes used by your accounting department and use the information to determine cost. For more
information, see
and
API Version 2013-06-30
393