View a markdown version of this page

Esempi di API di etichettatura per gruppi di risorse utilizzando AWS CLI - AWS Command Line Interface
Azioni

Questa documentazione è valida AWS CLI solo per la versione 1.

Abbiamo annunciato l'imminente fine del supporto per la AWS CLI versione 1. La AWS CLI versione 1 è ora in modalità manutenzione. Ti consigliamo di eseguire la migrazione alla AWS CLI versione 2. Per date, dettagli aggiuntivi e informazioni su come eseguire la migrazione, consulta l'annuncio. Per la documentazione relativa alla versione 2 del AWS CLI, consulta la Guida per l'utente della versione 2.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Esempi di API di etichettatura per gruppi di risorse utilizzando AWS CLI

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando l'API AWS Command Line Interface with Resource Groups Tagging.

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

L’esempio di codice seguente mostra come utilizzare get-resources.

AWS CLI

Come ottenere un elenco di risorse taggate

L’esempio get-resources seguente visualizza un elenco di risorse dell’account contrassegnate con il nome e il valore della chiave specificati.

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

Output:

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

Per ulteriori informazioni, consulta GetResources la sezione Resource Groups Tagging API Reference.

  • Per i dettagli sull'API, vedi GetResources in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-tag-keys.

AWS CLI

Come ottenere un elenco di tutte le chiavi di tag

L’esempio get-tag-keys seguente recupera l’elenco di tutti i nomi delle chiavi di tag utilizzati dalle risorse nell’account.

aws resourcegroupstaggingapi get-tag-keys

Output:

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

Per ulteriori informazioni, consulta la sezione Resource Groups GetTagKeys Tagging API Reference.

  • Per i dettagli sull'API, vedi GetTagKeys in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-tag-values.

AWS CLI

Come ottenere un elenco di tutti i valori dei tag

L’esempio get-tag-values seguente visualizza tutti i valori utilizzati per la chiave specificata per tutte le risorse nell’account.

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

Output:

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

Per ulteriori informazioni, consulta la sezione Resource Groups GetTagValues Tagging API Reference.

  • Per i dettagli sull'API, vedi GetTagValues in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare tag-resources.

AWS CLI

Come associare un tag a una risorsa

L’esempio tag-resources seguente contrassegna la risorsa specificata con un nome e un valore di chiave.

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

Output:

{
    "FailedResourcesMap": {}
}

Per ulteriori informazioni, consulta TagResources la sezione Resource Groups Tagging API Reference.

  • Per i dettagli sull'API, vedi TagResources in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare untag-resources.

AWS CLI

Come rimuovere un tag da una risorsa

L’esempio untag-resources seguente rimuove le chiavi di tag specificate e i relativi valori associati dalla risorsa specificata.

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

Output:

{
    "FailedResourcesMap": {}
}

Per ulteriori informazioni, consulta UntagResources la sezione Resource Groups Tagging API Reference.