Ejemplos de la API para Resource Groups Tagging que utilizan la AWS CLI

Para obtener una lista de recursos etiquetados

En el siguiente ejemplo de get-resources, se muestra una lista de los recursos de la cuenta que están etiquetados con el nombre y el valor clave especificados.

aws resourcegroupstaggingapi get-resources \
    --tag-filters Key=Environment,Values=Production \
    --tags-per-page 100

Salida:

{
    "ResourceTagMappingList": [
        {
            "ResourceARN": " arn:aws:inspector:us-west-2:123456789012:target/0-nvgVhaxX/template/0-7sbz2Kz0",
            "Tags": [
                {
                    "Key": "Environment",
                    "Value": "Production"
                }
            ]
        }
    ]
}

Para obtener más información, consulte GetResources en la Referencia de la API de Resource Groups Tagging.

Para obtener una lista de todas las claves de etiqueta

En el siguiente ejemplo de get-tag-keys se recupera la lista de todos los nombres de las claves de etiqueta que utilizan los recursos de la cuenta.

aws resourcegroupstaggingapi get-tag-keys

Salida:

{
    "TagKeys": [
        "Environment",
        "CostCenter",
        "Department"
    ]
}

Para obtener más información, consulte GetTagKeys en la Referencia de la API de Resource Groups Tagging.

Para obtener una lista de todos los valores de etiqueta

En el ejemplo siguiente de get-tag-values, se muestran todos los valores utilizados para la clave especificada de todos los recursos del

aws resourcegroupstaggingapi get-tag-values \
    --key=Environment

Salida:

{
    "TagValues": [
        "Alpha",
        "Gamma",
        "Production"
    ]
}

Para obtener más información, consulte GetTagValues en la Referencia de la API de Resource Groups Tagging.

Para asociar una etiqueta a un recurso

El siguiente ejemplo de tag-resources etiqueta el recurso especificado con un nombre y un valor clave.

aws resourcegroupstaggingapi tag-resources \
    --resource-arn-list arn:aws:s3:::MyProductionBucket \
    --tags Environment=Production,CostCenter=1234

Salida:

{
    "FailedResourcesMap": {}
}

Para obtener más información, consulte TagResources en la Referencia de la API de Resource Groups Tagging.

Para eliminar una etiqueta de un recurso

El siguiente ejemplo de untag-resources elimina las claves de etiqueta especificadas y cualquier valor asociado de un recurso especificado.

aws resourcegroupstaggingapi untag-resources \
    --resource-arn-list arn:aws:s3:::amzn-s3-demo-bucket \
    --tag-keys Environment CostCenter

Salida:

{
    "FailedResourcesMap": {}
}

Para obtener más información, consulte UntagResources en la Referencia de la API de Resource Groups Tagging.