AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Container for the parameters to the CreateTapes operation. Creates one or more virtual tapes. You write data to the virtual tapes and then archive the tapes. This operation is only supported in the tape gateway type.

Cache storage must be allocated to the gateway before you can create virtual tapes. Use the AddCache operation to add cache storage to a gateway.

Inheritance Hierarchy


Namespace: Amazon.StorageGateway.Model
Assembly: AWSSDK.StorageGateway.dll
Version: 3.x.y.z


public class CreateTapesRequest : AmazonStorageGatewayRequest

The CreateTapesRequest type exposes the following members


Public Method CreateTapesRequest()


Public Property ClientToken System.String

Gets and sets the property ClientToken.

A unique identifier that you use to retry a request. If you retry a request, use the same ClientToken you specified in the initial request.

Using the same ClientToken prevents creating the tape multiple times.

Public Property GatewayARN System.String

Gets and sets the property GatewayARN.

The unique Amazon Resource Name (ARN) that represents the gateway to associate the virtual tapes with. Use the ListGateways operation to return a list of gateways for your account and region.

Public Property KMSEncrypted System.Boolean

Gets and sets the property KMSEncrypted.

True to use Amazon S3 server side encryption with your own AWS KMS key, or false to use a key managed by Amazon S3. Optional.

Public Property KMSKey System.String

Gets and sets the property KMSKey.

The Amazon Resource Name (ARN) of the AWS KMS key used for Amazon S3 server side encryption. This value can only be set when KMSEncrypted is true. Optional.

Public Property NumTapesToCreate System.Int32

Gets and sets the property NumTapesToCreate.

The number of virtual tapes that you want to create.

Public Property TapeBarcodePrefix System.String

Gets and sets the property TapeBarcodePrefix.

A prefix that you append to the barcode of the virtual tape you are creating. This prefix makes the barcode unique.

The prefix must be 1 to 4 characters in length and must be one of the uppercase letters from A to Z.

Public Property TapeSizeInBytes System.Int64

Gets and sets the property TapeSizeInBytes.

The size, in bytes, of the virtual tapes that you want to create.

The size must be aligned by gigabyte (1024*1024*1024 byte).


Creates one or more virtual tapes.

To create a virtual tape

var response = client.CreateTapes(new CreateTapesRequest 
    ClientToken = "77777",
    GatewayARN = "arn:aws:storagegateway:us-east-1:999999999999:gateway/sgw-12A3456B",
    NumTapesToCreate = 3,
    TapeBarcodePrefix = "TEST",
    TapeSizeInBytes = 107374182400

List tapeARNs = response.TapeARNs;


Version Information

.NET Standard:
Supported in: 1.3

.NET Framework:
Supported in: 4.5, 4.0, 3.5

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms