# 创建环境
#### 功能介绍
在实际的生产中，API提供者可能有多个环境，如开发环境、测试环境、生产环境等，用户可以自由将API发布到某个环境，供调用者调用。对于不同的环境，API的版本、请求地址甚至于包括请求消息等均有可能不同。如：某个API，v1.0的版本为稳定版本，发布到了生产环境供生产使用，同时，该API正处于迭代中，v1.1的版本是开发人员交付测试人员进行测试的版本，发布在测试环境上，而v1.2的版本目前开发团队正处于开发过程中，可以发布到开发环境进行自测等。
为此，API网关提供多环境管理功能，使租户能够最大化的模拟实际场景，低成本的接入API网关。
#### URI
HTTP/HTTPS请求方法以及URI如下表所示。
表1HTTP/HTTPS请求方法以及URI 
| 请求方法 | URI              |
|:---|:---|
| POST | /v1.0/apigw/envs |
   
#### 请求消息
表2参数说明 
| 参数     | 是否必选 | 类型     | 说明                                                                                                                                                                                                                      |
|:---|:---|:---|:---|
| name   | 是    | String | 环境的名称 支持英文，数字，下划线，且只能以英文字母开头，3 \~ 64字符。                                                                                                                          |
| remark | 否    | String | 描述信息 字符长度不能大于255 说明： 中文字符必须为UTF-8或者unicode编码。 |
   
请求消息样例：
```
{
"name": "DEV",
"remark": "开发环境"
}
```
#### 响应消息
表3参数说明 
| 参数          | 类型        | 说明   |
|:---|:---|:---|
| id          | String    | 环境ID |
| name        | String    | 环境名称 |
| create_time | Timestamp | 创建时间 |
| remark      | String    | 描述信息 |
   
响应参数样例：
```
{
"id": "0035dd2e76dd4e3fa45fef634318ada4",
"name": "DEV",
"remark": "开发环境",
"create_time": "2017-12-28T12:50:47.0744311Z"
}
```
#### 状态码
表4返回消息说明 
| 状态码 | 说明                    |
|:---|:---|
| 201 | Created               |
| 400 | Bad Request           |
| 401 | Unauthorized          |
| 403 | Forbidden             |
| 500 | Server Internal Error |