Usar etiquetas da AWS com a funcionalidade Concessões de Acesso do S3 - Amazon Simple Storage Service

Usar etiquetas da AWS com a funcionalidade Concessões de Acesso do S3

As etiquetas na funcionalidade Concessões de Acesso do Amazon S3 têm características semelhantes às etiquetas de objeto no Amazon S3. Cada tag é um par de chave/valor. Os recursos na funcionalidade Concessões de Acesso do S3 que você pode marcar são instâncias, locais e concessões da funcionalidade Concessões de Acesso do S3.

nota

A marcação na funcionalidade Concessões de Acesso do S3 usa operações de API diferentes da marcação de objetos. A funcionalidade Concessões de Acesso do S3 usa as operações de API TagResource, UntagResource e ListTagsForResource, em que um recurso pode ser uma instância, um local registrado ou uma concessão de acesso da funcionalidade Concessões de Acesso do S3.

Semelhante às etiquetas de objeto, as seguintes limitações se aplicam:

  • Você pode adicionar etiquetas a novos recursos da funcionalidade Concessões de Acesso do S3 ao criá-los, ou pode adicionar etiquetas a recursos existentes.

  • Você pode associar até 10 etiquetas a um recurso. Se várias etiquetas estiverem associadas ao mesmo recurso, elas deverão ter chaves de etiqueta exclusivas.

  • Um chave de tag pode ter até 128 caracteres Unicode e os valores de tag podem ter até 256 caracteres Unicode. As etiquetas são representadas internamente em UTF-16. Em UTF-16, os caracteres utilizam posições de um ou de dois caracteres.

  • As chaves e os valores diferenciam letras maiúsculas de minúsculas.

Para obter mais informações sobre restrições de etiquetas, consulte Restrições de tags definidas pelo usuário no Guia do usuário do AWS Billing.

Você pode marcar recursos na funcionalidade Concessões de Acesso do S3 usando a AWS Command Line Interface (AWS CLI), a API REST do Amazon S3 ou os AWS SDKs.

Para instalar a AWS CLI, consulte Instalar a AWS CLI no Guia do usuário da AWS Command Line Interface.

Você pode marcar um recurso da funcionalidade Concessões de Acesso do S3 durante a criação ou depois de criá-lo. Os exemplos a seguir mostram como marcar ou desmarcar uma instância da funcionalidade Concessões de Acesso do S3. Você pode realizar operações semelhantes para locais registrados e concessões de acesso.

Para usar os comandos a seguir, substitua os user input placeholders por suas próprias informações.

exemplo : criar uma instância da funcionalidade Concessões de Acesso do S3
aws s3control create-access-grants-instance \
 --account-id 111122223333 \
 --profile access-grants-profile \
 --region us-east-2 \
 --tags Key=tagKey1,Value=tagValue1

Resposta:

 {
    "CreatedAt": "2023-10-25T01:09:46.719000+00:00",
    "AccessGrantsInstanceId": "default",
    "AccessGrantsInstanceArn": "arn:aws:s3:us-east-2:111122223333:access-grants/default"
}
exemplo : marcar uma instância já criada da funcionalidade Concessões de Acesso do S3
aws s3control tag-resource \
--account-id 111122223333 \
--resource-arn "arn:aws:s3:us-east-2:111122223333:access-grants/default" \
--profile access-grants-profile \
--region us-east-2 \
--tags Key=tagKey2,Value=tagValue2
exemplo : listar as etiquetas da instância da funcionalidade Concessões de Acesso do S3
aws s3control list-tags-for-resource \
--account-id 111122223333 \
--resource-arn "arn:aws:s3:us-east-2:111122223333:access-grants/default" \
--profile access-grants-profile \
--region us-east-2

Resposta:

{
    "Tags": [
        {
            "Key": "tagKey1",
            "Value": "tagValue1"
        },
        {
            "Key": "tagKey2",
            "Value": "tagValue2"
        }
    ]
}
exemplo : desmarcar a instância da funcionalidade Concessões de Acesso do S3
aws s3control untag-resource \
 --account-id 111122223333 \
 --resource-arn "arn:aws:s3:us-east-2:111122223333:access-grants/default" \
 --profile access-grants-profile \
 --region us-east-2 \
 --tag-keys "tagKey2"

Você pode usar a API do Amazon S3 para marcar, desmarcar ou listar as etiquetas de uma instância, um local registrado ou uma concessão de acesso da funcionalidade Concessões de Acesso do S3. Para obter informações sobre o suporte à API REST para gerenciar a funcionalidade Concessões de Acesso do S3, consulte as seguintes seções na Referência da API do Amazon Simple Storage Service: