Sign in Dashboard Get started
  1. Registry
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. storagegateway
  6. Tape

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.81.0
published on Monday, Sep 28, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws-native

aws-native.storagegateway.Tape

aws-native logo aws-native logo

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.81.0
published on Monday, Sep 28, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws-native

    Creates a virtual tape with a user-defined barcode on a Tape Gateway (VTL). A virtual tape is stored in Amazon S3 and can be archived to S3 Glacier or S3 Glacier Deep Archive.

    Create Tape Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Tape(name: string, args: TapeArgs, opts?: CustomResourceOptions);
    @overload
def Tape(resource_name: str,
         args: TapeArgs,
         opts: Optional[ResourceOptions] = None)

@overload
def Tape(resource_name: str,
         opts: Optional[ResourceOptions] = None,
         gateway_arn: Optional[str] = None,
         tape_size_in_bytes: Optional[float] = None,
         kms_encrypted: Optional[bool] = None,
         kms_key: Optional[str] = None,
         pool_id: Optional[str] = None,
         tags: Optional[Sequence[_root_inputs.TagArgs]] = None,
         tape_barcode: Optional[str] = None,
         worm: Optional[bool] = None)
    func NewTape(ctx *Context, name string, args TapeArgs, opts ...ResourceOption) (*Tape, error)
    public Tape(string name, TapeArgs args, CustomResourceOptions? opts = null)
    public Tape(String name, TapeArgs args)
