调用ModifyHybridMonitorTask修改监控任务_云监控(CMS)-阿里云帮助中心

调用ModifyHybridMonitorTask接口修改SLS日志的监控项。

接口说明

本文将提供一个示例，将 SLS 日志的监控任务36****的采集周期修改为15秒。返回结果显示，修改监控项成功。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
cms:ModifyHybridMonitorTask	update	全部资源 *	无	无

请求参数

名称	类型	必填	描述	示例值
TaskId	string	是	监控任务 ID。关于如何获取监控任务 ID，请参见 DescribeHybridMonitorTaskList 。	36****
TaskName	string	否	监控任务名称。关于如何获取监控任务 ID，请参见 DescribeHybridMonitorTaskList 。	SLS_task
Description	string	否	监控任务描述。	SLS日志监控数据。
CollectInterval	string	否	监控项的采集周期。取值： 15 60 单位：秒。	15
AttachLabels	array<object>	否	监控项的标签。
	object	否	无。
Value	string	否	监控项的标签值。	testValue
Name	string	否	监控项的标签键。	app_service
SLSProcessConfig	object	否	SLS 日志配置。
Filter	object	否	SLS 日志中参数的过滤条件。
Relation	string	否	多个参数过滤条件之间的关系。取值： and（默认值）：满足所有过滤条件，才处理日志。 or：满足任意过滤条件，即可处理日志。	and
Filters	array<object>	否	无。
	object	否	无。
SLSKeyName	string	否	SLS 日志中过滤的参数名称。	code
Operator	string	否	SLS 日志中参数值的过滤方式。取值： `contain`：包含。 `notContain`：不包含。 `>`：大于。 `<`：小于。 `=`：等于。 `!=`：不等于。 `>=`：大于等于。 `<=`：小于等于。	=
Value	string	否	SLS 日志中参数的过滤值。	200
Statistics	array<object>	否	无。
	object	否	无。
SLSKeyName	string	否	SLS 日志统计的参数名称。	name
Function	string	否	在计算周期内根据选定的统计方法对日志数据进行聚合处理。取值： count：计数。 sum：求和。 avg：平均值。 max：最大值。 min：最小值。 value：周期内采样。 countps：计算统计周期内指定字段求 count 后的每秒平均值。 sumps：计算统计周期内指定字段求 sum 后的每秒平均值。 distinct：去重后计算统计周期内指定字段出现的次数。 distribution：计算字段值在一个区间内的出现次数。 percentile：计算字段值的分布值，例如：P50。	count
Alias	string	否	SLS 日志统计结果的别名。	level_count
Parameter1	string	否	SLS 日志的统计值。当`Function`为`distribution`时，表示统计区间的下限，例如：统计 HttpCode 的 2XX 数量，填写 200。当`Function`为`percentile`时，表示统计分布的百分位，例如：0.5 表示 P50。	200
Parameter2	string	否	SLS 日志的统计值。说明仅当`Function`为`distribution`时，需要设置该参数。表示统计区间的上限，例如：统计 HttpCode 的 2XX 数量，填写 299。	299
GroupBy	array<object>	否	对数据进行空间维度聚合，相当于 SQL 中的 Group By。
	object	否	无。
SLSKeyName	string	否	SLS 日志统计的参数名称。	code
Alias	string	否	SLS 日志统计结果的别名。	ApiResult
Express	array<object>	否	SLS 日志统计结果的扩展字段的四则运算结果。
	object	否	无。
Express	string	否	SLS 日志统计结果的扩展字段的四则运算结果。	success_count
Alias	string	否	SLS 日志统计结果的扩展字段的四则运算结果的别名。	SuccRate

关于公共请求参数的详情，请参见公共参数。

返回参数

名称	类型	描述	示例值
	object	无。
Code	string	状态码。说明 200 表示成功。	200
Message	string	错误信息。	Invalid.SLSConfig
RequestId	string	请求 ID。	11145B76-566A-5D80-A8A3-FAD98D310079
Success	string	操作是否成功。取值： true：成功。 false：失败。	true

示例

正常返回示例

JSON格式

{
  "Code": "200",
  "Message": "Invalid.SLSConfig",
  "RequestId": "11145B76-566A-5D80-A8A3-FAD98D310079",
  "Success": "true"
}

错误码

HTTP status code	错误码	错误信息
400	%s	%s
500	InternalError	%s

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作
2022-07-11	OpenAPI 错误码发生变更	查看变更详情