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

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"
    }
  } ]
}

Status Codes

Status Code

Description

200

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

Error Codes

See Error Codes.