View a markdown version of this page

Struttura del campo di dettaglio - AWS Resource Groups
Modifica dello stato del gruppoModifica dell'appartenenza al gruppo

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

Struttura del campo di dettaglio

Nota

AWS La funzionalità Group Lifecycle Events (GLE) di non AWS Resource Groups è più aperta ai nuovi clienti. Per funzionalità simili a Group Lifecycle Events (GLE), consulta l'alternativa consigliata. EventBridge-based Per ulteriori informazioni, consulta Funzione Group Lifecycle Events di AWS Resource Groups modifica della disponibilità.

Il detail campo include tutti i dettagli specifici del servizio Resource Groups su una modifica specifica. Il detail campo può assumere una delle due forme, una modifica dello stato del gruppo o una modifica dell'appartenenza, in base al valore del detail-type campo descritto nella sezione precedente.

Importante

I gruppi di risorse coinvolti in questi eventi sono identificati da una combinazione dell'ARN del gruppo e di un "unique-id" campo che contiene un https://wikipedia.org/wiki/Universally_unique_identifier UUID. Includendo un UUID come parte dell'identità di un gruppo di risorse, è possibile distinguere tra un gruppo eliminato e un gruppo diverso che viene successivamente creato con lo stesso nome. Ti consigliamo di considerare una concatenazione dell'ARN e dell'ID univoco come chiave del gruppo nei tuoi programmi che interagisce con questi eventi.

Modifica dello stato del gruppo

"detail-type": "ResourceGroups Group State Change"

Questo detail-type valore indica che lo stato del gruppo stesso, inclusi i relativi metadati, è cambiato. Questa modifica si verifica quando un gruppo viene creato, aggiornato o eliminato, come indicato dal "change" campo all'interno del. detail

Le informazioni incluse nella details sezione quando detail-type viene specificato includono i campi descritti nella tabella seguente.

Nome del campo Tipo Description
event-sequence Double Un numero crescente in modo monotono che specifica la sequenza di eventi per un gruppo specifico. Il numero viene ripristinato quando si elimina il gruppo e si crea un altro gruppo con lo stesso nome.
group GroupOggetto JSON L'oggetto di gruppo associato all'evento in base al relativo ARN, nome e ID univoco.
state-change Stringa Il tipo di modifica dello stato che si è verificata. Può essere uno dei seguenti valori:
old-state GroupStateOggetto JSON Lo stato del gruppo prima della modifica. L'oggetto include solo i valori delle proprietà che sono state modificate.

new-state

 GroupStateOggetto JSON Lo stato del gruppo dopo la modifica. L'oggetto include solo i valori delle proprietà che sono state modificate.

L'oggetto group JSON contiene gli elementi descritti nella tabella seguente.

Nome del campo Tipo Description
arn Stringa L'ARN del gruppo.
name Stringa Il nome descrittivo del gruppo.
unique-id GUIDA Un valore GUID univoco che distingue tra un gruppo eliminato e un gruppo diverso che è stato successivamente creato con lo stesso nome e ARN. Utilizzate la concatenazione di ARN e questo valore come chiave univoca per il gruppo quando utilizzate questi eventi nel codice.

Gli oggetti GroupState JSON contengono gli elementi descritti nella tabella seguente.

Nome del campo Tipo Description
description Stringa La descrizione del gruppo di risorse fornita dal cliente.
resource-query ResourceQueryOggetto JSON Una rappresentazione JSON della query che definisce i membri del gruppo. Questo campo è presente solo per i gruppi basati su una query. La sintassi di questo campo è definita dal tipo di dati ResourceQuery API. Alcuni esempi sono inclusi negli esempi degli eventi Create and Update.
group-configuration ConfigurationOggetto JSON Una rappresentazione JSON dei parametri di configurazione associati a un gruppo collegato ai servizi. Per ulteriori informazioni, consulta Configurazioni dei servizi per i gruppi di risorse nell'API Reference. AWS Resource Groups

Ciascuno dei seguenti esempi di codice illustra il contenuto del detail campo per ciascun state-change tipo.

Crea

"state-change": "create"

L'evento indica che è stato creato un nuovo gruppo. L'evento contiene tutte le proprietà dei metadati del gruppo impostate durante la creazione del gruppo. Questo evento è in genere seguito da uno o più eventi di appartenenza al gruppo, a meno che il gruppo non sia vuoto. Le proprietà con un valore nullo non vengono visualizzate nel corpo dell'evento.

L'evento di esempio seguente indica un gruppo di risorse appena creato denominatomy-service-group. In questo esempio, il gruppo utilizza una query basata su tag che corrisponde solo alle istanze Amazon Elastic Compute Cloud (Amazon EC2) che hanno il tag. "project"="my-service"

{
    "version": "0",
    "id": "08f00e24-2e30-ec44-b824-8acddf1ac868",
    "detail-type": "ResourceGroups Group State Change",
    "source": "aws.resource-groups",
    "account": "123456789012",
    "time": "2020-09-29T09:59:01Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:resource-groups:us-east-1:123456789012:group/my-service-group"
    ],
    "detail": {
        "event-sequence": 1.0,
        "state-change": "create", 
        "group": {
            "arn": "arn:aws:resource-groups:us-east-1:123456789012:group/my-service-group",
            "name": "my-service-group",
            "unique-id": "3dd07ab7-3228-4410-8cdc-6c4a10fcceea"
        },        
        "new-state": {
            "resource-query": {
                "type": "TAG_FILTERS_1_0",
                "query": "{
                    \"ResourceTypeFilters\": [\"AWS::EC2::Instance\"],
                    \"TagFilters\": [{\"Key\":\"project\", \"Values\":[\"my-service\"}]
                }"
            }
        }
    }
}

