文档首页/ MapReduce服务 MRS/ API参考/ API V2/ 标签管理接口/ 启用或关闭集群默认标签-SwitchClusterTags
更新时间：2026-01-12 GMT+08:00
在线调试
CLI示例
查看PDF
分享

启用或关闭集群默认标签-SwitchClusterTags

功能介绍

对已有集群启用或关闭集群默认标签。开启后，集群内节点会打上集群默认标签。

接口约束

无

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和受限项。
  • 如果使用身份策略授权，当前API调用无需身份策略权限。

URI

POST /v2/{project_id}/clusters/{cluster_id}/tags/switch

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

项目编号。获取方法，请参见获取项目ID。

约束限制：

不涉及

取值范围：

只能由英文字母和数字组成，且长度为[1-64]个字符。

默认取值：

不涉及

cluster_id

是

String

参数解释：

集群ID。如果指定集群ID，则获取该集群做过补丁更新的最新版本元数据。获取方法，请参见获取集群ID。

约束限制：

不涉及

取值范围：

只能由英文字母、数字以及“_”和“-”组成，且长度为[1-64]个字符。

默认取值：

不涉及

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

action

是

String

参数解释：

操作类型，支持创建和删除。

约束限制：

不涉及

取值范围：

  • create：创建集群标签。
  • delete：删除集群标签。

默认取值：

不涉及

响应参数

无

请求示例

  • 关闭集群默认标签 
    /v2/174ee662a7e24cc99bfc858c455xxxxxx/clusters/848cd341-cbc8-4ac3-82f2-35cd58c077d9/tags/switch

{
  "action" : "delete"
}
  • 开启集群标签 
    /v2/174ee662a7e24cc99bfc858c455xxxxxx/clusters/848cd341-cbc8-4ac3-82f2-35cd58c077d9/tags/switch

{
  "action" : "create"
}

响应示例

状态码： 400

请求失败

{
  "error_code" : "MRS.00000000",
  "error_msg" : "标签配额不足"
}

状态码

状态码请参见状态码。

错误码

请参见错误码。

父主题： 标签管理接口