Request Syntax URI Request Parameters Request Body Response Syntax Response Elements Errors See Also

ListGroupingAttributeDefinitions

Returns the current grouping configuration for this account, including all custom grouping attribute definitions that have been configured. These definitions determine how services are logically grouped based on telemetry attributes, AWS tags, or predefined mappings.

Request Syntax


POST /grouping-attribute-definitions?NextToken=NextToken HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

NextToken: Include this value, if it was returned by the previous operation, to get the next set of grouping attribute definitions.

Request Body

The request does not have a request body.

Response Syntax


HTTP/1.1 200
Content-type: application/json

{
   "GroupingAttributeDefinitions": [ 
      { 
         "DefaultGroupingValue": "string",
         "GroupingName": "string",
         "GroupingSourceKeys": [ "string" ]
      }
   ],
   "NextToken": "string",
   "UpdatedAt": number
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

GroupingAttributeDefinitions

An array of structures, where each structure contains information about one grouping attribute definition, including the grouping name, source keys, and default values.

Type: Array of GroupingAttributeDefinition objects

NextToken

Include this value in your next use of this API to get the next set of grouping attribute definitions.

Type: String

UpdatedAt

The timestamp when the grouping configuration was last updated. When used in a raw HTTP Query API, it is formatted as epoch time in seconds.

Type: Timestamp

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDeniedException

You don't have sufficient permissions to perform this action.

HTTP Status Code: 403

ThrottlingException

The request was throttled because of quota limits.

HTTP Status Code: 429

ValidationException

The resource is not valid.

HTTP Status Code: 400