Help Center> Cloud Connect> API Reference> API> Central Networks> Deleting a Tag from a Central Network
Updated on 2024-05-13 GMT+08:00
Online Debugging
CLI Examples
View PDF

Deleting a Tag from a Central Network

Function

This API is used to delete a tag from a central network.

Calling Method

For details, see Calling APIs.

URI

POST /v3/{domain_id}/gcn/central-networks/{central_network_id}/untag

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

domain_id

Yes

String

Account ID.

Minimum: 10

Maximum: 32

central_network_id

Yes

String

Central network ID.

Minimum: 36

Maximum: 36

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

No

String

User token.

Minimum: 0

Maximum: 2000000
Table 3 Request body parameters

Parameter

Mandatory

Type

Description

tags

Yes

Array of Tag objects

Tags.

Array Length: 1 - 20
Table 4 Tag

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: 204

Table 5 Response header parameters

Parameter

Type

Description

x-request-id

-

-

Example Requests

Deleting a tag from a central network

POST /v3/{domain_id}/gcn/central-networks/{central_network_id}/untag

{
  "tags" : [ {
    "key" : "key",
    "value" : "value"
  } ]
}

Example Responses

None

Status Codes

Status Code

Description

204

The tag has been deleted from the central network.

Error Codes

See Error Codes.

Parent Topic: Central Networks