Structure and syntax of Resource Groups lifecycle events

Focus mode

Structure and syntax of Resource Groups lifecycle events - AWS Resource Groups

Topics

The lifecycle events for AWS Resource Groups take the form of JSON object strings in the following general 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": {
        ...
    }
}

For details about the fields common to all Amazon EventBridge events, see Amazon EventBridge events in the Amazon EventBridge User Guide. Details that are specific to Resource Groups are explained in the following table.

Field name	Type	Description
`detail-type`	String	For Resource Groups, the `detail-type` field is always one of the following values: `ResourceGroups Group State Change` – Represents changes to the overall group state and its properties. `ResourceGroups Group Membership Change` – Represents changes to the group membership.
`source`	String	For Resource Groups, this value is always `"aws.resource-groups"`.
`resources`	An array of Amazon Resource Names (ARNs)	This field always includes the Amazon resource name (ARN) of the group with the change that triggered this event. This field can also include the ARNs of any resources added to or removed from the group, if applicable.
`detail`	JSON object string	This is the payload of the event. The contents of the `detail` field vary based on the value of the `detail-type`. See the next section for more information.