CmdID / aws / aws storagegateway
aws storagegateway list-gateways
Lists gateways owned by an Amazon Web Services account in an Amazon Web Services Region specified in the request. AWS CLI reference
1 example 2 options Its page in the AWS CLI reference
Examples
To list gateways for an account
The following list-gateways example lists all the gateways defined for an account.
aws storagegateway list-gatewaysIdentifyThis command outputs a JSON block that contains a list of gateway Amazon Resource Names (ARNs).
Its output
{
"Gateways": [
{
"GatewayId": "sgw-12A3456B",
"GatewayARN": "arn:aws:storagegateway:us-west-2:123456789012:gateway/sgw-12A3456B",
"GatewayType": "STORED",
"GatewayOperationalState": "ACTIVE",
"GatewayName": "my-gateway",
"HostEnvironment": "VMWARE"
},
{
"GatewayId": "sgw-23B4567C",
"GatewayARN": "arn:aws:storagegateway:us-west-2:123456789012:gateway/sgw-23B4567C",
"GatewayType": "CACHED",
"GatewayOperationalState": "ACTIVE",
"GatewayName": "my-cached-gateway",
"HostEnvironment": "VMWARE"
}
]
}For more information, see Understanding Storage Gateway Resources and Resource IDs in the AWS Storage Gateway Volume Gateway User Guide.
Options
--limitSpecifies that the list of gateways returned be limited to the specified number of items.--markerAn opaque string that indicates the position at which to begin the returned list of gateways.