PutAggregationAuthorization - AWS Config


Authorizes the aggregator account and region to collect data from the source account and region.


PutAggregationAuthorization is an idempotent API. Subsequent requests won’t create a duplicate resource if one was already created. If a following request has different tags values, AWS Config will ignore these differences and treat it as an idempotent request of the previous. In this case, tags will not be updated, even if they are different.

Request Syntax

{ "AuthorizedAccountId": "string", "AuthorizedAwsRegion": "string", "Tags": [ { "Key": "string", "Value": "string" } ] }

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.


The 12-digit account ID of the account authorized to aggregate data.

Type: String

Pattern: \d{12}

Required: Yes


The region authorized to collect aggregated data.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Required: Yes


An array of tag object.

Type: Array of Tag objects

Array Members: Minimum number of 0 items. Maximum number of 50 items.

Required: No

Response Syntax

{ "AggregationAuthorization": { "AggregationAuthorizationArn": "string", "AuthorizedAccountId": "string", "AuthorizedAwsRegion": "string", "CreationTime": 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.


Returns an AggregationAuthorization object.

Type: AggregationAuthorization object


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


One or more of the specified parameters are not valid. Verify that your parameters are valid and try again.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: