# 修改环境信息
#### 功能介绍
此API通过环境ID修改环境信息。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=ServiceStage&api=ChangeEnvironment)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
PUT /v2/{project_id}/cas/environments/{environment_id}
表1路径参数 
| 参数             | 是否必选 | 参数类型   | 描述                                                                                                   |
|:---|:---|:---|:---|
| project_id     | 是    | String | 租户项目ID。获取方法，请参考[获取项目ID](https://support.huaweicloud.com/api-servicestage/servicestage_06_0164.html)。 |
| environment_id | 是    | String | 环境ID。获取方法，请参考[获取所有环境](https://support.huaweicloud.com/api-servicestage/servicestage_06_0024.html)。   |
   
#### 请求消息
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                           |
|:---|:---|:---|:---|
| Content-Type | 是    | String | 消息体的类型（格式），默认取值为"application/json;charset=utf8"。                                                                                             |
| X-Auth-Token | 是    | String | 调用接口的认证方式分为Token和AK/SK两种。如果您使用的Token方式，此参数为必填，请填写Token的值。Token获取方式，请参考[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)。 |
   
表3请求Body参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                                                                                                  |
|:---|:---|:---|:---|
| name        | 否    | String | 环境名称。 由英文字母、数字、中划线（-）、下划线（_）组成，并以英文字母开头，英文字母或者数字结尾，英文字母不区分大小写，长度为2\~64个字符。 |
| alias       | 否    | String | 环境别名。 最大长度为64个字符。                                                                            |
| description | 否    | String | 环境描述。 最大长度为128个字符。                                                                          |
   
#### 响应消息
表4响应参数 
| 参数                    | 参数类型             | 描述                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|
| id                    | String           | 环境ID。                                                                                                                                                                                                                                                                                                                                                                                                                 |
| name                  | String           | 环境名称。                                                                                                                                                                                                                                                                                                                                                                                                                 |
| alias                 | String           | 环境别名。                                                                                                                                                                                                                                                                                                                                                                                                                 |
| description           | String           | 环境描述。                                                                                                                                                                                                                                                                                                                                                                                                                 |
| project_id            | String           | 项目ID。                                                                                                                                                                                                                                                                                                                                                                                                                 |
| enterprise_project_id | String           | 企业项目ID。                                                                                                                                                                                                                                                                                                                                                                                                               |
| charge_mode           | String           | 收费模式。                                                                                                                                                                                                                                                                                                                                                                                                                 |
| deploy_mode           | String           | 环境类型。 - virtualmachine：虚拟机。  - container：Kubernetes。  - mixed ：虚拟机和Kubernetes。   |
| vpc_id                | String           | 虚拟私有云ID。                                                                                                                                                                                                                                                                                                                                                                                                              |
| base_resources        | Array of objects | 基础资源，请参考[表5]。                                                                                                                                                                                                                                                                                                                                                  |
| optional_resources    | Array of objects | 可选资源，请参考[表5]。                                                                                                                                                                                                                                                                                                                                                  |
| creator               | String           | 创建人。                                                                                                                                                                                                                                                                                                                                                                                                                  |
| create_time           | Integer          | 创建时间。                                                                                                                                                                                                                                                                                                                                                                                                                 |
| update_time           | Integer          | 修改时间。                                                                                                                                                                                                                                                                                                                                                                                                                 |
   
 表5resources 
| 参数   | 参数类型   | 描述                                                                                                   |
|:---|:---|:---|
| id   | String | 资源ID。                                                                                                |
| name | String | 资源名称。                                                                                                |
| type | String | 基础资源：cce、ecs、as。 可选资源：rds、dcs、elb、cse等其他类型。 |
   
#### 请求示例
修改名称为development-env2的环境，增加环境描述信息。
```
{
"name": "development-env2",
"description": "here is description"
}
```
#### 响应示例
```
{
"id": "00078e9d-a61c-476e-ac63-a10c9cb2638e",
"name": "development-env2",
"alias": null,
"description": "here is description",
"project_id": "e7d2e9c589e5445e808a8ff0d1235aca",
"enterprise_project_id": "0",
"charge_mode": "provided",
        "deploy_mode": "container",
"vpc_id": "29d55020-ae0e-4a18-871c-93e6976ee7bd",
"base_resources": [
{
"id": "523498f1-36c4-11eb-ae36-0255ac1000c2",
"type": "cce",
"name": "cce-test"
}
],
"optional_resources": [
{
"id": "9963306a-791e-468c-9306-cf80a9d00298",
"type": "elb",
"name": "elb-2dd2"
}
],
"creator": "ss-test",
"create_time": 1610418873730,
"update_time": 1610420992462
}
```
#### 状态码
| 状态码 | 描述       |
|:---|:---|
| 200 | 操作成功。    |
| 400 | 错误的请求。   |
| 404 | 请求对象不存在。 |
| 500 | 内部错误。    |
   
#### 错误码
请参考[ServiceStage错误码](https://support.huaweicloud.com/api-servicestage/servicestage_06_0162.html)。