Usar PutBucketTagging com o AWS SDK ou a CLI

Os exemplos de código a seguir mostram como usar o PutBucketTagging.

CLI

AWS CLI

O seguinte comando aplica a configuração de marcação a um bucket denominado my-bucket:

aws s3api put-bucket-tagging --bucket my-bucket --tagging file://tagging.json

O arquivo tagging.json é um documento JSON na pasta atual que especifica duas tags:

{
   "TagSet": [
     {
       "Key": "organization",
       "Value": "marketing"
     }
   ]
}

Ou aplique uma configuração de marcação a my-bucket diretamente da linha de comando:

aws s3api put-bucket-tagging --bucket my-bucket --tagging 'TagSet=[{Key=organization,Value=marketing}]'

• Para obter detalhes da API, consulte PutBucketTagging na Referência de comandos da AWS CLI.

PowerShell

Tools for PowerShell

Exemplo 1: este comando aplica duas tags a um bucket denominado cloudtrail-test-2018 (uma tag com uma chave de Stage e um valor de Test e uma tag com uma chave de Environment e um valor de Alpha). Para verificar se as tags foram adicionadas ao bucket, execute Get-S3BucketTagging -BucketName bucket_name. Os resultados devem mostrar as tags que você aplicou ao bucket no primeiro comando. Observe que Write-S3BucketTagging substitui todo o conjunto de tags existente em um bucket. Para adicionar ou excluir tags individuais, execute os cmdlets da API de grupos de recursos e marcação: Add-RGTResourceTag e Remove-RGTResourceTag. Também e possível usar o editor de tags no Console de Gerenciamento da AWS para gerenciar as tags de bucket do S3.

Write-S3BucketTagging -BucketName cloudtrail-test-2018 -TagSet @( @{ Key="Stage"; Value="Test" }, @{ Key="Environment"; Value="Alpha" } )

Exemplo 2: este comando envia um bucket denominado cloudtrail-test-2018 para o cmdlet Write-S3BucketTagging. Ele aplica as tags Stage:Production e Department:Finance ao bucket. Observe que Write-S3BucketTagging substitui todo o conjunto de tags existente em um bucket.

Get-S3Bucket -BucketName cloudtrail-test-2018 | Write-S3BucketTagging -TagSet @( @{ Key="Stage"; Value="Production" }, @{ Key="Department"; Value="Finance" } )

• Para obter detalhes da API, consulte PutBucketTagging na AWS Tools for PowerShell Cmdlet Reference.

Para ver uma lista completa dos Guias do desenvolvedor de SDK da AWS e exemplos de código, consulte Usar este serviço com um AWS SDK. Este tópico também inclui informações sobre como começar e detalhes sobre versões anteriores do SDK.