Esempi di Resource Groups utilizzando 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 JSON file 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 CloudFormation basato 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.

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.

Per allegare 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 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."
    }
}

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"
    }
}

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

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 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"
        }
    ]
}

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, vedere Configurazioni dei servizi per i gruppi di risorse nella Resource Groups API Reference Guide.

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 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 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.

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.

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.