Request Syntax Request Parameters Response Syntax Response Elements Errors See Also

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

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