ListConnectionGroups
Lists the connection groups in your Amazon Web Services account.
Request Syntax
POST /2020-05-31/connection-groups HTTP/1.1
<?xml version="1.0" encoding="UTF-8"?>
<ListConnectionGroupsRequest xmlns="http://cloudfront.amazonaws.com/doc/2020-05-31/">
<AssociationFilter>
<AnycastIpListId>string</AnycastIpListId>
</AssociationFilter>
<Marker>string</Marker>
<MaxItems>integer</MaxItems>
</ListConnectionGroupsRequest>URI Request Parameters
The request does not use any URI parameters.
Request Body
The request accepts the following data in XML format.
- ListConnectionGroupsRequest
-
Root level tag for the ListConnectionGroupsRequest parameters.
Required: Yes
- AssociationFilter
-
Filter by associated Anycast IP list ID.
Type: ConnectionGroupAssociationFilter object
Required: No
- Marker
-
The marker for the next set of connection groups to retrieve.
Type: String
Required: No
- MaxItems
-
The maximum number of connection groups to return.
Type: Integer
Required: No
Response Syntax
HTTP/1.1 200
<?xml version="1.0" encoding="UTF-8"?>
<ListConnectionGroupsResult>
<ConnectionGroups>
<ConnectionGroupSummary>
<AnycastIpListId>string</AnycastIpListId>
<Arn>string</Arn>
<CreatedTime>timestamp</CreatedTime>
<Enabled>boolean</Enabled>
<ETag>string</ETag>
<Id>string</Id>
<IsDefault>boolean</IsDefault>
<LastModifiedTime>timestamp</LastModifiedTime>
<Name>string</Name>
<RoutingEndpoint>string</RoutingEndpoint>
<Status>string</Status>
</ConnectionGroupSummary>
</ConnectionGroups>
<NextMarker>string</NextMarker>
</ListConnectionGroupsResult>Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in XML format by the service.
- ListConnectionGroupsResult
-
Root level tag for the ListConnectionGroupsResult parameters.
Required: Yes
- ConnectionGroups
-
The list of connection groups that you retrieved.
Type: Array of ConnectionGroupSummary objects
- NextMarker
-
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.
Type: String
Errors
For information about the errors that are common to all actions, see Common Errors.
- AccessDenied
-
Access denied.
HTTP Status Code: 403
- EntityNotFound
-
The entity was not found.
HTTP Status Code: 404
- InvalidArgument
-
An argument is invalid.
HTTP Status Code: 400
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: