Uso de PutBucketTagging con un AWS SDK o la CLI

Los siguientes ejemplos de código muestran cómo utilizar PutBucketTagging.

CLI

AWS CLI

El siguiente comando aplica una configuración de etiquetado a un bucket denominado my-bucket:

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

El archivo tagging.json es un documento JSON en la carpeta actual que especifica etiquetas:

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

O aplique una configuración de etiquetado a my-bucket directamente desde la línea de comandos:

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

• Para obtener información sobre la API, consulte PutBucketTagging en la Referencia de comandos de la AWS CLI.

PowerShell

Herramientas para PowerShell

Ejemplo 1: este comando aplica dos etiquetas a un bucket denominado cloudtrail-test-2018, una etiqueta con una clave de Stage y un valor de Test, y una etiqueta con una clave de Environment y un valor de Alpha. Para comprobar que las etiquetas se han añadido al bucket, ejecute Get-S3BucketTagging -BucketName bucket_name. Los resultados deben mostrar las etiquetas que ha aplicado al bucket en el primer comando. Tenga en cuenta que Write-S3BucketTagging sobrescribe todo el conjunto de etiquetas existente en un bucket. Para añadir o eliminar etiquetas individuales, ejecute los cmdlets Resource Groups y Tagging API, Add-RGTResourceTag y Remove-RGTResourceTag. Como alternativa, puede utilizar el editor de etiquetas de la consola de administración de AWS para administrar las etiquetas del bucket de S3.

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

Ejemplo 2: este comando canaliza un bucket denominado cloudtrail-test-2018 al cmdlet de Write-S3BucketTagging. Aplica las etiquetas Stage:Production y Department:Finance al bucket. Tenga en cuenta que Write-S3BucketTagging sobrescribe todo el conjunto de etiquetas existente en un bucket.

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

• Para obtener información sobre la API, consulte PutBucketTagging en la Referencia de Cmdlet de AWS Tools for PowerShell.

Para obtener una lista completa de las guías para desarrolladores del AWS SDK y ejemplos de código, consulte Uso de este servicio con un SDK de AWS. En este tema también se incluye información sobre cómo comenzar a utilizar el SDK y detalles sobre sus versiones anteriores.