Esempi di gruppi di risorse che utilizzano AWS CLI

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

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

Azioni

L’esempio di codice seguente mostra come utilizzare create-group.

AWS CLI

Esempio 1: come creare un gruppo di risorse basato su tag

L’esempio create-group seguente crea un gruppo di risorse basato su tag di istanze Amazon EC2 nella Regione corrente. Si basa su una query relativa alle risorse taggate con la chiave Name e il valore WebServers. Il nome del gruppo è tbq-WebServer. La query si trova in un file JSON separato che viene passato al comando.


aws resource-groups create-group \
    --name tbq-WebServer \
    --resource-query file://query.json

Contenuto di query.json:


{
    "Type": "TAG_FILTERS_1_0",
    "Query": "{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Name\", \"Values\":[\"WebServers\"]}]}"
}

Output:


{
    "Group": {
        "GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer",
        "Name": "tbq-WebServer"
    },
    "ResourceQuery": {
        "Type": "TAG_FILTERS_1_0",
        "Query": "{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Name\", \"Values\":[\"WebServers\"]}]}"
    }
}

Esempio 2: creare un gruppo di risorse basato su CloudFormation stack

L'create-groupesempio seguente crea un gruppo di risorse AWS CloudFormation basato su stack denominato. sampleCFNstackgroup La query include tutte le risorse nello CloudFormation stack specificato supportate dai gruppi di AWS risorse.


aws resource-groups create-group \
    --name cbq-CFNstackgroup \
    --resource-query file://query.json

Contenuto di query.json:


{
    "Type": "CLOUDFORMATION_STACK_1_0",
    "Query": "{\"ResourceTypeFilters\":[\"AWS::AllSupported\"],\"StackIdentifier\":\"arn:aws:cloudformation:us-west-2:123456789012:stack/MyCFNStack/1415z9z0-z39z-11z8-97z5-500z212zz6fz\"}"
}

Output:


{
    "Group": {
        "GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/cbq-CFNstackgroup",
        "Name": "cbq-CFNstackgroup"
    },
    "ResourceQuery": {
        "Type": "CLOUDFORMATION_STACK_1_0",
        "Query": "{\"ResourceTypeFilters\":[\"AWS::AllSupported\"],\"StackIdentifier\":\"arn:aws:cloudformation:us-east-2:123456789012:stack/MyCFNStack/1415z9z0-z39z-11z8-97z5-500z212zz6fz\"}"}'
    }
}

Per ulteriori informazioni, consulta Creazione di gruppi nella Guida per l’utente di Gruppi di risorse AWS .

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

L’esempio di codice seguente mostra come utilizzare delete-group.

AWS CLI

Come aggiornare la descrizione di un gruppo di risorse

L’esempio delete-group seguente aggiorna il gruppo di risorse specificato.


aws resource-groups delete-group \
    --group-name tbq-WebServer

Output:


{
    "Group": {
        "GroupArn": "arn:aws:resource-groups:us-west-2:1234567890:group/tbq-WebServer",
        "Name": "tbq-WebServer"
    }
}

Per ulteriori informazioni, consulta Eliminazione di gruppi nella Guida per l’utente di Gruppi di risorse AWS .

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

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

AWS CLI

Come ottenere la query associata a un gruppo di risorse

L’esempio get-group-query seguente visualizza la query associata al gruppo di risorse specificato.


aws resource-groups get-group-query \
    --group-name tbq-WebServer

Output:


{
    "GroupQuery": {
        "GroupName": "tbq-WebServer",
        "ResourceQuery": {
            "Type": "TAG_FILTERS_1_0",
            "Query": "{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Name\", \"Values\":[\"WebServers\"]}]}"
        }
    }
}

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

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

AWS CLI

Come ottenere informazioni su un gruppo di risorse

L’esempio get-group seguente visualizza i dettagli relativi al gruppo di risorse specificato. Per ottenere la query associata al gruppo, utilizza get-group-query.


aws resource-groups get-group \
    --group-name tbq-WebServer

Output:


{
    "Group": {
        "GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer",
        "Name": "tbq-WebServer",
        "Description": "A tag-based query resource group of WebServers."
    }
}

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

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

AWS CLI

Come recuperare i tag associati a un gruppo di risorse

L’esempio get-tags seguente visualizza le coppie di chiavi di tag e valori associate al gruppo di risorse specificato (il gruppo stesso e non i relativi membri).


aws resource-groups get-tags \
    --arn arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer

Output:


