Creating a Static Route

Function

This API is used to create a static route. Static routes are manually created, and valid routes are preferred routes.

Constraints

If is_blackhole is set to false, the attachment_id parameter must be passed. If is_blackhole is set to true, the attachment_id parameter cannot be passed.

Calling Method

For details, see Calling APIs.

URI

POST /v3/{project_id}/enterprise-router/route-tables/{route_table_id}/static-routes

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID
route_table_id	Yes	String	Route table ID

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Client-Token	No	String	Idempotence identifier Minimum: 1 Maximum: 64

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
route	Yes	CreateRoute object	Request body for creating a route

**Table 4** CreateRoute
Parameter	Mandatory	Type	Description
destination	Yes	String	Destination address of a route Minimum: 0 Maximum: 256
attachment_id	No	String	ID of the attachment that the next hop of the route points to
is_blackhole	No	Boolean	Whether the route is a blackhole route. The default value is false.

Response Parameters

Status code: 202

**Table 5** Response header parameters
Parameter	Type	Description
X-Client-Token	String	Idempotence identifier

**Table 6** Response body parameters
Parameter	Type	Description
route	Route object	Route
request_id	String	Request ID

**Table 7** Route
Parameter	Type	Description
id	String	Route ID
type	String	Route type. The value is static.
state	String	Route status. Value options: pending, available, modifying, deleting, deleted, and failed
is_blackhole	Boolean	Whether the route is a blackhole route
destination	String	Destination address of a route
attachments	Array of RouteAttachment objects	Next hops
route_table_id	String	Route table ID
created_at	String	Creation time in the format of YYYY-MM-DDTHH:mm:ss.sssZ
updated_at	String	Update time in the format of YYYY-MM-DDTHH:MM:SS

**Table 8** RouteAttachment
Parameter	Type	Description
resource_id	String	Attached resource ID
resource_type	String	Attachment type.
attachment_id	String	Attachment ID

Example Requests

Creating a static route (not a blackhole route) destined for 192.168.0.0/16 through the specified attachment

POST https://{erouter_endpoint}/v3/08d5a9564a704afda6039ae2babbef3c/enterprise-router/route-tables/0d1748a0-5188-11e5-b86f-a51b5f125b84/static-routes

{
  "route" : {
    "destination" : "192.168.0.0/16",
    "is_blackhole" : false,
    "attachment_id" : "b70aee08-c671-4cad-9fd5-7381d163bcc8"
  }
}

Example Responses

Status code: 202

Accepted

{
  "route" : {
    "id" : "9b3b38a9-1c9d-4f01-9429-81af6b545289",
    "type" : "static",
    "destination" : "192.168.0.0/16",
    "description" : "static route",
    "attachments" : [ {
      "resource_id" : "9c4ab06a-0ab4-4fad-93a8-f733f3a4433d",
      "resource_type" : "vpc",
      "attachment_id" : "b70aee08-c671-4cad-9fd5-7381d163bcc8"
    } ],
    "route_table_id" : "0d1748a0-5188-11e5-b86f-a51b5f125b84",
    "is_blackhole" : false,
    "state" : "pending",
    "created_at" : "2020-03-11T15:13:31Z",
    "updated_at" : "2020-03-11T15:13:31Z"
  },
  "request_id" : "915a14a6-867b-4af7-83d1-70efceb146f9"
}