POST /nodes/{nodeId}/tags

基本信息

在节点nodeId上创建一个标签。 您可以在JSON正文中指定标签，如下所示：

{
  "tag":"test-tag-1"
}

Note: 您可以通过在JSON正文中指定标签列表来创建多个标签，如下所示：

[
  {
    "tag":"test-tag-1"
  },
  {
    "tag":"test-tag-2"
  }
]

如果将列表指定为输入，则在响应正文中返回分页列表而不是条目。 例如：

{
  "list": {
    "pagination": {
      "count": 2,
      "hasMoreItems": false,
      "totalItems": 2,
      "skipCount": 0,
      "maxItems": 100
    },
    "entries": [
      {
        "entry": {
          ...
        }
      },
      {
        "entry": {
         ...
        }
      }
    ]
  }
}

请求方式 POST

请求API/ nodes / {nodeId} / tags

响应等级（状态201）

成功回应

{
  "entry": {
    "id": "string",
    "tag": "string"
  }
}

响应内容类型 applicaiton/json

Query参数

名称	类型	是否必填	示例值	描述
fields	Array[string]	否		field名称的list。 例如，如果您想节省整体带宽，则可以使用此参数来限制响应中返回的field。 例如，如果您想节省整体带宽，则可以使用此参数来限制响应中返回的field。 该列表适用于返回的单个实体或集合中的条目。 如果API方法也支持include参数，则除了在fields参数中指定的fields外，还返回include参数中指定的fields。

Path参数

名称	类型	是否必填	示例值	描述
nodeId	string	是		节点的标识符。

Body参数（tagBodyCreate）

request body示例

{
  "tag": "string"
}

错误信息描述

状态码	原因
400	无效的参数：tagBodyUpdate无效
401	验证失败
403	用户无权在节点上创建标签
404	nodeId不存在
405	无法标记此类型的节点
default	意外错误

返回结果示例

{
  "error": {
    "errorKey": "string",
    "statusCode": 0,
    "briefSummary": "string",
    "stackTrace": "string",
    "descriptionURL": "string",
    "logId": "string"
  }
}