すべてのプロダクト
Search
ドキュメントセンター

Application Real-Time Monitoring Service:UpdateTimingSyntheticTask

最終更新日:Apr 11, 2026

スケジュールされた合成監視タスクを更新します。

操作説明

クラウドダイヤルテストは現在、中国 (杭州) リージョンでのみ利用可能です。SDK または OpenAPI を使用する場合は、中国 (杭州) リージョンに対応するサービスアクセスポイントを選択してください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター

必須 / 任意

説明

RegionId

string

任意

リージョン ID。

cn-hangzhou

TaskId

string

任意

合成監視タスクの ID。

5308a2691f59422c8c3b7aeccxxxxxxx

Name

string

任意

タスクの名前。

拨测任务

MonitorConf

object

任意

モニタリング設定。

NetICMP

object

任意

ICMP 合成監視テストのパラメーター。

TargetUrl

string

任意

宛先ホストの IP アドレスまたはドメイン名。この値には、ポート番号、プロトコルヘッダー、またはリクエストパスを含めることはできません。

www.aliyun.com

Interval

integer

任意

ICMP パケットの送信間隔。単位:ミリ秒。最小値:200。最大値:10000。

300

PackageNum

integer

任意

送信される ICMP パケットの数。最小値:1。最大値:50。デフォルト値:4。

4

PackageSize

integer

任意

各 ICMP パケットのサイズ。単位:バイト。有効な値:32、64、128、256、512、1024、1080、1450。

32

SplitPackage

boolean

任意

ICMP パケットを分割するかどうかを指定します。デフォルト値:true。

true

Timeout

integer

任意

ICMP 合成監視テストのタイムアウト期間。単位:ミリ秒。最小値:1000。最大値:300000。デフォルト値:20000。

5000

TracertEnable

boolean

任意

tracert コマンドを有効にするかどうかを指定します。デフォルト値:true。

true

TracertNumMax

integer

任意

tracert コマンドの最大ホップ数。最小値:1。最大値:128。デフォルト値:20。

20

TracertTimeout

integer

任意

tracert コマンドのタイムアウト期間。単位:ミリ秒。最小値:1000。最大値:300000。デフォルト値:60000。

60000

NetTCP

object

任意

TCP 合成監視テストのパラメーター。

TargetUrl

string

任意

宛先ホストの IP アドレス。

127.0.0.1:8888

ConnectTimes

integer

任意

確立される TCP 接続の数。最小値:1。最大値:16。デフォルト値:4。

4

Interval

integer

任意

TCP 接続が確立される間隔。単位:ミリ秒。最小値:200。最大値:10000。デフォルト値:200。

300

Timeout

integer

任意

TCP 合成監視テストのタイムアウト期間。単位:ミリ秒。最小値:1000。最大値:300000。デフォルト値:20000。

1000

TracertEnable

boolean

任意

tracert コマンドを有効にするかどうかを指定します。デフォルト値:true。

true

TracertNumMax

integer

任意

tracert コマンドの最大ホップ数。最小値:1。最大値:128。デフォルト値:20。

20

TracertTimeout

integer

任意

tracert コマンドのタイムアウト期間。単位:ミリ秒。最小値:1000。最大値:300000。デフォルト値:60000。

1000

NetDNS

object

任意

DNS 合成監視テストのパラメーター。

TargetUrl

string

任意

ドメイン名。

www.aliyun.com

Dig

integer

任意

dig コマンドを使用してデータを表示するかどうかを指定します。有効な値:0:いいえ。1:はい。

0

DnsServerIpType

integer

任意

DNS サーバーの IP バージョン。有効な値:0:IPv4。1:IPv6。2:バージョンが自動的に選択されます。デフォルト値:0。

0

NsServer

string

任意

DNS サーバーの IP アドレス。デフォルト値:114.114.114.114。

114.114.114.114

QueryMethod

integer

任意

DNS クエリメソッド。有効な値:0:再帰。1:反復。デフォルト値:0。

0

Timeout

integer

任意

