Help Center/ Cloud Connect/ API Reference/ API/ Central Network Attachments/ Removing an Attachment from a Central Network
Updated on 2025-07-29 GMT+08:00

Removing an Attachment from a Central Network

Function

This API is used to remove an attachment from a central network.

URI

DELETE /v3/{domain_id}/gcn/central-network/{central_network_id}/attachments/{attachment_id}

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

domain_id

Yes

String

Account ID.

central_network_id

Yes

String

Central network ID.

attachment_id

Yes

String

ID of the attachment on the central network.

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

No

String

User token.

Response Parameters

Status code: 202

Table 3 Response body parameters

Parameter

Type

Description

request_id

String

Request ID.

central_network_attachment

CentralNetworkAttachment object

Details of the attachment on the central network.

Table 4 CentralNetworkAttachment

Parameter

Type

Description

id

String

Instance ID.

name

String

Instance name.

description

String

Resource description. Angle brackets (<>) are not allowed.

domain_id

String

ID of the account that the instance belongs to.

state

String

Central network connection status.

  • AVAILABLE: The connection is available.

  • CREATING: The connection is being created.

  • UPDATING: The connection is being updated.

  • DELETING: The connection is being deleted.

  • FREEZING: The connection is being frozen.

  • UNFREEZING: The connection is being unfrozen.

  • RECOVERING: The connection is being recovered.

  • FAILED: The operation on the connection failed.

  • DELETED: The connection is deleted.

  • APPROVING: The connection is being approved.

  • APPROVED: The connection is approved.

  • UNAPPROVED: The approval failed.

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.

central_network_id

String

Central network ID.

central_network_plane_id

String

ID of the central network plane.

global_connection_bandwidth_id

String

Global connection bandwidth ID.

bandwidth_type

String

Bandwidth type. The bandwidth types are as follows:

  • BandwidthPackage: A global connection bandwidth billed by fixed bandwidth is required, and cross-site connection bandwidths are assigned from the global connection bandwidth.

  • TestBandwidth: The test bandwidth is free. Only the minimum bandwidth is used for testing cross-region connectivity.

bandwidth_size

Integer

Bandwidth capacity, in Mbit/s.

is_frozen

Boolean

Whether the resource is frozen.

enterprise_router_id

String

Enterprise router ID.

enterprise_router_project_id

String

Project ID of the enterprise router.

enterprise_router_region_id

String

Region ID of an enterprise router.

enterprise_router_attachment_id

String

Attachment ID of the enterprise router.

attachment_instance_type

String

Type of the resource that can be added to a central network as an attachment. The value can be GDGW (global DC gateway) or ER_ROUTE_TABLE (enterprise router route table).

attachment_instance_id

String

ID of the resource used as an attachment on the central network, for example, enterprise router route table ID or global DC gateway ID.

attachment_id

String

Attachment ID of the enterprise router or peer link ID of the global DC gateway.

attachment_instance_project_id

String

Project ID of the resource used as an attachment on the central network.

attachment_instance_region_id

String

Region ID of the resource used as an attachment on the central network.

attachment_instance_site_code

String

Site code of the resource used as an attachment on the central network.

enterprise_router_site_code

String

Site code of the enterprise router on a central network.

specification_value

CentralNetworkAttachmentSpecificationValueInfo object

Additional information about an attachment.

Table 5 CentralNetworkAttachmentSpecificationValueInfo

Parameter

Type

Description

enterprise_router_table_id

String

ID of the enterprise router route table.

attachment_parent_instance_id

String

ID of the parent resource of an attachment. Here it is the ID of the enterprise router.

hosted_cloud

String

  • HWCloud: Huawei Cloud

  • Ireland: Ireland site

approved_state

String

Approval status.

  • APPROVING: Approving

  • APPROVED: Approved

  • UNAPPROVED: Approval failed

reason

String

Reason for rejecting attachment creation.

Example Requests

Removing an attachment from a central network

DELETE /v3/{domain_id}/gcn/central-network/{central_network_id}/attachments/{attachment_id}

Example Responses

Status code: 202

The attachment has been removed from the central network.

{
  "request_id" : "a3bad420-33b8-4e26-9e9b-bdf67aa8e72b",
  "central_network_attachment" : {
    "id" : "a3bad420-33b8-4e26-9e9b-bdf67aa8e72b",
    "name" : "name",
    "description" : "description",
    "domain_id" : "XXX",
    "state" : "AVAILABLE",
    "created_at" : "2023-10-09T10:15:32.134Z",
    "updated_at" : "2023-10-09T10:15:32.134Z",
    "central_network_id" : "a3bad420-33b8-4e26-9e9b-bdf67aa8e72b",
    "central_network_plane_id" : "a3bad420-33b8-4e26-9e9b-bdf67aa8e72b",
    "global_connection_bandwidth_id" : "a3bad420-33b8-4e26-9e9b-bdf67aa8e72b",
    "bandwidth_type" : "BandwidthPackage",
    "bandwidth_size" : 20,
    "is_frozen" : false,
    "enterprise_router_id" : "a3bad420-33b8-4e26-9e9b-bdf67aa8e72b",
    "enterprise_router_project_id" : "XXX",
    "enterprise_router_region_id" : "region-abc",
    "enterprise_router_attachment_id" : "a3bad420-33b8-4e26-9e9b-bdf67aa8e72b",
    "attachment_instance_type" : "GDGW",
    "attachment_instance_id" : "a3bad420-33b8-4e26-9e9b-bdf67aa8e72b",
    "attachment_id" : "a3bad420-33b8-4e26-9e9b-bdf67aa8e72b",
    "attachment_instance_project_id" : "XXX",
    "attachment_instance_region_id" : "region-abc",
    "attachment_instance_site_code" : "site-abc",
    "enterprise_router_site_code" : "site-abc",
    "specification_value" : {
      "enterprise_router_table_id" : "a3bad420-33b8-4e26-9e9b-bdf67aa8e72b",
      "attached_er_id" : "a3bad420-33b8-4e26-9e9b-bdf67aa8e72b",
      "approved_state" : "APPROVING",
      "hosted_cloud" : "HWCloud",
      "reason" : "string"
    }
  }
}

Status Codes

Status Code

Description

202

The attachment has been removed from the central network.

Error Codes

See Error Codes.