UpdateVTLDeviceTypeCommand

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.

Example Syntax

Use a bare-bones client and the command you need to make an API call.

import { StorageGatewayClient, UpdateVTLDeviceTypeCommand } from "@aws-sdk/client-storage-gateway"; // ES Modules import
// const { StorageGatewayClient, UpdateVTLDeviceTypeCommand } = require("@aws-sdk/client-storage-gateway"); // CommonJS import
const client = new StorageGatewayClient(config);
const input = { // UpdateVTLDeviceTypeInput
  VTLDeviceARN: "STRING_VALUE", // required
  DeviceType: "STRING_VALUE", // required
};
const command = new UpdateVTLDeviceTypeCommand(input);
const response = await client.send(command);
// { // UpdateVTLDeviceTypeOutput
//   VTLDeviceARN: "STRING_VALUE",
// };

Example Usage

 Loading code editor

UpdateVTLDeviceTypeCommand Input

See UpdateVTLDeviceTypeCommandInput for more details

Parameter
Type
Description
DeviceType
Required
string | undefined

The type of medium changer you want to select.

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

VTLDeviceARN
Required
string | undefined

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

UpdateVTLDeviceTypeCommand Output

Parameter
Type
Description
$metadata
Required
ResponseMetadata
Metadata pertaining to this request.
VTLDeviceARN
string | undefined

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

Throws

Name
Fault
Details
InternalServerError
server

An internal server error has occurred during the request. For more information, see the error and message fields.

InvalidGatewayRequestException
client

An exception occurred because an invalid gateway request was issued to the service. For more information, see the error and message fields.

StorageGatewayServiceException
Base exception class for all service exceptions from StorageGateway service.