DNS 合成監視テストのタイムアウト期間。単位:ミリ秒。最小値:1000。最大値:45000。デフォルト値:5000。

1000

ApiHTTP

object

任意

HTTP(S) 合成監視テストのパラメーター。

TargetUrl

string

任意

合成監視の URL またはリクエストパス。

https://********

Method

string

任意

リクエストメソッド。有効な値:

  • POST

  • GET

POST

RequestHeaders

object

任意

カスタムヘッダーフィールド。

string

任意

HTTP リクエストヘッダー。

{ "key1": "value1", "key2": "value2" }

RequestBody

object

任意

HTTP リクエストボディ。

Content

string

任意

リクエストボディの内容。フォーマット:JSON 文字列。Type パラメーターが text/plain、application/json、application/xml、または text/html に設定されている場合、このパラメーターは必須です。フォーマット:JSON 文字列。

{ "key1": "value1", "key2": "value2" }

Type

string

任意

リクエストボディのタイプ。有効な値:text/plain、application/json、application/x-www-form-urlencoded、multipart/form-data、application/xml、text/html。

application/json

ConnectTimeout

integer

任意

接続タイムアウト期間。単位:ミリ秒。デフォルト値:5000。最小値:1000。最大値:300000。

5000

Timeout

integer

任意

タイムアウト期間。単位:ミリ秒。デフォルト値:10000。最小値:1000。最大値:300000。

5000

CheckCert

boolean

任意

証明書を検証するかどうかを指定します。デフォルト値:false。

true

ProtocolAlpnProtocol

integer

任意

ALPN プロトコルのバージョン。WAP モバイルクライアントで HTTPS 合成監視テストを実行するときに、このパラメーターを設定できます。有効な値:

0:デフォルト

1-http/1.1

2-h2

3:ALPN プロトコルを無効にします

0

Website

object

任意

Web サイト速度測定のパラメーター。

TargetUrl

string

任意

Web サイトの URL。

https://********

AutomaticScrolling

integer

任意

画面を自動的に上下にスクロールしてページを読み込むかどうかを指定します。有効な値:0:いいえ。1:はい。デフォルト値:0。

0

CustomHeader

integer

任意

カスタムヘッダーを作成するかどうかを指定します。有効な値:0:いいえ。1:最初のパケットが変更されます。2:すべてのパケットが変更されます。デフォルト値:0。

0

CustomHeaderContent

object

任意

カスタムヘッダー。フォーマット:JSON マップ。

string

任意

カスタムヘッダー。フォーマット:JSON マップ。

{ "key1": "value1", "key2": "value2" }

DisableCache

integer

任意

キャッシュを無効にするかどうかを指定します。有効な値:0:いいえ。1:はい。デフォルト値:1。

0

DisableCompression

integer

任意

HTTP Accept-Encoding リクエストヘッダーに基づいて圧縮ファイルを受け入れるかどうかを指定します。有効な値:0:いいえ。1:はい。デフォルト値:0。

0

FilterInvalidIP

integer

任意

無効な IP アドレスを除外するかどうかを指定します。有効な値:

  • 1:いいえ

  • 0:はい

0

IgnoreCertificateError

integer

任意

ブラウジング中に SSL 証明書エラーを無視するかどうかを指定します。有効な値:0:いいえ。1:はい。デフォルト値:1。

0

MonitorTimeout

integer

任意

モニタリングタイムアウト期間。単位:ミリ秒。最小値:5000。最大値:300000。デフォルト値:40000。

20000

Redirection

integer

任意

リダイレクト後にブラウジングを続行するかどうかを指定します。有効な値:0:いいえ。1:はい。デフォルト値:1。

0

SlowElementThreshold

integer

任意

低速要素を定義するために使用される時間しきい値。単位:ミリ秒。デフォルト値:5000。最小値:1。最大値:300000。

5000

WaitCompletionTime

integer

任意

最大待機時間。単位:ミリ秒。デフォルト値:5000。最小値:5000。最大値:300000。

5000

VerifyStringBlacklist

string

任意

