Enables or modifies the health check configuration for a virtual border router (VBR).

Usage notes

You can configure the health check feature for a VBR to monitor the physical connections between your data center and Alibaba Cloud. This helps detect connection issues in a timely manner.

Before you use the health check feature, take note of the following information:

  • If your VBR uses static routing, you must add a static route for the data center that is connected to the VBR after you configure the health check feature.

    You must configure the static route as follows: set the destination CIDR block to the source IP address of health checks, set the mask length to 32, and set the next hop to the IP address of the VBR on the Alibaba Cloud side.

  • If your VBR uses dynamic Border Gateway Protocol (BGP) routing, you do not need to add routes for the data center.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String No EnableCenVbrHealthCheck

The operation that you want to perform. Set the value to EnableCenVbrHealthCheck.

CenId String Yes cen-hahhfskfkseig****

The ID of the Cloud Enterprise Network (CEN) instance.

HealthCheckSourceIp String Yes 192.XX.XX.1

The source IP address of the health check. You can set the source IP address in the following ways:

  • Automatic IP Address (recommended): The system automatically assigns an IP address from the 100.96.0.0/16 CIDR block.
  • Custom IP Address: You can specify an idle IP address that belongs to the 10.0.0.0/8, 192.168.0.0/16, or 172.16.0.0/12 CIDR block. The specified IP address must not conflict with the IP address of the VBR on the Alibaba Cloud side, the IP address of the VBR on the customer side, or other IP addresses with which the VBR communicates through the CEN instance.
HealthCheckTargetIp String Yes 10.XX.XX.1

The destination IP address of the health check.

Set the destination IP address to the IP address of the VBR on the customer side.

VbrInstanceId String Yes vbr-wz95o9aylj181n5mzk****

The ID of the VBR.

VbrInstanceRegionId String Yes cn-shenzhen

The ID of the region where the VBR is deployed.

You can call the DescribeChildInstanceRegions operation to query the most recent region list.

VbrInstanceOwnerId Long No 1688000000000000

The ID of the Alibaba Cloud account that owns the VBR.

Note The parameter is required if the VBR and the CEN instance belong to different Alibaba Cloud accounts.
HealthCheckInterval Integer No 2

The time interval at which probe packets are sent during the health check.

Default value: 2. Valid values: 2 to 3.

Unit: seconds.

HealthyThreshold Integer No 8

The number of probe packets that are sent during the health check.

Default value: 8. Valid values: 3 to 8.

Unit: packets.

Response parameters

Parameter Type Example Description
RequestId String 1F59F19C-EFD2-40B1-94D5-65B40CA8E34A

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/?Action=EnableCenVbrHealthCheck
&CenId=cen-hahhfskfkseig****
&HealthCheckSourceIp=192.XX.XX.1
&HealthCheckTargetIp=10.XX.XX.1
&VbrInstanceId=vbr-wz95o9aylj181n5mzk****
&VbrInstanceRegionId=cn-shenzhen
&<Common request parameters>

Sample success responses

XML format

<EnableCenVbrHealthCheckResponse>
  <RequestId>1F59F19C-EFD2-40B1-94D5-65B40CA8E34A</RequestId>
</EnableCenVbrHealthCheckResponse>

JSON format

{
    "RequestId": "1F59F19C-EFD2-40B1-94D5-65B40CA8E34A"
}

Error codes

HttpCode Error code Error message Description
400 RouteConflict The specified route already exists. The error message returned because the specified route already exists.
400 Illegal.SourceIpOrTargetIp The specified source IP address or destination IP address is invalid. The error message returned because the specified source or destination IP address is invalid.

For a list of error codes, visit the API Error Center.