API生命周期管理

步骤一：创建API

1. 登录云原生API网关控制台。

2. 在左侧导航栏，选择API管理 > API列表，并在顶部菜单栏选择地域。

3. 在页面左上角，单击创建API > 基于OpenAPI文件创建。

4. 在基于OpenAPI创建文件面板中，配置API相关参数，并单击确定。

   配置项	说明
   API名称	自定义创建的API名称，API名称需要全局唯一。
   OpenAPI文件	支持选择文件或粘贴文本内容。
   版本管理	是否启用API版本管理能力，不同版本的API视为独立的API，它们具有相同的API名称，但API的其他基本信息和接口信息可以不同。访问时需要指定版本标识符。 开启版本管理功能后，需要配置版本号及使用方式。 说明 选择使用方式为Query时，需要配置参数项添加Query。 选择使用方式为Header时，需要配置参数项添加Header。
   版本号	相同API名称下，以版本号进行区分。
   使用方式	支持Path、Query、Header三种方式。 使用Path时，需要完整访问路径为：/API基本路径/版本号/接口路径。 使用Query时，完整访问路径为：/API基本路径/接口路径，请求参数中需要配置参数项添加Query为版本号。 使用Header时，完整访问路径为：/API基本路径/接口路径，请求头中需要配置参数项添加Header为版本号。
   描述	填写API的相关描述。

5. 创建成功后，可在接口列表中查看OpenAPI中定义的接口信息。

步骤二：发布API

1. 登录云原生API网关控制台。

2. 在左侧导航栏，选择API管理 > API列表，并在顶部菜单栏选择地域。

3. 在API列表中，选择需要发布的API，单击页面右上角发布。

4. 在发布面板中，配置相关参数，并单击确定。

   配置项	说明
   域名	选择对应的域名进行发布，发布后，支持通过相关域名访问API。 若无域名，可单击创建域名，具体操作，请参见创建域名。
   发布环境	将API发布到指定环境。若无发布环境，可单击创建环境，具体操作，请参见。 重要 若该环境下API已发布，则本次发布将覆盖已发布数据，请谨慎操作。
   使用场景	支持Mock、单服务、按比例、按内容、按标签等场景进行发布。 发布Mock场景 Mock场景，接口的响应将返回接口定义中的Mock配置，若接口未定义Mock配置，则将无法访问该接口。 发布Mock场景时，要求当前API中至少有一个接口开启了Mock配置，否则将发布失败。 发布单服务场景 单服务场景，所有流量将转发到某一具体的后端服务。 发布单服务场景时，支持已有服务、云产品资源（容器服务、MSE Nacos、FC）、固定地址、DNS域名等服务类型。 选择已有服务时，将展示发布环境所绑定的网关实例当前已创建的服务信息。 选择云产品资源 > 容器服务时，将展示发布环境所绑定的网关实例当前所有容器服务数据。若无数据请先创建服务来源，具体操作，请参见创建服务来源。 选择云产品资源 > MSE Nacos时，将展示发布环境所绑定的网关实例当前所有MSE Nacos服务数据。若无数据请先创建服务来源，具体操作，请参见创建服务来源。 选择云产品资源 > FC时，将展示当前地域所有FC函数信息。若无数据，请在函数计算控制台确认当前地域下存在函数。 选择固定地址时，请填写IP:端口，多个配置之间使用逗号分隔。 选择DNS域名时，请填写域名:端口，多个配置之间使用逗号分隔。 发布按比例场景 按比例场景，所有的流量将按比例分发到对应的后端服务中。 发布按比例（多服务）场景时，支持已有服务、云产品资源（容器服务、MSE Nacos）、固定地址、DNS域名等服务类型。 选择已有服务时，将展示发布环境所绑定的网关实例当前已创建的服务信息。 选择云产品资源 > 容器服务时，将展示发布环境所绑定的网关实例当前所有容器服务数据。若无数据请先创建服务来源，具体操作，请参见创建服务来源。 选择云产品资源 > MSE Nacos时，将展示发布环境所绑定的网关实例当前所有MSE Nacos服务数据。若无数据请先创建服务来源，具体操作，请参见创建服务来源。 选择固定地址时，请填写IP:端口，多个配置之间使用逗号分隔。 选择DNS域名时，请填写域名:端口，多个配置之间使用逗号分隔。 说明 要求多个条目的服务权重之和等于100。 发布按内容场景 按内容场景，所有的流量将按照匹配条件分发到对应的后端服务中，若匹配条件勾选默认，则无其他匹配规则命中时，流量将进入该条目所对应后端服务。 匹配条件支持：等于、前缀是、正则匹配。 参数类型支持：Query、Header。 多个匹配条件之间为“且”运算逻辑。 发布按内容（多服务）场景时，支持已有服务、云产品资源（容器服务、MSE Nacos）、固定地址、DNS域名等服务类型。 选择已有服务时，将展示发布环境所绑定的网关实例当前已创建的服务信息。 选择云产品资源 > 容器服务时，将展示发布环境所绑定的网关实例当前所有容器服务数据。若无数据请先创建服务来源，具体操作，请参见创建服务来源。 选择云产品资源 > MSE Nacos时，将展示发布环境所绑定的网关实例当前所有MSE Nacos服务数据。若无数据请先创建服务来源，具体操作，请参见创建服务来源。 选择固定地址时，请填写IP:端口，多个配置之间使用逗号分隔。 选择DNS域名时，请填写域名:端口，多个配置之间使用逗号分隔。 重要 要求多个条目中，只允许一个条目勾选默认，且其余条目的匹配条件非空。 发布按标签场景 按标签场景下，所有流量将按比例进入到对应的已有服务的服务版本中。 发布按标签（多服务）场景时，支持服务类型为已有服务。 选择已有服务时，将展示发布环境所绑定的网关实例当前已创建的服务信息。 说明 要求多个条目的服务权重之和等于100。
   发布描述	填写API的发布描述。