検証用のページのソースコード内の任意の文字列。クライアントから返されたソースコードにブラックリスト内の文字列が含まれている場合、エラーコード 650 が報告され、文字列の検証に失敗したことを示します。複数の文字列は縦棒 (|) で区切ります。

error

VerifyStringWhitelist

string

任意

検証用のページのソースコード内の任意の文字列。クライアントから返されたソースコードにホワイトリストにない文字列が含まれている場合、エラーコード 650 が報告され、文字列の検証に失敗したことを示します。複数の文字列は縦棒 (|) で区切ります。

success

ElementBlacklist

string

任意

ページ読み込みプロセスで読み込まない要素。

a.jpg

DNSHijackWhitelist

string

任意

ドメイン名から解決された IP アドレスまたは CNAME レコードが DNS ホワイトリストに含まれていない場合、ドメイン名にアクセスできないか、別のドメイン名に属する IP アドレスが返されます。IP アドレスまたは CNAME レコードが DNS ホワイトリストに含まれている場合、DNS ハイジャックは発生しません。

フォーマット:<ドメイン名>:<オブジェクト>。オブジェクトには、IP アドレス、ワイルドカードマスク、サブネットマスク、または CNAME レコードを指定できます。複数のオブジェクトは縦棒 (|) で区切ります。例:www.aliyun.com:203.0.3.55|203.3.44.67。これは、203.0.3.55 と 203.3.44.67 を除く www.aliyun.com ドメイン名に属するすべての IP アドレスがハイジャックされることを示します。

www.aliyun.com:203.0.3.55|203.3.44.67

PageTamper

string

任意

ホワイトリストに含まれておらず、ページに表示される要素は改ざんされます。これらの要素には、ポップアップ広告、フローティング広告、ページリダイレクトなどがあります。

www.aliyun.com:|/cc/bb/a.gif|/vv/bb/cc.jpg

FlowHijackJumpTimes

integer

任意

ページ上の要素の総数。

1

FileDownload

object

任意

ファイルダウンロードのパラメーター。

TargetUrl

string

任意

ファイルをダウンロードするために使用される URL。

https://img.alicdn.com/tfs/TB13DzOjXP7gK0jSZFjXXc5aXXa-212-48.png

DownloadKernel

integer

任意

カーネルタイプ。有効な値:

  • 1: curl

  • 0: WinInet

0

QuickProtocol

integer

任意

QUIC プロトコルタイプ。有効な値:

  • 1: HTTP/1

  • 2: HTTP/2

  • 3: http3

1

ConnectionTimeout

integer

任意

単位:ミリ秒。最小値:1000。最大値:120000。デフォルト値:5000。

5000

MonitorTimeout

integer

任意

モニタリングタイムアウト期間。単位:ミリ秒。最小値:1000。最大値:120000。デフォルト値:60000。

60000

CustomHeaderContent

object

任意

カスタムリクエストヘッダーの内容。フォーマット:JSON マップ。

string

任意

カスタムリクエストヘッダーの内容。フォーマット:JSON マップ。

{ "key1": "value1", "key2": "value2" }

IgnoreCertificateStatusError

integer

任意

証明書ステータスエラーを無視するかどうかを指定します。0:いいえ。1:はい。デフォルト値:1。

0

IgnoreCertificateUntrustworthyError

integer

任意

証明書の信頼性エラーを無視するかどうかを指定します。有効な値:0:いいえ。1:はい。デフォルト値:1。

0

IgnoreInvalidHostError

integer

任意

ホストの無効性を無視するかどうかを指定します。有効な値:0:いいえ。1:はい。デフォルト値:1。

0

Redirection

integer

任意

リダイレクトをサポートするかどうかを指定します。有効な値:0:いいえ。1:はい。デフォルト値:1。

0

TransmissionSize

integer

任意

単一転送の最大ファイルサイズ。単位:KB。最小値:1。最大値:20480。有効な値:2048。

2048

IgnoreCertificateCanceledError

integer

任意

証明書失効エラーを無視するかどうかを指定します。有効な値:0:いいえ。1:はい。デフォルト値:1。

0

IgnoreCertificateAuthError

integer

任意