{
    "Arn": "arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer",
    "Tags": {
        "QueryType": "tags",
        "QueryResources": "ec2-instances"
    }
}

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

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

AWS CLI

Come elencare tutte le risorse in un gruppo di risorse

Esempio 1: l’esempio list-resource-groups seguente elenca tutte le risorse appartenenti gruppo di risorse specificato.


aws resource-groups list-group-resources \
    --group-name tbq-WebServer

Output:


{
    "ResourceIdentifiers": [
        {
            "ResourceArn": "arn:aws:ec2:us-west-2:123456789012:instance/i-09f77fa38c12345ab",
            "ResourceType": "AWS::EC2::Instance"
        }
    ]
}

Esempio 2: l’esempio seguente elenca tutte le risorse del gruppo che hanno il parametro “resource-type” con il valore “AWS::EC2::Instance”.

aws resource-groups list-group-resources --group-name tbq- --filters name=Resource-type, Values=: :EC2: :Instance WebServer AWS

Per i dettagli sulle API, consulta la sezione ListGroupResources AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-groups.

AWS CLI

Come elencare i gruppi di risorse disponibili

L’esempio list-groups seguente visualizza un elenco di tutti i gruppi di risorse.


aws resource-groups list-groups

Output:


{
    "GroupIdentifiers": [
        {
            "GroupName": "tbq-WebServer",
            "GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer3"
        },
        {
            "GroupName": "cbq-CFNStackQuery",
            "GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/cbq-CFNStackQuery"
        }
    ],
    "Groups": [
        {
            "GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer",
            "Name": "tbq-WebServer"
        },
        {
            "GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/cbq-CFNStackQuery",
            "Name": "cbq-CFNStackQuery"
        }
    ]
}

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

L’esempio di codice seguente mostra come utilizzare list-resource-groups.

AWS CLI

Come elencare tutte le risorse in un gruppo di risorse

L’esempio list-resource-groups seguente elenca tutte le risorse appartenenti gruppo di risorse specificato.


aws resource-groups list-group-resources \
    --group-name tbq-WebServer

Output:


{
    "ResourceIdentifiers": [
        {
            "ResourceArn": "arn:aws:ec2:us-west-2:123456789012:instance/i-09f77fa38c12345ab",
            "ResourceType": "AWS::EC2::Instance"
        }
    ]
}

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

L’esempio di codice seguente mostra come utilizzare put-group-configuration.

AWS CLI

Come associare una configurazione di servizio a un gruppo di risorse

Esempio 1: l’esempio put-group-configuration seguente specifica che il gruppo di risorse deve contenere solo le prenotazioni della capacità di Amazon EC2 per le istanze delle famiglie C5 o M5.


aws resource-groups put-group-configuration \
    --group MyTestGroup \
    --configuration file://config.json

Contenuto di config.json:


[
    {
        "Type": "AWS::EC2::HostManagement",
        "Parameters": [
            {
                "Name": "allowed-host-families",
                "Values": [ "c5", "m5" ]
            },
                {
                    "Name": "any-host-based-license-configuration",
                    "Values": [ "true" ]
                }
        ]
    },
    {
        "Type": "AWS::ResourceGroups::Generic",
        "Parameters": [
            {
                "Name": "allowed-resource-types",
                "Values": [ "AWS::EC2::Host" ]
            },
            {
                "Name": "deletion-protection",
                "Values": [ "UNLESS_EMPTY" ]
            }
        ]
    }
]

Questo comando non produce alcun output se ha esito positivo.

Per ulteriori informazioni, consulta Configurazioni dei servizi per i gruppi di risorse nella Guida di riferimento dell’API per gruppi di risorse.

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

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

AWS CLI

Come trovare le risorse che corrispondono a una query

L'search-resourcesesempio seguente recupera un elenco di tutte le AWS risorse che corrispondono alla query specificata.


aws resource-groups search-resources \
    --resource-query file://query.json

Contenuto di query.json:


{
    "Type": "TAG_FILTERS_1_0",
    "Query": "{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Patch Group\", \"Values\":[\"Dev\"]}]}"
}

Output:


{
    "ResourceIdentifiers": [
        {
            "ResourceArn": "arn:aws:ec2:us-west-2:123456789012:instance/i-01a23bc45d67890ef",
            "ResourceType": "AWS::EC2::Instance"
        }
    ]
}

Per i dettagli sull'API, vedere SearchResources in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare tag.

AWS CLI

Come associare un tag a un gruppo di risorse

