StorageGateway / Client / attach_volume



Connects a volume to an iSCSI connection and then attaches the volume to the specified gateway. Detaching and attaching a volume enables you to recover your data from one gateway to a different gateway without creating a snapshot. It also makes it easier to move your volumes from an on-premises gateway to a gateway hosted on an Amazon EC2 instance.

See also: AWS API Documentation

Request Syntax

response = client.attach_volume(
  • GatewayARN (string) –


    The Amazon Resource Name (ARN) of the gateway that you want to attach the volume to.

  • TargetName (string) –

    The name of the iSCSI target used by an initiator to connect to a volume and used as a suffix for the target ARN. For example, specifying TargetName as myvolume results in the target ARN of arn:aws:storagegateway:us-east-2:111122223333:gateway/sgw-12A3456B/target/ The target name must be unique across all volumes on a gateway.

    If you don’t specify a value, Storage Gateway uses the value that was previously used for this volume as the new target name.

  • VolumeARN (string) –


    The Amazon Resource Name (ARN) of the volume to attach to the specified gateway.

  • NetworkInterfaceId (string) –


    The network interface of the gateway on which to expose the iSCSI target. Only IPv4 addresses are accepted. Use DescribeGatewayInformation to get a list of the network interfaces available on a gateway.

    Valid Values: A valid IP address.

  • DiskId (string) – The unique device ID or other distinguishing data that identifies the local disk used to create the volume. This value is only required when you are attaching a stored volume.

Return type:



Response Syntax

    'VolumeARN': 'string',
    'TargetARN': 'string'

Response Structure

  • (dict) –


    • VolumeARN (string) –

      The Amazon Resource Name (ARN) of the volume that was attached to the gateway.

    • TargetARN (string) –

      The Amazon Resource Name (ARN) of the volume target, which includes the iSCSI name for the initiator that was used to connect to the target.


  • StorageGateway.Client.exceptions.InvalidGatewayRequestException

  • StorageGateway.Client.exceptions.InternalServerError