CA 証明書認証エラーを無視するかどうかを指定します。有効な値:0:いいえ。1:はい。デフォルト値:1。

0

IgnoreCertificateOutOfDateError

integer

任意

証明書の無効性を無視するかどうかを指定します。有効な値:0:いいえ。1:はい。デフォルト値:1。

0

IgnoreCertificateUsingError

integer

任意

証明書使用エラーを無視するかどうかを指定します。有効な値:0:いいえ。1:はい。デフォルト値:1。

0

VerifyWay

integer

任意

検証方法。有効な値:

  • 0:検証なし

  • 1:文字列検証

  • 2:MD5 検証

0

ValidateKeywords

string

任意

検証で使用されるキーワード。

aliyun

WhiteList

string

任意

DNS ハイジャックを回避するために使用されるホワイトリストに登録されたオブジェクト。オブジェクトには、IP アドレス、ワイルドカードマスク、サブネットマスク、または CNAME レコードを指定できます。複数のオブジェクトは縦棒 (|) で区切ります。例:www.aliyun.com:203.0.3.55|203.3.44.67。これは、203.0.3.55 と 203.3.44.67 を除く www.aliyun.com ドメイン名に属するすべての IP アドレスがハイジャックされることを示します。

www.aliyun.com:203.0.3.55|203.3.44.67

Stream

object

任意

ストリーミングメディア合成監視テストのパラメーター。

TargetUrl

string

任意

ストリーミングメディアのリソース URL。

http://www.aliyun.com/stream/test.mp4

StreamType

integer

任意

リソースがビデオかオーディオかを指定します。有効な値:0:ビデオ。1:オーディオ。

0

StreamMonitorTimeout

integer

任意

モニタリング期間。単位:秒。最大値およびデフォルト値:60。

30

StreamAddressType

integer

任意

リソースのアドレスタイプ。有効な値:

  • 1:リソース URL。

  • 0:ページ URL。デフォルト値:0。

1

PlayerType

integer

任意

プレーヤー。デフォルト値:12。有効な値:

  • 12: VLC

  • 2: Flash Player

2

CustomHeaderContent

object

任意

カスタムヘッダー。フォーマット:JSON マップ。

string

任意

カスタムヘッダー。フォーマット:JSON マップ。

{ "key1": "value1", "key2": "value2" }

WhiteList

string

任意

DNS ハイジャックを回避するために使用されるホワイトリストに登録されたオブジェクト。オブジェクトには、IP アドレス、ワイルドカードマスク、サブネットマスク、または CNAME レコードを指定できます。複数のオブジェクトは縦棒 (|) で区切ります。例:www.aliyun.com:203.0.3.55|203.3.44.67。これは、203.0.3.55 と 203.3.44.67 を除く www.aliyun.com ドメイン名に属するすべての IP アドレスがハイジャックされることを示します。

www.aliyun.com:203.0.3.55|203.3.44.67

Monitors

array<object>

任意

監視ポイントのリスト。

object

任意

CityCode

string

任意

都市コード。

100001

OperatorCode

string

任意

キャリアコード。

1

ClientType

integer

任意

監視ポイントのクライアントタイプ。有効な値:1:データセンター。2:インターネット。3:モバイルデバイス。4:ECS インスタンス。

4

Frequency

string

任意

検出頻度。有効な値:1m、5m、10m、15m、20m、30m、1h、2h、3h、4h、6h、8h、12h、24h。

5m

CustomPeriod

object

任意

カスタム期間。

EndHour

integer

任意

テストが終了する時間。有効な値:0~24。

22

StartHour

integer

任意

テストが開始する時間。有効な値:0~24。

14

CommonSetting

object

任意

一般設定。

CustomHost

object

任意

カスタムホスト設定。

Hosts

array<object>

任意

ホストのリスト。

object

任意

カスタムホスト設定。

Domain

string

任意

ドメイン名。

www.aliyun.com

IpType

integer

任意

IP バージョン。有効な値:

  • 0:バージョンが自動的に選択されます。

  • 1: IPv4

  • 2: IPv6

0

Ips

array

