StorageGateway / Client / update_vtl_device_type

update_vtl_device_type#

StorageGateway.Client.update_vtl_device_type(**kwargs)#

Updates the type of medium changer in a tape gateway. When you activate a tape gateway, you select a medium changer type for the tape gateway. This operation enables you to select a different type of medium changer after a tape gateway is activated. This operation is only supported in the tape gateway type.

See also: AWS API Documentation

Request Syntax

response = client.update_vtl_device_type(
    VTLDeviceARN='string',
    DeviceType='string'
)
Parameters:
  • VTLDeviceARN (string) –

    [REQUIRED]

    The Amazon Resource Name (ARN) of the medium changer you want to select.

  • DeviceType (string) –

    [REQUIRED]

    The type of medium changer you want to select.

    Valid Values: STK-L700 | AWS-Gateway-VTL | IBM-03584L32-0402

Return type:

dict

Returns:

Response Syntax

{
    'VTLDeviceARN': 'string'
}

Response Structure

  • (dict) –

    UpdateVTLDeviceTypeOutput

    • VTLDeviceARN (string) –

      The Amazon Resource Name (ARN) of the medium changer you have selected.

Exceptions

  • StorageGateway.Client.exceptions.InvalidGatewayRequestException

  • StorageGateway.Client.exceptions.InternalServerError

Examples

Updates the type of medium changer in a gateway-VTL after a gateway-VTL is activated.

response = client.update_vtl_device_type(
    DeviceType='Medium Changer',
    VTLDeviceARN='arn:aws:storagegateway:us-east-1:999999999999:gateway/sgw-12A3456B/device/AMZN_SGW-1FAD4876_MEDIACHANGER_00001',
)

print(response)

Expected Output:

{
    'VTLDeviceARN': 'arn:aws:storagegateway:us-east-1:999999999999:gateway/sgw-12A3456B/device/AMZN_SGW-1FAD4876_MEDIACHANGER_00001',
    'ResponseMetadata': {
        '...': '...',
    },
}