public Tape(String name, TapeArgs args, CustomResourceOptions options)

    type: aws-native:storagegateway:Tape
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.


    resource "aws-native_storagegateway_tape" "name" {
    # resource properties
}

    Parameters

    name string
    The unique name of the resource.
    args TapeArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args TapeArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args TapeArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args TapeArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args TapeArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Tape Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Tape resource accepts the following input properties:

    GatewayArn string
    The Amazon Resource Name (ARN) of the Tape Gateway that hosts the virtual tape.
    TapeSizeInBytes double
    The size, in bytes, of the virtual tape that you want to create.
    KmsEncrypted bool
    Set to true to use Amazon S3 server-side encryption with your own KMS key, or false to use a key managed by Amazon S3. Optional.
    KmsKey string
    The Amazon Resource Name (ARN) of a symmetric customer master key (CMK) used for Amazon S3 server-side encryption. This value must be set if KMSEncrypted is true.
    PoolId string
    The ID of the pool that you want to add your tape to for archiving. Tapes in this pool are archived in the S3 storage class that is associated with the pool.
    Tags List<Pulumi.AwsNative.Inputs.Tag>
    A list of up to 50 tags to assign to the virtual tape.
    TapeBarcode string
    The barcode that you want to assign to the virtual tape. Barcodes cannot be reused, even after a tape is deleted.
    Worm bool
    Set to true to create a write-once-read-many (WORM) virtual tape.
    GatewayArn string
    The Amazon Resource Name (ARN) of the Tape Gateway that hosts the virtual tape.
    TapeSizeInBytes float64
    The size, in bytes, of the virtual tape that you want to create.
    KmsEncrypted bool
    Set to true to use Amazon S3 server-side encryption with your own KMS key, or false to use a key managed by Amazon S3. Optional.
    KmsKey string
    The Amazon Resource Name (ARN) of a symmetric customer master key (CMK) used for Amazon S3 server-side encryption. This value must be set if KMSEncrypted is true.
    PoolId string
    The ID of the pool that you want to add your tape to for archiving. Tapes in this pool are archived in the S3 storage class that is associated with the pool.
    Tags TagArgs
    A list of up to 50 tags to assign to the virtual tape.
    TapeBarcode string
    The barcode that you want to assign to the virtual tape. Barcodes cannot be reused, even after a tape is deleted.
    Worm bool
    Set to true to create a write-once-read-many (WORM) virtual tape.
    gateway_arn string
    The Amazon Resource Name (ARN) of the Tape Gateway that hosts the virtual tape.
    tape_size_in_bytes number
    The size, in bytes, of the virtual tape that you want to create.
    kms_encrypted bool
    Set to true to use Amazon S3 server-side encryption with your own KMS key, or false to use a key managed by Amazon S3. Optional.
    kms_key string
    The Amazon Resource Name (ARN) of a symmetric customer master key (CMK) used for Amazon S3 server-side encryption. This value must be set if KMSEncrypted is true.
    pool_id string
    The ID of the pool that you want to add your tape to for archiving. Tapes in this pool are archived in the S3 storage class that is associated with the pool.
    tags list(object)
    A list of up to 50 tags to assign to the virtual tape.
    tape_barcode string
    The barcode that you want to assign to the virtual tape. Barcodes cannot be reused, even after a tape is deleted.
    worm bool
    Set to true to create a write-once-read-many (WORM) virtual tape.
    gatewayArn String
    The Amazon Resource Name (ARN) of the Tape Gateway that hosts the virtual tape.
    tapeSizeInBytes Double
    The size, in bytes, of the virtual tape that you want to create.
    kmsEncrypted Boolean
    Set to true to use Amazon S3 server-side encryption with your own KMS key, or false to use a key managed by Amazon S3. Optional.
    kmsKey String
    The Amazon Resource Name (ARN) of a symmetric customer master key (CMK) used for Amazon S3 server-side encryption. This value must be set if KMSEncrypted is true.
    poolId String
    The ID of the pool that you want to add your tape to for archiving. Tapes in this pool are archived in the S3 storage class that is associated with the pool.
    tags List<Tag>
    A list of up to 50 tags to assign to the virtual tape.
    tapeBarcode String
    The barcode that you want to assign to the virtual tape. Barcodes cannot be reused, even after a tape is deleted.
    worm Boolean
    Set to true to create a write-once-read-many (WORM) virtual tape.
    gatewayArn string
    The Amazon Resource Name (ARN) of the Tape Gateway that hosts the virtual tape.
    tapeSizeInBytes number
    The size, in bytes, of the virtual tape that you want to create.
    kmsEncrypted boolean
    Set to true to use Amazon S3 server-side encryption with your own KMS key, or false to use a key managed by Amazon S3. Optional.
    kmsKey string
    The Amazon Resource Name (ARN) of a symmetric customer master key (CMK) used for Amazon S3 server-side encryption. This value must be set if KMSEncrypted is true.
    poolId string
    The ID of the pool that you want to add your tape to for archiving. Tapes in this pool are archived in the S3 storage class that is associated with the pool.
    tags Tag[]
    A list of up to 50 tags to assign to the virtual tape.
    tapeBarcode string
    The barcode that you want to assign to the virtual tape. Barcodes cannot be reused, even after a tape is deleted.
    worm boolean
    Set to true to create a write-once-read-many (WORM) virtual tape.
    gateway_arn str
    The Amazon Resource Name (ARN) of the Tape Gateway that hosts the virtual tape.
    tape_size_in_bytes float
    The size, in bytes, of the virtual tape that you want to create.
    kms_encrypted bool
    Set to true to use Amazon S3 server-side encryption with your own KMS key, or false to use a key managed by Amazon S3. Optional.
    kms_key str
    The Amazon Resource Name (ARN) of a symmetric customer master key (CMK) used for Amazon S3 server-side encryption. This value must be set if KMSEncrypted is true.
    pool_id str
    The ID of the pool that you want to add your tape to for archiving. Tapes in this pool are archived in the S3 storage class that is associated with the pool.
    tags Sequence[TagArgs]
    A list of up to 50 tags to assign to the virtual tape.
    tape_barcode str
    The barcode that you want to assign to the virtual tape. Barcodes cannot be reused, even after a tape is deleted.
    worm bool
    Set to true to create a write-once-read-many (WORM) virtual tape.
    gatewayArn String
    The Amazon Resource Name (ARN) of the Tape Gateway that hosts the virtual tape.
    tapeSizeInBytes Number
    The size, in bytes, of the virtual tape that you want to create.
    kmsEncrypted Boolean
    Set to true to use Amazon S3 server-side encryption with your own KMS key, or false to use a key managed by Amazon S3. Optional.
    kmsKey String
    The Amazon Resource Name (ARN) of a symmetric customer master key (CMK) used for Amazon S3 server-side encryption. This value must be set if KMSEncrypted is true.
    poolId String
    The ID of the pool that you want to add your tape to for archiving. Tapes in this pool are archived in the S3 storage class that is associated with the pool.
    tags List<Property Map>
    A list of up to 50 tags to assign to the virtual tape.
    tapeBarcode String
    The barcode that you want to assign to the virtual tape. Barcodes cannot be reused, even after a tape is deleted.
    worm Boolean
    Set to true to create a write-once-read-many (WORM) virtual tape.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Tape resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    TapeArn string
    The Amazon Resource Name (ARN) of the virtual tape.
    TapeCreatedDate string
    The date and time that the virtual tape was created.
    TapeStatus string
    The current status of the virtual tape.
    TapeUsedInBytes double
    The size, in bytes, of data stored on the virtual tape.
    Id string
    The provider-assigned unique ID for this managed resource.
    TapeArn string
    The Amazon Resource Name (ARN) of the virtual tape.
    TapeCreatedDate string
    The date and time that the virtual tape was created.
    TapeStatus string
    The current status of the virtual tape.
    TapeUsedInBytes float64
    The size, in bytes, of data stored on the virtual tape.
    id string
    The provider-assigned unique ID for this managed resource.
    tape_arn string
    The Amazon Resource Name (ARN) of the virtual tape.
    tape_created_date string
    The date and time that the virtual tape was created.
    tape_status string
    The current status of the virtual tape.
    tape_used_in_bytes number
    The size, in bytes, of data stored on the virtual tape.
    id String
    The provider-assigned unique ID for this managed resource.
    tapeArn String
    The Amazon Resource Name (ARN) of the virtual tape.
    tapeCreatedDate String
    The date and time that the virtual tape was created.
    tapeStatus String
    The current status of the virtual tape.
    tapeUsedInBytes Double
    The size, in bytes, of data stored on the virtual tape.
    id string
    The provider-assigned unique ID for this managed resource.
    tapeArn string
    The Amazon Resource Name (ARN) of the virtual tape.
    tapeCreatedDate string
    The date and time that the virtual tape was created.
    tapeStatus string
    The current status of the virtual tape.
    tapeUsedInBytes number
    The size, in bytes, of data stored on the virtual tape.
    id str
    The provider-assigned unique ID for this managed resource.
    tape_arn str
    The Amazon Resource Name (ARN) of the virtual tape.
    tape_created_date str
    The date and time that the virtual tape was created.
    tape_status str
    The current status of the virtual tape.
    tape_used_in_bytes float
    The size, in bytes, of data stored on the virtual tape.
    id String
    The provider-assigned unique ID for this managed resource.
    tapeArn String
    The Amazon Resource Name (ARN) of the virtual tape.
    tapeCreatedDate String
    The date and time that the virtual tape was created.
    tapeStatus String
    The current status of the virtual tape.
    tapeUsedInBytes Number
    The size, in bytes, of data stored on the virtual tape.

    Supporting Types

    Tag, TagArgs

    A set of tags to apply to the resource.
    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo aws-native logo

    We recommend new projects start with resources from the AWS provider.

    Viewing docs for AWS Cloud Control v1.81.0
    published on Monday, Sep 28, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-aws-native

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial