文档中心

上云无忧 > 文档中心 > 百度智能云弹性伸缩伸缩组相关接口
百度智能云
弹性伸缩
简介/价格/文档
百度智能云弹性伸缩伸缩组相关接口

文档简介：
查询伸缩组列表 查询所有伸缩组的详细信息。 请求结构 GET /v{version}/asGroup?marker={marker}&maxKeys={maxKeys}&groupName={groupName} HTTP/1.1 Host: as.bj.baidubce.com Authorization: authorization string 请求头域 除公共头域外，无其它特殊头域。
*此产品及展示信息均由百度智能云官方提供。免费试用 咨询热线：400-826-7010，为您提供专业的售前咨询，让您快速了解云产品，助您轻松上云！ 微信咨询
  免费试用、价格特惠

查询伸缩组列表

  • 查询所有伸缩组的详细信息。

请求结构 

GET /v{version}/asGroup?marker={marker}&maxKeys={maxKeys}&groupName={groupName} HTTP/1.1
Host: as.bj.baidubce.com
Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称 类型 是否必需 参数位置 描述
version String 是 URL参数 API版本号
marker String 否 Query参数 批量获取列表的查询的起始位置，是一个由系统生成的字符串
maxKeys int 否 Query参数 每页包含的最大数量，最大数量通常不超过1000。缺省值为1000
groupName String 否 Query参数 伸缩组名称

返回头域

除公共头域，无其它特殊头域。

返回参数

参数名称 类型 描述
marker String 标记查询的起始位置
isTruncated boolean true表示后面还有数据，false表示已经是最后一页
nextMarker String 获取下一页所需要传递的marker值。当isTruncated为false时，该域不出现
maxKeys int 每页包含的最大数量
asGroupInfo List<AsGroup> 伸缩组信息，由 AsGroup 组成的集合

错误码

无特殊返回错误码

请求示例 

GET /v2/asGroup?marker=asg-IyWRtII7&maxKeys=1 HTTP/1.1
Host: as.bj.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21
/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

返回示例 

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Wed, 03 Dec 2014 06:42:19 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS

{
    "nextMarker": "asg-xktdeMSf",
    "marker": "asg-IyWRtII7",
    "maxKeys": 1,
    "isTruncated": true,
    "asGroupInfo": [
        {
            "groupId": "asg-LNwOIX6G",
            "groupName": "asg-01",
            "region": "bj",
            "status": "RUNNING",
            "vpcId": "vpc-09480k1ihuzn",
            "nodeNum": 0,
            "createTime": "2019-10-25T06:06:43Z",
            "zoneInfo": [{
                "zone": "zoneA",
                "subnetId": "sbn-5jtva2b0e7gf"
            }],
            "groupConfig": {
                "minNodeNum": 0,
                "maxNodeNum": 20,
                "cooldownInSec": 300
            },
            "blbId": "lb-e8dcbae4"
        }
    ]
}

查询伸缩组详情

  • 查询单个伸缩组的详细信息。

请求结构 

GET /v{version}/asGroup/{groupId} HTTP/1.1
Host: as.bj.baidubce.com
Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称 类型 是否必需 参数位置 描述
version String 是 URL参数 API版本号
groupId String 是 URL参数 待查询的伸缩组ID

返回头域

除公共头域，无其它特殊头域。

返回参数

参数名称 类型 描述
groupId String 伸缩组ID，符合BCE规范，是一个定长字符串，且只允许包含大小写字母、数字、连字号（-）和下划线（_)。
groupName String 伸缩组名称,支持大小写字母、数字、中文以及-_ /.特殊字符，必须以字母开头，长度1-65。
region String 伸缩组所在地域
status AsGroupStatus 伸缩组状态
vpcInfo VpcInfo 私有网络VPC信息
rdsIds String 云数据库RdsId
scsIds String 云数据库ScsId
createTime String 创建时间
zoneInfo ZoneInfo 可用区及子网信息
groupConfig GroupConfig 伸缩组规格
blb String 负载均衡Id
nodeNum int 伸缩组下节点数量

请求示例 

GET /v2/asGroup/asg-7a8LXBQ8 HTTP/1.1
Host: as.bj.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/
2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

返回示例 

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Wed, 03 Dec 2014 06:42:19 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS

