Help Center/ Cloud Connect/ API Reference/ API/ Central Networks/ Querying the Changes Between the Current Policy and an Applied Policy

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

View PDF

Querying the Changes Between the Current Policy and an Applied Policy

Function

This API is used query the changes between the current policy and an applied policy.

URI

GET /v3/{domain_id}/gcn/central-network/{central_network_id}/policies/{policy_id}/change-set

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
domain_id	Yes	String	Account ID.
policy_id	Yes	String	Central network policy 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.

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
request_id	String	Request ID.
page_info	PageInfo object	Pagination query information.
central_network_policy_change_set	Array of CentralNetworkElementChange objects	List of central network policy changes.

**Table 4** PageInfo
Parameter	Type	Description
next_marker	String	Backward pagination identifier.
previous_marker	String	Forward pagination identifier.
current_count	Integer	Number of the resources in the current list.

**Table 5** CentralNetworkElementChange
Parameter	Type	Description
operation_id	String	Operation on a central network. CreateCentralNetworkPlane: Add a central network plane. DeleteCentralNetworkPlane: Remove a central network plane. UpdateCentralNetworkPlane: Update a central network plane. CreateCentralNetworkErInstance: Add an enterprise router as an attachment on a central network. DeleteCentralNetworkErInstance: Remove an enterprise router from a central network. CreateCentralNetworkErConnection: Create a connection between enterprise routers on a central network. DeleteCentralNetworkErConnection: Delete a connection between enterprise routers from a central network. CreateCentralNetworkErTable: Add an enterprise router route table as an attachment on a central network. DeleteCentralNetworkErTable: Remove an enterprise router route table from a central network. SwitchCentralNetworkErTable: Change an enterprise router route table on a central network.

Example Requests

Querying the changes between the current policy and an applied policy

GET /v3/{domain_id}/gcn/central-network/{central_network_id}/policies/{policy_id}/change-set

Example Responses

Status code: 200

Changes between the current policy and applied policy have been queried.

{
  "request_id" : "a334adc3e2cba87855de6f3ab58b9db5",
  "page_info" : {
    "current_count" : 5
  },
  "central_network_policy_change_set" : [ {
    "operation_id" : "UpdateCentralNetworkPlane",
    "original_central_network_plane" : {
      "name" : "default-plane",
      "is_default" : true,
      "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"
      } ]
    },
    "newest_central_network_plane" : {
      "name" : "default-plane",
      "is_default" : true,
      "associate_er_tables" : [ {
        "project_id" : "XXX",
        "region_id" : "region-abc",
        "enterprise_router_id" : "c73b26b7-33f0-438d-b440-8e87dfe6fef9",
        "enterprise_router_table_id" : "c0d51f20-0313-40f7-a74e-9dccb5da21c0"
      } ]
    }
  }, {
    "operation_id" : "CreateCentralNetworkErInstance",
    "create_central_network_er_instance" : {
      "enterprise_router_id" : "c73b26b7-33f0-438d-b440-8e87dfe6fef9",
      "project_id" : "XXX",
      "region_id" : "region-abc"
    }
  }, {
    "operation_id" : "DeleteCentralNetworkErInstance",
    "delete_central_network_er_instance" : {
      "enterprise_router_id" : "395b0884-aab4-4bf0-8cb8-7f2da26708dd",
      "project_id" : "XXX",
      "region_id" : "region-abc"
    }
  }, {
    "operation_id" : "CreateCentralNetworkErConnection",
    "central_network_plane_name" : "default-plane",
    "index" : 0,
    "create_central_network_er_connection" : [ {
      "project_id" : "XXX",
      "region_id" : "region-abc-1",
      "enterprise_router_id" : "c9c9c756-6984-4866-bab7-5b55c81594bd",
      "enterprise_router_table_id" : "58613052-f9d4-4fa4-a3f0-6d6873190826"
    }, {
      "project_id" : "8d01a037388442f6a2e435f4f30860a3",
      "region_id" : "region-abc-2",
      "enterprise_router_id" : "58fad9c1-b4bd-4622-84e4-a0fcb2423601",
      "enterprise_router_table_id" : "a5347056-e29f-4192-9256-e151c61f854c"
    } ]
  }, {
    "operation_id" : "DeleteCentralNetworkErConnection",
    "central_network_plane_name" : "default-plane",
    "index" : 1,
    "delete_central_network_er_connection" : [ {
      "project_id" : "XXX",
      "region_id" : "region-abc-1",
      "enterprise_router_id" : "c9c9c756-6984-4866-bab7-5b55c81594bd",
      "enterprise_router_table_id" : "58613052-f9d4-4fa4-a3f0-6d6873190826"
    }, {
      "project_id" : "8d01a037388442f6a2e435f4f30860a3",
      "region_id" : "region-abc-2",
      "enterprise_router_id" : "58fad9c1-b4bd-4622-84e4-a0fcb2423601",
      "enterprise_router_table_id" : "a5347056-e29f-4192-9256-e151c61f854c"
    } ]
  }, {
    "operation_id" : "CreateCentralNetworkErTable",
    "central_network_plane_name" : "default-plane",
    "create_central_network_er_table" : {
      "project_id" : "XXX",
      "region_id" : "region-abc",
      "enterprise_router_id" : "c73b26b7-33f0-438d-b440-8e87dfe6fef9",
      "enterprise_router_table_id" : "c0d51f20-0313-40f7-a74e-9dccb5da21c0"
    }
  }, {
    "operation_id" : "DeleteCentralNetworkErTable",
    "central_network_plane_name" : "default-plane",
    "delete_central_network_er_table" : {
      "project_id" : "XXX",
      "region_id" : "region-abc",
      "enterprise_router_id" : "395b0884-aab4-4bf0-8cb8-7f2da26708dd",
      "enterprise_router_table_id" : "cc542128-5c2d-402a-8960-53bb2ed9484e"
    }
  }, {
    "operation_id" : "SwitchCentralNetworkErTable",
    "central_network_plane_name" : "default-plane",
    "switch_central_network_er_table" : {
      "project_id" : "XXX",
      "region_id" : "region-abc",
      "enterprise_router_id" : "5cc75ed0-bd6c-3af4-663b-caba3315bb08",
      "original_enterprise_router_table_id" : "b705f49e-df88-eaf3-3aeb-95d534138156",
      "new_enterprise_router_table_id" : "b705f49e-df88-eaf3-3aeb-95d534138158"
    }
  } ]
}