AWS Security Hub Security Hub Aggregatorv2 API
The Security Hub Aggregatorv2 API from AWS Security Hub — 5 operation(s) for security hub aggregatorv2.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/aws-security-hub:aws-security-hub-aggregatorv2-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: AWS SecurityHub Aggregatorv2 API
version: '2018-10-26'
description: Generated from AWS's published Smithy model for AWS SecurityHub. 5 operation(s).
contact:
name: Amazon Web Services
url: https://aws.amazon.com/contact-us/
license:
name: Apache 2.0
identifier: Apache-2.0
url: https://github.com/aws/api-models-aws/blob/main/LICENSE
servers:
- url: https://securityhub.{region}.amazonaws.com
variables:
region:
default: us-east-1
security:
- sigv4: []
tags:
- name: Aggregatorv2
paths:
/aggregatorv2/create:
post:
operationId: CreateAggregatorV2
summary: Create Aggregator V2
description: Enables aggregation across Amazon Web Services Regions.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/CreateAggregatorV2Response'
'403':
description: AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException'
'409':
description: ConflictException
content:
application/json:
schema:
$ref: '#/components/schemas/ConflictException'
'500':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
'404':
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceNotFoundException'
'402':
description: ServiceQuotaExceededException
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceQuotaExceededException'
'429':
description: ThrottlingException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
'400':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateAggregatorV2Request'
tags:
- Aggregatorv2
/aggregatorv2/delete/{AggregatorV2Arn+}:
delete:
operationId: DeleteAggregatorV2
summary: Delete Aggregator V2
description: Deletes the Aggregator V2.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteAggregatorV2Response'
'403':
description: AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException'
'409':
description: ConflictException
content:
application/json:
schema:
$ref: '#/components/schemas/ConflictException'
'500':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
'404':
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceNotFoundException'
'429':
description: ThrottlingException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
'400':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteAggregatorV2Request'
tags:
- Aggregatorv2
/aggregatorv2/get/{AggregatorV2Arn+}:
get:
operationId: GetAggregatorV2
summary: Get Aggregator V2
description: Returns the configuration of the specified Aggregator V2.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/GetAggregatorV2Response'
'403':
description: AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException'
'409':
description: ConflictException
content:
application/json:
schema:
$ref: '#/components/schemas/ConflictException'
'500':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
'404':
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceNotFoundException'
'429':
description: ThrottlingException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
'400':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/GetAggregatorV2Request'
tags:
- Aggregatorv2
/aggregatorv2/list:
get:
operationId: ListAggregatorsV2
summary: List Aggregators V2
description: Retrieves a list of V2 aggregators.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/ListAggregatorsV2Response'
'403':
description: AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException'
'409':
description: ConflictException
content:
application/json:
schema:
$ref: '#/components/schemas/ConflictException'
'500':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
'404':
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceNotFoundException'
'429':
description: ThrottlingException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
'400':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ListAggregatorsV2Request'
tags:
- Aggregatorv2
/aggregatorv2/update/{AggregatorV2Arn+}:
patch:
operationId: UpdateAggregatorV2
summary: Update Aggregator V2
description: Udpates the configuration for the Aggregator V2.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateAggregatorV2Response'
'403':
description: AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException'
'409':
description: ConflictException
content:
application/json:
schema:
$ref: '#/components/schemas/ConflictException'
'500':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
'404':
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceNotFoundException'
'429':
description: ThrottlingException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
'400':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateAggregatorV2Request'
tags:
- Aggregatorv2
components:
schemas:
ValidationException:
type: object
properties:
Message:
type: string
Code:
type: string
DeleteAggregatorV2Request:
type: object
properties:
AggregatorV2Arn:
type: string
description: The ARN of the Aggregator V2.
required:
- AggregatorV2Arn
UpdateAggregatorV2Request:
type: object
properties:
AggregatorV2Arn:
type: string
description: The ARN of the Aggregator V2.
RegionLinkingMode:
type: string
description: Determines how Amazon Web Services Regions should be linked to the Aggregator V2.
LinkedRegions:
type: array
items:
type: string
description: A list of Amazon Web Services Regions linked to the aggegation Region.
required:
- AggregatorV2Arn
- RegionLinkingMode
GetAggregatorV2Request:
type: object
properties:
AggregatorV2Arn:
type: string
description: The ARN of the Aggregator V2.
required:
- AggregatorV2Arn
CreateAggregatorV2Request:
type: object
properties:
RegionLinkingMode:
type: string
description: Determines how Regions are linked to an Aggregator V2.
LinkedRegions:
type: array
items:
type: string
description: The list of Regions that are linked to the aggregation Region.
Tags:
type: object
additionalProperties:
type: string
description: A list of key-value pairs to be applied to the AggregatorV2.
ClientToken:
type: string
description: A unique identifier used to ensure idempotency.
required:
- RegionLinkingMode
ListAggregatorsV2Response:
type: object
properties:
AggregatorsV2:
type: array
items:
$ref: '#/components/schemas/AggregatorV2'
description: An array of aggregators.
NextToken:
type: string
description: The pagination token to use to request the next page of results. Otherwise, this parameter is null.
InternalServerException:
type: object
properties:
Message:
type: string
Code:
type: string
DeleteAggregatorV2Response:
type: object
properties: {}
ConflictException:
type: object
properties:
Message:
type: string
Code:
type: string
ResourceNotFoundException:
type: object
properties:
Message:
type: string
Code:
type: string
ThrottlingException:
type: object
properties:
Message:
type: string
Code:
type: string
AggregatorV2:
type: object
properties:
AggregatorV2Arn:
type: string
description: The ARN of the aggregatorV2.
CreateAggregatorV2Response:
type: object
properties:
AggregatorV2Arn:
type: string
description: The ARN of the AggregatorV2.
AggregationRegion:
type: string
description: The Amazon Web Services Region where data is aggregated.
RegionLinkingMode:
type: string
description: Determines how Regions are linked to an Aggregator V2.
LinkedRegions:
type: array
items:
type: string
description: The list of Regions that are linked to the aggregation Region.
GetAggregatorV2Response:
type: object
properties:
AggregatorV2Arn:
type: string
description: The ARN of the Aggregator V2.
AggregationRegion:
type: string
description: The Amazon Web Services Region where data is aggregated.
RegionLinkingMode:
type: string
description: Determines how Regions are linked to an Aggregator V2.
LinkedRegions:
type: array
items:
type: string
description: The list of Regions that are linked to the aggregation Region.
ServiceQuotaExceededException:
type: object
properties:
Message:
type: string
Code:
type: string
AccessDeniedException:
type: object
properties:
Message:
type: string
Code:
type: string
ListAggregatorsV2Request:
type: object
properties:
NextToken:
type: string
description: The token required for pagination. On your first call, set the value of this parameter to NULL. For subsequent calls, to continue listing data, set the value of this parameter to the value returned in the previous response.
MaxResults:
type: integer
description: The maximum number of results to return.
UpdateAggregatorV2Response:
type: object
properties:
AggregatorV2Arn:
type: string
description: The ARN of the Aggregator V2.
AggregationRegion:
type: string
description: The Amazon Web Services Region where data is aggregated.
RegionLinkingMode:
type: string
description: Determines how Amazon Web Services Regions should be linked to the Aggregator V2.
LinkedRegions:
type: array
items:
type: string
description: A list of Amazon Web Services Regions linked to the aggegation Region.
securitySchemes:
sigv4:
type: apiKey
in: header
name: Authorization
description: AWS Signature Version 4. The Authorization header carries an AWS4-HMAC-SHA256 signature over the canonical request, with X-Amz-Date (and X-Amz-Security-Token for temporary credentials). Not a bearer token.
x-aws-sigv4:
signingName: securityhub
x-provenance:
method: harvested
publisher: Amazon Web Services
source: https://raw.githubusercontent.com/aws/api-models-aws/582e55931c45b944739742a2c1620b6026dd2d13/models/securityhub/service/2018-10-26/securityhub-2018-10-26.json
note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)