找不到 API ? 点击 反馈吧
- 应用分组
- 主机监控
- 事件中心
- 自定义监控
- 日志监控
- 站点监控
- 通过资源组创建应用分组CreateMonitorGroupByResourceGroupId
- 创建站点监控任务CreateSiteMonitor
- 创建一次性探测任务CreateInstantSiteMonitor
- 批量创建站点监控任务BatchCreateInstantSiteMonitor
- 删除站点监控的探测任务DeleteSiteMonitors
- 禁用一个或多个站点监控任务DisableSiteMonitors
- 修改站点监控任务ModifySiteMonitor
- 启用一个或多个站点监控任务EnableSiteMonitors
- 查询站点监控的配额以及版本DescribeSiteMonitorQuota
- 查询站点监控任务的详细信息DescribeSiteMonitorAttribute
- 查询所有运营商探测点详情DescribeSiteMonitorISPCityList
- 查询任务的细粒度监控数据DescribeSiteMonitorData
- 查询指定站点监控任务中指定监控项的平均统计数据DescribeSiteMonitorStatistics
- 查询站点监控任务列表DescribeSiteMonitorList
- 查询一次性探测任务的探测日志DescribeSiteMonitorLog
- 云产品监控
- 报警服务
- 企业云监控
- 其它
CreateSiteMonitor
创建站点监控任务
服务地址:
华东1(杭州)
参数配置
高级配置
输入参数
只看必填
注意事项
Address监控任务的URL或IP地址
TaskType监控任务的监控类型
TaskName监控任务的名称
Interval监控频率
IspCities探针信息
OptionsJson监控任务对应协议类型的高级扩展选项
AlertIds报警规则ID
CustomSchedule自定义探测周期
VpcConfig创建vpc内网拨测任务时需要提供的网络信息
文档
调用结果
SDK 示例
CLI示例
相关示例
调用历史
错误码
流控
插件下载了解更多
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
接口说明
本文将提供一个示例,创建一个站点监控任务HanZhou_ECS1
,该监控任务的监控地址为https://www.aliyun.com
、监控类型为HTTPS
。
请求参数
字段名称 | 字段详情 |
---|---|
Addressstring | 监控任务的 URL 或 IP 地址。 示例值:https://www.aliyun.com |
TaskTypestring | 监控任务的监控类型。展开详情 示例值:HTTP |
TaskNamestring | 监控任务的名称。展开详情 示例值:HanZhou_ECS1 |
Intervalstring | 监控频率。展开详情 示例值:1 |
IspCitiesstring | 探针信息。如果该参数取值为空,则系统随机选择 3 个探测点。展开详情 示例值:[{"city":"546","isp":"465"},{"city":"572","isp":"465"},{"city":"738","isp":"465"}] |
OptionsJsonstring | 监控任务对应协议类型的高级扩展选项。不同监控任务的协议类型对应不同的扩展选项。 示例值:{"time_out":5000} |
AlertIdsstring | 报警规则 ID。展开详情 示例值:SystemDefault_acs_ecs_dashboard_InternetOutRate_Percent |
CustomSchedulestring | 自定义探测周期。只能选择周一至周日的某个时间段进行探测。 示例值:{"start_hour":0,"end_hour":24, "days":[0], "time_zone":"Local"} |
VpcConfigstring | 创建 vpc 内网拨测任务时需要提供的网络信息。需要提供一个 JSON,里边必须包含 vpcId,vswitchId,securityGroupId 和 region 四个字段。 示例值:{"vpcId": "vpc-xxxxxx", "vswitchId": "vsw-xxxxxx", "securityGroupId": "sg-xxxxxx", "region": "cn-beijing"} |
请求说明
TaskType 中 HTTP(S)、PING、TCP、UDP、DNS、WEBSOCKET、SMTP、POP3 和 FTP 的高级参数的设置方法如下表所示。
- HTTP(S)
参数 | 类型 | 描述 |
---|---|---|
http_method | String | HTTP 或 HTTPS 请求方式。支持三种请求方式:GET、POST、HEAD。默认值:GET。 |
header | String | 换行符(\n)分隔的自定义 HTTP header。 每行 Header 格式需符合 HTTP 协议(使用半角冒号分隔的键值)。 |
cookie | String | Cookie 和 HTTP 请求标准的写法一致。 |
request_content | String | 请求内容。支持两种格式:JSON 和表单。不提供时,请求中不含正文。 |
response_content | String | 期望的回应内容。探测时会在 HTTP 服务器返回的前 64 个字节进行检查。 |
match_rule | String | 0:回应中不含 response_content 时,探测成功。 1:回应中含 response_content 时,探测成功。 |
username | String | 如果提供用户名,则会在 HTTP 请求中携带 BasicAuth header。 |
password | String | HTTP 或 HTTPS 请求验证密码。 |
time_out | int | 超时时间。单位:毫秒。默认值:5 。 |
max_redirect | int | 最大跳转次数。ECS 探针默认 5 次,运营商探针默认 2 次。 如果需要禁止跳转,则将该参数设置为:0。 取值范围:0~50 。 |
- PING
参数 | 类型 | 描述 |
---|---|---|
failure_rate | 文本 | 当 PING 失败率超过该参数时,探测失败,返回 610(PingAllFail)或 615(PingPartialFail)。 默认值:0.1。 |
ping_num | int | PING 次数,默认值:10。 取值范围:1~100。 |
- DNS
参数 | 类型 | 描述 |
---|---|---|
dns_server | string | DNS 服务器地址,可以为域名或 IP 地址。 |
dns_type | string | DNS 查询类型。取值:A、NS、CNAME、MX、TXT、ANY、AAAA。 |
expect_value | string | 英文空白符分隔的期望值列表。 |
match_rule | string | 期望值列表与 DNS 列表的关系,当不满足指定关系时,探测失败。 空字符串或 IN_DNS:期望值列表是 DNS 列表的子集。 DNS_IN:DNS 列表是期望值列表的子集。 EQUAL:DNS 列表与期望值列表相等。 ANY:DNS 列表与期望值列表有交集(交集不为空)。 |
- FTP
参数 | 类型 | 描述 |
---|---|---|
port | int | FTP 服务器端口号。如果不提供,则使用默认值。FTP 默认值:21,FTPS 默认值:990。 |
username | string | FTP 用户名。 如果未提供,则匿名登录。 |
password | string | FTP 密码。 |
- POP3 或 SMTP
参数 | 类型 | 描述 |
---|---|---|
port | int | POP3 或 SMTP 服务器的端口号。POP3 默认值:110,POP3S 默认值:995,SMTP 默认值:25。 |
username | string | POP3 或 SMTP 的用户名。POP3 或 SMTP 的用户名和密码必填。 |
password | string | POP3 或 SMTP 的密码。POP3 或 SMTP 的用户名和密码必填。 |
- TCP 或 UDP
参数 | 类型 | 描述 |
---|---|---|
port | int | TCP 或 UDP 服务器的端口。 |
request_content | string | 请求内容。当 request_format 为 hex 时,request_content 内容为十六进制紧凑格式。 |
request_format | string | 当 request_format 为其他值时,request_content 作为普通字符串发送给 TCP 或 UDP 服务器。 |
response_content | string | 回应内容。当 TCP 或 UDP 服务器返回的内容中不含 response_content 时,探测失败。 当 response_format 为 hex 时,response_content 中的内容为十六进制紧凑格式。 当 response_content 为其他值时,response_content 为普通字符串。 |
- WEBSOCKET
参数 | 类型 | 描述 |
---|---|---|
request_content | string | 消息内容。 |
empty_message | boolean | 允许服务端不返回消息或返回空字符串。 |
返回参数
变更历史
暂无变更历史