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>
14 KiB
Creating a VPC Route
Function
This API is used to create a route.
URI
POST /v2.0/vpc/routes
Request Parameters
Parameter |
Type |
Mandatory |
Description |
---|---|---|---|
route |
route object |
Yes |
Specifies the route. For details, see Table 2. |
Attribute |
Type |
Mandatory |
Description |
---|---|---|---|
destination |
String |
Yes |
Specifies the destination address in the CIDR notation format, for example, 192.168.200.0/24. Both IPv4 and IPv6 addresses are supported. |
nexthop |
String |
Yes |
Specifies the next hop. If the route type is peering, enter the VPC peering connection ID. |
type |
String |
Yes |
Specifies the route type. Currently, only the peering type is supported, that is, the next hop is a VPC peering connection. |
vpc_id |
String |
Yes |
Specifies the ID of the VPC ID requesting for creating a route. |
Example Request
- Create a route in the route table of the VPC whose ID is ab78be2d-782f-42a5-aa72-35879f6890ff for the VPC peering connection. The next hop is the peering connection whose ID is 60c809cb-6731-45d0-ace8-3bf5626421a9, and the destination is 192.168.200.0/24.
POST https://{Endpoint}/v2.0/vpc/routes { "route": { "type": "peering", "nexthop": "60c809cb-6731-45d0-ace8-3bf5626421a9", "destination": "192.168.200.0/24", "vpc_id": "ab78be2d-782f-42a5-aa72-35879f6890ff" } }
Response Parameters
Parameter |
Type |
Description |
---|---|---|
route |
route object |
Specifies the route. For details, see Table 4. |
Attribute |
Type |
Description |
---|---|---|
id |
String |
Specifies the route ID. |
destination |
String |
Specifies the destination address in the CIDR notation format, for example, 192.168.200.0/24. |
nexthop |
String |
Specifies the next hop. If the route type is peering, enter the VPC peering connection ID. |
type |
String |
Specifies the route type. Currently, the value can only be peering. |
vpc_id |
String |
Specifies the VPC of the route. Set this parameter to the existing VPC ID. |
tenant_id |
String |
Specifies the project ID. |
Example Response
{ "route": { "type": "peering", "nexthop": "60c809cb-6731-45d0-ace8-3bf5626421a9", "destination": "192.168.200.0/24", "vpc_id": "ab78be2d-782f-42a5-aa72-35879f6890ff", "tenant_id": "6fbe9263116a4b68818cf1edce16bc4f", "id": "3d42a0d4-a980-4613-ae76-a2cddecff054" } }
Status Code
See Status Codes.
Error Code
See Error Codes.