Request Syntax URI Request Parameters Request Body Response Syntax Response Elements Errors See Also

ListConnectionGroups

Lists the connection groups in your AWS account.

Request Syntax


POST /2020-05-31/connection-groups HTTP/1.1

<ListConnectionGroupsRequest xmlns="http://cloudfront.amazonaws.com/doc/2020-05-31/">
   <AssociationFilter>
      <AnycastIpListId>stringAnycastIpListId>
   AssociationFilter>
   <Marker>stringMarker>
   <MaxItems>integerMaxItems>
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

<ListConnectionGroupsResult>
   <ConnectionGroups>
      
         <AnycastIpListId>stringAnycastIpListId>
         <Arn>stringArn>
         <CreatedTime>timestampCreatedTime>
         <Enabled>booleanEnabled>
         <ETag>stringETag>
         <Id>stringId>
         <IsDefault>booleanIsDefault>
         <LastModifiedTime>timestampLastModifiedTime>
         <Name>stringName>
         <RoutingEndpoint>stringRoutingEndpoint>
         <Status>stringStatus>
      
   ConnectionGroups>
   <NextMarker>stringNextMarker>
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 Error Types.

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