文档首页/ 虚拟私有云 VPC/ API参考/ API/ 子网资源标签管理/ 创建子网资源标签
更新时间：2024-03-28 GMT+08:00
在线调试
CLI示例
查看PDF
分享

创建子网资源标签

功能介绍

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

调试

您可以在API Explorer中调试该接口。

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"
    }
}

响应参数

无

响应示例

无

状态码

请参见状态码。

错误码

请参考错误码。

相关文档