调用ModifyMetricRuleBlackList接口修改报警黑名单策略

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	ModifyMetricRuleBlackList	要执行的操作，取值：ModifyMetricRuleBlackList。
Id	String	是	93514c96-ceb8-47d8-8ee3-93b6d98b****	报警黑名单策略的ID。关于如何获取报警黑名单策略的ID，请参见DescribeMetricRuleBlackList。
Name	String	是	Blacklist-02	报警黑名单策略的名称。
Namespace	String	是	acs_ecs_dashboard	云服务的数据命名空间。关于云服务的命名空间，请参见云服务监控项。
Category	String	是	ecs	云服务分类。例如：Redis有`kvstore_standard`（标准版）、`kvstore_sharding`（集群版）和`kvstore_splitrw`（读写分离版）等。
ScopeType	String	否	USER	报警黑名单策略的生效范围。取值： USER：报警黑名单策略仅在当前阿里云账号中生效。 GROUP（默认值）：报警黑名单策略在指定应用分组中生效，您需要选择指定应用分组。关于如何获取应用分组ID，请参见DescribeMonitorGroups。
ScopeValue	String	否	["67**","78**"]	应用分组ID列表。格式为JSON Array。说明仅当`ScopeType`为`GROUP`时，需要设置该参数。
EnableStartTime	String	否	1640237400000	报警黑名单策略生效的开始时间戳。单位：毫秒。
EnableEndTime	String	否	1640608200000	报警黑名单策略生效的结束时间戳。单位：毫秒。
EffectiveTime	String	否	03:00-04:59	报警黑名单策略的生效时间范围。是否设置该参数的含义如下：如果您未设置该参数，则报警黑名单策略永久有效。如果您已设置该参数，则黑名单策略仅在指定的时间范围内有效。该参数有以下两种格式示例： `03:00-04:59`：本地时间凌晨3点到凌5点（不包含05:00）报警黑名单策略有效。 `03:00-04:59 UTC+0700`：东7区时间凌晨3点到凌晨5点（不包含05:00）报警黑名单策略有效。
Instances.N	String	是	{"instancceId":"i-bp1ew0zfkjblsuwx****"}	报警黑名单策略中指定云服务的实例列表。格式为JSON Array。 N的取值范围：1~20。
Metrics.N.MetricName	String	是	disk_utilization	监控指标名称。 N的取值范围：1~10。
Metrics.N.Resource	String	否	{"device":"C:"}	实例的扩展维度信息。例如：`{"device":"C:"}`，表示对云服务器ECS实例下的所有C盘应用黑名单策略。 N的取值范围：1~10。

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

返回数据


名称	类型	示例值	描述
Code	String	200	状态码。说明 200表示成功。
Message	String	The specified resource is not found.	错误信息。
RequestId	String	008773AE-1D86-3231-90F9-1AF7F808F9CE	请求ID。
Success	Boolean	true	操作是否成功。取值： true：成功。 false：失败。
Count	String	1	成功修改报警黑名单策略的数量。

示例

请求示例

http(s)://[Endpoint]/?Action=ModifyMetricRuleBlackList
&Id=93514c96-ceb8-47d8-8ee3-93b6d98b****
&Name=Blacklist-02
&Namespace=acs_ecs_dashboard
&Category=ecs
&Instances=["{\"instancceId\":\"i-bp1ew0zfkjblsuwx****\"}"]
&Metrics=[{"MetricName":"disk_utilization"}]
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyMetricRuleBlackListResponse>
    <RequestId>008773AE-1D86-3231-90F9-1AF7F808F9CE</RequestId>
    <Success>true</Success>
    <Count>1</Count>
</ModifyMetricRuleBlackListResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "008773AE-1D86-3231-90F9-1AF7F808F9CE",
  "Success" : true,
  "Count" : "1"
}

错误码


HttpCode	错误码	错误信息	描述
404	ResourceNotFound	The specified resource is not found.	未找到指定资源。

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