步骤三：调试API

1. 登录云原生API网关控制台。

2. 在左侧导航栏，选择API管理 > API列表，并在顶部菜单栏选择地域。

3. 在API列表中，选择目标API，单击接口列表，选择需要调试的接口，单击调试。

   

4. 在调试接口面板中，配置相关参数进行调试。

   

步骤四：通过域名访问API

1. 登录云原生API网关控制台。

2. 在左侧导航栏，选择API管理 > API列表，并在顶部菜单栏选择地域。

3. 在API列表中，选择目标API，查看API详情。

4. 在API详情页中，可查看当前API的发布信息。

   在发布信息中，有两种域名类型：

   • 公网二级域名：系统自动生成，可直接进行访问的公网域名。公网域名仅供API测试使用，直接访问时，每天有100次访问限制。

   • 域名：用户自定义域名，在发布时进行的配置。用户需将该自定义域名CNMAE映射到对应的公网二级域名，以实现通过域名对API的访问。通过该方式，将不再受限于公网二级域名100次的访问上限。

   最终对外可访问的路径为：http(s)://{域名}/{BasePath}/接口路径。

步骤五：下线API

1. 登录云原生API网关控制台。

2. 在左侧导航栏，选择API管理 > API列表，并在顶部菜单栏选择地域。

3. 在API列表中，选择目标API，并单击API详情。

4. 在发布信息栏中，单击需要下线的发布记录操作列中的下线。

5. 在确认下线弹窗中，单击下线。

   重要

   下线后，无法再通过相关域名访问该API下的所有接口，请谨慎操作。

步骤一：创建API

1. 登录云原生API网关控制台。

2. 在左侧导航栏，选择API管理 > API列表，并在顶部菜单栏选择地域。

3. 在页面左上角，单击创建API > HTTP(s)。

4. 在创建HTTP API面板中，配置API相关参数，并单击确定。

   配置项	说明
   API名称	自定义创建的API名称。 重要 API名称必须全局唯一。
   协议	支持HTTP、HTTPS。
   Base Path	API的基本路径，访问具体接口时，完整路径为http(s)://{域名}/{apiBasePath}/{接口Path}。
   版本管理	是否启用API版本管理能力，不同版本的API视为独立的API，它们具有相同的API名称，但API的其他基本信息和接口信息可以不同。访问时需要指定版本标识符。 开启版本管理功能后，需要配置版本号及使用方式。 说明 选择使用方式为Query时，需要配置参数项添加Query。 选择使用方式为Header时，需要配置参数项添加Header。
   版本号	相同API名称下，以版本号进行区分。
   使用方式	支持Path、Query、Header三种方式。 使用Path时，需要完整访问路径为：/API基本路径/版本号/接口路径。 使用Query时，完整访问路径为：/API基本路径/接口路径，请求参数中需要配置参数项添加Query为版本号。 使用Header时，完整访问路径为：/API基本路径/接口路径，请求头中需要配置参数项添加Header为版本号。
   描述	填写API的相关描述。

步骤二：添加接口

1. 登录云原生API网关控制台。

2. 在左侧导航栏，选择API管理 > API列表，并在顶部菜单栏选择地域。

3. 选择目标API及对应的版本后，单击添加接口。

4. 在创建接口面板中，配置接口相关参数，并单击创建。

   配置项	说明
   接口名称	自定义创建的接口名称，在API下需要全局唯一。
   接口Path	接口的具体路径。
   Method	接口的请求方法。接口的路径+接口的方法，需要在API下全局唯一。
   描述	接口的描述信息。
   请求定义	支持定义Header、Query、Parameter Path参数以及Body参数。 其中Path参数支持在接口Path中三种定义变量的方式： /books/[bookId] /books/{bookId} /books/:bookId 其中，推荐使用{bookId}方式进行定义。 请求定义仅用于生成SDK和文档，不对运行时进行校验。
   响应定义	定义不同响应码的数据结构。 响应码定义仅用于生成SDK和文档，不对运行时进行校验。
   Mock	Mock配置仅在API发布Mock场景下生效。