{
    "groupId": "asg-LNwOIX6G",
    "groupName": "asg-01",
    "region": "bj",
    "status": "RUNNING",
    "vpcInfo": {
        "vpcId": "vpc-whrt3k5fq0h2",
        "vpcName": "network1"
    },
    "nodeNum": 0,
    "createTime": "2019-10-25T06:06:43Z",
    "zoneInfo": [{
        "zone": "cn-bj-a",
        "subnetId": "sbn-5jtva2b0e7gf"
    }],
    "groupConfig": {
        "minNodeNum": 0,
        "maxNodeNum": 20,
        "cooldownInSec": 300
    },
    "blbId": "lb-e8dcbae4"
}

查询伸缩组下节点列表

  • 查询指定伸缩组下节点的详细信息。

请求结构 

GET /v{version}/asNode/{groupId}?marker={marker}&maxKeys={maxKeys} HTTP/1.1
Host: as.bj.baidubce.com
Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称 类型 是否必需 参数位置 描述
version String 是 URL参数 API版本号
marker String 否 Query参数 批量获取列表的查询的起始位置，是一个由系统生成的字符串
maxKeys int 否 Query参数 每页包含的最大数量，最大数量通常不超过1000。缺省值为1000
groupId String 是 URL参数 伸缩组ID

返回头域

除公共头域，无其它特殊头域。

返回参数

参数名称 类型 描述
marker String 标记查询的起始位置
isTruncated boolean true表示后面还有数据，false表示已经是最后一页
nextMarker String 获取下一页所需要传递的marker值。当isTruncated为false时，该域不出现
maxKeys int 每页包含的最大数量
result List<NodeModel> 节点信息，由 NodeModel 组成的集合

错误码

无特殊返回错误码

请求示例 

GET /v2/asNode/asg-BKzF1aDX?marker=asg-IyWRtII7&maxKeys=1 HTTP/1.1
Host: as.bj.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/
2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

返回示例 

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Wed, 03 Dec 2014 06:42:19 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS

{
    "nextMarker": "asg-xktdeMSf",
    "marker": "asg-IyWRtII7",
    "maxKeys": 1,
    "isTruncated": true,
    "result": [
        {
            "instanceId": "i-XPWvxNy7",
            "instanceName": "instance-5ncjagda",
            "floatingIp": "10.107.233.231",
            "internalIp": "192.168.64.177",
            "status": "Running",
            "payment": "Postpaid",
            "cpuCount": 0,
            "memoryCapacityInGB": 0,
            "instanceType": "10",
            "sysDiskInGB": 40,
            "subnetType": "BCC",
            "createTime": "2019-10-25T06:06:43Z",
            "isProtected": true,
            "nodeType": "FOREIGN",
            "eip": {
                "bandwidthInMbps": 1,
                "address": "10.107.248.96",
                "eipStatus": "binded",
                "eipAllocationId": "ip-09c65903"
            }
        }
    ]
}

伸缩组扩容

  • 本接口用于在指定伸缩组下添加节点。
  • 接口参数：伸缩组ID、新增节点数量
  • 返回实例ID和伸缩组ID

请求结构 

POST /v{version}/asGroup/{groupId}?increase&clientToken={clientToken} HTTP/1.1
Host: as.bj.baidubce.com
Authorization: authorization string
{
  "nodeCount" : nodeCount
}

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称 类型 是否必需 参数位置 描述
version String 是 URL参数 API版本号
clientToken String 是 Query参数 幂等性Token，是一个长度不超过64位的ASCII字符串，详见链接
groupId String 是 URL参数 待添加节点的伸缩组ID
nodeCount int 是 RequestBody参数 新增节点数量

返回头域

除公共头域，无其它特殊头域。

返回参数

参数名称 类型 描述
groupId String 伸缩组ID
instanceId List<String> 实例ID

错误码

无特殊返回错误码

请求示例 

POST /v2/asGroup/asg-LNwOIX6G?increase&clientToken=3A8d84403d-a94b-40ce-9d6a-f6225dd26676
Host: as.bj.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/
2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

{
  "nodeCount" : 1
}

返回示例 

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Wed, 08 Jul 2015 03:28:11 GMT
x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS

{
  "groupId": "asg-LNwOIX6G",
  "instanceId": ["i-ymEOSpX8"]
}

伸缩组缩容

  • 本接口用于伸缩组下节点的缩容。
  • 接口参数：伸缩组ID、缩容数量
  • 当前伸缩组处于运行中状态，触发成功并返回TaskId
  • 当前伸缩组不处于运行中状态，触发失败并返回失败信息

请求结构 

