# 使用前必读 #### 概述 欢迎使用CCE Autopilot集群。CCE Autopilot集群是云容器引擎服务推出的Serverless版集群，为您提供免运维的容器服务，并提供经过优化的Kubernetes兼容能力。通过CCE Autopilot集群，您可以在云上轻松部署、管理和扩展容器化应用程序。 您可以使用本文档提供API对CCE Autopilot集群进行相关操作，如创建、删除、变更规格、添加网卡等。 在调用CCE Autopilot集群API之前，请确保已经充分了解CCE Autopilot集群的相关概念，详细信息请参见[产品介绍](https://support.huaweicloud.com/productdesc-cce-autopilot/cce_12_0001.html)。 另外，CCE Autopilot集群所提供的接口分为CCE接口与Kubernetes原生接口。通过配合使用，您可以完整地使用CCE Autopilot集群的所有功能。 - CCE接口：CCE服务通过API网关开放的接口，支持操作云服务层面的基础设施（如创建集群）。同时也支持调用集群层面的资源（如[创建工作负载](https://support.huaweicloud.com/api-cce-autopilot/kubernetesapi.html#kubernetesapi__section41207155509)）。 - Kubernetes原生接口：直接通过Kubernetes原生API Server来调用集群层面的资源（如[通过集群API Server调用Kubernetes API](https://support.huaweicloud.com/api-cce-autopilot/kubernetesapi.html#kubernetesapi__section59774389359)），但不支持操作云服务层面的基础设施（如创建集群）。 Kubernetes原生接口版本级别的相关概念请参见。 ![](https://support.huaweicloud.com/api-cce-autopilot/public_sys-resources/note_3.0-zh-cn.png) - 当前版本调用Kubernetes接口不支持HTTP长链接。 - 当前版本调用的Kubernetes接口包含Beta级别的接口，即版本名称包含了beta （例如: v1beta1）的接口。此类接口会根据Kubernetes原生接口的变化而变化，因此推荐在非重要的情况下使用，例如短期测试集群等。 #### 调用说明 CCE Autopilot集群提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见[3 如何调用API](https://support.huaweicloud.com/api-cce-autopilot/cce_02_0099.html)。 #### 终端节点（Endpoint） 终端节点（Endpoint）即调用API的**请求地址** ，不同服务不同区域的终端节点不同，您可以从[地区和终端节点](https://developer.huaweicloud.com/endpoint)查询服务的终端节点。 请您根据业务需要选择对应区域的终端节点。 - 集群管理、配额管理的URL格式为：**https://Endpoint/uri** 。其中**uri**为资源路径，也即API访问的路径。 - Kubernetes API、存储管理、插件管理的URL格式为：**https://{clusterid}.Endpoint/uri** 。其中**{clusterid}** 为集群ID，**uri** 为资源路径，也即API访问的路径。 ![](https://support.huaweicloud.com/api-cce-autopilot/public_sys-resources/note_3.0-zh-cn.png) - 插件管理接口调用的URL格式为：**https://{clusterid}.Endpoint/uri** ，但**{clusterid}** 参数仅用于域名，不会被接口校验和使用。插件管理实际使用的**{clusterid}**参数请参考插件管理，填写在query或body体中。 - **{clusterid}**参数对Kubernetes API、存储管理生效，对应需要调用接口访问的集群。 表1URL中的参数说明 | 参数 | 描述 | |:---|:---| | {clusterid} | 集群ID，创建集群后，调用[获取指定项目下的集群](https://support.huaweicloud.com/api-cce-autopilot/ListAutopilotClusters.html)接口获取。 | | Endpoint | Web服务入口点的URL，不同服务不同区域的终端节点不同。 | | uri | 资源路径，也即API访问路径。从具体接口的URI模块获取，例如"**获取用户Token**"API的resource-path为"v3/auth/tokens"。 | #### 约束与限制 - 云容器引擎对单个用户的资源数量和容量限定了配额，默认情况下，您最多可以创建5个集群（每个Region下）。如果您需要创建更多的集群，请[提交工单](https://console.huaweicloud.com/quota/?locale=zh-cn#/quota)申请。配额的详细信息请参见[关于配额](https://support.huaweicloud.com/usermanual-iaas/zh-cn_topic_0040259342.html)。 - 更详细的限制请参见具体API的说明。 #### 基本概念 - 账号 用户注册时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用用户进行日常管理工作。 - 用户 由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在[我的凭证](https://console.huaweicloud.com/iam/?locale=zh-cn#/mine/apiCredential)下，您可以查看账号ID和IAM用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 - 区域（Region） 从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。 详情请参见[区域和可用区](https://support.huaweicloud.com/usermanual-iaas/zh-cn_topic_0184026189.html)。 - 可用区（AZ，Availability Zone） 一个可用区是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 - 项目 区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中创建资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中的资源，使得资源的权限控制更加精确。 图1项目隔离模型 ![](https://support.huaweicloud.com/api-cce-autopilot/zh-cn_image_0000002072534428.png "点击放大") 同样在[我的凭证](https://console.huaweicloud.com/iam/?locale=zh-cn#/mine/apiCredential)下，您可以查看项目ID。 - 企业项目 企业项目是项目的升级版，针对企业不同项目间的资源进行分组和管理，是逻辑隔离。企业项目中可以包含多个区域的资源，且项目中的资源可以迁入迁出。 关于企业项目ID的获取及企业项目特性的详细信息，请参见《[企业管理用户指南](https://support.huaweicloud.com/usermanual-em/em_am_0006.html)》。