Sono disponibili altri esempi AWS SDK nel repository [AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples) Examples. GitHub 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 codice per l'utilizzo dell'API Resource Groups Tagging AWS SDKs I seguenti esempi di codice mostrano come utilizzarlo AWS Resource Groups Tagging API con un kit di sviluppo AWS software (SDK). 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. **Altre risorse** + **[Guida per l’utente dell’API Tagging di Gruppi di risorse](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html)**: ulteriori informazioni sull’API Tagging di Gruppi di risorse. + **[Documentazione di riferimento dell’API Tagging di Gruppi di risorse](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/overview.html)**: dettagli su tutte le azioni disponibili per l’API Tagging dell’API Gruppi di risorse. + **[AWS Developer Center](https://aws.amazon.com/developer/code-examples/?awsf.sdk-code-examples-product=product%23)**: esempi di codice che puoi filtrare per categoria o per ricerca completa. + **[AWS Esempi SDK](https://github.com/awsdocs/aws-doc-sdk-examples)**: GitHub repository con codice completo nelle lingue preferite. Include le istruzioni su come configurare ed eseguire il codice. **Contents** + [Nozioni di base](resource-groups-tagging-api_code_examples_basics.md) + [Azioni](resource-groups-tagging-api_code_examples_actions.md) + [`GetResources`](resource-groups-tagging-api_example_resource-groups-tagging-api_GetResources_section.md) + [`GetTagKeys`](resource-groups-tagging-api_example_resource-groups-tagging-api_GetTagKeys_section.md) + [`GetTagValues`](resource-groups-tagging-api_example_resource-groups-tagging-api_GetTagValues_section.md) + [`TagResources`](resource-groups-tagging-api_example_resource-groups-tagging-api_TagResources_section.md) + [`UntagResources`](resource-groups-tagging-api_example_resource-groups-tagging-api_UntagResources_section.md) # Esempi di base per l'utilizzo dell'API Resource Groups Tagging AWS SDKs I seguenti esempi di codice mostrano come utilizzare le nozioni di base di with. AWS Resource Groups Tagging API AWS SDKs **Contents** + [Azioni](resource-groups-tagging-api_code_examples_actions.md) + [`GetResources`](resource-groups-tagging-api_example_resource-groups-tagging-api_GetResources_section.md) + [`GetTagKeys`](resource-groups-tagging-api_example_resource-groups-tagging-api_GetTagKeys_section.md) + [`GetTagValues`](resource-groups-tagging-api_example_resource-groups-tagging-api_GetTagValues_section.md) + [`TagResources`](resource-groups-tagging-api_example_resource-groups-tagging-api_TagResources_section.md) + [`UntagResources`](resource-groups-tagging-api_example_resource-groups-tagging-api_UntagResources_section.md) # Azioni per l'utilizzo dell'API Resource Groups Tagging AWS SDKs I seguenti esempi di codice mostrano come eseguire singole azioni dell'API Resource Groups Tagging con AWS SDKs. Ogni esempio include un collegamento a GitHub, dove è possibile trovare le istruzioni per la configurazione e l'esecuzione del codice. Gli esempi seguenti includono solo le azioni più comunemente utilizzate. Per un elenco completo, consulta la [documentazione di riferimento dell’API AWS Resource Groups Tagging API](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/overview.html). **Topics** + [`GetResources`](resource-groups-tagging-api_example_resource-groups-tagging-api_GetResources_section.md) + [`GetTagKeys`](resource-groups-tagging-api_example_resource-groups-tagging-api_GetTagKeys_section.md) + [`GetTagValues`](resource-groups-tagging-api_example_resource-groups-tagging-api_GetTagValues_section.md) + [`TagResources`](resource-groups-tagging-api_example_resource-groups-tagging-api_TagResources_section.md) + [`UntagResources`](resource-groups-tagging-api_example_resource-groups-tagging-api_UntagResources_section.md) # Utilizzare `GetResources` con una CLI Gli esempi di codice seguenti mostrano come utilizzare `GetResources`. ------ #### [ CLI ] **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](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_GetResources.html)il *Resource Groups Tagging API Reference.* + Per i dettagli sull'API, consulta [GetResources AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resourcegroupstaggingapi/get-resources.html)*Command Reference.* ------ #### [ PowerShell ] **Strumenti per PowerShell V4** **Esempio 1: restituisce tutte le risorse con tag in una Regione e le chiavi di tag associate alla risorsa. Se non viene specificato il parametro -Region, il cmdlet tenterà di ricavare la Regione dalla shell o dai metadati dell’istanza EC2.** ``` Get-RGTResource ``` **Output:** ``` ResourceARN Tags ----------- ---- arn:aws:dynamodb:us-west-2:123456789012:table/mytable {stage, version} arn:aws:s3:::amzn-s3-demo-bucket {stage, version, othertag} ``` **Esempio 2: restituisce tutte le risorse con tag del tipo specificato in una Regione. La stringa per ogni nome di servizio e tipo di risorsa è la stessa incorporata nel nome della risorsa Amazon (ARN) di una risorsa.** ``` Get-RGTResource -ResourceType "s3" ``` **Output:** ``` ResourceARN Tags ----------- ---- arn:aws:s3:::amzn-s3-demo-bucket {stage, version, othertag} ``` **Esempio 3: restituisce tutte le risorse con tag del tipo specificato in una Regione. Nota che quando i tipi di risorse vengono reindirizzati al cmdlet, viene effettuata una chiamata al servizio per ogni tipo di risorsa fornito.** ``` "dynamodb","s3" | Get-RGTResource ``` **Output:** ``` ResourceARN Tags ----------- ---- arn:aws:dynamodb:us-west-2:123456789012:table/mytable {stage, version} arn:aws:s3:::amzn-s3-demo-bucket {stage, version, othertag} ``` **Esempio 4: restituisce tutte le risorse con tag che corrispondono al filtro specificato.** ``` Get-RGTResource -TagFilter @{ Key="stage" } ``` **Output:** ``` ResourceARN Tags ----------- ---- arn:aws:s3:::amzn-s3-demo-bucket {stage, version, othertag} ``` **Esempio 5: restituisce tutte le risorse con tag che corrispondono al filtro e al tipo di risorsa specificati.** ``` Get-RGTResource -TagFilter @{ Key="stage" } -ResourceType "dynamodb" ``` **Output:** ``` ResourceARN Tags ----------- ---- arn:aws:dynamodb:us-west-2:123456789012:table/mytable {stage, version} ``` **Esempio 6: restituisce tutte le risorse con tag che corrispondono al filtro specificato.** ``` Get-RGTResource -TagFilter @{ Key="stage"; Values=@("beta","gamma") } ``` **Output:** ``` ResourceARN Tags ----------- ---- arn:aws:dynamodb:us-west-2:123456789012:table/mytable {stage, version} ``` + Per i dettagli sull'API, vedere [GetResources](https://docs.aws.amazon.com/powershell/v4/reference)in *AWS Strumenti per PowerShell Cmdlet Reference (*V4). **Strumenti per V5 PowerShell ** **Esempio 1: restituisce tutte le risorse con tag in una Regione e le chiavi di tag associate alla risorsa. Se non viene specificato il parametro -Region, il cmdlet tenterà di ricavare la Regione dalla shell o dai metadati dell’istanza EC2.** ``` Get-RGTResource ``` **Output:** ``` ResourceARN Tags ----------- ---- arn:aws:dynamodb:us-west-2:123456789012:table/mytable {stage, version} arn:aws:s3:::amzn-s3-demo-bucket {stage, version, othertag} ``` **Esempio 2: restituisce tutte le risorse con tag del tipo specificato in una Regione. La stringa per ogni nome di servizio e tipo di risorsa è la stessa incorporata nel nome della risorsa Amazon (ARN) di una risorsa.** ``` Get-RGTResource -ResourceType "s3" ``` **Output:** ``` ResourceARN Tags ----------- ---- arn:aws:s3:::amzn-s3-demo-bucket {stage, version, othertag} ``` **Esempio 3: restituisce tutte le risorse con tag del tipo specificato in una Regione. Nota che quando i tipi di risorse vengono reindirizzati al cmdlet, viene effettuata una chiamata al servizio per ogni tipo di risorsa fornito.** ``` "dynamodb","s3" | Get-RGTResource ``` **Output:** ``` ResourceARN Tags ----------- ---- arn:aws:dynamodb:us-west-2:123456789012:table/mytable {stage, version} arn:aws:s3:::amzn-s3-demo-bucket {stage, version, othertag} ``` **Esempio 4: restituisce tutte le risorse con tag che corrispondono al filtro specificato.** ``` Get-RGTResource -TagFilter @{ Key="stage" } ``` **Output:** ``` ResourceARN Tags ----------- ---- arn:aws:s3:::amzn-s3-demo-bucket {stage, version, othertag} ``` **Esempio 5: restituisce tutte le risorse con tag che corrispondono al filtro e al tipo di risorsa specificati.** ``` Get-RGTResource -TagFilter @{ Key="stage" } -ResourceType "dynamodb" ``` **Output:** ``` ResourceARN Tags ----------- ---- arn:aws:dynamodb:us-west-2:123456789012:table/mytable {stage, version} ``` **Esempio 6: restituisce tutte le risorse con tag che corrispondono al filtro specificato.** ``` Get-RGTResource -TagFilter @{ Key="stage"; Values=@("beta","gamma") } ``` **Output:** ``` ResourceARN Tags ----------- ---- arn:aws:dynamodb:us-west-2:123456789012:table/mytable {stage, version} ``` + Per i dettagli sull'API, vedere [GetResources](https://docs.aws.amazon.com/powershell/v5/reference)in *AWS Strumenti per PowerShell Cmdlet Reference (*V5). ------ # Utilizzare `GetTagKeys` con una CLI Gli esempi di codice seguenti mostrano come utilizzare `GetTagKeys`. ------ #### [ CLI ] **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 [GetTagKeys](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_GetTagKeys.html)il *Resource Groups Tagging API Reference.* + Per i dettagli sull'API, consulta [GetTagKeys AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resourcegroupstaggingapi/get-tag-keys.html)*Command Reference.* ------ #### [ PowerShell ] **Strumenti per PowerShell V4** **Esempio 1: restituisce tutte le chiavi di tag nella Regione specificata. Se non viene specificato il parametro -Region, il cmdlet tenterà di ricavare la Regione dalla Regione predefinita della shell o dai metadati dell’istanza EC2. Nota che le chiavi di tag non vengono restituite in base a un ordine specifico.** ``` Get-RGTTagKey -region us-west-2 ``` **Output:** ``` version stage ``` + Per i dettagli sull'API, vedere [GetTagKeys](https://docs.aws.amazon.com/powershell/v4/reference)in *AWS Strumenti per PowerShell Cmdlet Reference (*V4). **Strumenti per V5 PowerShell ** **Esempio 1: restituisce tutte le chiavi di tag nella Regione specificata. Se non viene specificato il parametro -Region, il cmdlet tenterà di ricavare la Regione dalla Regione predefinita della shell o dai metadati dell’istanza EC2. Nota che le chiavi di tag non vengono restituite in base a un ordine specifico.** ``` Get-RGTTagKey -region us-west-2 ``` **Output:** ``` version stage ``` + Per i dettagli sull'API, vedere [GetTagKeys](https://docs.aws.amazon.com/powershell/v5/reference)in *AWS Strumenti per PowerShell Cmdlet Reference (*V5). ------ # Utilizzare `GetTagValues` con una CLI Gli esempi di codice seguenti mostrano come utilizzare `GetTagValues`. ------ #### [ CLI ] **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 [GetTagValues](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_GetTagValues.html)il *Resource Groups Tagging API Reference.* + Per i dettagli sull'API, consulta [GetTagValues AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resourcegroupstaggingapi/get-tag-values.html)*Command Reference.* ------ #### [ PowerShell ] **Strumenti per PowerShell V4** **Esempio 1: restituisce il valore per il tag specificato in una Regione. Se non viene specificato il parametro -Region, il cmdlet tenterà di ricavare la Regione dalla Regione predefinita della shell o dai metadati dell’istanza EC2.** ``` Get-RGTTagValue -Key "stage" -Region us-west-2 ``` **Output:** ``` beta ``` + Per i dettagli sull'API, vedere [GetTagValues](https://docs.aws.amazon.com/powershell/v4/reference)in *AWS Strumenti per PowerShell Cmdlet Reference (*V4). **Strumenti per V5 PowerShell ** **Esempio 1: restituisce il valore per il tag specificato in una Regione. Se non viene specificato il parametro -Region, il cmdlet tenterà di ricavare la Regione dalla Regione predefinita della shell o dai metadati dell’istanza EC2.** ``` Get-RGTTagValue -Key "stage" -Region us-west-2 ``` **Output:** ``` beta ``` + Per i dettagli sull'API, vedere [GetTagValues](https://docs.aws.amazon.com/powershell/v5/reference)in *AWS Strumenti per PowerShell Cmdlet Reference (*V5). ------ # Utilizzare `TagResources` con una CLI Gli esempi di codice seguenti mostrano come utilizzare `TagResources`. ------ #### [ CLI ] **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](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_TagResources.html)il *Resource Groups Tagging API Reference.* + Per i dettagli sull'API, consulta [TagResources AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resourcegroupstaggingapi/tag-resources.html)*Command Reference.* ------ #### [ PowerShell ] **Strumenti per PowerShell V4** **Esempio 1: questo esempio aggiunge le chiavi di tag “stage” e “version” con i valori “beta” e “preprod\$1test” a un bucket Amazon S3 e una tabella Amazon DynamoDB. Viene effettuata una sola chiamata al servizio per applicare i tag.** ``` $arn1 = "arn:aws:s3:::amzn-s3-demo-bucket" $arn2 = "arn:aws:dynamodb:us-west-2:123456789012:table/mytable" Add-RGTResourceTag -ResourceARNList $arn1,$arn2 -Tag @{ "stage"="beta"; "version"="preprod_test" } ``` **Esempio 2: questo esempio aggiunge i tag e i valori specificati a un bucket Amazon S3 e a una tabella Amazon DynamoDB. Vengono effettuate due chiamate al servizio, una per ogni ARN di risorsa reindirizzato al cmdlet.** ``` $arn1 = "arn:aws:s3:::amzn-s3-demo-bucket" $arn2 = "arn:aws:dynamodb:us-west-2:123456789012:table/mytable" $arn1,$arn2 | Add-RGTResourceTag -Tag @{ "stage"="beta"; "version"="preprod_test" } ``` + Per i dettagli sull'API, vedere [TagResources](https://docs.aws.amazon.com/powershell/v4/reference)in *AWS Strumenti per PowerShell Cmdlet Reference (*V4). **Strumenti per V5 PowerShell ** **Esempio 1: questo esempio aggiunge le chiavi di tag “stage” e “version” con i valori “beta” e “preprod\$1test” a un bucket Amazon S3 e una tabella Amazon DynamoDB. Viene effettuata una sola chiamata al servizio per applicare i tag.** ``` $arn1 = "arn:aws:s3:::amzn-s3-demo-bucket" $arn2 = "arn:aws:dynamodb:us-west-2:123456789012:table/mytable" Add-RGTResourceTag -ResourceARNList $arn1,$arn2 -Tag @{ "stage"="beta"; "version"="preprod_test" } ``` **Esempio 2: questo esempio aggiunge i tag e i valori specificati a un bucket Amazon S3 e a una tabella Amazon DynamoDB. Vengono effettuate due chiamate al servizio, una per ogni ARN di risorsa reindirizzato al cmdlet.** ``` $arn1 = "arn:aws:s3:::amzn-s3-demo-bucket" $arn2 = "arn:aws:dynamodb:us-west-2:123456789012:table/mytable" $arn1,$arn2 | Add-RGTResourceTag -Tag @{ "stage"="beta"; "version"="preprod_test" } ``` + Per i dettagli sull'API, vedere [TagResources](https://docs.aws.amazon.com/powershell/v5/reference)in *AWS Strumenti per PowerShell Cmdlet Reference (*V5). ------ # Utilizzare `UntagResources` con una CLI Gli esempi di codice seguenti mostrano come utilizzare `UntagResources`. ------ #### [ CLI ] **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](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_UntagResources.html)il *Resource Groups Tagging API Reference.* + Per i dettagli sull'API, consulta [UntagResources AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resourcegroupstaggingapi/untag-resources.html)*Command Reference.* ------ #### [ PowerShell ] **Strumenti per PowerShell V4** **Esempio 1: rimuove le chiavi di tag “stage” e “version” e i valori associati da un bucket Amazon S3 e da una tabella Amazon DynamoDB. Viene effettuata una sola chiamata al servizio per rimuovere i tag. Prima di rimuovere i tag, il cmdlet richiederà una conferma. Per disabilitare la conferma, aggiungi il parametro -Force.** ``` $arn1 = "arn:aws:s3:::amzn-s3-demo-bucket" $arn2 = "arn:aws:dynamodb:us-west-2:123456789012:table/mytable" Remove-RGTResourceTag -ResourceARNList $arn1,$arn2 -TagKey "stage","version" ``` **Esempio 2: rimuove le chiavi di tag “stage” e “version” e i valori associati da un bucket Amazon S3 e da una tabella Amazon DynamoDB. Vengono effettuate due chiamate al servizio, una per ogni ARN di risorsa reindirizzato al cmdlet. Prima di ogni chiamata, il cmdlet richiederà una conferma. Per disabilitare la conferma, aggiungi il parametro -Force.** ``` $arn1 = "arn:aws:s3:::amzn-s3-demo-bucket" $arn2 = "arn:aws:dynamodb:us-west-2:123456789012:table/mytable" $arn1,$arn2 | Remove-RGTResourceTag -TagKey "stage","version" ``` + Per i dettagli sull'API, vedere [UntagResources](https://docs.aws.amazon.com/powershell/v4/reference)in *AWS Strumenti per PowerShell Cmdlet Reference (*V4). **Strumenti per V5 PowerShell ** **Esempio 1: rimuove le chiavi di tag “stage” e “version” e i valori associati da un bucket Amazon S3 e da una tabella Amazon DynamoDB. Viene effettuata una sola chiamata al servizio per rimuovere i tag. Prima di rimuovere i tag, il cmdlet richiederà una conferma. Per disabilitare la conferma, aggiungi il parametro -Force.** ``` $arn1 = "arn:aws:s3:::amzn-s3-demo-bucket" $arn2 = "arn:aws:dynamodb:us-west-2:123456789012:table/mytable" Remove-RGTResourceTag -ResourceARNList $arn1,$arn2 -TagKey "stage","version" ``` **Esempio 2: rimuove le chiavi di tag “stage” e “version” e i valori associati da un bucket Amazon S3 e da una tabella Amazon DynamoDB. Vengono effettuate due chiamate al servizio, una per ogni ARN di risorsa reindirizzato al cmdlet. Prima di ogni chiamata, il cmdlet richiederà una conferma. Per disabilitare la conferma, aggiungi il parametro -Force.** ``` $arn1 = "arn:aws:s3:::amzn-s3-demo-bucket" $arn2 = "arn:aws:dynamodb:us-west-2:123456789012:table/mytable" $arn1,$arn2 | Remove-RGTResourceTag -TagKey "stage","version" ``` + Per i dettagli sull'API, vedere [UntagResources](https://docs.aws.amazon.com/powershell/v5/reference)in *AWS Strumenti per PowerShell Cmdlet Reference (*V5). ------