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 und Syntax von Lebenszyklusereignissen für Resource Groups
**Topics**
+ [Struktur des `detail` Feldes](monitor-groups-syntax-detail.md)
+ [Beispiel für EventBridge benutzerdefinierte Ereignismuster für verschiedene Anwendungsfälle](monitor-groups-example-eventbridge-filters.md)
Die AWS -Ressourcengruppen Lebenszyklusereignisse für haben die Form von [JSON-Objektzeichenfolgen](https://json.org) im folgenden allgemeinen Format.
```
{
"version": "0",
"id": "08f00e24-2e30-ec44-b824-8acddf1ac868",
"detail-type": "ResourceGroups Group ... 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/MyGroupName"
],
"detail": {
...
}
}
```
Einzelheiten zu den Feldern, die allen EventBridge Amazon-Veranstaltungen gemeinsam sind, finden Sie unter [ EventBridge Amazon-Ereignisse](https://docs.aws.amazon.com//eventbridge/latest/userguide/aws-events.html) im * EventBridge Amazon-Benutzerhandbuch*. Details, die für Resource Groups spezifisch sind, werden in der folgenden Tabelle erklärt.
| Feldname | Typ | Description |
| --- | --- | --- |
| detail-type | Zeichenfolge | Für Resource Groups hat das `detail-type` Feld immer einen der folgenden Werte: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/ARG/latest/userguide/monitor-groups-syntax.html) |
| source | Zeichenfolge | Für Resource Groups ist dieser Wert immer"aws.resource-groups". |
| resources | Eine Reihe von Amazon-Ressourcennamen (ARNs) | Dieses Feld enthält immer den [Amazon-Ressourcennamen (ARN)](https://docs.aws.amazon.com//general/latest/gr/aws-arns-and-namespaces.html) der Gruppe mit der Änderung, die dieses Ereignis ausgelöst hat. Dieses Feld kann gegebenenfalls auch ARNs die Ressourcen enthalten, die der Gruppe hinzugefügt oder daraus entfernt wurden. |
| `detail` | Zeichenfolge für das JSON-Objekt | Dies ist die Nutzlast des Ereignisses. Der Inhalt des detail Felds variiert je nach Wert von. detail-type [Weitere Informationen finden Sie im nächsten Abschnitt.](monitor-groups-syntax-detail.md) |
# 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"
}
]
}
}
```
# Beispiel für EventBridge benutzerdefinierte Ereignismuster für verschiedene Anwendungsfälle
Im folgenden Beispiel für EventBridge benutzerdefinierte Ereignismuster werden die von Resource Groups generierten Ereignisse nur nach Ereignissen gefiltert, an denen Sie für eine bestimmte Ereignisregel und ein bestimmtes Ziel interessiert sind.
Wenn in den folgenden Codebeispielen eine bestimmte Gruppe oder Ressource benötigt wird, ersetzen Sie jede *user input placeholder* durch Ihre eigenen Informationen.
Alle Resource Groups Groups-Ereignisse
```
{
"source": [ "aws.resource-groups" ]
}
```
Ereignisse zur Änderung des Gruppenstatus oder der Mitgliedschaft
Das folgende Codebeispiel bezieht sich auf alle Änderungen *des Gruppenstatus*.
```
{
"source": [ "aws.resource-groups" ],
"detail-type": [ "ResourceGroups Group State Change " ]
}
```
Das folgende Codebeispiel bezieht sich auf alle Änderungen der *Gruppenmitgliedschaft*.
```
{
"source": [ "aws.resource-groups" ],
"detail-type": [ "ResourceGroups Group Membership Change" ]
}
```
Ereignisse für eine bestimmte Gruppe
```
{
"source": [ "aws.resource-groups" ],
"detail": {
"group": {
"arn": [ "my-group-arn" ]
}
}
}
```
Im vorherigen Beispiel werden Änderungen an der angegebenen Gruppe erfasst. Das folgende Beispiel macht dasselbe und erfasst auch Änderungen, wenn die Gruppe eine Mitgliedsressource einer anderen Gruppe ist.
```
{
"source": [ "aws.resource-groups" ],
"resources": [ "my-group-arn" ]
}
```
Ereignisse für eine bestimmte Ressource
Sie können nur Ereignisse zur Änderung der Gruppenmitgliedschaft nach bestimmten Mitgliederressourcen filtern.
```
{
"source": [ "aws.resource-groups" ],
"detail-type": [ "ResourceGroups Group Membership Change " ],
"resources": [ "arn:aws:ec2:us-east-1:123456789012:instance/i-b188560f" ]
}
```
Ereignisse für einen bestimmten Ressourcentyp
Sie können den Präfixabgleich mit verwenden ARNs , um Ereignisse für einen bestimmten Ressourcentyp abzugleichen.
```
{
"source": [ "aws.resource-groups" ],
"resources": [
{ "prefix": "arn:aws:ec2:us-east-1:123456789012:instance" }
]
}
```
Alternativ können Sie den exakten Abgleich verwenden, indem Sie `resource-type` Bezeichner verwenden, sodass möglicherweise mehrere Typen präzise zugeordnet werden können. Im Gegensatz zum vorherigen Beispiel werden im folgenden Beispiel nur Ereignisse zur Änderung der Gruppenmitgliedschaft berücksichtigt, da Ereignisse zur Änderung des Gruppenstatus kein `resources` Feld in ihrem Feld enthalten. `detail`
```
{
"source": [ "aws.resource-groups" ],
"detail": {
"resources": {
"resource-type": [ "AWS::EC2::Instance", "AWS::EC2::Volume" ]
}
}
}
```
Alle Ereignisse beim Entfernen von Ressourcen
```
{
"source": [ "aws.resource-groups" ],
"detail-type": [ "ResourceGroups Group Membership Change" ],
"detail": {
"resources": {
"membership-change": [ "remove" ]
}
}
}
```
Alle Ereignisse beim Entfernen von Ressourcen für eine bestimmte Ressource
```
{
"source": [ "aws.resource-groups" ],
"detail-type": [ "ResourceGroups Group Membership Change" ],
"detail": {
"resources": {
"membership-change": [ "remove" ],
"arn": [ "arn:aws:ec2:us-east-1:123456789012:instance/i-b188560f" ]
}
}
}
```
Sie können das `resources` Array der **obersten Ebene**, das im ersten Beispiel in diesem Abschnitt verwendet wurde, nicht für diese Art der Ereignisfilterung verwenden. Das liegt daran, dass es sich bei einer Ressource im `resources` Element der obersten Ebene möglicherweise um eine Ressource handelt, die zu einer Gruppe hinzugefügt wird, und das Ereignis trotzdem zutrifft. Mit anderen Worten, das folgende Codebeispiel könnte unerwartete Ereignisse zurückgeben. Verwenden Sie stattdessen die im vorherigen Beispiel gezeigte Syntax.
```
{
"source": [ "aws.resource-groups" ],
"detail-type": [ "ResourceGroups Group Membership Change" ],
"resources": [ "arn:aws:ec2:us-east-1:123456789012:instance/i-b188560f" ],
"detail": {
"resources": {
"membership-change": [ "remove" ]
}
}
}
```