Aggiorna

"state-change": "update"

L'evento indica che un gruppo esistente è stato modificato in qualche modo. L'evento contiene solo le proprietà che sono cambiate rispetto allo stato precedente. Le proprietà che non sono state modificate non vengono visualizzate nel corpo dell'evento.

Il seguente evento di esempio indica che la query basata su tag nel gruppo di risorse dell'esempio precedente è stata modificata per includere anche le risorse di volume di Amazon EC2 nel gruppo.

{
    "version": "0",
    "id": "08f00e24-2e30-ec44-b824-8acddf1ac868",
    "detail-type": "ResourceGroups Group State Change",
    "source": "aws.resource-groups",
    "account": "123456789012",
    "time": "2020-09-29T09:59:01Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:resource-groups:us-east-1:123456789012:group/my-service-group"
    ],
    "detail": {
        "event-sequence": 3.0,
        "state-change": "update",
        "group": {
            "arn": "arn:aws:resource-groups:us-east-1:123456789012:group/my-service-group",
            "name": "my-service",
            "unique-id": "3dd07ab7-3228-4410-8cdc-6c4a10fcceea"
        },        
        "new-state": {
            "resource-query": {
                "type": "TAG_FILTERS_1_0",
                "query": "{
                    \"ResourceTypeFilters\": [\"AWS::EC2::Instance\", \"AWS::EC2::Volume\"],
                    \"TagFilters\": [{\"Key\":\"project\", \"Values\":[\"my-service\"}]
                }"
            }
        },
        "old-state": {
            "resource-query": {
                "type": "TAG_FILTERS_1_0",
                "query": "{
                    \"ResourceTypeFilters\": [\"AWS::EC2::Instance\"],
                    \"TagFilters\": [{\"Key\":\"Project\", \"Values\":[\"my-service\"}]
                }"
            }
        }
    }
}

Elimina

"state-change": "delete"

L'evento indica che un gruppo esistente è stato eliminato. Il campo dei dettagli non include metadati sul gruppo oltre alla sua identificazione. Il event-sequence campo viene reimpostato dopo questo evento poiché è, per definizione, l'ultimo evento per questo arn e. unique-id

{
    "version": "0",
    "id": "08f00e24-2e30-ec44-b824-8acddf1ac868",
    "detail-type": "ResourceGroups Group State Change",
    "source": "aws.resource-groups",
    "account": "123456789012",
    "time": "2020-09-29T09:59:01Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:resource-groups:us-east-1:123456789012:group/my-service"
    ],
    "detail": {
        "event-sequence": 4.0,   
        "state-change": "delete",
        "group": {
            "arn": "arn:aws:resource-groups:us-east-1:123456789012:group/my-service",
            "name": "my-service",
            "unique-id": "3dd07ab7-3228-4410-8cdc-6c4a10fcceea"
        }
    }
}

Modifica dell'appartenenza al gruppo

"detail-type": "ResourceGroups Group Membership Change"

Questo detail-type valore indica che l'appartenenza al gruppo è stata modificata da una risorsa aggiunta o rimossa dal gruppo. Quando detail-type viene specificato, il resources campo di primo livello include l'ARN del gruppo la cui appartenenza è stata modificata e gli ARN di tutte le risorse aggiunte o rimosse dal gruppo.

Le informazioni incluse nella details sezione quando detail-type viene specificato includono i campi descritti nella tabella seguente.

Nome del campo Tipo Description
event-sequence Double Un numero crescente in modo monotono che indica la sequenza di eventi per un gruppo specifico. Il numero viene ripristinato quando il gruppo viene eliminato e il relativo ID univoco cambia.
group GroupOggetto JSON Identifica l'oggetto del gruppo associato all'evento in base al relativo ARN, nome e ID univoco.

resources

 Matrice di oggetti JSON ResourceChange

Una serie di risorse la cui appartenenza al gruppo è cambiata.

Questo ResourceChange oggetto contiene i seguenti campi per ogni risorsa:

  • membership-change— Il valore è "add" o"remove".

  • arn— L'ARN della risorsa aggiunta o rimossa.

  • resource-type— Il tipo di risorsa aggiunta o rimossa.

L'esempio di codice seguente illustra il contenuto dell'evento per un tipico tipo di modifica dell'iscrizione. Questo esempio mostra una risorsa aggiunta al gruppo e una risorsa rimossa dal gruppo.

{
    "version": "0",
    "id": "08f00e24-2e30-ec44-b824-8acddf1ac868",
    "detail-type": "ResourceGroups Group Membership Change",
    "source": "aws.resource-groups",
    "account": "123456789012",
    "time": "2020-09-29T09:59:01Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:resource-groups:us-east-1:123456789012:group/my-service",
        "arn:aws:ec2:us-east-1:123456789012:instance/i-abcd1111",
        "arn:aws:ec2:us-east-1:123456789012:instance/i-efef2222"
    ],
    "detail": {
        "event-sequence": 2.0,
        "group": {
            "arn": "arn:aws:resource-groups:us-east-1:123456789012:group/my-service",
            "name": "my-service",
            "unique-id": "3dd07ab7-3228-4410-8cdc-6c4a10fcceea"
        },
        "resources": [
            {
                "membership-change": "add",
                "arn": "arn:aws:ec2:us-east-1:123456789012:instance/i-abcd1111",
                "resource-type": "AWS::EC2::Instance"
            },
            {
                "membership-change": "remove",
                "arn": "arn:aws:ec2:us-east-1:123456789012:instance/i-efef2222",
                "resource-type": "AWS::EC2::Instance"
            }
        ]
    }
}