PutAggregationAuthorization
Authorizes the aggregator account and region to collect data from the source account and region.
Note
Tags are added at creation and cannot be updated with this operation
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.
Use TagResource and UntagResource to update tags after creation.
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.
- AuthorizedAccountId
-
The 12-digit account ID of the account authorized to aggregate data.
Type: String
Length Constraints: Fixed length of 12.
Pattern:
\d{12}Required: Yes
- AuthorizedAwsRegion
-
The region authorized to collect aggregated data.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 64.
Required: Yes
- Tags
-
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.
- AggregationAuthorization
-
Returns an AggregationAuthorization object.
Type: AggregationAuthorization object
Errors
For information about the errors that are common to all actions, see Common Errors.
- InvalidParameterValueException
-
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:
