Esempi di Resource Groups utilizzando AWS CLI - AWS Esempi di codice SDK
Azioni

Sono disponibili altri esempi AWS SDK nel repository AWS Doc SDK 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 Resource Groups utilizzando AWS CLI

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

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

Ogni esempio include un collegamento al codice sorgente completo, in cui è possibile trovare istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Il seguente esempio di codice mostra come utilizzarecreate-group.

AWS CLI

Esempio 1: creare un gruppo di risorse basato su tag

L'create-groupesempio seguente crea un gruppo di risorse basato su tag di EC2 istanze Amazon nella regione corrente. Si basa su una query relativa alle risorse etichettate con la chiave e Name 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 CloudFormation sullo stack

L'create-groupesempio seguente crea un gruppo di risorse AWS CloudFormation basato sullo stack denominato. sampleCFNstackgroup La query include tutte le risorse nello CloudFormation stack specificato supportate da AWS Resource Groups.

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 Create Groups nella AWS Resource Groups User Guide.

Il seguente esempio di codice mostra come utilizzaredelete-group.

AWS CLI

Per aggiornare la descrizione di un gruppo di risorse

L'delete-groupesempio 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 Delete Groups nella AWS Resource Groups User Guide.

Il seguente esempio di codice mostra come utilizzareget-group-query.

AWS CLI

Per associare la query a un gruppo di risorse

L'get-group-queryesempio seguente visualizza una 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, vedere GetGroupQueryin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzareget-group.

AWS CLI

Per ottenere informazioni su un gruppo di risorse

L'get-groupesempio seguente mostra i dettagli sul gruppo di risorse specificato. Per allegare la query al gruppo, utilizzareget-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."
    }
}

Il seguente esempio di codice mostra come utilizzareget-tags.

AWS CLI

Per recuperare i tag allegati a un gruppo di risorse

L'get-tagsesempio seguente visualizza le coppie di tag chiave e valore associate al gruppo di risorse specificato (il gruppo stesso, non i suoi 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"
    }
}

Il seguente esempio di codice mostra come utilizzarelist-group-resources.

AWS CLI

Per elencare tutte le risorse di un gruppo di risorse

Esempio 1: L'list-resource-groupsesempio seguente elenca tutte le risorse che fanno parte del 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 anche un «tipo di risorsa» del tipo '::: :Instance'AWS EC2 . :

aws resource-groups list-group-resources --group-name tbq- WebServer --filters Nome=Tipo di risorsa, Valori=::: :Instance AWS EC2

Il seguente esempio di codice mostra come utilizzarelist-groups.

AWS CLI

Per elencare i gruppi di risorse disponibili

L'list-groupsesempio 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, vedere ListGroupsin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarelist-resource-groups.

AWS CLI

Per elencare tutte le risorse di un gruppo di risorse

L'list-resource-groupsesempio seguente elenca tutte le risorse che fanno parte del 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"
        }
    ]
}

Il seguente esempio di codice mostra come utilizzareput-group-configuration.

AWS CLI

Per allegare una configurazione di servizio a un gruppo di risorse

Esempio 1: l'put-group-configurationesempio seguente specifica che il gruppo di risorse deve contenere solo le prenotazioni di EC2 capacità Amazon per le istanze delle famiglie C5 orM5.

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 in caso di successo.

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

Il seguente esempio di codice mostra come utilizzaresearch-resources.

AWS CLI

Per trovare 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 SearchResourcesin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzaretag.

AWS CLI

Per allegare un tag a un gruppo di risorse

L'tagesempio seguente associa le coppie di chiave e valore del tag specificate al gruppo di risorse specificato (il gruppo stesso, non i suoi 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 Manage tags nella AWS Resource Groups User Guide.

  • Per i dettagli sull'API, consulta Tag in AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzareuntag.

AWS CLI

Per rimuovere i tag da un gruppo di risorse

L'untagsesempio seguente rimuove qualsiasi tag con la chiave specificata dal gruppo di risorse stesso, non dai suoi 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 Manage tags nella AWS Resource Groups User Guide.

  • Per i dettagli sull'API, consulta Untag in AWS CLI Command Reference.

Il seguente esempio di codice mostra come usareupdate-group-query.

AWS CLI

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

L'update-group-queryesempio seguente aggiorna la query allegata 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 Update Groups nella AWS Resource Groups User Guide.

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

L'update-group-queryesempio seguente aggiorna la query 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 Update Groups nella AWS Resource Groups User Guide.

Il seguente esempio di codice mostra come utilizzareupdate-group.

AWS CLI

Per aggiornare la descrizione di un gruppo di risorse

L'update-groupesempio seguente aggiorna la descrizione per il 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 Update Groups nella AWS Resource Groups User Guide.