doc-exports/docs/dc/api-ref/en-us_topic_0055025323.html
Qin Ying, Fan 62ab8a5fe2 DC API 20231101 version
Reviewed-by: Sarda, Priya <prsarda@noreply.gitea.eco.tsi-dev.otc-service.com>
Co-authored-by: Qin Ying, Fan <fanqinying@huawei.com>
Co-committed-by: Qin Ying, Fan <fanqinying@huawei.com>
2024-03-11 15:10:40 +00:00

7.1 KiB

Querying the Virtual Gateway List

Function

This API is used to query the virtual gateway list.

URI

GET /v2.0/dcaas/virtual-gateways

Request

Table 1 lists the request parameter.

Table 1 Request parameter

Parameter

Type

Mandatory

Description

fields

String

No

Specifies the parameters expected to be returned.

If you do not specify it, all parameters will be returned.

Response

Table 2 lists the response parameter.

Table 2 Response parameter

Parameter

Type

Description

virtual_gateways

List

Specifies the virtual gateway list.

For details about the virtual_gateway field, see Table 1.

Examples

  • Example request
    1. Querying all virtual gateways
    GET /v2.0/dcaas/virtual-gateways
    1. Querying a virtual gateway by ID
    GET /v2.0/dcaas/virtual-gateways?id=7ec892f3-ca64-46c7-863f-a2eb1b9e8389
  • Example response
    { 
        "virtual_gateways" : [{ 
                "id": "0a0888a6-4096-43a6-81c6-923912933451",
                "name": "virtual gateway",
                "description": null,
                "tenant_id": "0605768a3300d5762f82c01180692873",
                "vpc_id": "5352423b-b4ff-4a9e-839d-02698c2b36af",
                "local_ep_group_id": "f8834cf1-5468-87c7-223d-56e78b9699ab",
                "local_ep_group_ipv6_id": null,
                "device_id": "aaa_01",
                "redundant_device_id": null,
                "type": "default",
                "ipsec_bandwidth": 1,
                "status": "PENDING_CREATE",
                "admin_state_up": true,
                "bgp_asn": 64512,
                "region_id": null
        }] 
    }

Status Codes

For details, see Common Status Codes.