Updating a Central Network
Function
This API is used to update a central network.
URI
PUT /v3/{domain_id}/gcn/central-networks/{central_network_id}
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
domain_id |
Yes |
String |
Account ID. |
central_network_id |
Yes |
String |
Central network ID. |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
X-Auth-Token |
No |
String |
User token. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
central_network |
Yes |
UpdateCentralNetwork object |
Details of the central network to be updated. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
name |
No |
String |
Instance name. |
description |
No |
String |
Resource description. Angle brackets (<>) are not allowed. |
tags |
No |
Array of Tag objects |
Resource tags. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
key |
Yes |
String |
Tag key. The key can contain a maximum of 128 Unicode characters, including letters, digits, hyphens (-), and underscores (_). |
value |
No |
String |
Tag value. The value can contain a maximum of 255 Unicode characters, including letters, digits, hyphens (-), underscores (_), and periods (.). |
Response Parameters
Status code: 200
Parameter |
Type |
Description |
---|---|---|
request_id |
String |
Request ID. |
central_network |
CentralNetwork object |
Central network. |
Parameter |
Type |
Description |
---|---|---|
id |
String |
Instance ID. |
name |
String |
Instance name. |
description |
String |
Resource description. Angle brackets (<>) are not allowed. |
created_at |
String |
Time when the resource was created. The UTC time is in the yyyy-MM-ddTHH:mm:ss format. |
updated_at |
String |
Time when the resource was updated. The UTC time must be in the yyyy-MM-ddTHH:mm:ss format. |
domain_id |
String |
ID of the account that the instance belongs to. |
state |
String |
Central network status.
|
enterprise_project_id |
String |
ID of the enterprise project that the resource belongs to. |
tags |
Array of Tag objects |
Resource tags. |
default_plane_id |
String |
ID of the default central network plane. |
planes |
Array of CentralNetworkPlane objects |
List of central network planes. |
er_instances |
Array of CentralNetworkErInstance objects |
List of enterprise routers on a central network. |
connections |
Array of CentralNetworkConnectionInfo objects |
List of the enterprise router attachments on a central network. |
Parameter |
Type |
Description |
---|---|---|
key |
String |
Tag key. The key can contain a maximum of 128 Unicode characters, including letters, digits, hyphens (-), and underscores (_). |
value |
String |
Tag value. The value can contain a maximum of 255 Unicode characters, including letters, digits, hyphens (-), underscores (_), and periods (.). |
Parameter |
Type |
Description |
---|---|---|
id |
String |
Instance ID. |
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. |
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. |
Parameter |
Type |
Description |
---|---|---|
[items] |
Array of AssociateErInstanceDocument objects |
Connections between enterprise routers managed by the central network plane. |
Parameter |
Type |
Description |
---|---|---|
enterprise_router_id |
String |
Enterprise router ID. |
project_id |
String |
Project ID. |
region_id |
String |
Region ID. |
Parameter |
Type |
Description |
---|---|---|
id |
String |
Instance ID. |
enterprise_router_id |
String |
Enterprise router ID. |
project_id |
String |
Project ID. |
region_id |
String |
Region ID. |
asn |
Long |
ASN of the network instance when BGP is used for routing. |
site_code |
String |
Site code. |
Parameter |
Type |
Description |
---|---|---|
id |
String |
Instance ID. |
plane_id |
String |
ID of the central network plane. |
global_connection_bandwidth_id |
String |
Global connection bandwidth ID. |
bandwidth_size |
Integer |
Bandwidth capacity, in Mbit/s. |
connection_type |
String |
Type of a central network connection.
|
connection_point_pair |
Array of ConnectionPoint objects |
Both ends of a central network connection. The length is fixed to an array of 2. |
state |
String |
Central network connection status.
|
Parameter |
Type |
Description |
---|---|---|
id |
String |
Instance ID. |
project_id |
String |
Project ID. |
region_id |
String |
Region ID. |
site_code |
String |
Site code. |
instance_id |
String |
Instance ID at an end of a connection. |
parent_instance_id |
String |
Parent resource ID of the instance at an end of a connection. |
type |
String |
Type of the resource that can be added to a central network as an attachment.
|
Example Requests
Updating a central network
PUT /v3/{domain_id}/gcn/central-networks/{central_network_id} { "central_network" : { "description" : "new description" } }
Example Responses
Status code: 200
The central network has been updated.
{ "request_id" : "b0f83900a5850b757cc59bf919d90947", "central_network" : { "id" : "e096c86f-817c-418c-945c-6b1d8860a15d", "name" : "name", "description" : "new description", "created_at" : "2023-10-09T06:22:40.856Z", "updated_at" : "2023-10-09T06:27:55.75Z", "domain_id" : "XXX", "state" : "AVAILABLE", "enterprise_project_id" : "0" } }
Status Codes
Status Code |
Description |
---|---|
200 |
The central network has been updated. |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.