AWS cli documentation change
Summary
Updated command functionality to return current grouping configurations with cross-account support, added new parameters (--aws-account-id and --include-linked-accounts), and enhanced output field descriptions
Security assessment
The changes add cross-account monitoring capabilities (--aws-account-id and --include-linked-accounts parameters) which enable security best practices for centralized monitoring. This documents security-relevant features but doesn't fix a specific vulnerability.
Diff
diff --git a/cli/latest/reference/application-signals/list-grouping-attribute-definitions.md b/cli/latest/reference/application-signals/list-grouping-attribute-definitions.md index 7154b1fa3..80d196b32 100644 --- a//cli/latest/reference/application-signals/list-grouping-attribute-definitions.md +++ b//cli/latest/reference/application-signals/list-grouping-attribute-definitions.md @@ -14,2 +14,2 @@ - * [previous](list-audit-findings.html "list-audit-findings") | - * [AWS CLI 2.31.39 Command Reference](../../index.html) » + * [previous](list-entity-events.html "list-entity-events") | + * [AWS CLI 2.32.3 Command Reference](../../index.html) » @@ -22 +22 @@ - * [← list-audit-findings](list-audit-findings.html "previous chapter \(use the left arrow\)") / + * [← list-entity-events](list-entity-events.html "previous chapter \(use the left arrow\)") / @@ -59,3 +59 @@ First time using the AWS CLI? See the [User Guide](https://docs.aws.amazon.com/c -Retrieves the available grouping attribute definitions that can be used to create grouping configurations. These definitions specify the attributes and rules available for organizing services. - -Use this operation to discover what grouping options are available before creating or updating grouping configurations. +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, Amazon Web Services tags, or predefined mappings. @@ -69,0 +68,2 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/applic + [--aws-account-id <value>] + [--include-linked-accounts | --no-include-linked-accounts] @@ -96 +96,15 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/applic -> The token for the next set of results. Use this token to retrieve additional pages of grouping attribute definitions when the result set is large. +> Include this value, if it was returned by the previous operation, to get the next set of grouping attribute definitions. + +`--aws-account-id` (string) + +> The Amazon Web Services account ID to retrieve grouping attribute definitions for. Use this when accessing grouping configurations from a different account in cross-account monitoring scenarios. +> +> Constraints: +> +> * pattern: `[0-9]{12}` +> + + +`--include-linked-accounts` | `--no-include-linked-accounts` (boolean) + +> If you are using this operation in a monitoring account, specify `true` to include grouping attributes from source accounts in the returned data. @@ -199 +213 @@ GroupingAttributeDefinitions -> (list) -> An array of available grouping attribute definitions that can be used to create grouping configurations. +> An array of structures, where each structure contains information about one grouping attribute definition, including the grouping name, source keys, and default values. @@ -203 +217 @@ GroupingAttributeDefinitions -> (list) ->> Defines how services should be grouped based on specific attributes. This allows logical organization of services in dashboards and service maps. +>> A structure that defines how services should be grouped based on specific attributes. This includes the friendly name for the grouping, the source keys to derive values from, and an optional default value. @@ -207 +221 @@ GroupingAttributeDefinitions -> (list) ->>> The name of the grouping attribute, such as “Environment”, “Team”, or “Application”. +>>> The friendly name for this grouping attribute, such as `BusinessUnit` or `Environment` . This name is used to identify the grouping in the console and APIs. @@ -219 +233 @@ GroupingAttributeDefinitions -> (list) ->>> An array of source attribute keys that will be used to determine the grouping value for each service. These keys correspond to service metadata or tags. +>>> An array of source keys used to derive the grouping attribute value from telemetry data, Amazon Web Services tags, or other sources. For example, [“business_unit”, “team”] would look for values in those fields. @@ -233 +247 @@ GroupingAttributeDefinitions -> (list) ->>> The default value to use for grouping when a service doesn’t have any of the specified source keys, such as “Unknown” or “Unassigned”. +>>> The default value to use for this grouping attribute when no value can be derived from the source keys. This ensures all services have a grouping value even if the source data is missing. @@ -245 +259 @@ UpdatedAt -> (timestamp) -> The timestamp when the grouping attribute definitions were last updated. Expressed as the number of milliseconds since January 1, 1970, 00:00:00 UTC. +> 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. @@ -249 +263 @@ NextToken -> (string) -> The token to use for retrieving the next page of results. This value is present only if there are more results available than were returned in the current response. +> Include this value in your next use of this API to get the next set of grouping attribute definitions. @@ -251 +265 @@ NextToken -> (string) - * [← list-audit-findings](list-audit-findings.html "previous chapter \(use the left arrow\)") / + * [← list-entity-events](list-entity-events.html "previous chapter \(use the left arrow\)") / @@ -260,2 +274,2 @@ NextToken -> (string) - * [previous](list-audit-findings.html "list-audit-findings") | - * [AWS CLI 2.31.39 Command Reference](../../index.html) » + * [previous](list-entity-events.html "list-entity-events") | + * [AWS CLI 2.32.3 Command Reference](../../index.html) »