BsmAgent相关接口
更新时间：2026-07-28
描述
批量获取最多100台虚机内bsm-agent的状态。
OpenAPI Explorer
去调试
您可以在 OpenAPI Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /v{version}/ca/agent/batch
2Host: ca.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "hosts": [
7 {
8 "instanceId": instanceId
9 }
10 ]
11}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值为1 |
| hosts | List<Host> | 是 | RequestBody参数 | 虚机列表 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| requestId | String | 请求id |
| code | String | 响应状态，成功为success |
| message | String | 错误信息 |
| success | Boolean | 请求是否处理成功 |
| result | List<Agent> | 虚机bsm-agent状态 |
请求示例
Plain Text
1POST /v1/ca/agent/batch
2Host: ca.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "hosts" : [ {
7 "instanceId" : "i-LxvHe***"
8 }, {
9 "instanceId" : "i-gVGDt***"
10 } ]
11}返回示例
Plain Text
1200 Success
2
3{
4 "requestId" : "d8752367-38e8-45e4-b4c7-e53be3******",
5 "code" : "success",
6 "result" : [ {
7 "host" : {
8 "instanceId" : "i-LxvHe***"
9 },
10 "state" : "ONLINE",
11 "version" : "0.0.0.1"
12 }, {
13 "host" : {
14 "instanceId" : "i-gVGDt***"
15 },
16 "state" : "OFFLINE",
17 "version" : "0.0.0.1"
18 } ]
19}评价此篇文章