删除资源标签 - DeleteNotebookTags
功能介绍
删除资源标签接口用于移除指定Notebook实例的标签信息。该接口适用于以下场景:用户需要清理或重新组织Notebook实例的标签时,可通过此接口删除单个或多个标签。使用该接口的前提条件是用户已登录系统并具有操作目标Notebook实例的权限。调用该接口后,系统将删除指定的标签,若标签不存在则不进行操作。若用户无权限操作指定Notebook实例或输入的参数无效,接口将返回相应的错误信息。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。获取该接口关联的CLI示例: hcloud ModelArts DeleteNotebookTags。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,当前API调用无需身份策略权限。
URI
DELETE /v1/{project_id}/notebooks/{resource_id}/tags/delete
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释:用户项目ID,获取方法请参见获取项目ID和名称。 约束限制:不涉及。 取值范围:不涉及。 默认取值:不涉及。 |
|
resource_id |
是 |
String |
参数解释:资源ID:如Notebook实例ID。 约束限制:不涉及。 取值范围:不涉及。 默认取值:不涉及。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
tags |
是 |
Array of TmsTagForDelete objects |
参数解释:要删除的标签列表。 约束限制:不涉及。 |
响应参数
状态码:204
删除成功。
状态码:400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
参数解释:ModelArts错误码。 取值范围:不涉及。 |
|
error_msg |
String |
参数解释:具体错误信息。 取值范围:不涉及。 |
状态码:401
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
参数解释:ModelArts错误码。 取值范围:不涉及。 |
|
error_msg |
String |
参数解释:具体错误信息。 取值范围:不涉及。 |
状态码:403
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
参数解释:ModelArts错误码。 取值范围:不涉及。 |
|
error_msg |
String |
参数解释:具体错误信息。 取值范围:不涉及。 |
状态码:404
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
参数解释:ModelArts错误码。 取值范围:不涉及。 |
|
error_msg |
String |
参数解释:具体错误信息。 取值范围:不涉及。 |
请求示例
https://{endpoint}/v1/{project_id}/notebooks/a55eba18-1ebf-4e9a-8229-d2d3b593a3dc/tags/delete
{
"action" : "delete",
"tags" : [ {
"key" : "dev",
"value" : "dev1"
} ]
}
响应示例
无
状态码
|
状态码 |
描述 |
|---|---|
|
204 |
删除成功。 |
|
400 |
参数非法。 |
|
401 |
鉴权失败。 |
|
403 |
权限不足。 |
|
404 |
资源不存在。 |
错误码
请参见错误码。