Amazon Glacier

2015/06/24 - Amazon Glacier - 3 new api methods

ListTagsForVault (new) Link ¶

This operation lists all the tags attached to a vault. The operation returns an empty map if there are no tags. For more information about tags, see Tagging Amazon Glacier Resources.

Request Syntax

client.list_tags_for_vault(
    accountId='string',
    vaultName='string'
)
type accountId:

string

param accountId:

[REQUIRED]

The AccountId value is the AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single apos ``-``apos (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, do not include any hyphens (apos-apos) in the ID.

type vaultName:

string

param vaultName:

[REQUIRED]

The name of the vault.

rtype:

dict

returns:

Response Syntax

{
    'Tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) --

    Contains the Amazon Glacier response to your request.

    • Tags (dict) --

      The tags attached to the vault. Each tag is composed of a key and a value.

      • (string) --

        • (string) --

AddTagsToVault (new) Link ¶

This operation adds the specified tags to a vault. Each tag is composed of a key and a value. Each vault can have up to 10 tags. If your request would cause the tag limit for the vault to be exceeded, the operation throws the LimitExceededException error. If a tag already exists on the vault under a specified key, the existing key value will be overwritten. For more information about tags, see Tagging Amazon Glacier Resources.

Request Syntax

client.add_tags_to_vault(
    accountId='string',
    vaultName='string',
    Tags={
        'string': 'string'
    }
)
type accountId:

string

param accountId:

[REQUIRED]

The AccountId value is the AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single apos ``-``apos (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, do not include any hyphens (apos-apos) in the ID.

type vaultName:

string

param vaultName:

[REQUIRED]

The name of the vault.

type Tags:

dict

param Tags:

The tags to add to the vault. Each tag is composed of a key and a value. The value can be an empty string.

  • (string) --

    • (string) --

returns:

None

RemoveTagsFromVault (new) Link ¶

This operation removes one or more tags from the set of tags attached to a vault. For more information about tags, see Tagging Amazon Glacier Resources. This operation is idempotent. The operation will be successful, even if there are no tags attached to the vault.

Request Syntax

client.remove_tags_from_vault(
    accountId='string',
    vaultName='string',
    TagKeys=[
        'string',
    ]
)
type accountId:

string

param accountId:

[REQUIRED]

The AccountId value is the AWS account ID of the account that owns the vault. You can either specify an AWS account ID or optionally a single apos ``-``apos (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you use an account ID, do not include any hyphens (apos-apos) in the ID.

type vaultName:

string

param vaultName:

[REQUIRED]

The name of the vault.

type TagKeys:

list

param TagKeys:

A list of tag keys. Each corresponding tag is removed from the vault.

  • (string) --

returns:

None