L’esempio tag seguente collega le coppie di chiavi di tag e valori specificate al gruppo di risorse specificato (il gruppo stesso e non i relativi membri).


aws resource-groups tag \
    --tags QueryType=tags,QueryResources=ec2-instances \
    --arn arn:aws:resource-groups:us-west-2:128716708097:group/tbq-WebServer

Output:


{
    "Arn": "arn:aws:resource-groups:us-west-2:128716708097:group/tbq-WebServer",
    "Tags": {
        "QueryType": "tags",
        "QueryResources": "ec2-instances"
    }
}

Per ulteriori informazioni, consulta Gestione dei tag nella Guida per l’utente di Gruppi di risorse AWS .

Per informazioni dettagliate sull’API, consulta Tag nella documentazione di riferimento dei comandi della AWS CLI .

L’esempio di codice seguente mostra come utilizzare untag.

AWS CLI

Come rimuovere i tag da un gruppo di risorse

L’esempio untags seguente rimuove qualsiasi tag con la chiave specificata dal gruppo di risorse stesso e non dai relativi membri.


aws resource-groups untag \
    --arn arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer \
    --keys QueryType

Output:


{
    "Arn": "arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer",
    "Keys": [
        "QueryType"
    ]
}

Per ulteriori informazioni, consulta Gestione dei tag nella Guida per l’utente di Gruppi di risorse AWS .

Per informazioni dettagliate sull’API, consulta Untag nella documentazione di riferimento dei comandi della AWS CLI .

L’esempio di codice seguente mostra come utilizzare update-group-query.

AWS CLI

Esempio 1: come aggiornare la query per un gruppo di risorse basato su tag

L’esempio update-group-query seguente aggiorna la query associata al gruppo di risorse basato su tag specificato.


aws resource-groups update-group-query \
    --group-name tbq-WebServer \
    --resource-query '{"Type":"TAG_FILTERS_1_0", "Query":"{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Name\", \"Values\":[\"WebServers\"]}]}"}'

Output:


{
    "Group": {
        "GroupArn": "arn:aws:resource-groups:us-east-2:123456789012:group/tbq-WebServer",
        "Name": "tbq-WebServer"
    },
    "ResourceQuery": {
        "Type": "TAG_FILTERS_1_0",
        "Query": "{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Name\", \"Values\":[\"WebServers\"]}]}"
    }
}

Per ulteriori informazioni, consulta Aggiornamento dei gruppi nella Guida per l’utente di Gruppi di risorse AWS .

Esempio 2: per aggiornare la query per un gruppo di risorse basato su stack CloudFormation

L'update-group-queryesempio seguente aggiorna l'interrogazione allegata al gruppo di risorse basato sullo AWS CloudFormation stack specificato.


aws resource-groups update-group-query \
    --group-name cbq-CFNstackgroup \
    --resource-query '{"Type": "CLOUDFORMATION_STACK_1_0", "Query": "{\"ResourceTypeFilters\":[\"AWS::AllSupported\"],\"StackIdentifier\":\"arn:aws:cloudformation:us-west-2:123456789012:stack/MyCFNStack/1415z9z0-z39z-11z8-97z5-500z212zz6fz\"}"}'

Output:


{
    "Group": {
        "GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/cbq-CFNstackgroup",
        "Name": "cbq-CFNstackgroup"
    },
    "ResourceQuery": {
        "Type": "CLOUDFORMATION_STACK_1_0",
        "Query": "{\"ResourceTypeFilters\":[\"AWS::AllSupported\"],\"StackIdentifier\":\"arn:aws:cloudformation:us-west-2:123456789012:stack/MyCFNStack/1415z9z0-z39z-11z8-97z5-500z212zz6fz\"}"
    }
}

Per ulteriori informazioni, consulta Aggiornamento dei gruppi nella Guida per l’utente di Gruppi di risorse AWS .

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

L’esempio di codice seguente mostra come utilizzare update-group.

AWS CLI

Come aggiornare la descrizione di un gruppo di risorse

L’esempio update-group seguente aggiorna la descrizione del gruppo di risorse specificato.


aws resource-groups update-group \
    --group-name tbq-WebServer \
    --description "Resource group for all web server resources."

Output:


{
    "Group": {
        "GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/tbq-WebServer",
        "Name": "tbq-WebServer"
        "Description": "Resource group for all web server resources."
    }
}

Per ulteriori informazioni, consulta Aggiornamento dei gruppi nella Guida per l’utente di Gruppi di risorse AWS .

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

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Esploratore di risorse

Resource Groups Tagging API