CloudFront Connection Group API
The Connection Group API from CloudFront — 4 operation(s) for connection group.
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/cloudfront:cloudfront-connection-group-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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.1.0
info:
title: Amazon CloudFront Connection Group API
version: '2020-05-31'
description: Generated from AWS's published Smithy model for Amazon CloudFront. 6 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://cloudfront.{region}.amazonaws.com
variables:
region:
default: us-east-1
security:
- sigv4: []
paths:
/2020-05-31/connection-group:
post:
operationId: CreateConnectionGroup
summary: Create Connection Group
description: Creates a connection group.
responses:
'200':
description: Success
content:
text/xml:
schema:
$ref: '#/components/schemas/CreateConnectionGroupResult'
'403':
description: AccessDenied
content:
text/xml:
schema:
$ref: '#/components/schemas/AccessDenied'
'409':
description: EntityAlreadyExists
content:
text/xml:
schema:
$ref: '#/components/schemas/EntityAlreadyExists'
'400':
description: EntityLimitExceeded; InvalidArgument; InvalidTagging
content:
text/xml:
schema:
$ref: '#/components/schemas/EntityLimitExceeded'
'404':
description: EntityNotFound
content:
text/xml:
schema:
$ref: '#/components/schemas/EntityNotFound'
requestBody:
content:
application/xml:
schema:
$ref: '#/components/schemas/CreateConnectionGroupRequest'
tags:
- Connection Group
get:
operationId: GetConnectionGroupByRoutingEndpoint
summary: Get Connection Group By Routing Endpoint
description: Gets information about a connection group by using the endpoint that you specify.
responses:
'200':
description: Success
content:
text/xml:
schema:
$ref: '#/components/schemas/GetConnectionGroupByRoutingEndpointResult'
'403':
description: AccessDenied
content:
text/xml:
schema:
$ref: '#/components/schemas/AccessDenied'
'404':
description: EntityNotFound
content:
text/xml:
schema:
$ref: '#/components/schemas/EntityNotFound'
requestBody:
content:
application/xml:
schema:
$ref: '#/components/schemas/GetConnectionGroupByRoutingEndpointRequest'
tags:
- Connection Group
/2020-05-31/connection-group/{Id}:
delete:
operationId: DeleteConnectionGroup
summary: Delete Connection Group
description: Deletes a connection group.
responses:
'200':
description: Success
content:
text/xml:
schema:
type: string
'403':
description: AccessDenied
content:
text/xml:
schema:
$ref: '#/components/schemas/AccessDenied'
'409':
description: CannotDeleteEntityWhileInUse; ResourceNotDisabled
content:
text/xml:
schema:
$ref: '#/components/schemas/CannotDeleteEntityWhileInUse'
'404':
description: EntityNotFound
content:
text/xml:
schema:
$ref: '#/components/schemas/EntityNotFound'
'400':
description: InvalidIfMatchVersion
content:
text/xml:
schema:
$ref: '#/components/schemas/InvalidIfMatchVersion'
'412':
description: PreconditionFailed
content:
text/xml:
schema:
$ref: '#/components/schemas/PreconditionFailed'
requestBody:
content:
application/xml:
schema:
$ref: '#/components/schemas/DeleteConnectionGroupRequest'
tags:
- Connection Group
put:
operationId: UpdateConnectionGroup
summary: Update Connection Group
description: Updates a connection group.
responses:
'200':
description: Success
content:
text/xml:
schema:
$ref: '#/components/schemas/UpdateConnectionGroupResult'
'403':
description: AccessDenied
content:
text/xml:
schema:
$ref: '#/components/schemas/AccessDenied'
'409':
description: EntityAlreadyExists; ResourceInUse
content:
text/xml:
schema:
$ref: '#/components/schemas/EntityAlreadyExists'
'400':
description: EntityLimitExceeded; InvalidArgument; InvalidIfMatchVersion
content:
text/xml:
schema:
$ref: '#/components/schemas/EntityLimitExceeded'
'404':
description: EntityNotFound
content:
text/xml:
schema:
$ref: '#/components/schemas/EntityNotFound'
'412':
description: PreconditionFailed
content:
text/xml:
schema:
$ref: '#/components/schemas/PreconditionFailed'
requestBody:
content:
application/xml:
schema:
$ref: '#/components/schemas/UpdateConnectionGroupRequest'
tags:
- Connection Group
/2020-05-31/connection-group/{Identifier}:
get:
operationId: GetConnectionGroup
summary: Get Connection Group
description: Gets information about a connection group.
responses:
'200':
description: Success
content:
text/xml:
schema:
$ref: '#/components/schemas/GetConnectionGroupResult'
'403':
description: AccessDenied
content:
text/xml:
schema:
$ref: '#/components/schemas/AccessDenied'
'404':
description: EntityNotFound
content:
text/xml:
schema:
$ref: '#/components/schemas/EntityNotFound'
requestBody:
content:
application/xml:
schema:
$ref: '#/components/schemas/GetConnectionGroupRequest'
tags:
- Connection Group
/2020-05-31/connection-groups:
post:
operationId: ListConnectionGroups
summary: List Connection Groups
description: Lists the connection groups in your Amazon Web Services account.
responses:
'200':
description: Success
content:
text/xml:
schema:
$ref: '#/components/schemas/ListConnectionGroupsResult'
'403':
description: AccessDenied
content:
text/xml:
schema:
$ref: '#/components/schemas/AccessDenied'
'404':
description: EntityNotFound
content:
text/xml:
schema:
$ref: '#/components/schemas/EntityNotFound'
'400':
description: InvalidArgument
content:
text/xml:
schema:
$ref: '#/components/schemas/InvalidArgument'
requestBody:
content:
application/xml:
schema:
$ref: '#/components/schemas/ListConnectionGroupsRequest'
tags:
- Connection Group
components:
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: cloudfront
schemas:
AccessDenied:
type: object
properties:
Message:
type: string
CannotDeleteEntityWhileInUse:
type: object
properties:
Message:
type: string
ConnectionGroup:
type: object
properties:
Id:
type: string
description: The ID of the connection group.
Name:
type: string
description: The name of the connection group.
Arn:
type: string
description: The Amazon Resource Name (ARN) of the connection group.
CreatedTime:
type: string
format: date-time
description: The date and time when the connection group was created.
LastModifiedTime:
type: string
format: date-time
description: The date and time when the connection group was updated.
Tags:
$ref: '#/components/schemas/Tags'
Ipv6Enabled:
type: boolean
description: IPv6 is enabled for the connection group.
RoutingEndpoint:
type: string
description: The routing endpoint (also known as the DNS name) that is assigned to the connection group, such as
d111111abcdef8.cloudfront.net.
AnycastIpListId:
type: string
description: The ID of the Anycast static IP list.
Status:
type: string
description: The status of the connection group.
Enabled:
type: boolean
description: Whether the connection group is enabled.
IsDefault:
type: boolean
description: Whether the connection group is the default connection group for the distribution tenants.
ConnectionGroupAssociationFilter:
type: object
properties:
AnycastIpListId:
type: string
description: The ID of the Anycast static IP list.
ConnectionGroupSummary:
type: object
properties:
Id:
type: string
description: The ID of the connection group.
Name:
type: string
description: The name of the connection group.
Arn:
type: string
description: The Amazon Resource Name (ARN) of the connection group.
RoutingEndpoint:
type: string
description: The routing endpoint (also known as the DNS name) that is assigned to the connection group, such as
d111111abcdef8.cloudfront.net.
CreatedTime:
type: string
format: date-time
description: The date and time when the connection group was created.
LastModifiedTime:
type: string
format: date-time
description: The date and time when the connection group was updated.
ETag:
type: string
description: The current version of the connection group.
AnycastIpListId:
type: string
description: The ID of the Anycast static IP list.
Enabled:
type: boolean
description: Whether the connection group is enabled
Status:
type: string
description: The status of the connection group.
IsDefault:
type: boolean
description: Whether the connection group is the default connection group for the distribution tenants.
required:
- Id
- Name
- Arn
- RoutingEndpoint
- CreatedTime
- LastModifiedTime
- ETag
CreateConnectionGroupRequest:
type: object
properties:
Name:
type: string
description: The name of the connection group. Enter a friendly identifier that is unique within your Amazon Web
Services account. This name can't be updated after you create the connection group.
Ipv6Enabled:
type: boolean
description: Enable IPv6 for the connection group. The default is true. For more information, see Enable IPv6 in
the Amazon CloudFront Developer Guide.
Tags:
$ref: '#/components/schemas/Tags'
AnycastIpListId:
type: string
description: The ID of the Anycast static IP list.
Enabled:
type: boolean
description: Enable the connection group.
required:
- Name
CreateConnectionGroupResult:
type: object
properties:
ConnectionGroup:
$ref: '#/components/schemas/ConnectionGroup'
ETag:
type: string
description: The current version of the connection group.
DeleteConnectionGroupRequest:
type: object
properties:
Id:
type: string
description: The ID of the connection group to delete.
IfMatch:
type: string
description: The value of the ETag header that you received when retrieving the connection group to delete.
required:
- Id
- IfMatch
EntityAlreadyExists:
type: object
properties:
Message:
type: string
EntityLimitExceeded:
type: object
properties:
Message:
type: string
EntityNotFound:
type: object
properties:
Message:
type: string
GetConnectionGroupByRoutingEndpointRequest:
type: object
properties:
RoutingEndpoint:
type: string
description: The routing endpoint for the target connection group, such as d111111abcdef8.cloudfront.net.
required:
- RoutingEndpoint
GetConnectionGroupByRoutingEndpointResult:
type: object
properties:
ConnectionGroup:
$ref: '#/components/schemas/ConnectionGroup'
ETag:
type: string
description: The current version of the connection group.
GetConnectionGroupRequest:
type: object
properties:
Identifier:
type: string
description: The ID, name, or Amazon Resource Name (ARN) of the connection group.
required:
- Identifier
GetConnectionGroupResult:
type: object
properties:
ConnectionGroup:
$ref: '#/components/schemas/ConnectionGroup'
ETag:
type: string
description: The current version of the connection group.
InvalidArgument:
type: object
properties:
Message:
type: string
InvalidIfMatchVersion:
type: object
properties:
Message:
type: string
ListConnectionGroupsRequest:
type: object
properties:
AssociationFilter:
$ref: '#/components/schemas/ConnectionGroupAssociationFilter'
Marker:
type: string
description: The marker for the next set of connection groups to retrieve.
MaxItems:
type: integer
description: The maximum number of connection groups to return.
ListConnectionGroupsResult:
type: object
properties:
NextMarker:
type: string
description: A token used for pagination of results returned in the response. You can use the token from the previous
request to define where the current request should begin.
ConnectionGroups:
type: array
items:
$ref: '#/components/schemas/ConnectionGroupSummary'
description: The list of connection groups that you retrieved.
PreconditionFailed:
type: object
properties:
Message:
type: string
Tag:
type: object
properties:
Key:
type: string
description: 'A string that contains Tag key. The string length should be between 1 and 128 characters. Valid characters
include a-z, A-Z, 0-9, space, and the special characters _ - . : / = + @.'
Value:
type: string
description: 'A string that contains an optional Tag value. The string length should be between 0 and 256 characters.
Valid characters include a-z, A-Z, 0-9, space, and the special characters _ - . : / = + @.'
required:
- Key
Tags:
type: object
properties:
Items:
type: array
items:
$ref: '#/components/schemas/Tag'
description: A complex type that contains Tag elements.
UpdateConnectionGroupRequest:
type: object
properties:
Id:
type: string
description: The ID of the connection group.
Ipv6Enabled:
type: boolean
description: Enable IPv6 for the connection group. For more information, see Enable IPv6 in the Amazon CloudFront
Developer Guide.
IfMatch:
type: string
description: The value of the ETag header that you received when retrieving the connection group that you're updating.
AnycastIpListId:
type: string
description: The ID of the Anycast static IP list.
Enabled:
type: boolean
description: Whether the connection group is enabled.
required:
- Id
- IfMatch
UpdateConnectionGroupResult:
type: object
properties:
ConnectionGroup:
$ref: '#/components/schemas/ConnectionGroup'
ETag:
type: string
description: The current version of the connection group.
x-provenance:
method: harvested
publisher: Amazon Web Services
source: https://raw.githubusercontent.com/aws/api-models-aws/582e55931c45b944739742a2c1620b6026dd2d13/models/cloudfront/service/2020-05-31/cloudfront-2020-05-31.json
note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)