任意

IP アドレスのリスト。

string

任意

IP アドレス。

127.0.0.1

SelectType

integer

任意

選択モード。有効な値:

  • 0:ランダム

  • 1:ポーリング

0

IpType

integer

任意

IP バージョン。有効な値:

  • 0:バージョンが自動的に選択されます。

  • 1: IPv4

  • 2: IPv6

0

MonitorSamples

integer

任意

モニタリングサンプルを均等に分散させるかどうかを指定します。有効な値:

  • 0:いいえ

  • 1:はい

0

IsOpenTrace

boolean

任意

トレースを有効にするかどうかを指定します。

true

TraceClientType

integer

任意

トレース用クライアントのタイプ。有効な値:

  • 0: ARMS エージェント

  • 1: OpenTelemetry

  • 2: Jaeger

1

XtraceRegion

string

任意

トレースデータが報告されるリージョン。

cn-hangzhou

CustomVPCSetting

object

任意

Virtual Private Cloud (VPC) に関する情報。宛先 URL が Alibaba Cloud 内部エンドポイントである場合、VPC を設定する必要があります。

RegionId

string

任意

リージョン ID。

cn-hangzhou

VpcId

string

任意

VPC ID。

vpc-bp15bjtubjytclwxxxxxx

VSwitchId

string

任意

vSwitch ID。

vsw-2zevek6r3mpny7wxxxxxv

SecureGroupId

string

任意

クライアントが属するセキュリティグループの ID。セキュリティグループは、VPC に対するクライアントのインバウンドおよびアウトバウンドルールを指定します。クライアントが属するセキュリティグループが VPC が属するセキュリティグループにアクセスすることを許可する必要があります。そうしないと、クライアントは VPC 内のリソースにアクセスできません。

sg-xxxxxxxx

CustomPrometheusSetting

object

任意

予約済みパラメーター。

PrometheusLabels

object

任意

予約済みパラメーター。

string

任意

予約済みパラメーター。

保留字段。

PrometheusClusterId

string

任意

予約済みパラメーター。

保留字段。

PrometheusClusterRegion

string

任意

予約済みパラメーター。

保留字段。

AvailableAssertions

array<object>

任意

アサーションのリスト。

object

任意

Type

string

任意

アサーションタイプ。有効な値:HttpResCode、HttpResHead、HttpResBody、HttpResBodyJson、HttpResponseTime、IcmpPackLoss (パケット損失率)、IcmpPackMaxLatency (最大パケット遅延)、IcmpPackAvgLatency (平均パケット遅延)、TraceRouteHops (ホップ数)、DnsARecord (A レコード)、DnsCName (CNAME)、websiteTTFB (先頭パケット到達時間)、websiteTTLB (最終パケット到達時間)、websiteFST (初回ペイント時間)、websiteFFST (First Meaningful Paint)、websiteOnload (完全読み込み時間)。詳細については、以下の説明をご参照ください。

TraceRouteHops

Target

string

任意

チェックターゲット。type パラメーターを HttpResCode、HttpResBody、または HttpResponseTime に設定した場合、target パラメーターを設定する必要はありません。type パラメーターを HttpResHead に設定した場合は、ヘッダーのキーを指定する必要があります。type パラメーターを HttpResBodyJson に設定した場合は、jsonPath を使用します。

HttpResponseTime

Operator

string

任意

条件。gt:より大きい。gte:以上。lt:より小さい。lte:以下。eq:等しい。neq:等しくない。ctn:含む。nctn:含まない。exist:存在する。n_exist:存在しない。belong:属する。n_belong:属さない。reg_match:正規表現。

eq

Expect

string

任意

期待値。

200

ResourceGroupId

string

任意

リソースグループ ID。

rg-acfmxyexli2****

Tags

array<object>

任意

タグのリスト。

object

任意

Key

string

任意

タグのキー。

key

Value

string

任意

タグの値。

value

アサーションの説明:

HTTP 合成監視テスト:

● type パラメーターが HttpResCode に設定されている場合、Operator パラメーターは次の値をサポートします:eq、neq、gt、gte、lt、lte、belong、n_belong。

