Struttura del detail campo - 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 detail campo

Il detail campo include tutti i dettagli specifici del servizio Resource Groups su una modifica specifica. Il detail campo può assumere 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 in questi eventi sono identificati da una combinazione dell'ARN del gruppo e di un "unique-id" campo che contiene un 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. È consigliabile considerare una concatenazione dell'ARN e dell'ID univoco come chiave per il gruppo nei programmi che interagiscono 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'detailinterno di.

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

Nome del campo Tipo Descrizione
event-sequence Doppio Un numero monotonicamente crescente che specifica la sequenza di eventi per un gruppo specifico. Il numero viene reimpostato quando si elimina il gruppo e si crea un altro gruppo con lo stesso nome.
group GroupOggetto JSON L'oggetto gruppo associato all'evento tramite ARN, nome e ID univoco.
state-change Stringa Il tipo di cambiamento di stato che si è verificato. 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à modificate.

new-state

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

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

Nome del campo Tipo Descrizione
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. Usa la concatenazione di ARN e questo valore come chiave univoca per il gruppo quando utilizzi questi eventi nel tuo codice.

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

Nome del campo Tipo Descrizione
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 dell'ResourceQuery API. Alcuni esempi di ciò sono inclusi negli esempi di eventi Create and Update.
group-configuration ConfigurationOggetto JSON Una rappresentazione JSON dei parametri di configurazione associati a un gruppo collegato al servizio. 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 ogni state-change tipo.

Crea

"state-change": "create"

L'evento indica che è stato creato un nuovo gruppo. L'evento contiene tutte le proprietà dei metadati di 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 EC2 (Amazon) che dispongono del 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\"}]
                }"
            }
        }
    }
}

Aggiornamento

"state-change": "update"

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

L'evento di esempio seguente indica che la query basata su tag nel gruppo di risorse dell'esempio precedente è stata modificata per includere anche le risorse di EC2 volume Amazon 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\"}]
                }"
            }
        }
    }
}

Eliminazione

"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 ripristinato dopo questo evento in quanto è, per definizione, l'ultimo evento di questo arn eunique-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 dall'aggiunta o dalla rimozione di una risorsa dal gruppo. Quando detail-type viene specificato, il resources campo di primo livello include l'ARN del gruppo la cui appartenenza è stata modificata e ARNs quello di tutte le risorse che sono state aggiunte o rimosse dal gruppo.

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

Nome del campo Tipo Descrizione
event-sequence Doppio Un numero monotonicamente crescente che indica la sequenza di eventi per un gruppo specifico. Il numero viene reimpostato quando il gruppo viene eliminato e il relativo ID univoco cambia.
group GroupOggetto JSON Identifica l'oggetto gruppo associato all'evento tramite 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.

Il seguente esempio di codice illustra il contenuto dell'evento per un tipo tipico di modifica dell'iscrizione. Questo esempio mostra una risorsa che viene aggiunta al gruppo e una risorsa che viene 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"
            }
        ]
    }
}