更新时间:2024-04-18 GMT+08:00

创建子网资源标签

功能介绍

给指定子网资源实例增加标签信息。

URI

POST /v2.0/{project_id}/subnets/{subnet_id}/tags

参数说明请参见表1

表1 参数说明

名称

是否必选

说明

project_id

项目ID,请参见获取项目ID

subnet_id

子网唯一标识

如果您使用管理控制台,此值即为子网详情中的“网络ID”参数值。

请求参数

表2 请求参数

参数名称

类型

是否必选

说明

tag

tag object

tag对象,请参见表3

表3 tag对象

属性

类型

是否必选

说明

key

String

  • 标签名称。
  • 不能为空。
  • 长度不超过128个字符(当前控制台操作key长度不超过36个字符)。
  • 由英文字母、数字、下划线、中划线、中文字符组成。
  • 同一资源的key值不能重复。

value

String

  • 标签值。
  • 长度不超过255个字符(当前控制台操作value长度不超过43个字符)。
  • 由英文字母、数字、下划线、点、中划线、中文字符组成。

请求示例

  • 创建一条子网资源标签,key为key1,value为value1。
POST https://{Endpoint}/v2.0/{project_id}/subnets/{subnet_id}/tags

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

响应参数

响应示例

状态码

请参见状态码

错误码

请参考错误码