v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1490380385.5 KB

Returns a list of the gateway's local disks. To specify which gateway to describe, you use the Amazon Resource Name (ARN) of the gateway in the body of the request.

The request returns a list of all disks, specifying which are configured as working storage, cache storage, or stored volume or not configured at all. The response includes a DiskStatus field. This field can have a value of present (the disk is available to use), missing (the disk is no longer connected to the gateway), or mismatch (the disk node is occupied by a disk that has incorrect metadata or the disk content is corrupted).

post/#X-Amz-Target=StorageGateway_20130630.ListLocalDisks

Headers

X-Amz-Target'StorageGateway_20130630.ListLocalDisks' required

Request body

GatewayARNstring required

The Amazon Resource Name (ARN) of the gateway. Use the <a>ListGateways</a> operation to return a list of gateways for your account and Amazon Web Services Region.

Response

Success

GatewayARNstring

The Amazon Resource Name (ARN) of the gateway. Use the <a>ListGateways</a> operation to return a list of gateways for your account and Amazon Web Services Region.

Example response

{
  "Disks": [
    {
      "DiskAllocationType": "CACHE_STORAGE",
      "DiskId": "pci-0000:03:00.0-scsi-0:0:0:0",
      "DiskNode": "SCSI(0:0)",
      "DiskPath": "/dev/sda",
      "DiskSizeInBytes": 1099511627776,
      "DiskStatus": "missing"
    },
    {
      "DiskAllocationResource": "",
      "DiskAllocationType": "UPLOAD_BUFFER",
      "DiskId": "pci-0000:03:00.0-scsi-0:0:1:0",
      "DiskNode": "SCSI(0:1)",
      "DiskPath": "/dev/sdb",
      "DiskSizeInBytes": 1099511627776,
      "DiskStatus": "present"
    }
  ],
  "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B"
}