Qin Ying, Fan a79d5bdbdb DNS API 1017 version

Reviewed-by: Kucerak, Kristian <kristian.kucerak@t-systems.com>
Co-authored-by: Qin Ying, Fan <fanqinying@huawei.com>
Co-committed-by: Qin Ying, Fan <fanqinying@huawei.com>

2022-10-20 13:26:00 +00:00

11 KiB

Raw Blame History

Adding Resource Tags

Function

Add tags to a specified resource.

You can add a maximum of 20 tags to a resource.

The API is idempotent.

If a to-be-created tag has the same key as an existing tag, the tag will be created and overwrite the existing one.

URI

POST /v2/{project_id}/{resource_type}/{resource_id}/tags

For details, see Table 1.

**Table 1** Parameters in the URI
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. You can obtain it in Obtaining a Project ID.
resource_type	Yes	String	Resource type, which can be DNS-public_zone, DNS-private_zone, DNS-public_recordset, DNS-private_recordset, or DNS-ptr_record
resource_id	Yes	String	Resource ID

Request

Parameter description

**Table 2** Parameter in the request
Parameter	Mandatory	Type	Description
tag	Yes	Object	Tag For details, see Table 3.

**Table 3** Parameters in the tag list
Parameter	Mandatory	Type	Description
key	Yes	String	Tag key. The key contains 36 Unicode characters at most and cannot be blank. It can contain only digits, letters, hyphens (-), and underscores (_).
value	No	String	Tag value. Each value contains 43 Unicode characters at most and can be an empty string. It can contain only digits, letters, hyphens (-), and underscores (_).

Example request

Add tags for the private zone whose ID is ff8080825b8fc86c015b94bc6f8712c3:

POST https://{DNS_Endpoint}/v2/{project_id}/DNS-private_zone/ff8080825b8fc86c015b94bc6f8712c3/tags

{
    "tag": {
        "key": "key1", 
        "value": "value1"
    }
}

Response

None

Returned Value

If the API call returns a code of 2xx, for example, 200, 202, or 204, the request is successful.

For details, see Status Code.

Parent topic: Tag Management

11 KiB Raw Blame History