Usar PutBucketTagging com uma CLI

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

Exemplos de ações são trechos de código de programas maiores e devem ser executados em contexto. É possível ver essa ação em contexto no seguinte exemplo de código:

• Comece a usar o S3

CLI

AWS CLI

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

aws s3api put-bucket-tagging --bucket amzn-s3-demo-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 amzn-s3-demo-bucket diretamente da linha de comando:

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

• Para obter detalhes da API, consulte PutBucketTaggingna Referência de AWS CLI Comandos.

PowerShell

Ferramentas para PowerShell V4

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. Como alternativa, use o Editor de tags no console AWS de gerenciamento para gerenciar as tags de bucket do S3.

Write-S3BucketTagging -BucketName amzn-s3-demo-bucket -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 amzn-s3-demo-bucket | Write-S3BucketTagging -TagSet @( @{ Key="Stage"; Value="Production" }, @{ Key="Department"; Value="Finance" } )

• Para obter detalhes da API, consulte PutBucketTaggingem Referência de Ferramentas da AWS para PowerShell cmdlet (V4).

Ferramentas para PowerShell V5

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. Como alternativa, use o Editor de tags no console AWS de gerenciamento para gerenciar as tags de bucket do S3.

Write-S3BucketTagging -BucketName amzn-s3-demo-bucket -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 amzn-s3-demo-bucket | Write-S3BucketTagging -TagSet @( @{ Key="Stage"; Value="Production" }, @{ Key="Department"; Value="Finance" } )

• Para obter detalhes da API, consulte PutBucketTaggingem Referência de Ferramentas da AWS para PowerShell cmdlet (V5).