云监控服务 CES-批量创建Agent任务:请求参数

时间:2024-11-11 16:42:49

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

发送的实体的MIME类型。默认使用application/json; charset=UTF-8。

缺省值:application/json; charset=UTF-8

最小长度:1

最大长度:64

X-Auth-Token

String

用户project Token。用户Token也就是调用获取用户Token接口的响应值,该接口是唯一不需要认证的接口。请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。

最小长度:1

最大长度:16384

表3 请求Body参数

参数

是否必选

参数类型

描述

instance_ids

Array of strings

主机id列表(INSTALL和UPDATE时必须)

数组长度:1 - 100

invocation_type

String

任务类型,INSTALL 安装,UPDATE升级,ROLLBACK回退,RETRY重试

枚举值:

  • INSTALL

  • UPDATE

  • ROLLBACK

  • RETRY

invocation_target

String

任务对象,目前仅支持telescope

缺省值:telescope

枚举值:

  • telescope

invocation_ids

Array of strings

任务ID列表(ROLLBACK和RETRY时必须)

数组长度:1 - 100

version_type

String

插件升级时需要选择升级“基础版本”还是“增强版本”,传值“BASIC_VERSION”表示升级成基础版本,传值“ADVANCE_VERSION”表示升级成增强版本

枚举值:

  • BASIC_VERSION

  • ADVANCE_VERSION

origin

String

Agent任务接口调用源, CES 表示由Console调用,APICOM_BMS表示由裸金属服务器调用,ADMIN_SERVER表示由运维平台调用

枚举值:

  • CES

  • APICOM_BMS

  • ADMIN_SERVER

version

String

版本号

最小长度:0

最大长度:64

正则匹配:^([0-9A-Za-z]|_|-|\.)+$

support.huaweicloud.com/api-ces/BatchCreateAgentInvocations.html