UpdateCloudGtmMonitorTemplate - 修改健康探测模板

根据传入参数修改探测模板信息。

调试

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

授权信息

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

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

请求参数

名称类型必填描述示例值
AcceptLanguagestring

返回结果显示的语言。取值:

  • zh-CN:中文

  • en-US(默认值):英文

en-US
ClientTokenstring

用户生成的请求 token。用于保证请求的幂等性。注意 由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过 64 个 ASCII 字符。

1ae05db4-10e7-11ef-b126-00163e24****
TemplateIdstring

需要修改的健康探测模板 ID,唯一标识健康探测模板。

mtp-89518052425100****
Namestring

健康检查探测模板的名称,一般为了方便配置人员区分和记忆,建议名称可以区分健康检查协议。

Ping-IPv4
Intervalinteger

每次健康探测的时间间隔(秒),默认每间隔 1 分钟探测一次,健康检查间隔最小支持 15 秒(面向旗舰版实例开放)。

60
Timeoutinteger

探测超时时间(毫秒),大于超时时间未返回的数据包即判断为健康检查超时:

  • 2000

  • 3000

  • 5000

  • 10000

5000
EvaluationCountinteger

重试次数,连续多次监控出现异常,系统才将应用服务判断为异常,以防止因为一些网络瞬间抖动等其他原因影响监控准确率。重试次数可选值为:

  • 1

  • 2

  • 3

2
FailureRateinteger

所选节点探测失败比例(%),即健康检查异常的探测点占探测点总数的百分比,当失败比例超过设置的阈值时,将服务地址判断为异常。可设置的失败比例阈值为:

  • 20

  • 50

  • 80

  • 100

50
ExtendInfostring

Json 字符串扩展信息,各协议检查所需参数:

  • http(s):

    host:执行 HTTP(S)监控时,指定 HTTP(S)请求头部信息中携带的 Host 字段,用于标识需要访问的具体 HTTP 网站,默认为主域名,如果目标网站的 host 有特殊要求,请自行修改;

    path:HTTP 路径,用户 HTTP(S)健康检查的 URL 路径配置,系统默认填写“/”;

    code:当执行 HTTP(S)监控时,根据 Web 服务器的返回码判断 Web 服务器是否正常工作,大于返回码报警阈值时,系统认为应用服务出现异常:

    • 400:Bad Request,即如果 HTTP(S)请求携带了错误的请求参数,Web 服务器将返回大于 400 的返回码,如果校验内容设置为“异常码大于 400”,请务必在 URL 路径中填写精确的 URL 访问路径参数;

    • 500:Server Error,即如果 Web 服务器出现了某些异常,将返回大于 500 的异常码,系统默认使用大于 500 的异常码作为报警阈值;

    sni:是否开启 sni,仅在 HTTPS 协议时使用。SNI(Server Name Indication)是 TLS 协议的一个扩展,它允许客户端在发起 TLS 握手时指定想要连接的主机名。由于 TLS 握手发生在 HTTP 请求的任何数据被发送之前,SNI 允许服务器在发送证书之前知道客户端试图访问的服务,这使得服务器可以选择正确的证书来呈现给客户端。

    • true-开启

    • false-未开启

    followRedirect:是否跟随 3XX 重定向

    • true:监控点获取的状态码为 3XX (301,302,303, 307,308) 时,跟随跳转;

    • false:不跳转;

  • ping:

    packetNum:每次 Ping 监控,同时发出多少个 ICMP 数据包,可选 20、50、100

    packetLossRate:异常时丢包率,每次 ping 监控,对发出的 ICMP 数据包,计算丢包率(%)。丢包率=(丢失数据包/发送的总 ICMP 数据包数目)* 100%,达到丢包率阈值时,异常报警。丢包率可选值为:10、30、40、80、90、100

{\"code\":200,\"path\":\"\\index.htm\",\"host\":\"aliyun.com\"}
IspCityNodesarray<object>

探测节点列表,具体信息可通过调用 ListCloudGtmMonitorNodes 获取。

NodeListobject

探测节点。

CityCodestring

探测节点-城市编码。

503
IspCodestring

探测节点-运营商编码。

465

返回参数

名称类型描述示例值
object
RequestIdstring

唯一请求识别码。

6856BCF6-11D6-4D7E-AC53-FD579933522B
Successboolean

修改健康探测模板操作是否成功:

  • true:操作成功

  • false:操作失败

true

示例

正常返回示例

JSON格式

{
  "RequestId": "6856BCF6-11D6-4D7E-AC53-FD579933522B",
  "Success": true
}

错误码

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