Querying VPC Channel Details

Function

This API is used to query the details of a specified VPC channel.

URI

The following table lists the HTTP/HTTPS request method and URI of the API.

**Table 1** HTTP/HTTPS request method and URI
Request Method	URI
GET	/v1.0/apigw/vpc-channels/{id}

The following table lists the parameter in the URI.

**Table 2** Parameter description
Parameter	Mandatory	Type	Description
id	Yes	String	VPC channel ID

Request

N/A

Response

**Table 3** Parameter description
Parameter	Type	Description
id	String	VPC channel ID
name	String	VPC channel name
type	Integer	VPC channel type, which can be: 2: fast channel with the load balancing function
member_type	String	Member type of the VPC channel, which can be: ip (not supported currently) instance
status	Integer	VPC channel status, which can be: 1: normal 2: abnormal
port	Integer	Host port of the VPC channel
balance_strategy	Integer	Distribution algorithm, which can be: 1: WRR 2: WLC 3: SH 4: URI hashing
create_time	Timestamp	Time when the VPC channel is created
vpc_health_config	Dictionary	Health check details
vpc_instances	Dictionary	Backend instance list

**Table 4** Health check details
Parameter	Type	Description
id	String	Health check ID
vpc_id	String	VPC channel ID
protocol	String	Protocol for performing health checks on cloud servers in the VPC channel. The value can be: TCP HTTP HTTPS
path	String	Destination path for health checks NOTE: The value of this parameter must comply with URI specifications.
port	Integer	Destination port for health checks. By default, the host port of the VPC channel is used. Range: 1–65535
threshold_normal	Integer	Healthy threshold It refers to the number (x) of consecutive successful checks required for a cloud server to be marked as healthy. Range: 2–10
threshold_abnormal	Integer	Unhealthy threshold It refers to the number (x) of consecutive failed checks required for a cloud server to be marked as unhealthy. Range: 2–10
time_out	Integer	Timeout for determining whether a health check fails. Unit: s. The value must be less than the value of time_interval. Range: 2–30
time_interval	Integer	Interval between consecutive checks. Unit: s. The value must be greater than the value of time_out. Range: 5–300
http_code	String	HTTP response codes for determining a successful HTTP response The value can be any integer within 100–599 in one of the following formats: Multiple values, for example, 200,201,202 Range, for example, 200-299 Multiple values and ranges, for example, 201,202,210-299
create_time	Timestamp	Time when the VPC channel is created

**Table 5** Backend instance details
Parameter	Type	Description
id	String	Backend instance object ID
vpc_id	String	VPC channel ID
status	Integer	Status of the backend instance object
instance_name	String	Backend instance name
instance_id	String	Backend instance ID
host	String	IP address of the backend instance
weight	Integer	Cloud server weight The larger the weight is, the more requests are forwarded to the backend instance. Range: 1–100
create_time	Timestamp	Time when the backend instance is added to the VPC channel

Example response:

{
  "name": "vpc_001",
  "type": 2,
  "member_type": "instance",
  "port": 15565,
  "balance_strategy": 1,
  "id": "c3e6a7d85d9e47be89dfcc3cd37405d7",
  "create_time": "2018-07-27T12:30:48Z",
  "status": 1,
  "vpc_health_config": {
    "protocol": "http",
    "path": "/hc",
    "port": 15563,
    "threshold_normal": 5,
    "threshold_abnormal": 5,
    "time_out": 30,
    "time_interval": 200,
    "http_code": "205",
    "id": "f26c1b158f2e40f2b531cf5c1b5e05e5",
    "vpc_id": "c3e6a7d85d9e47be89dfcc3cd37405d7",
    "create_time": "2018-07-27T12:30:48Z"
  },
  "vpc_instances": [
    {
      "instance_id": "instance01",
      "instance_name": "instance_name01",
      "host": "127.0.0.1",
      "weight": 10,
      "id": "c3bc73605a8b400793363c87574fbad7",
      "vpc_id": "c3e6a7d85d9e47be89dfcc3cd37405d7",
      "status": 1,
      "create_time": "2018-07-27T12:30:48Z"
    }
  ]
}