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