● type パラメーターが HttpResHead に設定されている場合、Operator パラメーターはすべての値をサポートします。

● type パラメーターが HttpResBody に設定されている場合、Operator パラメーターはすべての値をサポートします。

● type パラメーターが HttpResBodyJson に設定されている場合、Operator パラメーターはすべての値をサポートします。

● type パラメーターが HttpResponseTime に設定されている場合、Operator パラメーターは次の値をサポートします:gt、gte、lt、lte、eq、belong。

ICMP 合成監視テスト:

● type パラメーターが IcmpPackLoss に設定されている場合、Operator パラメーターは次の値をサポートします:gt、gte、lt、lte、eq、belong。

● type パラメーターが IcmpPackMaxLatency に設定されている場合、Operator パラメーターは次の値をサポートします:gt、gte、lt、lte、eq、belong。

● type パラメーターが IcmpPackAvgLatency に設定されている場合、Operator パラメーターは次の値をサポートします:gt、gte、lt、lte、eq、belong。

● type パラメーターが TraceRouteHops に設定されている場合、Operator パラメーターは次の値をサポートします:gt、gte、lt、lte、eq、belong。

DNS 合成監視テスト:

● type パラメーターが DnsARecord に設定されている場合、Operator パラメーターは次の値をサポートします:eq、ctn、nctn、reg_match、not_reg_match。A レコードを選択的に表示できます。

● type パラメーターが DnsCName に設定されている場合、Operator パラメーターは次の値をサポートします:eq、ctn、nctn、reg_match、not_reg_match。CNAME レコードを選択的に表示できます。

Web サイト速度測定:

● type パラメーターが websiteTTFB に設定されている場合、Operator パラメーターは次の値をサポートします:gt、gte、lt、lte、eq、belong。

● type パラメーターが websiteTTLB に設定されている場合、Operator パラメーターは次の値をサポートします:gt、gte、lt、lte、eq、belong。

● type パラメーターが websiteFST に設定されている場合、Operator パラメーターは次の値をサポートします:gt、gte、lt、lte、eq、belong。

● type パラメーターが websiteFFST に設定されている場合、Operator パラメーターは次の値をサポートします:gt、gte、lt、lte、eq、belong。

● type パラメーターが websiteOnload に設定されている場合、Operator パラメーターは次の値をサポートします:gt、gte、lt、lte、eq、belong。

レスポンスフィールド

フィールド

説明

object

応答のスキーマ

RequestId

string

リクエスト ID。

F7781D4A-2818-41E7-B7BB-79D809E9****

Success

boolean

リクエストが成功したかどうかを示します。有効な値:

  • true

  • false

true

Code

integer

ステータスコード。ステータスコード 200 はリクエストが成功したことを示します。その他のステータスコードはリクエストが失敗したことを示します。

200

Message

string

返されるメッセージ。

success

Data

object

返される構造体。

TaskId

string

タスク ID。

1eeb351722c84e05b52c82fd0dc9953e

成功レスポンス

JSONJSON

{
  "RequestId": "F7781D4A-2818-41E7-B7BB-79D809E9****",
  "Success": true,
  "Code": 200,
  "Message": "success",
  "Data": {
    "TaskId": "1eeb351722c84e05b52c82fd0dc9953e"
  }
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 ParameterMissing %s
400 ParameterIllegal %s
400 TaskQuotaLimit %s
400 ParameterRegionIllegal %s
400 DuplicateTagKey Param tagKey is duplicate.
400 TagNumOUT the number of tag is out .
400 NoPermissionUSER user no permission
403 RAMNotAuthorize %s
403 STSNotAuthorize %s
403 IllegalUserAccess %s
403 APINotAuthorize %s
403 CommercialStatusException %s
403 SyntheticTrailExpired %s
403 SyntheticInDebt %s
403 SyntheticDailyTimesExhausted %s
403 SyntheticDailyLimit %s
403 INNER_PROHIBIT 内部用户禁用云拨测服务, 如需使用, 请加钉钉群31359689联系白玙

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。