检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
须具备调用该接口所需的权限，否则，API请求将调用失败。每个接口所需要的权限，与各个接口所对应的授权项相对应，只有发起请求的用户被授予授权项所对应的策略，该用户才能成功调用该接口。例如，用户要调用接口来查询云服务器列表，那么这个IAM用户被授予的策略中必须包含允许“ecs:ser
L格式时必须指定此参数。获取方式请参见如何获取接口URI中参数 表2 请求Body参数 参数 是否必选 参数类型 描述 apiVersion 是 String API版本，固定值v1 缺省值：v1 kind 是 String API类型，固定值PersistentVolume 缺省值：PersistentVolume
功能介绍 该API用于创建一个空集群（即只有控制节点Master，没有工作节点Node）。请在调用本接口完成集群创建之后，通过创建节点添加节点。 集群管理的URL格式为：https://Endpoint/uri。其中uri为资源路径，也即API访问的路径。 调用该接口创建集群时，
获取任务信息 功能介绍 该API用于获取任务信息。通过某一任务请求下发后返回的jobID来查询指定任务的进度。 集群管理的URL格式为：https://Endpoint/uri。其中uri为资源路径，也即API访问的路径 该接口通常使用场景为： 创建、删除集群时，查询相应任务的进度。
获取项目ID 操作场景 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式： 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET https:
式。 在弹出的窗口中可以下载kubectl配置文件kubeconfig.json。 图1 下载kubeconfig.json 父主题： API&kubectl
通过API或kubectl操作CCE集群，创建的资源是否能在控制台展示？ 在CCE控制台，暂时不支持显示的kubernetes资源有：DaemonSet、 ReplicationController、ReplicaSets、Endpoints等。 若需要查询这些资源，请通过kubectl命令进行查询。
式时必须指定此参数。获取方式请参见如何获取接口URI中参数 响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 apiVersion String API版本，固定值v1 缺省值：v1 kind String API类型，固定值PersistentVolume
获取集群升级相关信息 功能介绍 获取集群升级相关信息 调用方法 请参见如何调用API。 URI GET /api/v3/projects/{project_id}/clusters/{cluster_id}/upgradeinfo 表1 路径参数 参数 是否必选 参数类型 描述 project_id
SnapshotCluserResponseMetadata 参数 参数类型 描述 apiVersion String API版本，默认为v3.1 kind String 任务类型 请求示例 集群升级备份请求示例 POST /api/v3.1/projects/{project_id}/clust
删除集群 功能介绍 该API用于删除一个指定的集群。 集群管理的URL格式为：https://Endpoint/uri。其中uri为资源路径，也即API访问的路径。 调用方法 请参见如何调用API。 URI DELETE /api/v3/projects/{project_id}
开启集群升级流程引导任务 功能介绍 该API用于创建一个集群升级流程引导任务。请在调用本接口完成引导任务创建之后，通过集群升级前检查开始检查任务。 升级流程任务用于控制集群升级任务的执行流程，执行流程为 升级前检查 => 集群升级 => 升级后检查。 调用方法 请参见如何调用API。 URI POST
状态码： 200 表5 响应Body参数 参数 参数类型 描述 kind String API类型，固定值“WorkFlowTask”，该值不可修改。 apiVersion String API版本，固定值“v3”，该值不可修改。 metadata Metadata object 升级流程的元数据信息
集群升级涉及多维度的组件升级操作，强烈建议统一通过CCE控制台执行交互式升级，降低集群升级过程的业务意外受损风险； 当前集群升级相关接口受限开放。 调用方法 请参见如何调用API。 URI POST /api/v3/projects/{project_id}/clusters/{cluster_id}/operation/upgrade
资源费用。 接口约束 1、集群休眠后，将无法在此集群上创建和管理工作负载等资源。 2、按需付费集群休眠后，将暂停收取控制节点资源费用，集群所属的节点、绑定的弹性IP、带宽等资源按各自的计费方式（“包年/包月”或“按需付费”）进行收费。 调用方法 请参见如何调用API。 URI POST
查询AddonTemplates列表 功能介绍 插件模板查询接口，查询插件信息。 调用方法 请参见如何调用API。 URI GET /api/v3/addontemplates 表1 Query参数 参数 是否必选 参数类型 描述 addon_template_name 否 String
更新指定的集群 功能介绍 该API用于更新指定的集群。 集群管理的URL格式为：https://Endpoint/uri。其中uri为资源路径，也即API访问的路径。 调用方法 请参见如何调用API。 URI PUT /api/v3/projects/{project_id}/c
根据检查结果，检测到您的集群通过kubectl或其他应用调用了升级目标集群版本已废弃的API，您可在升级前进行整改，否则升级到目标版本后，该API将会被kube-apiserver拦截，影响您的使用。具体每个API废弃情况可参考废弃API说明。 案例介绍 社区v1.22版本集群废弃了extension
通过控制台可视化生成API参数 在使用API创建集群或节点时，如果请求中的API参数组合不正确，将会导致接口调用失败。您可以通过控制台可视化生成API参数，根据选项配置自动生成正确的参数组合。 生成创建集群的API参数 登录CCE控制台。 在“集群管理”页面右上角单击“购买集群”。
集群升级后确认 功能介绍 集群升级后确认，该接口建议配合Console使用，主要用于升级步骤完成后，客户确认集群状态和业务正常后做反馈。 调用方法 请参见如何调用API。 URI POST /api/v3/projects/{project_id}/clusters/{clust
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
