环境相关接口
更新时间：2019-06-14
环境相关接口
创建环境
| 方法 | API | 说明 |
|---|---|---|
| POST | /v1/env?clientToken={clientToken} | 创建一个新的环境 |
请求参数
| 参数名称 | 参数类型 | 是否必须 | 说明 |
|---|---|---|---|
| clientToken | String | 必须 | 用于保证接口幂等性 |
| appId | String | 必须 | 应用ID |
| envName | String | 必须 | 环境的名称，同一个应用下环境的名称不可重复 |
| domainPrefix | String | 必填 | 申请的域名前缀 |
| imageTag | String | 可选 | 自定义镜像的版本信息 |
| payType | String | 必须 | 付费方式，支持预付费与后付费，即Prepay, Postpay |
| chargeTime | Int | 可选 | 付费时长，预付费时必填，单位为月，12表示一年 |
| couponName | String | 可选 | 代金券名称 |
| instanceAmount | Int | 必须 | 实例数量 |
| cpuInCore | Int | 必须 | 每个实例最大使用的cpu核数 |
| memoryInMB | Int | 必须 | 每个实例最大使用的内存，单位MB |
| loadBalanceBandwidthInMbps | Int | 必须 | 负载均衡的最大网络带宽，单位Mbps |
返回参数
| 参数名称 | 参数类型 | 说明 |
|---|---|---|
| envId | String | 环境ID，由系统随机生成 |
| charge | BigDecimal | 消费金额，单位元 |
| expiredTime | Date | 预付费过期时间 |
| orderId | String | 订单ID |
请求示例
Plain Text
1POST /v1/env?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
2HOST: baepro.bj.baidubce.com
3Authorization: {authorization}
4Content-Type: application/json; charset=utf-8
5x-bce-date: 2016-06-01T23:00:10Z
6
7{
8 "appId": "baeapp-5atue8m3sxsv",
9 "envName": "released",
10 "domainPrefix": "testapp",
11 "payType": "Prepay",
12 "chargeTime": 2,
13 "instanceAmount": 2,
14 "cpuInCore": 1,
15 "memoryInMB": 1024,
16 "loadBalanceBandwidthInMbps": 5
17}返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3x-bce-request-id: 9ebc57ed-1ff5-480f-b5b1-6847ff54f2b4
4
5{
6 "envId": "baeenv-6zgpg8h8ujcq",
7 "charge": 100.12,
8 "expiredTime": "2016-08-01T23:00:10Z",
9 "orderId": "d04da3c16bd042af9e916a75bb1fa19g"
10}更新环境配置
| 方法 | API | 说明 |
|---|---|---|
| PUT | /v1/env/{envId}?clientToken={clientToken} | 更新环境配置（异步接口），即对内存、CPU或带宽执行升级或降级操作 |
请求参数
| 参数名称 | 参数类型 | 是否必须 | 说明 |
|---|---|---|---|
| clientToken | String | 必须 | 用于保证接口幂等性 |
| couponName | String | 可选 | 代金券名称 |
| instanceAmount | Int | 可选 | 实例数量 |
| cpuInCore | Int | 可选 | 每个实例最大使用的cpu核数 |
| memoryInMB | Int | 可选 | 每个实例最大使用的内存，单位MB |
| loadBalanceBandwidthInMbps | Int | 可选 | 负载均衡的最大网络带宽，单位Mbps |
请求示例
Plain Text
1PUT /v1/env/baeenv-iix5bwc10hfw?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
2HOST: baepro.bj.baidubce.com
3Authorization: {authorization}
4Content-Type: application/json; charset=utf-8
5x-bce-date: 2016-06-01T23:00:10Z
6
7{
8 "instanceAmount": 2,
9 "cpuInCore": 1,
10 "memoryInMB": 1024,
11 "loadBalanceBandwidthInMbps": 5
12}返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3x-bce-request-id: 9ebc57ed-1ff5-480f-b5b1-6847ff54f2b4删除环境
| 方法 | API | 说明 |
|---|---|---|
| DELETE | /v1/env/{envId} | 删除环境 |
请求示例
Plain Text
1DELETE /v1/env/baeenv-iix5bwc10hfw HTTP/1.1
2HOST: baepro.bj.baidubce.com
3Authorization: {authorization}
4Content-Type: application/json; charset=utf-8
5x-bce-date: 2016-06-01T23:00:10Z返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3x-bce-request-id: 9ebc57ed-1ff5-480f-b5b1-6847ff54f2b4获取环境信息
| 方法 | API | 说明 |
|---|---|---|
| GET | /v1/env/{envId} | 获取环境信息 |
返回参数
返回值为一个env对象，如下表所示。
env参数列表
| 参数名称 | 参数类型 | 说明 |
|---|---|---|
| appId | String | 应用ID |
| envId | String | 环境ID |
| envName | String | 环境的名称 |
| domainPrefix | String | 域名前缀 |
| domains | List<domain> | 由domain组成的数组，具体内容参请看domain参数列表 |
| code | Object | 一个envCode对象，具体内容请参看envCode参数列表 |
| image | Object | 一个envImage对象，具体内容请参看envImage参数列表 |
| createTime | DateTime | 环境的创建时间 |
| instanceAmount | Int | 实例数量 |
| instanceParameters | Object | 一个instanceParameters对象，具体内容请参看instanceParameters参数列表 |
| loadBalanceParameters | Object | 一个loadBalanceParameters对象，共享版不返回此项。具体内容请参看loadBalanceParameters参数列表 |
| status | String | 环境状态 |
| loadBalance | Object | 负载均衡相关，共享版不返回此项 |
domain参数列表
| 参数名称 | 参数类型 | 说明 |
|---|---|---|
| domain | String | 环境的域名 |
| default | Boolean | 该域名是否是由BAE提供的默认域名 |
| status | String | 域名状态 |
envCode参数列表
| 参数名称 | 参数类型 | 说明 |
|---|---|---|
| versionId | String | 部署的代码的版本号 |
| deployTime | DateTime | 部署时间 |
envAutoDeploy参数列表
| 参数名称 | 参数类型 | 说明 |
|---|---|---|
| enable | Boolean | 自动部署状态 |
envImage参数列表
| 参数名称 | 参数类型 | 说明 |
|---|---|---|
| imageId | String | 自定义镜像ID |
| name | String | 自定义镜像名称 |
| tag | String | 自定义镜像版本 |
instanceParameters参数列表
| 参数名称 | 参数类型 | 说明 |
|---|---|---|
| memoryInMB | Int | 实例内存大小 |
| cpuInCore | Int | 实例最大使用的cpu核数 |
| diskInGB | Int | 实例磁盘大小 |
| bandwidthInMbps | int | 实例带宽 |
loadBalanceParameters参数列表
| 参数名称 | 参数类型 | 说明 |
|---|---|---|
| bandwidthInMbps | Int | 负载均衡带宽 |
loadBalance参数列表
| 参数名称 | 参数类型 | 说明 |
|---|---|---|
| ip | String | 负载均衡公网IP |
请求示例
Plain Text
1GET /v1/env/baeenv-iix5bwc10hfw HTTP/1.1
2HOST: baepro.bj.baidubce.com
3Authorization: {authorization}
4Content-Type: application/json; charset=utf-8
5x-bce-date: 2016-06-01T23:00:10Z返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3x-bce-request-id: 9ebc57ed-1ff5-480f-b5b1-6847ff54f2b4
4
5{
6 "appId": "baeapp-5atue8m3sxsv",
7 "envId": "baeenv-iix5bwc10hfw",
8 "envName": "released",
9 "domainPrefix": "testapp",
10 "domains": [{
11 "domain": "testapp.duapp.com",
12 "default": true,
13 "status": "Active"
14 }],
15 "code": {
16 "versionId": "1",
17 "deployTime": "2016-06-01T23:00:10Z"
18 },
19 "createTime": "2016-06-01T23:00:10Z",
20 "instanceAmount": 2,
21 "instanceParameters": {
22 "cpuInCore": 1,
23 "memoryInMB": 1024,
24 "diskInGB": 2,
25 "bandwidthInMbps": 5
26 },
27 "loadBalanceParameters": {
28 "bandwidthInMbps": 10
29 },
30 "status": "Running",
31 "stopped": false,
32 "banned": false,
33 "loadBalance": {
34 "externalIp": "200.123.123.10",
35 "internalIp": "10.44.123.10"
36 }
37}查看环境列表
| 方法 | API | 说明 |
|---|---|---|
| GET | /v1/env?appId={appId} | 查看应用的环境列表 |
返回参数
| 参数名称 | 参数类型 | 说明 |
|---|---|---|
| envs | List<env> | 由env组成的数组 |
请求示例
Plain Text
1GET /v1/env?appId=baeapp-5atue8m3sxsv HTTP/1.1
2HOST: baepro.bj.baidubce.com
3Authorization: {authorization}
4Content-Type: application/json; charset=utf-8
5x-bce-date: 2016-06-01T23:00:10Z返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3x-bce-request-id: 9ebc57ed-1ff5-480f-b5b1-6847ff54f2b4
4
5{
6 "envs": [{
7 "appId": "baeapp-5atue8m3sxsv",
8 "envId": "baeenv-iix5bwc10hfw",
9 "envName": "released",
10 "domainPrefix": "testapp",
11 "domains": [{
12 "domain": "testapp.duapp.com",
13 "default": true,
14 "status": "Active"
15 }],
16 "code": {
17 "versionId": "1",
18 "deployTime": "2016-06-01T23:00:10Z"
19 },
20 "createTime": "2016-06-01T23:00:10Z",
21 "instanceAmount": 2,
22 "instanceParameters": {
23 "cpuInCore": 1,
24 "memoryInMB": 1024,
25 "diskInGB": 2,
26 "bandwidthInMbps": 5
27 },
28 "loadBalanceParameters": {
29 "bandwidthInMbps": 10
30 },
31 "status": "Running",
32 "stopped": false,
33 "banned": false,
34 "loadBalance": {
35 "externalIp": "200.123.123.10",
36 "internalIp": "10.44.123.10"
37 }
38 }]
39}暂停环境
| 方法 | API | 说明 |
|---|---|---|
| PUT | /v1/env/{envId}?pause | 暂停环境（异步接口） |
请求示例
Plain Text
1PUT /v1/env/baeenv-iix5bwc10hfw?pause HTTP/1.1
2HOST: baepro.bj.baidubce.com
3Authorization: {authorization}
4Content-Type: application/json; charset=utf-8
5x-bce-date: 2016-06-01T23:00:10Z返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3x-bce-request-id: 9ebc57ed-1ff5-480f-b5b1-6847ff54f2b4恢复环境
| 方法 | API | 说明 |
|---|---|---|
| PUT | /v1/env/{envId}?resume | 恢复环境（异步接口） |
请求示例
Plain Text
1PUT /v1/env/baeenv-iix5bwc10hfw?resume HTTP/1.1
2HOST: baepro.bj.baidubce.com
3Authorization: {authorization}
4Content-Type: application/json; charset=utf-8
5x-bce-date: 2016-06-01T23:00:10Z返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3x-bce-request-id: 9ebc57ed-1ff5-480f-b5b1-6847ff54f2b4环境续费
| 方法 | API | 说明 |
|---|---|---|
| PUT | /v1/env/{envId}?renew | 环境续费 |
请求参数
| 参数名称 | 参数类型 | 是否必须 | 说明 |
|---|---|---|---|
| couponName | String | 可选 | 代金券名称 |
| chargeTime | Int | 可选 | 续费时长，单位为月 |
返回参数
| 参数名称 | 参数类型 | 说明 |
|---|---|---|
| charge | BigDecimal | 消费金额，单位元 |
| expiredTime | Date | 预付费过期时间 |
| orderId | String | 订单ID |
请求示例
Plain Text
1PUT /v1/env/baeenv-iix5bwc10hfw?renew HTTP/1.1
2HOST: baepro.bj.baidubce.com
3Authorization: {authorization}
4Content-Type: application/json; charset=utf-8
5x-bce-date: 2016-06-01T23:00:10Z
6
7{
8 "couponName": "coupon123",
9 "chargeTime": 2
10}返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3x-bce-request-id: 9ebc57ed-1ff5-480f-b5b1-6847ff54f2b4
4
5{
6 "charge": 100.12,
7 "expiredTime": "2016-06-01T23:00:10Z",
8 "orderId": "d04da3c16bd042af9e916a75bb1fa19g"
9}部署代码到环境
| 方法 | API | 说明 |
|---|---|---|
| PUT | /v1/env/{envId}?deploy | 部署代码到环境（异步接口） |
请求参数
| 参数名称 | 参数类型 | 是否必须 | 说明 |
|---|---|---|---|
| versionId | String | 必须 | 部署的代码的版本号 |
请求示例
Plain Text
1PUT /v1/env/baeenv-iix5bwc10hfw?deploy HTTP/1.1
2HOST: baepro.bj.baidubce.com
3Authorization: {authorization}
4Content-Type: application/json; charset=utf-8
5x-bce-date: 2016-06-01T23:00:10Z
6
7{
8 "versionId": "2"
9}返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3x-bce-request-id: 9ebc57ed-1ff5-480f-b5b1-6847ff54f2b4判断环境名称是否存在
| 方法 | API | 说明 |
|---|---|---|
| HEAD | /v1/env?appId={appId}&envName={envName} | 判断应用下环境名称是否已存在 |
请求参数
| 参数名称 | 参数类型 | 是否必须 | 说明 |
|---|---|---|---|
| appId | String | 必须 | 应用ID |
| envName | String | 必须 | 环境名称 |
返回参数
环境名称不存在时返回状态码为404，已存在时返回状态码为204。
请求示例
Plain Text
1HEAD /v1/env?appId=baeapp-5atue8m3sxsv&envName=released HTTP/1.1
2HOST: baepro.bj.baidubce.com
3Authorization: {authorization}
4Content-Type: application/json; charset=utf-8
5x-bce-date: 2016-06-01T23:00:10Z返回示例
Plain Text
1HTTP/1.1 404 Not Found
2Content-Type: application/json; charset=utf-8
3x-bce-request-id: 9ebc57ed-1ff5-480f-b5b1-6847ff54f2b4修改环境名称
| 方法 | API | 说明 |
|---|---|---|
| PUT | /v1/env/{envId}?envName | 修改环境名称 |
请求参数
| 参数名称 | 参数类型 | 是否必须 | 说明 |
|---|---|---|---|
| envName | String | 必须 | 环境名称 |
请求示例
Plain Text
1PUT /v1/env/baeenv-iix5bwc10hfw?envName HTTP/1.1
2HOST: baepro.bj.baidubce.com
3Authorization: {authorization}
4Content-Type: application/json; charset=utf-8
5x-bce-date: 2016-06-01T23:00:10Z
6
7{
8 "envName": "released"
9}返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3x-bce-request-id: 9ebc57ed-1ff5-480f-b5b1-6847ff54f2b4设置环境https
| 方法 | API | 说明 |
|---|---|---|
| PUT | /v1/env/{envId}/https | 设置环境HTTPS（异步接口） |
请求参数
| 参数名称 | 参数类型 | 是否必须 | 说明 |
|---|---|---|---|
| certId | String | 必须 | 证书id |
| enable | Boolean | 必须 | 是否打开https |
| force | Boolean | 可选 | 是否打开强制https |
请求示例
Plain Text
1PUT /v1/env/baeenv-iix5bwc10hfw/https HTTP/1.1
2HOST: baepro.bj.baidubce.com
3Authorization: {authorization}
4Content-Type: application/json; charset=utf-8
5x-bce-date: 2016-06-01T23:00:10Z
6
7{
8 "certId": "cert-xxxxxx"
9 "enable" : true
10}返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3x-bce-request-id: 9ebc57ed-1ff5-480f-b5b1-6847ff54f2b4获取环境https状态
| 方法 | API | 说明 |
|---|---|---|
| GET | /v1/env/{envId}/https | 获取环境HTTPS状态 |
返回参数
| 参数名称 | 参数类型 | 说明 |
|---|---|---|
| certId | String | 证书id |
| enable | Boolean | 是否打开https |
| force | Boolean | 是否打开强制https |
请求示例
Plain Text
1GET /v1/env/baeenv-iix5bwc10hfw/https HTTP/1.1
2HOST: baepro.bj.baidubce.com
3Authorization: {authorization}
4Content-Type: application/json; charset=utf-8
5x-bce-date: 2016-06-01T23:00:10Z返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3x-bce-request-id: 9ebc57ed-1ff5-480f-b5b1-6847ff54f2b4
4{
5 "certIds": "cert-xxxxxx"
6 "enable" : true
7 "force" : false
8}设置环境自动部署
| 方法 | API | 说明 |
|---|---|---|
| PUT | /v1/env/{envId}?autoDeploy | 设置环境自动部署 |
请求参数
| 参数名称 | 参数类型 | 是否必须 | 说明 |
|---|---|---|---|
| enable | Boolean | 必须 | 是否打开自动部署 |
请求示例
Plain Text
1PUT /v1/env/baeenv-iix5bwc10hfw?autoDeploy HTTP/1.1
2HOST: baepro.bj.baidubce.com
3Authorization: {authorization}
4Content-Type: application/json; charset=utf-8
5x-bce-date: 2016-06-01T23:00:10Z
6
7{
8 "enable" : true
9}返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3x-bce-request-id: 9ebc57ed-1ff5-480f-b5b1-6847ff54f2b4更新环境镜像版本
| 方法 | API | 说明 |
|---|---|---|
| PUT | /v1/env/{envId}?imageTag | 更新环境镜像版本 |
请求参数
| 参数名称 | 参数类型 | 是否必须 | 说明 |
|---|---|---|---|
| imageTag | String | 必须 | 需要更新的镜像版本 |
请求示例
Plain Text
1PUT /v1/env/baeenv-iix5bwc10hfw?imageTag HTTP/1.1
2HOST: baepro.bj.baidubce.com
3Authorization: {authorization}
4Content-Type: application/json; charset=utf-8
5x-bce-date: 2016-06-01T23:00:10Z
6
7{
8 "imageTag" : "tag123"
9}返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3x-bce-request-id: 9ebc57ed-1ff5-480f-b5b1-6847ff54f2b4