创建环境和环境变量
操作场景
API可以同时提供给不同的环境调用,如生产、测试或开发。RELEASE是默认存在的环境,无需创建。且API网关提供环境变量功能,通过创建环境变量,实现在不同的环境定义不同的API调用路径。
环境变量是指在环境上创建可管理的一种变量,该变量固定在环境上。通过创建环境变量,实现同一个API,在不同环境中调用不同的后端服务。
当创建API时定义了变量标识,则需要在环境中添加变量。例如创建API时定义了变量名为“Path”,在环境1中创建了变量名“Path”,变量值“/Stage/test”,则API在发布到环境1时,使用“/Stage/test”代替“Path”,API调用者在环境1中调用此API时,后端服务请求Path为“/Stage/test”。在环境2中创建了变量名“Path”,变量值“/Stage/AA”,则API在发布到环境2时,使用“/Stage/AA”代替“Path”,API调用者在环境2中调用此API时,后端服务请求Path为“/Stage/AA”。
![点击放大](https://support.huaweicloud.com/intl/zh-cn/eu-west-0-usermanual-apig/zh-cn_image_0000001142917658.png)
![](https://support.huaweicloud.com/intl/zh-cn/eu-west-0-usermanual-apig/public_sys-resources/note_3.0-zh-cn.png)
- 每个用户最多创建10个环境。
- 每个分组在任意一个环境中,最多创建50个变量。
前提条件
已创建API分组。
创建环境
- 登录管理控制台。
- 单击管理控制台左上角
,然后单击“API网关 APIG”。
- 选择“开放API > 环境管理”,进入到环境管理信息页面。
- 单击“创建环境”,弹出“创建环境”对话框。填写如表1所示信息。
- 单击“确定”,创建环境。
创建环境成功后,在“环境管理”页面的列表中显示新创建的环境。
访问环境
通过RESTful API可以访问API默认的RELEASE环境,如果访问其他环境,需要在请求头中添加X-Stage头,内容为环境名。例如访问名为“DEVELOP”的环境,则添加“X-Stage:DEVELOP”。
![](https://support.huaweicloud.com/intl/zh-cn/eu-west-0-usermanual-apig/public_sys-resources/note_3.0-zh-cn.png)
API网关管理控制台的“调试”功能,固定为调试环境,不支持携带环境变量调试。
创建环境变量
- 登录管理控制台。
- 单击管理控制台左上角
,然后单击“API网关 APIG”。
- 选择“开放API > API分组”,进入到API分组信息页面。
- 通过以下任意一种方式,进入“变量管理”页签。
- 单击待操作的分组名称,进入分组详细信息页面。单击“变量管理”。
- 在待创建环境变量的分组所在行,单击“更多 > 变量管理”。
- 在“环境”中选择待添加变量的环境名称,单击“添加变量”,弹出“新增变量”对话框。
- 填写如表2所示信息。
- 单击“确定”,完成变量的添加。
如果不再需要此变量时,在变量所在行单击“删除”。
在实际发送API请求中,环境变量名称与变量值会明文传递,请勿携带隐私信息。
后续操作
创建完环境和环境变量后,您可以将API发布到环境,以便API调用者调用。