Function

This API is used to query details about a VPN service.

URI

GET /v2.0/vpn/vpnservices/{service_id}

**Table 1** Parameter description
Parameter	Type	Mandatory	Description
service_id	String	Yes	Specifies the VPN service ID.

Request

None

Response

Table 2 describes the response parameters.

**Table 2** Response parameters
Parameter	Type	Description
status	String	Specifies whether the VPN service is operational. The value can be ACTIVE, DOWN, BUILD, ERROR, PENDING_CREATE, PENDING_UPDATE, or PENDING_DELETE.
router_id	String	Specifies the router ID.
name	String	Specifies the VPN service name.
external_v6_ip	String	Specifies the IPv6 address of the VPN service external gateway.
admin_state_up	Boolean	Specifies the administrative status, which can be true or false.
subnet_id	String	Specifies the subnet ID.
tenant_id	String	Specifies the project ID.
external_v4_ip	String	Specifies the IPv4 address of the VPN service external gateway.
id	String	Specifies the VPN service ID.
description	String	Provides supplementary information about the VPN service.
order_id	String	Specifies the ID of a yearly/monthly order. This parameter is only available to yearly/monthly VPNs.
product_id	String	Specifies the ID of a product that is billed on a yearly/monthly basis. This parameter is only available to yearly/monthly VPNs.
prepay_connection_num	Integer	Specifies the number of connections of the yearly/monthly VPN service. This parameter is only available to yearly/monthly VPNs.
resource_speccode	String	Specifies the specifications of the product that is billed on a yearly/monthly basis. This parameter is only available to yearly/monthly VPNs.
created_at	String	Specifies the time when the VPN service was created. The time is in YYYY-mm-dd HH:MM:SS.ffffff format.
tags	List<Object>	Specifies the tags.
vpnservice	Object	Specifies the VPN service object.

Example

Example request
```
GET /v2.0/vpn/vpnservices/{service_id}
```

Example response

{
    "vpnservice": {
        "router_id": "66e3b16c-8ce5-40fb-bb49-ab6d8dc3f2aa",
        "status": "PENDING_CREATE",
        "name": "myservice",
        "external_v6_ip": "2001:db8::1",
        "admin_state_up": true,
        "subnet_id": null,
        "tenant_id": "10039663455a446d8ba2cbb058b0f578",
        "external_v4_ip": "172.32.1.11",
        "id": "5c561d9d-eaea-45f6-ae3e-08d1a7080828",
        "description": "",
        "product_id": "",
        "order_id": "",
        "created_at": "2020-08-05 12:36:35.921257",
        "prepay_connection_num": 0,
        "tags": [],
        "resource_speccode": ""
    }
}

Returned Values

For details, see Common Returned Values.

Querying Details About a VPN Service

Function

URI

Request

Response

Example

Returned Values