GetFindingAggregator - AWS Security Hub


Returns the current finding aggregation configuration.

Request Syntax

GET /findingAggregator/get/FindingAggregatorArn+ HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.


The ARN of the finding aggregator to return details for. To obtain the ARN, use ListFindingAggregators.

Pattern: .*\S.*

Required: Yes

Request Body

The request does not have a request body.

Response Syntax

HTTP/1.1 200 Content-type: application/json { "FindingAggregationRegion": "string", "FindingAggregatorArn": "string", "RegionLinkingMode": "string", "Regions": [ "string" ] }

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.


The aggregation Region.

Type: String

Pattern: .*\S.*


The ARN of the finding aggregator.

Type: String

Pattern: .*\S.*


Indicates whether to link all Regions, all Regions except for a list of excluded Regions, or a list of included Regions.

Type: String

Pattern: .*\S.*


The list of excluded Regions or included Regions.

Type: Array of strings

Pattern: .*\S.*


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


You don't have permission to perform the action specified in the request.

HTTP Status Code: 403


Internal server error.

HTTP Status Code: 500


The account doesn't have permission to perform this action.

HTTP Status Code: 401


The request was rejected because you supplied an invalid or out-of-range value for an input parameter.

HTTP Status Code: 400


The request was rejected because it attempted to create resources beyond the current AWS account or throttling limits. The error code describes the limit exceeded.

HTTP Status Code: 429


The request was rejected because we can't find the specified resource.

HTTP Status Code: 404

See Also

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