POST /v{version}/asGroup/{groupId}?decrease&clientToken={clientToken} HTTP/1.1
Host: as.bj.baidubce.com
Authorization: authorization string
{
  "actionNum" : actionNum
}

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称 类型 是否必需 参数位置 描述
version String 是 URL参数 API版本号
clientToken String 是 Query参数 幂等性Token，是一个长度不超过64位的ASCII字符串，详见链接
groupId String 是 URL参数 待执行伸缩行为的伸缩组ID
actionNum int 是 RequestBody参数 缩容数量

返回头域

除公共头域，无其它特殊头域。

返回参数

参数名称 类型 描述
taskId String 任务ID

错误码

无特殊返回错误码

请求示例 

POST /v2/asGroup/asg-LNwOIX6G?decrease&clientToken=3A8d84403d-a94b-40ce-9d6a-f6225dd26676
Host: as.bj.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/
2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

{
  "actionNum" : 1
}

返回示例 

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Wed, 08 Jul 2015 03:28:11 GMT
x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS

{
  "taskId": "task-4IqP00II"
}

伸缩组节点数量调整

  • 本接口用于伸缩组下节点的缩容。
  • 接口参数：伸缩组ID、节点数量调整为
  • 当前伸缩组处于运行中状态，触发成功并返回TaskId
  • 当前伸缩组不处于运行中状态，触发失败并返回失败信息

请求结构 

POST /v{version}/asGroup/{groupId}?adjust&clientToken={clientToken} HTTP/1.1
Host: as.bj.baidubce.com
Authorization: authorization string
{
  "actionNum" : actionNum
}

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称 类型 是否必需 参数位置 描述
version String 是 URL参数 API版本号
clientToken String 是 Query参数 幂等性Token，是一个长度不超过64位的ASCII字符串，详见链接
groupId String 是 URL参数 待执行伸缩行为的伸缩组ID
actionNum int 是 RequestBody参数 节点数量调整为

返回头域

除公共头域，无其它特殊头域。

返回参数

参数名称 类型 描述
taskId String 任务ID

错误码

无特殊返回错误码

请求示例 

POST /v2/asGroup/asg-LNwOIX6G?adjust&clientToken=3A8d84403d-a94b-40ce-9d6a-f6225dd26676
Host: as.bj.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/
2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

{
  "actionNum" : 1
}

返回示例 

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Wed, 08 Jul 2015 03:28:11 GMT
x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS

{
  "taskId": "task-4IqP00II"
}
相似文档
  • 百度智能云弹性伸缩Model对象定义
    Model对象定义 AsGroup 参数名称 类型 描述 groupId String 伸缩组ID，符合BCE规范，是一个定长字符串，且只允许包含大小写字母、数字、连字号（-）和下划线（_)。 groupName String 伸缩组名称,支持大小写字母、数字、中文以及-_ /.特殊字符，必须以字母开头，长度1-65。
  • 百度智能云弹性伸缩安装JAVA SDK工具包
    运行环境 Java SDK工具包可在jdk1.7、jdk1.8环境下运行。 方式一：使用Maven安装 在Maven的pom.xml文件中添加bce-java-sdk的依赖： com.baidubce bce-java-sdk {version} 其中，{version}为版本号，可以在SDK下载页面找到。
  • 百度智能云弹性伸缩AsGroupClient
    AsGroupClient是Auto Scaling Group服务的客户端，为开发者与AsGroup服务进行交互提供了一系列的方法。 新建AsGroupClient 通过AK/SK方式访问AsGroup 用户可以参考如下代码新建一个AsGroupClient：
  • 百度智能云弹性伸缩伸缩组接口
    查询伸缩组列表 查询所有伸缩组的详细信息 public static void listAsGroup(AsGroupClient asGroupClient, String groupName, String marker, int maxKeys) { ListAsGroupRequest listAsGroupRequest = new ListAsGroupRequest(); // 可选，伸缩组名称 listAsGroupRequest.setGroupName(groupName);
  • 百度智能云弹性伸缩常见问题QA
    弹性伸缩能否提供垂直扩缩容的能力？ 目前弹性伸缩仅提供水平扩缩容能力，即增加或者减少实例数量，不能自动调整实例配置大小。伸缩组中的节点可以由用户自行调整配置大小。 伸缩组有哪些配额限制？ 默认一个账户在同一个区域最多创建10个伸缩组
官方微信
联系客服
400-826-7010
7x24小时客服热线
分享
  • QQ好友
  • QQ空间
  • 微信
  • 微博
返回顶部