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 architecture.

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

System.Object
  Amazon.Runtime.AmazonWebServiceRequest
    Amazon.StorageGateway.AmazonStorageGatewayRequest
      Amazon.StorageGateway.Model.CreateTapesRequest

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

Syntax

C#
public class CreateTapesRequest : AmazonStorageGatewayRequest
         IAmazonWebServiceRequest

The CreateTapesRequest type exposes the following members

Constructors

NameDescription
Public Method CreateTapesRequest()

Properties

NameTypeDescription
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 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).

Examples

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