Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Struktur des `detail` Feldes
Das `detail` Feld enthält alle dienstspezifischen Details zu einer bestimmten Änderung für Resource Groups. Das `detail` Feld kann eine von zwei Formen annehmen, eine Änderung des Gruppenstatus oder eine Änderung der Mitgliedschaft, basierend auf dem Wert des im vorherigen Abschnitt beschriebenen `detail-type` Felds.
**Wichtig**
Ressourcengruppen in diesen Ereignissen werden durch eine Kombination aus dem ARN der Gruppe und einem `"unique-id"` Feld identifiziert, das eine [UUID](https://wikipedia.org/wiki/Universally_unique_identifier) enthält. Indem Sie eine UUID als Teil der Identität einer Ressourcengruppe angeben, können Sie zwischen einer gelöschten Gruppe und einer anderen Gruppe unterscheiden, die später mit demselben Namen erstellt wird. Wir empfehlen Ihnen, eine Verkettung von ARN und eindeutiger ID als Schlüssel für die Gruppe in Ihren Programmen zu behandeln, die mit diesen Ereignissen interagieren.
## Änderung des Gruppenstatus
`"detail-type": "ResourceGroups Group State Change"`
Dieser `detail-type` Wert gibt an, dass sich der Status der Gruppe selbst, einschließlich ihrer Metadaten, geändert hat. Diese Änderung tritt ein, wenn eine Gruppe erstellt, aktualisiert oder gelöscht wird, wie aus dem `"change"` Feld in der hervorgeht`detail`.
Wenn dies angegeben `detail-type` ist, enthält der `details` Abschnitt auch die in der folgenden Tabelle beschriebenen Felder.
| Feldname | Typ | Description |
| --- | --- | --- |
| event-sequence | Double | Eine monoton steigende Zahl, die die Reihenfolge der Ereignisse für eine bestimmte Gruppe angibt. Die Zahl wird zurückgesetzt, wenn Sie die Gruppe löschen und eine weitere Gruppe mit demselben Namen erstellen. |
| group | [`Group`](#monitor-groups-syntax-detail-group-object)JSON-Objekt | Das dem Ereignis über seinen ARN, seinen Namen und seine eindeutige ID zugeordnete Gruppenobjekt. |
| state-change | Zeichenfolge | Die Art der Statusänderung, die eingetreten ist. Dabei kann es sich um einen der folgenden Werte handeln:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/ARG/latest/userguide/monitor-groups-syntax-detail.html) |
| old-state | GroupStateJSON-Objekt | Der Status der Gruppe vor der Änderung. Das Objekt enthält nur die Werte von Eigenschaften, die sich geändert haben. |
| `new-state` | GroupStateJSON-Objekt | Der Status der Gruppe nach der Änderung. Das Objekt enthält nur die Werte von Eigenschaften, die sich geändert haben. |
Das `group` JSON-Objekt enthält die in der folgenden Tabelle beschriebenen Elemente.
| Feldname | Typ | Description |
| --- | --- | --- |
| arn | Zeichenfolge | Der ARN der Gruppe. |
| name | Zeichenfolge | Der freundliche Name der Gruppe. |
| unique-id | EIN FÜHRER | Ein eindeutiger GUID-Wert, der zwischen einer gelöschten Gruppe und einer anderen Gruppe unterscheidet, die später mit demselben Namen und ARN erstellt wurde. Verwenden Sie die Verkettung von ARN und diesem Wert als eindeutigen Schlüssel für die Gruppe, wenn Sie diese Ereignisse in Ihrem Code verwenden. |
Die `GroupState` JSON-Objekte enthalten die in der folgenden Tabelle beschriebenen Elemente.
| Feldname | Typ | Description |
| --- | --- | --- |
| description | Zeichenfolge | Die vom Kunden bereitgestellte Beschreibung der Ressourcengruppe. |
| resource-query | ResourceQueryJSON-Objekt | Eine JSON-Darstellung der Abfrage, die die Mitglieder der Gruppe definiert. Dieses Feld ist nur für Gruppen vorhanden, die auf einer Abfrage basieren. Die Syntax dieses Felds wird durch den [ResourceQuery API-Datentyp](https://docs.aws.amazon.com//organizations/latest/APIReference/API_ResourceQuery.html) definiert. Beispiele dafür sind in den Beispielen für Ereignisse zum [Erstellen](#monitor-groups-syntax-detail-state-change-create) und [Aktualisieren](#monitor-groups-syntax-detail-state-change-update) enthalten. |
| group-configuration | ConfigurationJSON-Objekt | Eine JSON-Darstellung von Konfigurationsparametern, die einer serviceverknüpften Gruppe zugeordnet sind. Weitere Informationen finden Sie unter [Dienstkonfigurationen für Ressourcengruppen](https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html) in der AWS -Ressourcengruppen API-Referenz. |
Jedes der folgenden Codebeispiele veranschaulicht den Inhalt des `detail` Felds für jeden `state-change` Typ.
### Create
`"state-change": "create"`
Das Ereignis zeigt an, dass eine neue Gruppe erstellt wurde. Das Ereignis enthält alle Eigenschaften der Gruppenmetadaten, die bei der Erstellung der Gruppe festgelegt wurden. Auf dieses Ereignis folgt in der Regel eines oder mehrere Ereignisse zur Gruppenmitgliedschaft, sofern die Gruppe nicht leer ist. Eigenschaften, die einen Nullwert haben, werden im Hauptteil des Ereignisses nicht angezeigt.
Das folgende Beispielereignis weist auf eine neu erstellte Ressourcengruppe mit dem Namen hin`my-service-group`. In diesem Beispiel verwendet die Gruppe eine tagbasierte Abfrage, die nur Amazon Elastic Compute Cloud (Amazon EC2) -Instances abgleicht, die das Tag haben. `"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\"}]
}"
}
}
}
}
```
### Aktualisierung
`"state-change": "update"`
Das Ereignis weist darauf hin, dass eine bestehende Gruppe auf irgendeine Weise geändert wurde. Das Ereignis enthält nur die Eigenschaften, die sich gegenüber dem vorherigen Status geändert haben. Eigenschaften, die sich nicht geändert haben, werden im Ereignistext nicht angezeigt.
Das folgende Beispielereignis weist darauf hin, dass die tagbasierte Abfrage in der Ressourcengruppe des vorherigen Beispiels geändert wurde, um auch Amazon EC2 EC2-Volume-Ressourcen in die Gruppe aufzunehmen.
```
{
"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\"}]
}"
}
}
}
}
```
### Delete
`"state-change": "delete"`
Das Ereignis weist darauf hin, dass eine bestehende Gruppe gelöscht wurde. Das Detailfeld enthält außer ihrer Identifikation keine Metadaten über die Gruppe. Das `event-sequence` Feld wird nach diesem Ereignis zurückgesetzt, da es definitionsgemäß das letzte Ereignis für dieses `arn` und ist`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"
}
}
}
```
## Änderung der Gruppenmitgliedschaft
`"detail-type": "ResourceGroups Group Membership Change"`
Dieser `detail-type` Wert gibt an, dass die Mitgliedschaft der Gruppe durch das Hinzufügen oder Entfernen einer Ressource zur Gruppe geändert wurde. Wenn dies angegeben `detail-type` ist, enthält das `resources` Feld der obersten Ebene den ARN der Gruppe, deren Mitgliedschaft geändert wurde, sowie die ARNs aller Ressourcen, die der Gruppe hinzugefügt oder aus der Gruppe entfernt wurden.
Wenn dies angegeben `detail-type` wird, enthält der `details` Abschnitt auch die in der folgenden Tabelle beschriebenen Felder.
| Feldname | Typ | Description |
| --- | --- | --- |
| event-sequence | Double | Eine monoton steigende Zahl, die die Reihenfolge der Ereignisse für eine bestimmte Gruppe angibt. Die Zahl wird zurückgesetzt, wenn die Gruppe gelöscht wird und sich ihre eindeutige ID ändert. |
| group | GroupJSON-Objekt | Identifiziert das dem Ereignis zugeordnete Gruppenobjekt anhand seines ARN, Namens und seiner eindeutigen ID. |
| `resources` | Array von ResourceChange JSON-Objekten | Eine Reihe von Ressourcen, deren Gruppenmitgliedschaft sich geändert hat. Dieses `ResourceChange` Objekt enthält die folgenden Felder für jede Ressource: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/ARG/latest/userguide/monitor-groups-syntax-detail.html) |
Das folgende Codebeispiel veranschaulicht den Inhalt des Ereignisses für einen typischen Mitgliedschaftsänderungstyp. Dieses Beispiel zeigt, wie eine Ressource zur Gruppe hinzugefügt und eine Ressource aus der Gruppe entfernt wird.
```
{
"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"
}
]
}
}
```