Help Center/ Cloud Connect/ API Reference/ API/ Central Networks/ Adding a Central Network Policy

Updated on 2025-07-29 GMT+08:00

View PDF

Adding a Central Network Policy

Function

This API is used to add a central network policy. A policy cannot be modified. If the policy cannot meet your requirements, you need to add a new policy.

URI

POST /v3/{domain_id}/gcn/central-network/{central_network_id}/policies

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
domain_id	Yes	String	Account ID.
central_network_id	Yes	String	Central network ID.

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	No	String	User token.

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
central_network_policy_document	Yes	CentralNetworkPolicyDocument object	Central network policy document.

**Table 4** CentralNetworkPolicyDocument
Parameter	Mandatory	Type	Description
default_plane	Yes	String	Name of the default central network plane.
planes	Yes	Array of CentralNetworkPlaneDocument objects	List of the central network planes.
er_instances	No	Array of AssociateErInstanceDocument objects	List of the enterprise routers on a central network.

**Table 5** CentralNetworkPlaneDocument
Parameter	Mandatory	Type	Description
name	Yes	String	Instance name.
associate_er_tables	No	Array of AssociateErTableDocument objects	List of the enterprise routers on a central network.
exclude_er_connections	No	Array of ExcludeErConnectionDocument objects	Whether to exclude the connections to enterprise routers on the central network.

**Table 6** AssociateErTableDocument
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID.
region_id	Yes	String	Region ID.
enterprise_router_id	Yes	String	Enterprise router ID.
enterprise_router_table_id	Yes	String	ID of the enterprise router route table.

**Table 7** ExcludeErConnectionDocument
Parameter	Mandatory	Type	Description
[items]	No	Array of AssociateErInstanceDocument objects	Connections between enterprise routers managed by the central network plane.

**Table 8** AssociateErInstanceDocument
Parameter	Mandatory	Type	Description
enterprise_router_id	Yes	String	Enterprise router ID.
project_id	Yes	String	Project ID.
region_id	Yes	String	Region ID.

Response Parameters

Status code: 201

**Table 9** Response body parameters
Parameter	Type	Description
request_id	String	Request ID.
central_network_policy	CentralNetworkPolicy object	Details of the central network policy.

**Table 10** CentralNetworkPolicy
Parameter	Type	Description
id	String	Instance ID.
created_at	String	Time when the resource was created. The UTC time is in the yyyy-MM-ddTHH:mm:ss format.
domain_id	String	ID of the account that the instance belongs to.
state	String	Central network policy status. AVAILABLE: The policy is available. CANCELING: The policy is being cancelled. APPLYING: The policy is being applied. FAILED: The operation on the policy failed. DELETED: The policy is deleted.
central_network_id	String	Central network ID.
document_template_version	String	Document template version. 2022.08.30: August 30, 2022
is_applied	Boolean	Whether the policy is applied or not.
version	Integer	Version of the central network policy.
document	CentralNetworkPolicyDocument object	Central network policy document.

**Table 11** CentralNetworkPolicyDocument
Parameter	Type	Description
default_plane	String	Name of the default central network plane.
planes	Array of CentralNetworkPlaneDocument objects	List of the central network planes.
er_instances	Array of AssociateErInstanceDocument objects	List of the enterprise routers on a central network.

**Table 12** CentralNetworkPlaneDocument
Parameter	Type	Description
name	String	Instance name.
associate_er_tables	Array of AssociateErTableDocument objects	List of the enterprise routers on a central network.
exclude_er_connections	Array of ExcludeErConnectionDocument objects	Whether to exclude the connections to enterprise routers on the central network.

**Table 13** AssociateErTableDocument
Parameter	Type	Description
project_id	String	Project ID.
region_id	String	Region ID.
enterprise_router_id	String	Enterprise router ID.
enterprise_router_table_id	String	ID of the enterprise router route table.

**Table 14** ExcludeErConnectionDocument
Parameter	Type	Description
[items]	Array of AssociateErInstanceDocument objects	Connections between enterprise routers managed by the central network plane.

**Table 15** AssociateErInstanceDocument
Parameter	Type	Description
enterprise_router_id	String	Enterprise router ID.
project_id	String	Project ID.
region_id	String	Region ID.

Example Requests

Adding a central network policy

POST /v3/{domain_id}/gcn/central-network/{central_network_id}/policies

{
  "central_network_policy_document" : {
    "default_plane" : "default-plane",
    "planes" : [ {
      "name" : "default-plane"
    } ],
    "er_instances" : [ {
      "enterprise_router_id" : "395b0884-aab4-4bf0-8cb8-7f2da26708dd",
      "project_id" : "XXX",
      "region_id" : "region-abc"
    } ]
  }
}

Example Responses

Status code: 201

The central network policy has been added.

{
  "request_id" : "76bfd2b0d492d0e479fbbd3981869c12",
  "central_network_policy" : {
    "id" : "f03478aa-3975-4ca7-9fb2-b49428a01636",
    "created_at" : "2023-10-09T06:22:40.857Z",
    "domain_id" : "XXX",
    "state" : "AVAILABLE",
    "central_network_id" : "e096c86f-817c-418c-945c-6b1d8860a15d",
    "document_template_version" : "2022.08.30",
    "is_applied" : true,
    "version" : 1,
    "document" : {
      "default_plane" : "default-plane",
      "planes" : [ {
        "name" : "default-plane",
        "associate_er_tables" : [ {
          "project_id" : "XXX",
          "region_id" : "region-abc",
          "enterprise_router_id" : "395b0884-aab4-4bf0-8cb8-7f2da26708dd",
          "enterprise_router_table_id" : "cc542128-5c2d-402a-8960-53bb2ed9484e"
        } ]
      } ],
      "er_instances" : [ {
        "enterprise_router_id" : "395b0884-aab4-4bf0-8cb8-7f2da26708dd",
        "project_id" : "XXX",
        "region_id" : "region-abc"
      } ]
    }
  }
}