Querying a Direct Connect Endpoint Group

Function

This API is used to query a Direct Connect endpoint group.

URI

GET /v2.0/dcaas/dc-endpoint-groups/{endpoint_group_id}

Table 1 Parameter description

Parameter

Type

Mandatory

Description

endpoint_group_id

String

Yes

Specifies the ID of the Direct Connect endpoint group.

Request

Table 2 lists the request parameter.

Table 2 Request parameter

Parameter

Type

Mandatory

Description

endpoint_group_id

String

Yes

Specifies the ID of the Direct Connect endpoint group.

Response

Table 3 lists the response parameter.

Table 3 Response parameter

Parameter

Type

Description

dc_endpoint_group

Dictionary

Specifies the dc_endpoint_group object.

Table 4 Description of field dc_endpoint_group

Parameter

Type

Description

id

String

Specifies the ID of the Direct Connect endpoint group.

tenant_id

String

Specifies the project ID.

name

String

Specifies the name of the Direct Connect endpoint group.

description

String

Provides supplementary information about the Direct Connect endpoint group.

endpoints

List<String>

Specifies the list of the endpoints in a Direct Connect endpoint group.

type

String

Specifies the type of the Direct Connect endpoints. The value can only be cidr.

Only IPv4 CIDR blocks are supported.

Examples

  • Example request

    GET /v2.0/dcaas/dc-endpoint-groups/{endpoint_group_id}
    
  • Example response

    {
        "dc_endpoint_group" : {
             "id" : "6ecd9cf3-ca64-46c7-863f-f2eb1b9e838a",
             "tenant_id" : "6fbe9263116a4b68818cf1edce16bc4f",
             "name" : "endpoint group1",
             "description" : "",
             "endpoints" : [ "10.2.0.0/24", "10.3.0.0/24" ],
             "type" : "cidr"
        }
    }
    

Status Codes

For details, see Common Status Codes.