
# 通过CCE工作负载导入API
API网关支持导入云容器引擎（Cloud Container Engine，简称CCE）的工作负载，将工作负载作为后端服务，在API网关中开放API，提供给API调用者使用。
#### 费用说明
云容器引擎计费详情请参考[云容器引擎计费说明](https://support.huaweicloud.com/price-cce/cce_03_0003.html)。
#### 约束与限制
- 仅支持华为云CCE Turbo集群、VPC网络模型的CCE集群。
- 您需要确保当前实例与CCE集群所属同一个VPC中，或通过其他方式保证两者网络可达，否则导入后调用API会出现失败场景。
- 选择VPC网络模型的CCE集群时，您需要在实例详情界面的路由配置中添加CCE集群的容器网段，否则导入后调用API会出现失败场景。
- 导入后会生成相应的API以及微服务类型的负载通道，负载通道会监测工作负载下所有实例的地址变化，并更新到负载通道中。
- 如果当前实例不支持"导入CCE工作负载"，请联系客服。
 
#### 前提条件
已创建[CCE工作负载](https://support.huaweicloud.com/usermanual-cce/cce_10_0673.html)。
#### 导入CCE工作负载
1. 进入[API网关控制台](https://console.huaweicloud.com/apig2/#/overview)页面。
2. 根据实际业务在左侧导航栏上方选择实例。

3. 在左侧导航栏选择"API管理 \> API分组"。
4. 单击"创建API分组 \> 导入CCE工作负载"。根据下表参数说明，配置信息。 
   表1配置信息 
   | 参数       | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
   |:---|:---|
   | 所属分组     | 工作负载导入成功后，生成的API所在的API分组。支持同步创建新的分组或选择已有分组。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
   | 集群       | 选择工作负载所在的集群，可单击"查看云容器引擎CCE"查看。集群是CCE提供的基础设施资源，属于管理单元。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
   | 命名空间     | 选择工作负载的命名空间。命名空间是对一组资源和对象的抽象整合。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
   | 工作负载类型   | 工作负载是运行在集群之上的应用程序，支持以下几种类型的配置。 - 无状态负载 Deployment：在运行中始终不保存任何数据或状态的工作负载 。  - 有状态工作负载 Statefulset：在运行过程中会保存数据或状态的工作负载。  - 守护进程集 DaemonSet：守护进程集可以确保全部（或者某些）节点上仅运行一个Pod实例，当有节点加入集群时，也会为其新增一个Pod 。 当有节点从集群移除时，这些Pod会被回收。删除DaemonSet将会删除它创建的所有Pod。   了解更多工作负载类型详情请参考[工作负载概述](https://support.huaweicloud.com/usermanual-cce/cce_10_0006.html)。 |
   | 服务标识名    | 选择工作负载的Pod标签，通过Pod标签指定某个工作负载。服务标识名为Pod标签的键，服务标识值为Pod标签的值。 了解更多Pod标签内容详情请参考[设置标签与注解](https://support.huaweicloud.com/usermanual-cce/cce_10_0386.html)章节。                                                                                                                                                                                                                                                                                                                                                                                                                    |
   | 服务标识值    | 选择工作负载的Pod标签，通过Pod标签指定某个工作负载。服务标识名为Pod标签的键，服务标识值为Pod标签的值。 了解更多Pod标签内容详情请参考[设置标签与注解](https://support.huaweicloud.com/usermanual-cce/cce_10_0386.html)章节。                                                                                                                                                                                                                                                                                                                                                                                                                    |
   | 标签       | 选择工作负载的Pod标签。如果服务标识名和服务标识值不唯一，且不能指定某个工作负载时，还可以通过选择其他Pod标签指定某个工作负载。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
   | 请求协议     | 支持HTTP、HTTPS，传输重要或敏感数据时推荐使用HTTPS。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
   | 请求路径前缀   | 请求路径通过配置"+"做前缀匹配。例如，请求路径为/a/{b+}，表示/a/为固定前缀，请求路径匹配b及其后面的所有路径。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
   | 端口       | 填写CCE工作负载的监测端口号。端口号为"工作负载详情页面 \> 访问方式页签"中服务的"容器端口"。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
   | 安全认证     | 支持APP认证、华为IAM认证和无认证。 - APP认证：表示由API网关服务负责接口请求的安全认证。推荐使用APP认证方式。  - 华为IAM认证：表示借助IAM服务进行安全认证。  - 无认证：表示不需要认证。                                                                                                                                                                                                                                     |
   | 支持跨域CORS | 是否开启跨域访问CORS（cross-origin resource sharing）。 CORS允许浏览器向跨域服务器发出XMLHttpRequest请求，从而克服了AJAX只能同源使用的限制。 CORS请求分为两类： - 简单请求：头信息之中，增加一个Origin字段。  - 非简单请求：在正式通信之前，增加一次HTTP查询请求。   开启CORS（非简单请求）时，您需要单独创建一个"请求方法"为"OPTIONS"的API，具体操作请参考[开启跨域访问](https://support.huaweicloud.com/usermanual-apig/apig_03_0011.html)章节。                            |
   | 后端超时（ms） | 后端服务请求的超时时间，可填写范围1ms\~60000ms。 如果在API调试过程中，遇到后端响应超时之类的错误，请适当调大后端超时时间，以便排查原因。 说明： 在实例[配置参数](https://support.huaweicloud.com/usermanual-apig/apig_03_0039.html)中修改超时时间上限，可修改范围为1ms\~600000ms。                                                                                                                                                                                                                                                                                                                  |
      
   
   
5. 单击"完成"。 
   导入后生成相应的API以及微服务类型的负载通道，表示导入成功。
   
   
 
#### 相关文档
- 将导入成功的API[发布到环境](https://support.huaweicloud.com/usermanual-apig/apig_03_0014.html)中，API导入且发布完成后，API调用者就可以[调用API](https://support.huaweicloud.com/usermanual-apig/apig_03_0046.html)了。如果调用的是APP认证方式的API，还需要[配置API调用授权（可选）](https://support.huaweicloud.com/usermanual-apig/apig_03_0129.html)才可调用API。
- 您还可以[通过API设计文件导入API](https://support.huaweicloud.com/usermanual-apig/apig_03_0067.html)或[通过CSE微服务导入API](https://support.huaweicloud.com/usermanual-apig/apig_03_0074.html)。

- [使用专享版API网关开放云容器引擎CCE工作负载](https://support.huaweicloud.com/bestpractice-apig/apig-bp-0021.html)
- 如果您希望通过API导入CCE工作负载，请参考[导入微服务](https://support.huaweicloud.com/api-apig/ImportMicroservice.html)。
 
