v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1490380385.5 KB

Disables a tape gateway when the gateway is no longer functioning. For example, if your gateway VM is damaged, you can disable the gateway so you can recover virtual tapes.

Use this operation for a tape gateway that is not reachable or not functioning. This operation is only supported in the tape gateway type.

After a gateway is disabled, it cannot be enabled.

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

Headers

X-Amz-Target'StorageGateway_20130630.DisableGateway' 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 unique Amazon Resource Name (ARN) of the disabled gateway.

Example response

{
  "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B"
}