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
--taggingfile://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, ejecuteGet-S3BucketTagging -BucketName bucket_name
. Los resultados deben mostrar las etiquetas que ha aplicado al bucket en el primer comando. Tenga en cuenta queWrite-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
yRemove-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 deWrite-S3BucketTagging
. Aplica las etiquetas Stage:Production y Department:Finance al bucket. Tenga en cuenta queWrite-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.