purchase_provisioned_capacity

purchase_provisioned_capacity(**kwargs)

This operation purchases a provisioned capacity unit for an AWS account.

See also: AWS API Documentation

Request Syntax

response = client.purchase_provisioned_capacity(

)
Parameters
accountId (string) --

The AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single '-' (hyphen), in which case Amazon S3 Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, don't include any hyphens ('-') in the ID.

Note: this parameter is set to "-" bydefault if no value is not specified.
Return type
dict
Returns
Response Syntax
{
    'capacityId': 'string'
}

Response Structure

  • (dict) --
    • capacityId (string) --

      The ID that identifies the provisioned capacity unit.

Exceptions

  • Glacier.Client.exceptions.InvalidParameterValueException
  • Glacier.Client.exceptions.MissingParameterValueException
  • Glacier.Client.exceptions.LimitExceededException
  • Glacier.Client.exceptions.ServiceUnavailableException

Examples

The example purchases provisioned capacity unit for an AWS account.

response = client.purchase_provisioned_capacity(
    accountId='-',
)

print(response)

Expected Output:

{
    'capacityId': 'zSaq7NzHFQDANTfQkDen4V7z',
    'ResponseMetadata': {
        '...': '...',
    },
}