コンテンツにスキップ

作成



POST /api/v1/dialing_task/add

概要

通常またはモバイルの定期 Synthetic テストを作成し、実行設定を配信します。

呼び出し前の準備と使用手順

対象プロトコルとこのワークスペースで利用可能な実行ノードを選択し、完全なオブジェクトで作成します。通常タスクはデフォルトで task.status=ok として配信され、作成直後から定期 Synthetic テストと課金が開始される可能性があります。現在の公開 Body では task.status が宣言されていないため、このリクエストで stop を渡すことはできません。作成後に開始/停止 API で制御する必要がありますが、2 つのステップの間に実行されないことを保証するものではありません。mobile の作成ではノード選択と利用規約を検証します。nodes はリアルタイムの存在確認を行わず、groups はグループとメンバーを照会し、成功時はデフォルトで有効化されます。

現在の公開 task サブフィールドのホワイトリストには browser_config/browser_window/retry_options が宣言されておらず、browser コントローラーには browser_config が必須です。そのため、このエントリーポイントでは有効な browser の追加/変更を完了できません。必須スクリプトを渡すと先に 406 になり、渡さない場合は InvalidDialingTask になります。Front または DataKit の手動設定を、現在の OpenAPI で利用可能なパラメーターとして扱うことはできません。マルチステップでは専用の multi_task API を使用します。通常の HTTP/TCP/ICMP/WebSocket/SSL の条件と詳細オプションのセマンティクスについては、引き続きカスタム Synthetic テストを参照してください。

DNS は構造、型、列挙、アサーションリーフの数を検査し、実際のクエリは実行しません。変数テンプレート/Go 正規表現/証明書およびプロトコルのセマンティクスは実行側で検証されます。NetPath は厳格なフィールドホワイトリストを持ち、変数をサポートしません(config_vars は [] のみ)。mobile は通常の regions、変数、スクリプト、Cron/期限、クライアント provider などの内部フィールドをサポートしません。モバイルリソースに従ってノード選択スナップショットを入力し、テンプレートに自動追従させません。

通常タスクの配信とデータベースへのコミットはアトミックトランザクションではありません。追加失敗時には停止補償がありますが、完全なロールバックは保証されません。変更では配信が成功してもローカルコミットが失敗する可能性があります。mobile は先にローカルの stop を保存してからリモートを作成し、成功時に ok を書き戻します。失敗時には localSaved タスクが残る、またはリモート結果が不明になる可能性があるため、エラーの content から taskUUID と実際のプラットフォーム状態を読み戻してください。むやみに重複作成しないでください。既存の未バインドのモバイルタスクを変更すると、制御された復旧フローに入る可能性がありますが、毎回自動修復されることを保証するものではありません。返却されるのは設定であり、1 回の Synthetic テスト結果や通知の到達ではありません。

リクエストヘッダー

パラメーター名 型 必須 説明
DF-API-KEY string Y ワークスペースの OpenAPI 認証情報。
例: <DF-API-KEY>
取得または入力方法: 対象ワークスペースの API Key 管理から、この操作権限を持つ OpenAPI Key を取得します。

Body リクエストパラメーター

パラメーター名 型 必須 説明
regions[*] string 単一ノードの UUID。プロトコルごとのノード能力は実際のプラットフォームで確認してください。
例: reg_example
取得または入力方法: 現在利用可能なノードレコードの uuid を使用します。ノード名/都市または keycode は使用しません。
tags[*] string 名前で重複排除され、tag_ UUID ではありません。Synthetic テストのスコープに合わない場合はエラーになります。
例: production
取得または入力方法: 単一の業務タグ名を取得します。
task.success_when[*] json 単一の条件オブジェクト。外側の条件ロジックは success_when_logic で制御されます。内部条件のセマンティクスは対応する実行側で検証されます。
例: {"status_code": [{"is": "200"}]}
取得または入力方法: HTTP/TCP/DNS/NetPath などに対応するアサーションフィールドを組み合わせます。
task.advance_options.request_options json HTTP/WebSocket に適用。任意。HTTP/WebSocket リクエストオプション。
例: {}
取得または入力方法: 対象 HTTP インターフェース/ノード設定およびカスタム Synthetic テストに基づいて構築します。
task.advance_options.request_options.follow_redirect boolean HTTP/WebSocket に適用。任意。リダイレクトに従うかどうか。省略時は実行側のデフォルトに従います。
例: false
取得または入力方法: 対象 HTTP インターフェース/ノード設定およびカスタム Synthetic テストに基づいて構築します。
task.advance_options.request_options.headers json HTTP/WebSocket に適用。任意。リクエストヘッダー名から文字列値へのマッピング。実際の認証情報をサンプルに書き込まないでください。
例: {"Accept": "application/json"}
取得または入力方法: 対象 HTTP インターフェース/ノード設定およびカスタム Synthetic テストに基づいて構築します。
task.advance_options.request_options.headers.リクエストヘッダー名 string HTTP/WebSocket に適用。任意。動的なリクエストヘッダー値。名前は実際のインターフェースで必要な header を使用します。
例: application/json
取得または入力方法: 対象 HTTP インターフェース/ノード設定およびカスタム Synthetic テストに基づいて構築します。
task.advance_options.request_options.cookies string HTTP/WebSocket に適用。任意。Cookie テキスト。省略可能。
例:
取得または入力方法: 対象 HTTP インターフェース/ノード設定およびカスタム Synthetic テストに基づいて構築します。
task.advance_options.request_options.auth json HTTP/WebSocket に適用。任意。HTTP Basic のユーザー名/パスワード設定。省略可能。
例: {}
取得または入力方法: 対象 HTTP インターフェース/ノード設定およびカスタム Synthetic テストに基づいて構築します。
task.advance_options.request_options.auth.username string HTTP/WebSocket に適用。任意。Basic ユーザー名。対象インターフェースの管理者から提供されます。
例: USER-PLACEHOLDER
取得または入力方法: 対象 HTTP インターフェース/ノード設定およびカスタム Synthetic テストに基づいて構築します。
task.advance_options.request_options.auth.password string HTTP/WebSocket に適用。任意。Basic パスワード。安全な認証情報ソースから注入してください。
例: PASSWORD-PLACEHOLDER
取得または入力方法: 対象 HTTP インターフェース/ノード設定およびカスタム Synthetic テストに基づいて構築します。
task.advance_options.request_body json HTTP/WebSocket に適用。任意。リクエスト Body の形式と内容。
例: {}
取得または入力方法: 対象 HTTP インターフェース/ノード設定およびカスタム Synthetic テストに基づいて構築します。
task.advance_options.request_body.body_type string HTTP/WebSocket に適用。任意。リクエストの Content-Type。例: application/json/text/plain/text/xml/multipart/form-data。
例: application/json
取得または入力方法: 対象 HTTP インターフェース/ノード設定およびカスタム Synthetic テストに基づいて構築します。
task.advance_options.request_body.body string HTTP/WebSocket に適用。任意。リクエストボディ文字列。変更時は必要な業務内容を保持する必要があります。
例: {"check":true}
取得または入力方法: 対象 HTTP インターフェース/ノード設定およびカスタム Synthetic テストに基づいて構築します。
task.advance_options.request_body.form json HTTP/WebSocket に適用。任意。multipart フォームフィールドから文字列へのマッピング。省略可能。
例: {"check": "true"}
取得または入力方法: 対象 HTTP インターフェース/ノード設定およびカスタム Synthetic テストに基づいて構築します。
task.advance_options.request_body.form.フィールド名 string HTTP/WebSocket に適用。任意。単一のフォーム値。
例: true
取得または入力方法: 対象 HTTP インターフェース/ノード設定およびカスタム Synthetic テストに基づいて構築します。
task.advance_options.request_timeout string HTTP/WebSocket に適用。任意。HTTP 全体のタイムアウト duration。実行側のデフォルトは 60s。Studio は実際の実行側の検証を代替しません。
例: 60s
取得または入力方法: 対象 HTTP インターフェース/ノード設定およびカスタム Synthetic テストに基づいて構築します。
task.advance_options.protocol string HTTP/WebSocket に適用。任意。HTTP プロトコル auto/http/1.1/http/2/http/2-only/http/3。サポート状況はノードのバージョンに依存します。HTTP3 では同時にプロキシを設定しないでください。
例: auto
取得または入力方法: 対象 HTTP インターフェース/ノード設定およびカスタム Synthetic テストに基づいて構築します。
task.advance_options.certificate json HTTP/WebSocket に適用。任意。リクエストの TLS 証明書設定。
例: {}
取得または入力方法: 対象 HTTP インターフェース/ノード設定およびカスタム Synthetic テストに基づいて構築します。
task.advance_options.certificate.ignore_server_certificate_error boolean HTTP/WebSocket に適用。任意。証明書検証エラーを無視するかどうか。
例: false
取得または入力方法: 対象 HTTP インターフェース/ノード設定およびカスタム Synthetic テストに基づいて構築します。
task.advance_options.certificate.certificate string HTTP/WebSocket に適用。任意。PEM クライアント証明書。対象サービスから提供されます。
例: CERTIFICATE-PLACEHOLDER
取得または入力方法: 対象 HTTP インターフェース/ノード設定およびカスタム Synthetic テストに基づいて構築します。
task.advance_options.certificate.private_key string HTTP/WebSocket に適用。任意。証明書に対応する PEM 秘密鍵。安全なソースを使用してください。
例: PRIVATE-KEY-PLACEHOLDER
取得または入力方法: 対象 HTTP インターフェース/ノード設定およびカスタム Synthetic テストに基づいて構築します。
task.advance_options.certificate.ca string HTTP/WebSocket に適用。任意。CA の内容。一部の HTTP 実行側では保持されますが使用されません。DNS では certificate.ca をそのプロトコルに従って解釈します。
例: CA-PLACEHOLDER
取得または入力方法: 対象 HTTP インターフェース/ノード設定およびカスタム Synthetic テストに基づいて構築します。
task.advance_options.proxy json HTTP/WebSocket に適用。任意。HTTP プロキシオブジェクト。ノードが任意のプロキシにアクセスできると仮定しないでください。
例: {}
取得または入力方法: 対象 HTTP インターフェース/ノード設定およびカスタム Synthetic テストに基づいて構築します。
task.advance_options.proxy.url string HTTP/WebSocket に適用。任意。プロキシ URL。
例: http://proxy.example.com:8080
取得または入力方法: 対象 HTTP インターフェース/ノード設定およびカスタム Synthetic テストに基づいて構築します。
task.advance_options.proxy.headers json HTTP/WebSocket に適用。任意。プロキシ専用の文字列 header マッピング。
例: {}
取得または入力方法: 対象 HTTP インターフェース/ノード設定およびカスタム Synthetic テストに基づいて構築します。
task.advance_options.proxy.headers.リクエストヘッダー名 string HTTP/WebSocket に適用。任意。単一のプロキシリクエストヘッダー値。
例: VALUE-PLACEHOLDER
取得または入力方法: 対象 HTTP インターフェース/ノード設定およびカスタム Synthetic テストに基づいて構築します。
task.advance_options.secret json HTTP/WebSocket に適用。任意。従来の HTTP リクエストデータ保存オプション。実行側のサポート状況に従います。
例: {}
取得または入力方法: 対象 HTTP インターフェース/ノード設定およびカスタム Synthetic テストに基づいて構築します。
task.advance_options.secret.not_save boolean HTTP/WebSocket に適用。任意。リクエスト内容を保存しないかどうか。返却ドキュメント/ログのマスキングの代替にはなりません。
例: true
取得または入力方法: 対象 HTTP インターフェース/ノード設定およびカスタム Synthetic テストに基づいて構築します。
task.success_when[*].body array 任意のアサーション集合。キー名は実際のレスポンスに従います。実行側がサポートする比較のみを使用してください。
例: []
取得または入力方法: 実際の HTTP/WebSocket レスポンスから body または特定の header を選択します。
task.success_when[*].body[*].contains string 単一のテキスト比較。必要な操作に応じて選択します。正規表現のセマンティクスは実行側で検証され、保存成功は一致を証明するものではありません。
例: healthy
取得または入力方法: 一致させたいレスポンステキスト/有効な正規表現を取得します。レスポンス内の機密値をコピーしないでください。
task.success_when[*].body[*].not_contains string 単一のテキスト比較。必要な操作に応じて選択します。正規表現のセマンティクスは実行側で検証され、保存成功は一致を証明するものではありません。
例: healthy
取得または入力方法: 一致させたいレスポンステキスト/有効な正規表現を取得します。レスポンス内の機密値をコピーしないでください。
task.success_when[*].body[*].is string 単一のテキスト比較。必要な操作に応じて選択します。正規表現のセマンティクスは実行側で検証され、保存成功は一致を証明するものではありません。
例: healthy
取得または入力方法: 一致させたいレスポンステキスト/有効な正規表現を取得します。レスポンス内の機密値をコピーしないでください。
task.success_when[*].body[*].is_not string 単一のテキスト比較。必要な操作に応じて選択します。正規表現のセマンティクスは実行側で検証され、保存成功は一致を証明するものではありません。
例: healthy
取得または入力方法: 一致させたいレスポンステキスト/有効な正規表現を取得します。レスポンス内の機密値をコピーしないでください。
task.success_when[*].body[*].match_regex string 単一のテキスト比較。必要な操作に応じて選択します。正規表現のセマンティクスは実行側で検証され、保存成功は一致を証明するものではありません。
例: healthy
取得または入力方法: 一致させたいレスポンステキスト/有効な正規表現を取得します。レスポンス内の機密値をコピーしないでください。
task.success_when[*].body[*].not_match_regex string 単一のテキスト比較。必要な操作に応じて選択します。正規表現のセマンティクスは実行側で検証され、保存成功は一致を証明するものではありません。
例: healthy
取得または入力方法: 一致させたいレスポンステキスト/有効な正規表現を取得します。レスポンス内の機密値をコピーしないでください。
task.success_when[*].header.レスポンスヘッダー名 array 任意のアサーション集合。キー名は実際のレスポンスに従います。実行側がサポートする比較のみを使用してください。
例: []
取得または入力方法: 実際の HTTP/WebSocket レスポンスから body または特定の header を選択します。
task.success_when[*].header.レスポンスヘッダー名[*].contains string 単一のテキスト比較。必要な操作に応じて選択します。正規表現のセマンティクスは実行側で検証され、保存成功は一致を証明するものではありません。
例: healthy
取得または入力方法: 一致させたいレスポンステキスト/有効な正規表現を取得します。レスポンス内の機密値をコピーしないでください。
task.success_when[*].header.レスポンスヘッダー名[*].not_contains string 単一のテキスト比較。必要な操作に応じて選択します。正規表現のセマンティクスは実行側で検証され、保存成功は一致を証明するものではありません。
例: healthy
取得または入力方法: 一致させたいレスポンステキスト/有効な正規表現を取得します。レスポンス内の機密値をコピーしないでください。
task.success_when[*].header.レスポンスヘッダー名[*].is string 単一のテキスト比較。必要な操作に応じて選択します。正規表現のセマンティクスは実行側で検証され、保存成功は一致を証明するものではありません。
例: healthy
取得または入力方法: 一致させたいレスポンステキスト/有効な正規表現を取得します。レスポンス内の機密値をコピーしないでください。
task.success_when[*].header.レスポンスヘッダー名[*].is_not string 単一のテキスト比較。必要な操作に応じて選択します。正規表現のセマンティクスは実行側で検証され、保存成功は一致を証明するものではありません。
例: healthy
取得または入力方法: 一致させたいレスポンステキスト/有効な正規表現を取得します。レスポンス内の機密値をコピーしないでください。
task.success_when[*].header.レスポンスヘッダー名[*].match_regex string 単一のテキスト比較。必要な操作に応じて選択します。正規表現のセマンティクスは実行側で検証され、保存成功は一致を証明するものではありません。
例: healthy
取得または入力方法: 一致させたいレスポンステキスト/有効な正規表現を取得します。レスポンス内の機密値をコピーしないでください。
task.success_when[*].header.レスポンスヘッダー名[*].not_match_regex string 単一のテキスト比較。必要な操作に応じて選択します。正規表現のセマンティクスは実行側で検証され、保存成功は一致を証明するものではありません。
例: healthy
取得または入力方法: 一致させたいレスポンステキスト/有効な正規表現を取得します。レスポンス内の機密値をコピーしないでください。
task.success_when[*].header json 任意の header 名から条件集合へのマッピング。
例: {}
取得または入力方法: 実際のレスポンス header 名を取得します。
task.success_when[*].status_code array HTTP の任意のステータスアサーション集合。実行側のプロトコルに従って文字列を比較します。
例: [{"is": "200"}]
取得または入力方法: 成功 HTTP ステータスコードまたは対応する正規表現を選択します。
task.success_when[*].status_code[*].is string 単一のステータスコードアサーション操作。mobile の expectedResponseCode 整数配列と混用しないでください。
例: 200
取得または入力方法: 対象インターフェースで期待するステータス/ステータス正規表現を取得します。
task.success_when[*].status_code[*].is_not string 単一のステータスコードアサーション操作。mobile の expectedResponseCode 整数配列と混用しないでください。
例: 200
取得または入力方法: 対象インターフェースで期待するステータス/ステータス正規表現を取得します。
task.success_when[*].status_code[*].match_regex string 単一のステータスコードアサーション操作。mobile の expectedResponseCode 整数配列と混用しないでください。
例: 200
取得または入力方法: 対象インターフェースで期待するステータス/ステータス正規表現を取得します。
task.success_when[*].status_code[*].not_match_regex string 単一のステータスコードアサーション操作。mobile の expectedResponseCode 整数配列と混用しないでください。
例: 200
取得または入力方法: 対象インターフェースで期待するステータス/ステータス正規表現を取得します。
task.success_when[*].response_time string または array HTTP/WebSocket/DNS は duration しきい値文字列です。従来の TCP/ICMP は条件配列にできます。レスポンス時間の単位は対応するリーフフィールドを参照し、一律に素のミリ秒数値として解釈しないでください。
例: 100ms
取得または入力方法: 現在のプロトコルの所要時間要件に従って設定します。
task.success_when[*].response_time[*].is_contain_dns boolean 配列形式の場合のみ使用します。TCP/ICMP で DNS 所要時間を比較に含めるかどうか。
例: true
取得または入力方法: TCP/ICMP の所要時間要件および実行側の条件プロトコルに基づきます。
task.success_when[*].response_time[*].target string 配列形式の場合のみ使用します。所要時間比較値の duration。
例: 100ms
取得または入力方法: TCP/ICMP の所要時間要件および実行側の条件プロトコルに基づきます。
task.success_when[*].connection array TCP では任意ですが、指定する場合は空でない配列にする必要があり、eq established/refused/timeout のみです。
例: [{"op": "eq", "target": "established"}]
取得または入力方法: TCP 接続の希望状態から選択します。
task.success_when[*].connection[*].op string 必須。eq のみで、is/ne は受け付けません。
例: eq
取得または入力方法: TCP 接続状態のアサーションに従って構築します。
task.success_when[*].connection[*].target string 必須。established/refused/timeout の接続結果。
例: established
取得または入力方法: TCP 接続状態のアサーションに従って構築します。
task.record_types[*] string 単一のレコードタイプまたは有効な変数テンプレート。
例: A
取得または入力方法: DNS の値は業務ドメイン、DNS サーバーおよび実行側設定から取得します。その他のプロトコルでは現在の type に従って選択します。
task.doh.url string DoH では必須の URL。
例: https://resolver.example.net/dns-query
取得または入力方法: DNS の値は業務ドメイン、DNS サーバーおよび実行側設定から取得します。その他のプロトコルでは現在の type に従って選択します。
task.doh.method string 任意の GET/POST。省略時は実行側で処理されます。
例: POST
取得または入力方法: DNS の値は業務ドメイン、DNS サーバーおよび実行側設定から取得します。その他のプロトコルでは現在の type に従って選択します。
task.doh.http_protocol string 任意の auto/http/1.1/http/2-only/http/3。
例: auto
取得または入力方法: DNS の値は業務ドメイン、DNS サーバーおよび実行側設定から取得します。その他のプロトコルでは現在の type に従って選択します。
task.doh.headers json 任意の HTTP リクエストヘッダー文字列マッピング。
例: {"Accept": "application/dns-message"}
取得または入力方法: DNS の値は業務ドメイン、DNS サーバーおよび実行側設定から取得します。その他のプロトコルでは現在の type に従って選択します。
task.doh.headers.リクエストヘッダー名 string 単一の文字列リクエストヘッダー。
例: application/dns-message
取得または入力方法: DNS の値は業務ドメイン、DNS サーバーおよび実行側設定から取得します。その他のプロトコルでは現在の type に従って選択します。
task.dns_options.recursion_desired boolean 任意の RD 再帰クエリフラグ。省略時は実行側のデフォルトです。
例: true
取得または入力方法: DNS の値は業務ドメイン、DNS サーバーおよび実行側設定から取得します。その他のプロトコルでは現在の type に従って選択します。
task.dns_options.dnssec_ok boolean 任意の DO DNSSEC フラグ。
例: false
取得または入力方法: DNS の値は業務ドメイン、DNS サーバーおよび実行側設定から取得します。その他のプロトコルでは現在の type に従って選択します。
task.dns_options.checking_disabled boolean 任意の CD 検証無効化フラグ。
例: false
取得または入力方法: DNS の値は業務ドメイン、DNS サーバーおよび実行側設定から取得します。その他のプロトコルでは現在の type に従って選択します。
task.dns_options.udp_payload_size integer 任意の EDNS UDP ペイロードサイズ。単位はバイト。セマンティクス範囲は実行側で検証されます。
例: 1232
取得または入力方法: DNS の値は業務ドメイン、DNS サーバーおよび実行側設定から取得します。その他のプロトコルでは現在の type に従って選択します。
task.certificate.ca string DNS では任意。PEM CA。
例: CA-PLACEHOLDER
取得または入力方法: DNS TLS サービスに必要な証明書/信頼設定から取得します。
task.certificate.certificate string DNS では任意。PEM クライアント証明書。
例: CERTIFICATE-PLACEHOLDER
取得または入力方法: DNS TLS サービスに必要な証明書/信頼設定から取得します。
task.certificate.private_key string DNS では任意。PEM 秘密鍵。安全に注入してください。
例: PRIVATE-KEY-PLACEHOLDER
取得または入力方法: DNS TLS サービスに必要な証明書/信頼設定から取得します。
task.certificate.ignore_server_certificate_error boolean DNS では任意。証明書検証を無視するかどうか。
例: false
取得または入力方法: DNS TLS サービスに必要な証明書/信頼設定から取得します。
task.success_when[*].authenticated_data boolean DNS の任意リーフ。他のリーフとの合計は 20 を超えてはなりません。
例: true
取得または入力方法: DNSSEC で期待する AD フラグに従って選択します。
task.success_when[*].at_least_one_record json 任意ですが、指定する場合は空でないオブジェクトにし、レコードタイプごとにグループ化します。
例: {"of_type_a": [{"is": "203.0.113.10"}]}
取得または入力方法: DNS レコードの少なくとも 1 件が一致する場合は at_least_one_record、すべて一致する場合は every_record を選択します。
task.success_when[*].at_least_one_record.of_type_a array 指定する場合は空でない条件配列にし、各項目には 1 つの比較キーのみを指定できます。
例: [{"exists": true}]
取得または入力方法: DNS クエリのレコードタイプに従って対応する of_type キーを選択します。
task.success_when[*].at_least_one_record.of_type_a[*].exists boolean 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: true
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].at_least_one_record.of_type_a[*].is string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: 203.0.113.10
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].at_least_one_record.of_type_a[*].contains string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: example
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].at_least_one_record.of_type_a[*].match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: ^example
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].at_least_one_record.of_type_a[*].not_match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: invalid
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].at_least_one_record.of_type_aaaa array 指定する場合は空でない条件配列にし、各項目には 1 つの比較キーのみを指定できます。
例: [{"exists": true}]
取得または入力方法: DNS クエリのレコードタイプに従って対応する of_type キーを選択します。
task.success_when[*].at_least_one_record.of_type_aaaa[*].exists boolean 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: true
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].at_least_one_record.of_type_aaaa[*].is string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: 203.0.113.10
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].at_least_one_record.of_type_aaaa[*].contains string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: example
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].at_least_one_record.of_type_aaaa[*].match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: ^example
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].at_least_one_record.of_type_aaaa[*].not_match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: invalid
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].at_least_one_record.of_type_cname array 指定する場合は空でない条件配列にし、各項目には 1 つの比較キーのみを指定できます。
例: [{"exists": true}]
取得または入力方法: DNS クエリのレコードタイプに従って対応する of_type キーを選択します。
task.success_when[*].at_least_one_record.of_type_cname[*].exists boolean 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: true
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].at_least_one_record.of_type_cname[*].is string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: 203.0.113.10
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].at_least_one_record.of_type_cname[*].contains string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: example
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].at_least_one_record.of_type_cname[*].match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: ^example
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].at_least_one_record.of_type_cname[*].not_match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: invalid
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].at_least_one_record.of_type_mx array 指定する場合は空でない条件配列にし、各項目には 1 つの比較キーのみを指定できます。
例: [{"exists": true}]
取得または入力方法: DNS クエリのレコードタイプに従って対応する of_type キーを選択します。
task.success_when[*].at_least_one_record.of_type_mx[*].exists boolean 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: true
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].at_least_one_record.of_type_mx[*].is string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: 203.0.113.10
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].at_least_one_record.of_type_mx[*].contains string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: example
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].at_least_one_record.of_type_mx[*].match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: ^example
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].at_least_one_record.of_type_mx[*].not_match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: invalid
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].at_least_one_record.of_type_ns array 指定する場合は空でない条件配列にし、各項目には 1 つの比較キーのみを指定できます。
例: [{"exists": true}]
取得または入力方法: DNS クエリのレコードタイプに従って対応する of_type キーを選択します。
task.success_when[*].at_least_one_record.of_type_ns[*].exists boolean 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: true
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].at_least_one_record.of_type_ns[*].is string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: 203.0.113.10
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].at_least_one_record.of_type_ns[*].contains string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: example
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].at_least_one_record.of_type_ns[*].match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: ^example
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].at_least_one_record.of_type_ns[*].not_match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: invalid
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].at_least_one_record.of_type_txt array 指定する場合は空でない条件配列にし、各項目には 1 つの比較キーのみを指定できます。
例: [{"exists": true}]
取得または入力方法: DNS クエリのレコードタイプに従って対応する of_type キーを選択します。
task.success_when[*].at_least_one_record.of_type_txt[*].exists boolean 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: true
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].at_least_one_record.of_type_txt[*].is string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: 203.0.113.10
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].at_least_one_record.of_type_txt[*].contains string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: example
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].at_least_one_record.of_type_txt[*].match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: ^example
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].at_least_one_record.of_type_txt[*].not_match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: invalid
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].every_record json 任意ですが、指定する場合は空でないオブジェクトにし、レコードタイプごとにグループ化します。
例: {"of_type_a": [{"is": "203.0.113.10"}]}
取得または入力方法: DNS レコードの少なくとも 1 件が一致する場合は at_least_one_record、すべて一致する場合は every_record を選択します。
task.success_when[*].every_record.of_type_a array 指定する場合は空でない条件配列にし、各項目には 1 つの比較キーのみを指定できます。
例: [{"exists": true}]
取得または入力方法: DNS クエリのレコードタイプに従って対応する of_type キーを選択します。
task.success_when[*].every_record.of_type_a[*].exists boolean 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: true
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].every_record.of_type_a[*].is string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: 203.0.113.10
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].every_record.of_type_a[*].contains string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: example
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].every_record.of_type_a[*].match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: ^example
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].every_record.of_type_a[*].not_match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: invalid
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].every_record.of_type_aaaa array 指定する場合は空でない条件配列にし、各項目には 1 つの比較キーのみを指定できます。
例: [{"exists": true}]
取得または入力方法: DNS クエリのレコードタイプに従って対応する of_type キーを選択します。
task.success_when[*].every_record.of_type_aaaa[*].exists boolean 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: true
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].every_record.of_type_aaaa[*].is string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: 203.0.113.10
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].every_record.of_type_aaaa[*].contains string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: example
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].every_record.of_type_aaaa[*].match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: ^example
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].every_record.of_type_aaaa[*].not_match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: invalid
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].every_record.of_type_cname array 指定する場合は空でない条件配列にし、各項目には 1 つの比較キーのみを指定できます。
例: [{"exists": true}]
取得または入力方法: DNS クエリのレコードタイプに従って対応する of_type キーを選択します。
task.success_when[*].every_record.of_type_cname[*].exists boolean 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: true
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].every_record.of_type_cname[*].is string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: 203.0.113.10
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].every_record.of_type_cname[*].contains string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: example
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].every_record.of_type_cname[*].match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: ^example
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].every_record.of_type_cname[*].not_match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: invalid
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].every_record.of_type_mx array 指定する場合は空でない条件配列にし、各項目には 1 つの比較キーのみを指定できます。
例: [{"exists": true}]
取得または入力方法: DNS クエリのレコードタイプに従って対応する of_type キーを選択します。
task.success_when[*].every_record.of_type_mx[*].exists boolean 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: true
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].every_record.of_type_mx[*].is string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: 203.0.113.10
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].every_record.of_type_mx[*].contains string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: example
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].every_record.of_type_mx[*].match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: ^example
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].every_record.of_type_mx[*].not_match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: invalid
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].every_record.of_type_ns array 指定する場合は空でない条件配列にし、各項目には 1 つの比較キーのみを指定できます。
例: [{"exists": true}]
取得または入力方法: DNS クエリのレコードタイプに従って対応する of_type キーを選択します。
task.success_when[*].every_record.of_type_ns[*].exists boolean 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: true
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].every_record.of_type_ns[*].is string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: 203.0.113.10
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].every_record.of_type_ns[*].contains string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: example
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].every_record.of_type_ns[*].match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: ^example
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].every_record.of_type_ns[*].not_match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: invalid
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].every_record.of_type_txt array 指定する場合は空でない条件配列にし、各項目には 1 つの比較キーのみを指定できます。
例: [{"exists": true}]
取得または入力方法: DNS クエリのレコードタイプに従って対応する of_type キーを選択します。
task.success_when[*].every_record.of_type_txt[*].exists boolean 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: true
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].every_record.of_type_txt[*].is string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: 203.0.113.10
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].every_record.of_type_txt[*].contains string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: example
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].every_record.of_type_txt[*].match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: ^example
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.success_when[*].every_record.of_type_txt[*].not_match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
例: invalid
取得または入力方法: 期待する DNS レコードテキストまたは有効な Go 正規表現から取得します。
task.advance_options.timeout string NetPath のみ。必須。1s..30s の整数秒。
例: 10s
取得または入力方法: NetPath の測定要件に従って選択します。HTTP の詳細オプションではありません。
task.advance_options.max_ttl integer NetPath のみ。必須。TTL 上限。TCP/ICMP は 1..60、UDP は 1..255。
例: 30
取得または入力方法: NetPath の測定要件に従って選択します。HTTP の詳細オプションではありません。
task.advance_options.e2e_queries integer NetPath のみ。必須。エンドツーエンドのプローブ回数 1..100。
例: 10
取得または入力方法: NetPath の測定要件に従って選択します。HTTP の詳細オプションではありません。
task.advance_options.traceroute_queries integer NetPath のみ。必須。パスプローブ回数 1..10。
例: 3
取得または入力方法: NetPath の測定要件に従って選択します。HTTP の詳細オプションではありません。
task.advance_options.source_name string NetPath のみ。任意のソース表示名。trim 後 128 文字以下。空の場合は削除されます。
例: API
取得または入力方法: NetPath の測定要件に従って選択します。HTTP の詳細オプションではありません。
task.advance_options.target_name string NetPath のみ。任意のターゲット表示名。trim 後 128 文字以下。空の場合は削除されます。
例: DB
取得または入力方法: NetPath の測定要件に従って選択します。HTTP の詳細オプションではありません。
task.success_when[*].e2e_rtt_avg array 空でない条件配列。少なくとも 1 つの指標を選択する必要があり、未知の指標は追加できません。
例: [{"op": "lt", "target": "100ms"}]
取得または入力方法: NetPath の可用性指標から選択します。success_when の外側全体で 1 項目のみです。
task.success_when[*].e2e_rtt_avg[*].op string 状態は eq のみ、数値/所要時間は lt/gt/leq/geq/eq を許可します。
例: lt
取得または入力方法: 指標比較の要件に従って選択します。
task.success_when[*].e2e_rtt_avg[*].target string 負でないミリ秒文字列(例: 0.5ms)。秒や素の数値は使用できません。
例: 100ms
取得または入力方法: 期待する測定境界を取得します。過去の測定結果をそのまま設定として使用しないでください。
task.success_when[*].e2e_rtt_min array 空でない条件配列。少なくとも 1 つの指標を選択する必要があり、未知の指標は追加できません。
例: [{"op": "lt", "target": "100ms"}]
取得または入力方法: NetPath の可用性指標から選択します。success_when の外側全体で 1 項目のみです。
task.success_when[*].e2e_rtt_min[*].op string 状態は eq のみ、数値/所要時間は lt/gt/leq/geq/eq を許可します。
例: lt
取得または入力方法: 指標比較の要件に従って選択します。
task.success_when[*].e2e_rtt_min[*].target string 負でないミリ秒文字列(例: 0.5ms)。秒や素の数値は使用できません。
例: 100ms
取得または入力方法: 期待する測定境界を取得します。過去の測定結果をそのまま設定として使用しないでください。
task.success_when[*].e2e_rtt_max array 空でない条件配列。少なくとも 1 つの指標を選択する必要があり、未知の指標は追加できません。
例: [{"op": "lt", "target": "100ms"}]
取得または入力方法: NetPath の可用性指標から選択します。success_when の外側全体で 1 項目のみです。
task.success_when[*].e2e_rtt_max[*].op string 状態は eq のみ、数値/所要時間は lt/gt/leq/geq/eq を許可します。
例: lt
取得または入力方法: 指標比較の要件に従って選択します。
task.success_when[*].e2e_rtt_max[*].target string 負でないミリ秒文字列(例: 0.5ms)。秒や素の数値は使用できません。
例: 100ms
取得または入力方法: 期待する測定境界を取得します。過去の測定結果をそのまま設定として使用しないでください。
task.success_when[*].e2e_rtt_variation_avg array 空でない条件配列。少なくとも 1 つの指標を選択する必要があり、未知の指標は追加できません。
例: [{"op": "lt", "target": "100ms"}]
取得または入力方法: NetPath の可用性指標から選択します。success_when の外側全体で 1 項目のみです。
task.success_when[*].e2e_rtt_variation_avg[*].op string 状態は eq のみ、数値/所要時間は lt/gt/leq/geq/eq を許可します。
例: lt
取得または入力方法: 指標比較の要件に従って選択します。
task.success_when[*].e2e_rtt_variation_avg[*].target string 負でないミリ秒文字列(例: 0.5ms)。秒や素の数値は使用できません。
例: 100ms
取得または入力方法: 期待する測定境界を取得します。過去の測定結果をそのまま設定として使用しないでください。
task.success_when[*].e2e_rtt_variation_max array 空でない条件配列。少なくとも 1 つの指標を選択する必要があり、未知の指標は追加できません。
例: [{"op": "lt", "target": "100ms"}]
取得または入力方法: NetPath の可用性指標から選択します。success_when の外側全体で 1 項目のみです。
task.success_when[*].e2e_rtt_variation_max[*].op string 状態は eq のみ、数値/所要時間は lt/gt/leq/geq/eq を許可します。
例: lt
取得または入力方法: 指標比較の要件に従って選択します。
task.success_when[*].e2e_rtt_variation_max[*].target string 負でないミリ秒文字列(例: 0.5ms)。秒や素の数値は使用できません。
例: 100ms
取得または入力方法: 期待する測定境界を取得します。過去の測定結果をそのまま設定として使用しないでください。
task.success_when[*].e2e_probe_loss_percent array 空でない条件配列。少なくとも 1 つの指標を選択する必要があり、未知の指標は追加できません。
例: [{"op": "lt", "target": 1}]
取得または入力方法: NetPath の可用性指標から選択します。success_when の外側全体で 1 項目のみです。
task.success_when[*].e2e_probe_loss_percent[*].op string 状態は eq のみ、数値/所要時間は lt/gt/leq/geq/eq を許可します。
例: lt
取得または入力方法: 指標比較の要件に従って選択します。
task.success_when[*].e2e_probe_loss_percent[*].target number パケットロス率 0..100。JSON number。
例: 1
取得または入力方法: 期待する測定境界を取得します。過去の測定結果をそのまま設定として使用しないでください。
task.success_when[*].hop_count array 空でない条件配列。少なくとも 1 つの指標を選択する必要があり、未知の指標は追加できません。
例: [{"op": "lt", "target": 1}]
取得または入力方法: NetPath の可用性指標から選択します。success_when の外側全体で 1 項目のみです。
task.success_when[*].hop_count[*].op string 状態は eq のみ、数値/所要時間は lt/gt/leq/geq/eq を許可します。
例: lt
取得または入力方法: 指標比較の要件に従って選択します。
task.success_when[*].hop_count[*].target integer ホップ数。負でない JSON integer。
例: 1
取得または入力方法: 期待する測定境界を取得します。過去の測定結果をそのまま設定として使用しないでください。
task.success_when[*].e2e_status array 空でない条件配列。少なくとも 1 つの指標を選択する必要があり、未知の指標は追加できません。
例: [{"op": "eq", "target": "reached"}]
取得または入力方法: NetPath の可用性指標から選択します。success_when の外側全体で 1 項目のみです。
task.success_when[*].e2e_status[*].op string 状態は eq のみ、数値/所要時間は lt/gt/leq/geq/eq を許可します。
例: eq
取得または入力方法: 指標比較の要件に従って選択します。
task.success_when[*].e2e_status[*].target string 状態 reached/partial/failed。e2e_status ではさらに unknown を許可します。
例: reached
取得または入力方法: 期待する測定境界を取得します。過去の測定結果をそのまま設定として使用しないでください。
task.success_when[*].traceroute_status array 空でない条件配列。少なくとも 1 つの指標を選択する必要があり、未知の指標は追加できません。
例: [{"op": "eq", "target": "reached"}]
取得または入力方法: NetPath の可用性指標から選択します。success_when の外側全体で 1 項目のみです。
task.success_when[*].traceroute_status[*].op string 状態は eq のみ、数値/所要時間は lt/gt/leq/geq/eq を許可します。
例: eq
取得または入力方法: 指標比較の要件に従って選択します。
task.success_when[*].traceroute_status[*].target string 状態 reached/partial/failed。e2e_status ではさらに unknown を許可します。
例: reached
取得または入力方法: 期待する測定境界を取得します。過去の測定結果をそのまま設定として使用しないでください。
task.config_vars[*].id string DNS はこれらのフィールドで型を検証します。グローバル変数の UUID。type=global の場合は必須です。
例: dvar_example
取得または入力方法: Synthetic テスト変数管理または現在のタスク設定の実際の定義を使用します。
task.config_vars[*].type string DNS はこれらのフィールドで型を検証します。グローバルの global または現在のタスクのローカル型。ブラウザの機密情報種別 secret/password/secure には独立した保持ルールがあります。
例: global
取得または入力方法: Synthetic テスト変数管理または現在のタスク設定の実際の定義を使用します。
task.config_vars[*].name string DNS はこれらのフィールドで型を検証します。テンプレート参照変数名。
例: HOST
取得または入力方法: Synthetic テスト変数管理または現在のタスク設定の実際の定義を使用します。
task.config_vars[*].value string DNS はこれらのフィールドで型を検証します。ローカル変数値。安全なソースから注入してください。該当しないフィールドは省略します。
例: example.com
取得または入力方法: Synthetic テスト変数管理または現在のタスク設定の実際の定義を使用します。
task.config_vars[*].example string DNS はこれらのフィールドで型を検証します。プレビュー/例の値であり、実際の対象ソースの代替ではありません。
例: example.com
取得または入力方法: Synthetic テスト変数管理または現在のタスク設定の実際の定義を使用します。
task.config_vars[*].secure boolean DNS はこれらのフィールドで型を検証します。安全な変数かどうか。型はブール値です。
例: false
取得または入力方法: Synthetic テスト変数管理または現在のタスク設定の実際の定義を使用します。
task.nodeSelection.mode string mobile では必須。nodes はノードを指定し、groups はノードグループを指定します。
例: nodes
取得または入力方法: モバイルリソース/テンプレートから読み取って選択します。
task.nodeSelection.ids array mobile では必須。空でなく一意の文字列配列。対応するリソース id を取得し、region UUID ではありません。
例: ["NODE-ID"]
取得または入力方法: モバイルリソース/テンプレートから読み取って選択します。
task.nodeSelection.ids[*] string mobile では必須。単一の現在のノードまたはグループ id。nodes は英数字、アンダースコア、ハイフンのみです。
例: NODE-ID
取得または入力方法: モバイルリソース/テンプレートから読み取って選択します。
task.nodeSelection.sampleCount integer mobile では必須。各ノードで独立したサンプリング回数 1..5。選択したノード/グループメンバー数には制限されません。
例: 1
取得または入力方法: モバイルリソース/テンプレートから読み取って選択します。
task.protocolOptions.httpMethod string http のみ。任意。省略時はプラットフォームのデフォルトに従います。GET/POST。
例: GET
取得または入力方法: モバイル対象プロトコルと実行プラットフォーム設定から取得します。
task.protocolOptions.body string http のみ。任意。省略時はプラットフォームのデフォルトに従います。リクエストボディ文字列。
例: {"probe":true}
取得または入力方法: モバイル対象プロトコルと実行プラットフォーム設定から取得します。
task.protocolOptions.httpHost json http のみ。任意。省略時はプラットフォームのデフォルトに従います。文字列マッピング。対象 Host の設定に従います。
例: {"Host": "example.com"}
取得または入力方法: モバイル対象プロトコルと実行プラットフォーム設定から取得します。
task.protocolOptions.httpHost.キー名 string 動的な文字列メンバー。変数テンプレートは許可されません(expectedResponseBody を除く)。
例: VALUE
取得または入力方法: HTTP リクエストで実際に必要な文字列のキー/値に従って設定します。
task.protocolOptions.httpParams json http のみ。任意。省略時はプラットフォームのデフォルトに従います。Query パラメーターの文字列マッピング。
例: {"check": "true"}
取得または入力方法: モバイル対象プロトコルと実行プラットフォーム設定から取得します。
task.protocolOptions.httpParams.キー名 string 動的な文字列メンバー。変数テンプレートは許可されません(expectedResponseBody を除く)。
例: VALUE
取得または入力方法: HTTP リクエストで実際に必要な文字列のキー/値に従って設定します。
task.protocolOptions.httpHeader json http のみ。任意。省略時はプラットフォームのデフォルトに従います。リクエストヘッダーの文字列マッピング。
例: {"Accept": "application/json"}
取得または入力方法: モバイル対象プロトコルと実行プラットフォーム設定から取得します。
task.protocolOptions.httpHeader.キー名 string 動的な文字列メンバー。変数テンプレートは許可されません(expectedResponseBody を除く)。
例: VALUE
取得または入力方法: HTTP リクエストで実際に必要な文字列のキー/値に従って設定します。
task.protocolOptions.expectedResponseBody string http のみ。任意。省略時はプラットフォームのデフォルトに従います。空でない原文の包含一致。trim せず、その中のテンプレートマーカーも解釈しません。
例: healthy
取得または入力方法: モバイル対象プロトコルと実行プラットフォーム設定から取得します。
task.protocolOptions.expectedResponseCode array http のみ。任意。省略時はプラットフォームのデフォルトに従います。空でない JSON 整数配列。許可するコード集合。テキスト正規表現と混用しないでください。複数の検出の組み合わせ判定は実行プラットフォームの実際の契約に従います。
例: [200]
取得または入力方法: モバイル対象プロトコルと実行プラットフォーム設定から取得します。
task.protocolOptions.expectedResponseCode[*] integer http のみ。任意。省略時はプラットフォームのデフォルトに従います。単一の JSON 整数コード。文字列/ブール値は使用できません。
例: 200
取得または入力方法: モバイル対象プロトコルと実行プラットフォーム設定から取得します。
task.protocolOptions.dnsHost string dns のみ。任意。省略時はプラットフォームのデフォルトに従います。DNS サーバー/ホスト文字列。
例: resolver.example.net
取得または入力方法: モバイル対象プロトコルと実行プラットフォーム設定から取得します。
task.protocolOptions.dnsIpVerify string dns のみ。任意。省略時はプラットフォームのデフォルトに従います。期待する DNS 解決 IP 文字列。
例: 203.0.113.10
取得または入力方法: モバイル対象プロトコルと実行プラットフォーム設定から取得します。
task.protocolOptions.tcpHost string tcp のみ。任意。省略時はプラットフォームのデフォルトに従います。TCP 対象 Host 設定。
例: example.com
取得または入力方法: モバイル対象プロトコルと実行プラットフォーム設定から取得します。
task.protocolOptions.tcpTimeoutMs integer tcp のみ。任意。省略時はプラットフォームのデフォルトに従います。タイムアウト 1..10000 ミリ秒。
例: 1000
取得または入力方法: モバイル対象プロトコルと実行プラットフォーム設定から取得します。
task.protocolOptions.tcpData string tcp のみ。任意。省略時はプラットフォームのデフォルトに従います。送信データテキスト。
例: ping
取得または入力方法: モバイル対象プロトコルと実行プラットフォーム設定から取得します。
task.protocolOptions.tcpVerify string tcp のみ。任意。省略時はプラットフォームのデフォルトに従います。期待するレスポンステキスト。
例: pong
取得または入力方法: モバイル対象プロトコルと実行プラットフォーム設定から取得します。
task.protocolOptions.pingType integer ping のみ。任意。省略時はプラットフォームのデフォルトに従います。1/2、省略時は 1。
例: 1
取得または入力方法: モバイル対象プロトコルと実行プラットフォーム設定から取得します。
task.protocolOptions.pingCount integer ping のみ。任意。省略時はプラットフォームのデフォルトに従います。送信回数 1..10。
例: 3
取得または入力方法: モバイル対象プロトコルと実行プラットフォーム設定から取得します。
task.protocolOptions.pingTimeoutMs integer ping のみ。任意。省略時はプラットフォームのデフォルトに従います。タイムアウト 1..10000 ミリ秒。
例: 1000
取得または入力方法: モバイル対象プロトコルと実行プラットフォーム設定から取得します。
task.protocolOptions.taskTimeoutMs integer http/dns/tcp/ping のみ。任意。省略時はプラットフォームのデフォルトに従います。タスクタイムアウト 1..10000 ミリ秒。
例: 10000
取得または入力方法: モバイル対象プロトコルと実行プラットフォーム設定から取得します。
task.protocolOptions.flowLimit integer http/dns/tcp/ping のみ。任意。省略時はプラットフォームのデフォルトに従います。プラットフォームの流量制限整数 1..10。Studio では追加の単位換算を定義していません。
例: 1
取得または入力方法: モバイル対象プロトコルと実行プラットフォーム設定から取得します。
regions array Y 必須配列。通常タスクでは空にできません。モバイルタスクでは明示的に [] にし、代わりに task.nodeSelection を使用します。変更時はノード集合全体を置き換え、ノードを削除すると元のノードに停止が配信されます。
null 許可: False
例: ["reg_example"]
取得または入力方法: 利用可能なノード一覧またはデフォルト地域一覧から実際のノード uuid を取得します。
tags array 任意。デフォルトは []。変更時に省略または [] を指定するとタグ関係がクリアされます。モバイルタスクでは同時に送信タグを同期し、クライアントの dfLabel/extendConfig は受け付けません。
null 許可: False
例: ["production"]
取得または入力方法: タグ一覧から dialing/all スコープに適用できる名前を取得します。UUID ではありません。
task json Y 完全なオブジェクトが必須。追加時 maxDictLength=20000、変更時 65536。サーバー側の str(dict) 長と UTF-8 差分/2 の重み付きカウントに基づき、元の HTTP バイト上限ではありません。部分パッチではありません。レスポンスオブジェクト全体をそのまま返送することは禁止です。
null 許可: False
辞書長上限: 20000
例: {"name": "サイト可用性", "frequency": "5m", "method": "GET", "url": "https://example.com/health", "success_when": [{"status_code": [{"is": "200"}]}]}
取得または入力方法: 対象 type に従って完全なタスクオブジェクトを入力します。変更時は先に get でバックアップし、書き込み可能なフィールドのみを書き戻します。
task.address string mobile では必須。trim 後、空でなく 2048 文字以下。変数は許可されません。HTTP ではユーザー名/パスワードおよび空白/制御文字を禁止し、有効なポート/パス/Query を許可します。TCP では有効なポートが必須です。ping ではポートを追加できません。
例: https://example.com/health
取得または入力方法: モバイルタスクの対象: HTTP は完全な HTTPS、TCP は host:port、DNS はドメイン、ping はドメイン/IP。
task.advance_options json 任意のオブジェクト。NetPath では必須で、このページの 6 フィールドのみを厳密に許可します。HTTP リクエスト、証明書/プロキシなどは実行側の実際のサポートに従う必要があり、プロトコル検証をオンラインテストと同一視しないでください。
null 許可: False
例: {}
取得または入力方法: HTTP/WebSocket の詳細オプションまたは NetPath 専用構造に従って選択します。
task.advance_options_headless json 公開宣言として保持されますが、必須の browser_config の代替にはなりません。現在の公開追加/変更 browser は完全な設定を通過できません。このオブジェクトをブラウザスクリプトのエントリーポイントとして扱わないでください。
null 許可: False
例: {}
取得または入力方法: 従来のブラウザ詳細設定の保存構造。
task.certificate json DNS の任意 TLS 証明書オブジェクト。HTTP の advance_options には入れません。
null 許可: False
例: {}
取得または入力方法: DNS の値は業務ドメイン、DNS サーバーおよび実行側設定から取得します。その他のプロトコルでは現在の type に従って選択します。
task.config_vars array 任意。デフォルトは []。NetPath では [] のみ許可、mobile は非サポート。変更時は入力集合を再バインドします。DNS が参照する id はすべて現在のワークスペースの有効な変数に属している必要があり、サイレントフィルタリングではありません。
null 許可: False
例: []
取得または入力方法: ワークスペースの Synthetic テスト変数から取得するか、現在のタスクのローカル変数を定義します。
task.crontab string schedule_type=crontab の場合は空でなく、Cron 解析を通過する必要があります。frequency は引き続き公開宣言上の必須です。mobile はこのフィールドを受け付けません。タイムゾーン/実行間隔はノードの実際の環境と合わせて検証する必要があり、Unix タイムスタンプとして扱うことはできません。
null 許可: False
例: */5 * * * *
取得または入力方法: 対象スケジュールに従って完全な Cron 式を選択します。
task.dns_options json 任意の DNS クエリフラグ/EDNS パラメーター。
null 許可: False
例: {}
取得または入力方法: DNS の値は業務ドメイン、DNS サーバーおよび実行側設定から取得します。その他のプロトコルでは現在の type に従って選択します。
task.dns_server string DoH 以外ではサーバーのドメイン/IP が必須。ポートは含めません。DoH は URL から導出できます。
空文字列許可: True
null 許可: False
例: resolver.example.net
取得または入力方法: DNS の値は業務ドメイン、DNS サーバーおよび実行側設定から取得します。その他のプロトコルでは現在の type に従って選択します。
task.doh json DNS の DoH プロトコル設定。
null 許可: False
例: {}
取得または入力方法: DNS の値は業務ドメイン、DNS サーバーおよび実行側設定から取得します。その他のプロトコルでは現在の type に従って選択します。
task.domain string 業務上必須の照会対象ドメイン。検証済みの変数テンプレートを使用できます。
null 許可: False
例: example.com
取得または入力方法: DNS の値は業務ドメイン、DNS サーバーおよび実行側設定から取得します。その他のプロトコルでは現在の type に従って選択します。
task.enable_traceroute boolean 任意。省略時に Studio が統一デフォルトを補うことはありません。NetPath は自身のパスプロトコルを使用し、このフィールドを混用しません。
null 許可: False
例: false
取得または入力方法: TCP/ICMP でパス診断が必要な場合に有効化します。
task.frequency string Y 必須でデフォルトなし。無料/体験ワークスペースでは 30m/1h/6h/12h/24h のみです。DataKit の手動 JSON の任意の秒単位頻度を適用しないでください。
null 許可: False
選択可能な値: ['1m', '5m', '15m', '30m', '1h', '6h', '12h', '24h']
例: 5m
取得または入力方法: 業務予算と実行要件に従って 1m/5m/15m/30m/1h/6h/12h/24h を選択します。
task.host string 対応プロトコルで業務上必須。NetPath では trim 後空でないこと。HTTP URL scheme を含める必要はありません。mobile TCP では代わりに address=host:port を入力します。
null 許可: False
例: example.com
取得または入力方法: TCP/ICMP/SSL/NetPath 対象の到達可能なドメインまたは IP を取得します。
task.ignore_server_certificate_error boolean SSL では任意。省略時は実行側の安全なデフォルトに従います。DNS の証明書無視スイッチは certificate 内に置きます。
null 許可: False
例: false
取得または入力方法: SSL で本当にサーバー証明書エラーを無視する必要がある場合に明示的に選択します。
task.message string WebSocket で業務上必要。UTF-8 で 128KiB を超えてはなりません。モバイル TCP の tcpData には使用しません。
null 許可: False
例: ping
取得または入力方法: WebSocket 接続確立後に送信するメッセージテキスト。
task.method string HTTP で業務上必須。欠落時は MissingMethod を返します。その他のプロトコルでは省略し、任意のメソッドが実行側でサポートされることを保証しません。
null 許可: False
例: GET
取得または入力方法: 対象 HTTP インターフェースに従って GET/POST/PUT などの実際のメソッドを選択します。
task.name string Y 必須。trim 後 1..256 の Python 文字。trim 結果を保存します。すべての Synthetic テスト種別で、削除されていない名前の一意性を共有します。変更時は完全な名前を提供する必要があります。
null 許可: False
例: サイト可用性
取得または入力方法: 業務側がこのワークスペースで一意のタスク名を定義します。
task.nodeSelection json mobile では必須。mode/ids/sampleCount の 3 つのキーのみを持ちます。スナップショットを保存し、テンプレートに動的に追従しません。nodes は ID 構造のみを検証して元の ID/順序を保持し、リアルタイムの存在やマッピング済みであることを保証しません。groups は現在のグループとメンバーを照会し、ノード集合を照合します。
例: {"mode": "nodes", "ids": ["NODE-ID"], "sampleCount": 1}
取得または入力方法: nodes はモバイルリソースからノード ID を取得します。groups は現在、同じワークスペースの既存テンプレートまたは管理者が確認したグループレコードから ID を取得する必要があります(リソース入口は現在グループを取得しません)。ノード選択テンプレートのスナップショットを再利用することもできます。
task.packet_count integer ICMP では任意。各ラウンドの送信数。実際のノード制約は実行側で確認され、mobile の pingCount には使用しません。
null 許可: False
例: 3
取得または入力方法: ICMP のサンプリング回数に従って正の整数を決定します。
task.port string TCP/SSL で業務上必須。NetPath の TCP/UDP は 1..65535 かつ純粋な数字(先頭の 0 を保持可能)。ICMP では無視されます。DNS は独立したプロトコルポートで、デフォルト 53 または暗号化プロトコルの 853 は実行側が決定します。
null 許可: False
例: 443
取得または入力方法: 対象サービスが実際に待ち受けるポートに従い、数字文字列を送信します。
task.post_mode string 任意。実行側の選択方式。Studio の HTTP で success_when が必要かどうかは、実際には post_script が空でないかで判断され、このフィールドだけでは判断されません。
null 許可: False
例: default
取得または入力方法: 可用性判定には default、スクリプト判定には script を使用します。
task.post_script string 任意。空文字列はスクリプトを提供しないことを示します。HTTP で空でない場合、success_when を付けなくてもかまいません。DNS/NetPath/mobile はスクリプトによって専用ホワイトリストと検証をバイパスしません。
空文字列許可: True
null 許可: False
例:
取得または入力方法: 検証済みの Synthetic テスト Pipeline 判定スクリプトから取得します。
task.protocol string DNS は auto/udp/tcp/dot/doh/doq から選択(省略時 auto)。NetPath は tcp/udp/icmp から選択(必須)。mobile は http/dns/tcp/ping から選択(必須)。
null 許可: False
例: dot
取得または入力方法: DNS の値は業務ドメイン、DNS サーバーおよび実行側設定から取得します。その他のプロトコルでは現在の type に従って選択します。
task.protocolOptions json 任意。デフォルトは {}。完全置換。HTTP に従来の検出フィールドが存在する場合、変更時はオブジェクトを明示的に提供する必要があります。オブジェクト内で検出フィールドを省略した場合にのみクリアされ、空文字列/null/空配列はクリア指示ではありません。HTTP のデフォルトは httpMethod=GET、ping のデフォルトは pingType=1 で、その他の数値は Studio がデフォルトを補いません。
例: {}
取得または入力方法: mobile task.protocol に従って対応するパラメーターを選択し、その他のプロトコルではこのオブジェクトを入力しないでください。
task.record_types array 任意。A/AAAA/CNAME/MX/NS/TXT。アサーションから導出でき、実行側のデフォルトは A。
null 許可: False
例: ["A"]
取得または入力方法: DNS の値は業務ドメイン、DNS サーバーおよび実行側設定から取得します。その他のプロトコルでは現在の type に従って選択します。
task.schedule_type string 任意。省略時は実行側の通常頻度に従います。mobile は frequency のみで、crontab をサポートしません。
null 許可: False
選択可能な値: ['frequency', 'crontab']
例: frequency
取得または入力方法: 通常の周期は frequency、カスタムスケジュールは crontab。
task.server_ip string 任意の固定接続 IP。論理サーバー ID を保持し、省略時は実行側で解決されます。
空文字列許可: True
null 許可: False
例: 203.0.113.53
取得または入力方法: DNS の値は業務ドメイン、DNS サーバーおよび実行側設定から取得します。その他のプロトコルでは現在の type に従って選択します。
task.server_name string SSL/DNS では任意。server_ip で接続 IP を固定する場合に元のサービス ID を保持し、SNI の代わりに IP を直接入力しないでください。
null 許可: False
例: example.com
取得または入力方法: TLS サービス SNI/証明書に対応する論理ドメイン。
task.success_when array HTTP で空でない post_script がない場合、TCP/ICMP/WebSocket/SSL ではこのキーが必要です。DNS では 1..20 の有効なリーフが必須です。NetPath では外側が単一オブジェクトである必要があります。異なるプロトコルの構造を混用することはできません。保存時にリアルタイムの実行成功は要求されません。
null 許可: False
例: [{"status_code": [{"is": "200"}]}]
取得または入力方法: 本ページの対応プロトコルの指標/アサーション構造に従って構築し、先に実際の対象レスポンスを確認します。
task.success_when_logic string 任意の and/or。実行側の通常デフォルトは and。NetPath では明示的に入力する必要があります。アラート通知ポリシーを制御するものではありません。
null 許可: False
選択可能な値: ['and', 'or']
例: and
取得または入力方法: 複数の可用性条件をすべて満たす場合は and、いずれかを満たす場合は or を選択します。
task.timeout string TCP は 1s..60s の整数秒文字列。DNS のデフォルトは 10s、実行側の範囲は (0,60s] で変数テンプレートを使用できます。ICMP/SSL は実行側のサポートに従い、Studio は統一デフォルトを補いません。NetPath は advance_options.timeout を使用します。
null 許可: False
例: 10s
取得または入力方法: 接続/照会に許容される時間に従って duration を入力します。
task.url string HTTP/WebSocket はプロトコルに従って入力します。公開層では任意ですが、タスク実行には必要です。mobile には使用せず、mobile では address を入力します。ブラウザには現在の入口制限が別途あります。
null 許可: False
例: https://example.com/health
取得または入力方法: 監視対象の HTTP/WebSocket サービスから完全な対象 URL を取得し、選択したノードからアクセスできる必要があります。
type string Y 作成時は必須。大文字/小文字は正規化されます。変更時は既存エンティティの型で決まり、type は渡しません。browser には現在、後述の公開ホワイトリスト制限があります。multi は独立したマルチステップ API を使用します。
null 許可: fase
$lowerIn: ['http', 'tcp', 'dns', 'browser', 'icmp', 'websocket', 'ssl', 'netpath', 'mobile']
例: http
取得または入力方法: タスク用途に従って http/tcp/dns/browser/icmp/websocket/ssl/netpath/mobile を選択します。

パラメーター補足説明

各プロトコルのパラメーター、取得元、返却、境界は本ページの詳細表に従います。実行側の条件についてはカスタム Synthetic テストを参照してください。

リクエスト例

curl --request POST 'https://openapi.guance.com/api/v1/dialing_task/add' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  -H 'Content-Type: application/json' \
  --data-raw '{"regions":["reg_example"],"task":{"name":"サイト可用性","frequency":"5m","method":"GET","url":"https://example.com/health","success_when":[{"status_code":[{"is":"200"}]}]},"tags":[],"type":"http"}'

レスポンス

HTTP 200、application/json。以下の例は直接読み取れる主要フィールドを示します。

フィールド 型 説明
content.id integer または null レコード番号。通常作成ではコミット前にレスポンスを構築するため null になる可能性があります。
content.uuid string dial_ タスク UUID。後続の get/modify/開始/停止で使用します。
content.workspaceUUID string 所属ワークスペース UUID。
content.type string 保存されたタスク種別。mobile の細分化プロトコルは task.protocol を参照。マルチステップは multi。
content.status integer エンティティ状態。通常は 0、削除は 3。task.status の実行スイッチとは異なります。
content.isLocked integer または boolean ローカル/ワークスペースのロックフラグ。リモートの実測状態を表すものではありません。
content.regions array<string> 通常タスクの現在のノード UUID 配列。モバイルは []。
content.regions[] string ノード UUID。
content.regionsInfo array または object 従来のノード表示では UUID 配列、オブジェクト配列、または UUID キーマッピングになる可能性があります。作成/変更では通常、入力 UUID 配列です。
content.regionsInfo[] string または object ノード UUID または保存済みノード情報。
content.regionsInfo[].uuid string 条件付きで返されるノード UUID。
content.regionsInfo[].name string 現在の言語でのノード表示名。
content.regionsInfo[].nameEn string 英語/互換名。
content.regionsInfo[].nameI18n object 言語から名前へのマッピング。
content.regionsInfo[].nameI18n.言語コード string 単一の表示名。
content.regionsInfo.ノードUUID string または object 従来の UUID キーマッピング内のノード情報。配列のノード情報と同じセマンティクスです。
content.task object 保存済みタスクの完全な設定。リアルタイムの Synthetic テスト結果は含みません。
content.task.status string ok は有効/stop は停止。ローカル設定値はリモートとの完全同期を保証しません。
content.task.external_id string 一部の通常書き込みレスポンスにサーバー側タスク識別子が含まれる場合があります。list/get ではこの内部キーが削除され、書き込み可能フィールドとして扱われません。
content.task.owner_external_id string 一部の通常書き込みレスポンスにサーバー側ワークスペース識別子が含まれる場合があります。list/get では除外され、送信されません。
content.task.post_url string 一部の旧通常書き込みレスポンスにサーバー側の報告先アドレスが含まれる場合があります。list/get では除外されます。機密性のある返却値は安全に保管し、絶対に書き戻したり公開したりしないでください。
content.task.其他历史字段 JSON 互換保存フィールド。型に従って解釈され、本公開書き込み入口のホワイトリストとしては扱われません。
content.remoteStatus string mobile は固定で unknown。ローカルのみで読み取り、プラットフォームをリアルタイム照会しません。
content.creator string 作成者 ID。
content.updator string 更新者 ID。
content.createAt integer 作成 Unix 秒。
content.updateAt integer 更新 Unix 秒。
content.deleteAt integer 削除 Unix 秒。未削除は -1。
content.task.name string 必須。trim 後 1..256 の Python 文字。trim 結果を保存します。すべての Synthetic テスト種別で、削除されていない名前の一意性を共有します。変更時は完全な名前を提供する必要があります。
content.task.frequency string 必須でデフォルトなし。無料/体験ワークスペースでは 30m/1h/6h/12h/24h のみです。DataKit の手動 JSON の任意の秒単位頻度を適用しないでください。
content.task.schedule_type string 任意。省略時は実行側の通常頻度に従います。mobile は frequency のみで、crontab をサポートしません。
content.task.crontab string schedule_type=crontab の場合は空でなく、Cron 解析を通過する必要があります。frequency は引き続き公開宣言上の必須です。mobile はこのフィールドを受け付けません。タイムゾーン/実行間隔はノードの実際の環境と合わせて検証する必要があり、Unix タイムスタンプとして扱うことはできません。
content.task.url string HTTP/WebSocket はプロトコルに従って入力します。公開層では任意ですが、タスク実行には必要です。mobile には使用せず、mobile では address を入力します。ブラウザには現在の入口制限が別途あります。
content.task.method string HTTP で業務上必須。欠落時は MissingMethod を返します。その他のプロトコルでは省略し、任意のメソッドが実行側でサポートされることを保証しません。
content.task.success_when_logic string 任意の and/or。実行側の通常デフォルトは and。NetPath では明示的に入力する必要があります。アラート通知ポリシーを制御するものではありません。
content.task.success_when array HTTP で空でない post_script がない場合、TCP/ICMP/WebSocket/SSL ではこのキーが必要です。DNS では 1..20 の有効なリーフが必須です。NetPath では外側が単一オブジェクトである必要があります。異なるプロトコルの構造を混用することはできません。保存時にリアルタイムの実行成功は要求されません。
content.task.success_when[] json 単一の条件オブジェクト。外側の条件ロジックは success_when_logic で制御されます。内部条件のセマンティクスは対応する実行側で検証されます。
content.task.enable_traceroute boolean 任意。省略時に Studio が統一デフォルトを補うことはありません。NetPath は自身のパスプロトコルを使用し、このフィールドを混用しません。
content.task.packet_count integer ICMP では任意。各ラウンドの送信数。実際のノード制約は実行側で確認され、mobile の pingCount には使用しません。
content.task.host string 対応プロトコルで業務上必須。NetPath では trim 後空でないこと。HTTP URL scheme を含める必要はありません。mobile TCP では代わりに address=host:port を入力します。
content.task.port string TCP/SSL で業務上必須。NetPath の TCP/UDP は 1..65535 かつ純粋な数字(先頭の 0 を保持可能)。ICMP では無視されます。DNS は独立したプロトコルポートで、デフォルト 53 または暗号化プロトコルの 853 は実行側が決定します。
content.task.server_name string SSL/DNS では任意。server_ip で接続 IP を固定する場合に元のサービス ID を保持し、SNI の代わりに IP を直接入力しないでください。
content.task.timeout string TCP は 1s..60s の整数秒文字列。DNS のデフォルトは 10s、実行側の範囲は (0,60s] で変数テンプレートを使用できます。ICMP/SSL は実行側のサポートに従い、Studio は統一デフォルトを補いません。NetPath は advance_options.timeout を使用します。
content.task.ignore_server_certificate_error boolean SSL では任意。省略時は実行側の安全なデフォルトに従います。DNS の証明書無視スイッチは certificate 内に置きます。
content.task.message string WebSocket で業務上必要。UTF-8 で 128KiB を超えてはなりません。モバイル TCP の tcpData には使用しません。
content.task.post_mode string 任意。実行側の選択方式。Studio の HTTP で success_when が必要かどうかは、実際には post_script が空でないかで判断され、このフィールドだけでは判断されません。
content.task.post_script string 任意。空文字列はスクリプトを提供しないことを示します。HTTP で空でない場合、success_when を付けなくてもかまいません。DNS/NetPath/mobile はスクリプトによって専用ホワイトリストと検証をバイパスしません。
content.task.advance_options json 任意のオブジェクト。NetPath では必須で、このページの 6 フィールドのみを厳密に許可します。HTTP リクエスト、証明書/プロキシなどは実行側の実際のサポートに従う必要があり、プロトコル検証をオンラインテストと同一視しないでください。
content.task.advance_options_headless json 公開宣言として保持されますが、必須の browser_config の代替にはなりません。現在の公開追加/変更 browser は完全な設定を通過できません。このオブジェクトをブラウザスクリプトのエントリーポイントとして扱わないでください。
content.task.advance_options.request_options json HTTP/WebSocket に適用。任意。HTTP/WebSocket リクエストオプション。
content.task.advance_options.request_options.follow_redirect boolean HTTP/WebSocket に適用。任意。リダイレクトに従うかどうか。省略時は実行側のデフォルトに従います。
content.task.advance_options.request_options.headers json HTTP/WebSocket に適用。任意。リクエストヘッダー名から文字列値へのマッピング。実際の認証情報をサンプルに書き込まないでください。
content.task.advance_options.request_options.headers.リクエストヘッダー名 string HTTP/WebSocket に適用。任意。動的なリクエストヘッダー値。名前は実際のインターフェースで必要な header を使用します。
content.task.advance_options.request_options.cookies string HTTP/WebSocket に適用。任意。Cookie テキスト。省略可能。
content.task.advance_options.request_options.auth json HTTP/WebSocket に適用。任意。HTTP Basic のユーザー名/パスワード設定。省略可能。
content.task.advance_options.request_options.auth.username string HTTP/WebSocket に適用。任意。Basic ユーザー名。対象インターフェースの管理者から提供されます。
content.task.advance_options.request_options.auth.password string HTTP/WebSocket に適用。任意。Basic パスワード。安全な認証情報ソースから注入してください。
content.task.advance_options.request_body json HTTP/WebSocket に適用。任意。リクエスト Body の形式と内容。
content.task.advance_options.request_body.body_type string HTTP/WebSocket に適用。任意。リクエストの Content-Type。例: application/json/text/plain/text/xml/multipart/form-data。
content.task.advance_options.request_body.body string HTTP/WebSocket に適用。任意。リクエストボディ文字列。変更時は必要な業務内容を保持する必要があります。
content.task.advance_options.request_body.form json HTTP/WebSocket に適用。任意。multipart フォームフィールドから文字列へのマッピング。省略可能。
content.task.advance_options.request_body.form.フィールド名 string HTTP/WebSocket に適用。任意。単一のフォーム値。
content.task.advance_options.request_timeout string HTTP/WebSocket に適用。任意。HTTP 全体のタイムアウト duration。実行側のデフォルトは 60s。Studio は実際の実行側の検証を代替しません。
content.task.advance_options.protocol string HTTP/WebSocket に適用。任意。HTTP プロトコル auto/http/1.1/http/2/http/2-only/http/3。サポート状況はノードのバージョンに依存します。HTTP3 では同時にプロキシを設定しないでください。
content.task.advance_options.certificate json HTTP/WebSocket に適用。任意。リクエストの TLS 証明書設定。
content.task.advance_options.certificate.ignore_server_certificate_error boolean HTTP/WebSocket に適用。任意。証明書検証エラーを無視するかどうか。
content.task.advance_options.certificate.certificate string HTTP/WebSocket に適用。任意。PEM クライアント証明書。対象サービスから提供されます。
content.task.advance_options.certificate.private_key string HTTP/WebSocket に適用。任意。証明書に対応する PEM 秘密鍵。安全なソースを使用してください。
content.task.advance_options.certificate.ca string HTTP/WebSocket に適用。任意。CA の内容。一部の HTTP 実行側では保持されますが使用されません。DNS では certificate.ca をそのプロトコルに従って解釈します。
content.task.advance_options.proxy json HTTP/WebSocket に適用。任意。HTTP プロキシオブジェクト。ノードが任意のプロキシにアクセスできると仮定しないでください。
content.task.advance_options.proxy.url string HTTP/WebSocket に適用。任意。プロキシ URL。
content.task.advance_options.proxy.headers json HTTP/WebSocket に適用。任意。プロキシ専用の文字列 header マッピング。
content.task.advance_options.proxy.headers.リクエストヘッダー名 string HTTP/WebSocket に適用。任意。単一のプロキシリクエストヘッダー値。
content.task.advance_options.secret json HTTP/WebSocket に適用。任意。従来の HTTP リクエストデータ保存オプション。実行側のサポート状況に従います。
content.task.advance_options.secret.not_save boolean HTTP/WebSocket に適用。任意。リクエスト内容を保存しないかどうか。返却ドキュメント/ログのマスキングの代替にはなりません。
content.task.success_when[].body array 任意のアサーション集合。キー名は実際のレスポンスに従います。実行側がサポートする比較のみを使用してください。
content.task.success_when[].body[].contains string 単一のテキスト比較。必要な操作に応じて選択します。正規表現のセマンティクスは実行側で検証され、保存成功は一致を証明するものではありません。
content.task.success_when[].body[].not_contains string 単一のテキスト比較。必要な操作に応じて選択します。正規表現のセマンティクスは実行側で検証され、保存成功は一致を証明するものではありません。
content.task.success_when[].body[].is string 単一のテキスト比較。必要な操作に応じて選択します。正規表現のセマンティクスは実行側で検証され、保存成功は一致を証明するものではありません。
content.task.success_when[].body[].is_not string 単一のテキスト比較。必要な操作に応じて選択します。正規表現のセマンティクスは実行側で検証され、保存成功は一致を証明するものではありません。
content.task.success_when[].body[].match_regex string 単一のテキスト比較。必要な操作に応じて選択します。正規表現のセマンティクスは実行側で検証され、保存成功は一致を証明するものではありません。
content.task.success_when[].body[].not_match_regex string 単一のテキスト比較。必要な操作に応じて選択します。正規表現のセマンティクスは実行側で検証され、保存成功は一致を証明するものではありません。
content.task.success_when[].header.レスポンスヘッダー名 array 任意のアサーション集合。キー名は実際のレスポンスに従います。実行側がサポートする比較のみを使用してください。
content.task.success_when[].header.レスポンスヘッダー名[].contains string 単一のテキスト比較。必要な操作に応じて選択します。正規表現のセマンティクスは実行側で検証され、保存成功は一致を証明するものではありません。
content.task.success_when[].header.レスポンスヘッダー名[].not_contains string 単一のテキスト比較。必要な操作に応じて選択します。正規表現のセマンティクスは実行側で検証され、保存成功は一致を証明するものではありません。
content.task.success_when[].header.レスポンスヘッダー名[].is string 単一のテキスト比較。必要な操作に応じて選択します。正規表現のセマンティクスは実行側で検証され、保存成功は一致を証明するものではありません。
content.task.success_when[].header.レスポンスヘッダー名[].is_not string 単一のテキスト比較。必要な操作に応じて選択します。正規表現のセマンティクスは実行側で検証され、保存成功は一致を証明するものではありません。
content.task.success_when[].header.レスポンスヘッダー名[].match_regex string 単一のテキスト比較。必要な操作に応じて選択します。正規表現のセマンティクスは実行側で検証され、保存成功は一致を証明するものではありません。
content.task.success_when[].header.レスポンスヘッダー名[].not_match_regex string 単一のテキスト比較。必要な操作に応じて選択します。正規表現のセマンティクスは実行側で検証され、保存成功は一致を証明するものではありません。
content.task.success_when[].header json 任意の header 名から条件集合へのマッピング。
content.task.success_when[].status_code array HTTP の任意のステータスアサーション集合。実行側のプロトコルに従って文字列を比較します。
content.task.success_when[].status_code[].is string 単一のステータスコードアサーション操作。mobile の expectedResponseCode 整数配列と混用しないでください。
content.task.success_when[].status_code[].is_not string 単一のステータスコードアサーション操作。mobile の expectedResponseCode 整数配列と混用しないでください。
content.task.success_when[].status_code[].match_regex string 単一のステータスコードアサーション操作。mobile の expectedResponseCode 整数配列と混用しないでください。
content.task.success_when[].status_code[].not_match_regex string 単一のステータスコードアサーション操作。mobile の expectedResponseCode 整数配列と混用しないでください。
content.task.success_when[].response_time string または array HTTP/WebSocket/DNS は duration しきい値文字列です。従来の TCP/ICMP は条件配列にできます。レスポンス時間の単位は対応するリーフフィールドを参照し、一律に素のミリ秒数値として解釈しないでください。
content.task.success_when[].response_time[].is_contain_dns boolean 配列形式の場合のみ使用します。TCP/ICMP で DNS 所要時間を比較に含めるかどうか。
content.task.success_when[].response_time[].target string 配列形式の場合のみ使用します。所要時間比較値の duration。
content.task.success_when[].connection array TCP では任意ですが、指定する場合は空でない配列にする必要があり、eq established/refused/timeout のみです。
content.task.success_when[].connection[].op string 必須。eq のみで、is/ne は受け付けません。
content.task.success_when[].connection[].target string 必須。established/refused/timeout の接続結果。
content.task.domain string 業務上必須の照会対象ドメイン。検証済みの変数テンプレートを使用できます。
content.task.dns_server string DoH 以外ではサーバーのドメイン/IP が必須。ポートは含めません。DoH は URL から導出できます。
content.task.server_ip string 任意の固定接続 IP。論理サーバー ID を保持し、省略時は実行側で解決されます。
content.task.record_types array 任意。A/AAAA/CNAME/MX/NS/TXT。アサーションから導出でき、実行側のデフォルトは A。
content.task.record_types[] string 単一のレコードタイプまたは有効な変数テンプレート。
content.task.protocol string DNS は auto/udp/tcp/dot/doh/doq から選択(省略時 auto)。NetPath は tcp/udp/icmp から選択(必須)。mobile は http/dns/tcp/ping から選択(必須)。
content.task.certificate json DNS の任意 TLS 証明書オブジェクト。HTTP の advance_options には入れません。
content.task.doh json DNS の DoH プロトコル設定。
content.task.doh.url string DoH では必須の URL。
content.task.doh.method string 任意の GET/POST。省略時は実行側で処理されます。
content.task.doh.http_protocol string 任意の auto/http/1.1/http/2-only/http/3。
content.task.doh.headers json 任意の HTTP リクエストヘッダー文字列マッピング。
content.task.doh.headers.リクエストヘッダー名 string 単一の文字列リクエストヘッダー。
content.task.dns_options json 任意の DNS クエリフラグ/EDNS パラメーター。
content.task.dns_options.recursion_desired boolean 任意の RD 再帰クエリフラグ。省略時は実行側のデフォルトです。
content.task.dns_options.dnssec_ok boolean 任意の DO DNSSEC フラグ。
content.task.dns_options.checking_disabled boolean 任意の CD 検証無効化フラグ。
content.task.dns_options.udp_payload_size integer 任意の EDNS UDP ペイロードサイズ。単位はバイト。セマンティクス範囲は実行側で検証されます。
content.task.certificate.ca string DNS では任意。PEM CA。
content.task.certificate.certificate string DNS では任意。PEM クライアント証明書。
content.task.certificate.private_key string DNS では任意。PEM 秘密鍵。安全に注入してください。
content.task.certificate.ignore_server_certificate_error boolean DNS では任意。証明書検証を無視するかどうか。
content.task.success_when[].authenticated_data boolean DNS の任意リーフ。他のリーフとの合計は 20 を超えてはなりません。
content.task.success_when[].at_least_one_record json 任意ですが、指定する場合は空でないオブジェクトにし、レコードタイプごとにグループ化します。
content.task.success_when[].at_least_one_record.of_type_a array 指定する場合は空でない条件配列にし、各項目には 1 つの比較キーのみを指定できます。
content.task.success_when[].at_least_one_record.of_type_a[].exists boolean 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].at_least_one_record.of_type_a[].is string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].at_least_one_record.of_type_a[].contains string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].at_least_one_record.of_type_a[].match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].at_least_one_record.of_type_a[].not_match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].at_least_one_record.of_type_aaaa array 指定する場合は空でない条件配列にし、各項目には 1 つの比較キーのみを指定できます。
content.task.success_when[].at_least_one_record.of_type_aaaa[].exists boolean 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].at_least_one_record.of_type_aaaa[].is string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].at_least_one_record.of_type_aaaa[].contains string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].at_least_one_record.of_type_aaaa[].match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].at_least_one_record.of_type_aaaa[].not_match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].at_least_one_record.of_type_cname array 指定する場合は空でない条件配列にし、各項目には 1 つの比較キーのみを指定できます。
content.task.success_when[].at_least_one_record.of_type_cname[].exists boolean 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].at_least_one_record.of_type_cname[].is string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].at_least_one_record.of_type_cname[].contains string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].at_least_one_record.of_type_cname[].match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].at_least_one_record.of_type_cname[].not_match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].at_least_one_record.of_type_mx array 指定する場合は空でない条件配列にし、各項目には 1 つの比較キーのみを指定できます。
content.task.success_when[].at_least_one_record.of_type_mx[].exists boolean 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].at_least_one_record.of_type_mx[].is string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].at_least_one_record.of_type_mx[].contains string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].at_least_one_record.of_type_mx[].match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].at_least_one_record.of_type_mx[].not_match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].at_least_one_record.of_type_ns array 指定する場合は空でない条件配列にし、各項目には 1 つの比較キーのみを指定できます。
content.task.success_when[].at_least_one_record.of_type_ns[].exists boolean 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].at_least_one_record.of_type_ns[].is string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].at_least_one_record.of_type_ns[].contains string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].at_least_one_record.of_type_ns[].match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].at_least_one_record.of_type_ns[].not_match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].at_least_one_record.of_type_txt array 指定する場合は空でない条件配列にし、各項目には 1 つの比較キーのみを指定できます。
content.task.success_when[].at_least_one_record.of_type_txt[].exists boolean 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].at_least_one_record.of_type_txt[].is string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].at_least_one_record.of_type_txt[].contains string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].at_least_one_record.of_type_txt[].match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].at_least_one_record.of_type_txt[].not_match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].every_record json 任意ですが、指定する場合は空でないオブジェクトにし、レコードタイプごとにグループ化します。
content.task.success_when[].every_record.of_type_a array 指定する場合は空でない条件配列にし、各項目には 1 つの比較キーのみを指定できます。
content.task.success_when[].every_record.of_type_a[].exists boolean 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].every_record.of_type_a[].is string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].every_record.of_type_a[].contains string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].every_record.of_type_a[].match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].every_record.of_type_a[].not_match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].every_record.of_type_aaaa array 指定する場合は空でない条件配列にし、各項目には 1 つの比較キーのみを指定できます。
content.task.success_when[].every_record.of_type_aaaa[].exists boolean 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].every_record.of_type_aaaa[].is string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].every_record.of_type_aaaa[].contains string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].every_record.of_type_aaaa[].match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].every_record.of_type_aaaa[].not_match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].every_record.of_type_cname array 指定する場合は空でない条件配列にし、各項目には 1 つの比較キーのみを指定できます。
content.task.success_when[].every_record.of_type_cname[].exists boolean 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].every_record.of_type_cname[].is string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].every_record.of_type_cname[].contains string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].every_record.of_type_cname[].match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].every_record.of_type_cname[].not_match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].every_record.of_type_mx array 指定する場合は空でない条件配列にし、各項目には 1 つの比較キーのみを指定できます。
content.task.success_when[].every_record.of_type_mx[].exists boolean 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].every_record.of_type_mx[].is string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].every_record.of_type_mx[].contains string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].every_record.of_type_mx[].match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].every_record.of_type_mx[].not_match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].every_record.of_type_ns array 指定する場合は空でない条件配列にし、各項目には 1 つの比較キーのみを指定できます。
content.task.success_when[].every_record.of_type_ns[].exists boolean 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].every_record.of_type_ns[].is string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].every_record.of_type_ns[].contains string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].every_record.of_type_ns[].match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].every_record.of_type_ns[].not_match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].every_record.of_type_txt array 指定する場合は空でない条件配列にし、各項目には 1 つの比較キーのみを指定できます。
content.task.success_when[].every_record.of_type_txt[].exists boolean 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].every_record.of_type_txt[].is string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].every_record.of_type_txt[].contains string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].every_record.of_type_txt[].match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.success_when[].every_record.of_type_txt[].not_match_regex string 単一の DNS 条件。exists は true のみ、それ以外は空でない文字列である必要があります。すべての DNS 条件の合計は 1..20 で、各項目に複数の操作を同時に指定することはできません。
content.task.advance_options.timeout string NetPath のみ。必須。1s..30s の整数秒。
content.task.advance_options.max_ttl integer NetPath のみ。必須。TTL 上限。TCP/ICMP は 1..60、UDP は 1..255。
content.task.advance_options.e2e_queries integer NetPath のみ。必須。エンドツーエンドのプローブ回数 1..100。
content.task.advance_options.traceroute_queries integer NetPath のみ。必須。パスプローブ回数 1..10。
content.task.advance_options.source_name string NetPath のみ。任意のソース表示名。trim 後 128 文字以下。空の場合は削除されます。
content.task.advance_options.target_name string NetPath のみ。任意のターゲット表示名。trim 後 128 文字以下。空の場合は削除されます。
content.task.success_when[].e2e_rtt_avg array 空でない条件配列。少なくとも 1 つの指標を選択する必要があり、未知の指標は追加できません。
content.task.success_when[].e2e_rtt_avg[].op string 状態は eq のみ、数値/所要時間は lt/gt/leq/geq/eq を許可します。
content.task.success_when[].e2e_rtt_avg[].target string 負でないミリ秒文字列(例: 0.5ms)。秒や素の数値は使用できません。
content.task.success_when[].e2e_rtt_min array 空でない条件配列。少なくとも 1 つの指標を選択する必要があり、未知の指標は追加できません。
content.task.success_when[].e2e_rtt_min[].op string 状態は eq のみ、数値/所要時間は lt/gt/leq/geq/eq を許可します。
content.task.success_when[].e2e_rtt_min[].target string 負でないミリ秒文字列(例: 0.5ms)。秒や素の数値は使用できません。
content.task.success_when[].e2e_rtt_max array 空でない条件配列。少なくとも 1 つの指標を選択する必要があり、未知の指標は追加できません。
content.task.success_when[].e2e_rtt_max[].op string 状態は eq のみ、数値/所要時間は lt/gt/leq/geq/eq を許可します。
content.task.success_when[].e2e_rtt_max[].target string 負でないミリ秒文字列(例: 0.5ms)。秒や素の数値は使用できません。
content.task.success_when[].e2e_rtt_variation_avg array 空でない条件配列。少なくとも 1 つの指標を選択する必要があり、未知の指標は追加できません。
content.task.success_when[].e2e_rtt_variation_avg[].op string 状態は eq のみ、数値/所要時間は lt/gt/leq/geq/eq を許可します。
content.task.success_when[].e2e_rtt_variation_avg[].target string 負でないミリ秒文字列(例: 0.5ms)。秒や素の数値は使用できません。
content.task.success_when[].e2e_rtt_variation_max array 空でない条件配列。少なくとも 1 つの指標を選択する必要があり、未知の指標は追加できません。
content.task.success_when[].e2e_rtt_variation_max[].op string 状態は eq のみ、数値/所要時間は lt/gt/leq/geq/eq を許可します。
content.task.success_when[].e2e_rtt_variation_max[].target string 負でないミリ秒文字列(例: 0.5ms)。秒や素の数値は使用できません。
content.task.success_when[].e2e_probe_loss_percent array 空でない条件配列。少なくとも 1 つの指標を選択する必要があり、未知の指標は追加できません。
content.task.success_when[].e2e_probe_loss_percent[].op string 状態は eq のみ、数値/所要時間は lt/gt/leq/geq/eq を許可します。
content.task.success_when[].e2e_probe_loss_percent[].target number パケットロス率 0..100。JSON number。
content.task.success_when[].hop_count array 空でない条件配列。少なくとも 1 つの指標を選択する必要があり、未知の指標は追加できません。
content.task.success_when[].hop_count[].op string 状態は eq のみ、数値/所要時間は lt/gt/leq/geq/eq を許可します。
content.task.success_when[].hop_count[].target integer ホップ数。負でない JSON integer。
content.task.success_when[].e2e_status array 空でない条件配列。少なくとも 1 つの指標を選択する必要があり、未知の指標は追加できません。
content.task.success_when[].e2e_status[].op string 状態は eq のみ、数値/所要時間は lt/gt/leq/geq/eq を許可します。
content.task.success_when[].e2e_status[].target string 状態 reached/partial/failed。e2e_status ではさらに unknown を許可します。
content.task.success_when[].traceroute_status array 空でない条件配列。少なくとも 1 つの指標を選択する必要があり、未知の指標は追加できません。
content.task.success_when[].traceroute_status[].op string 状態は eq のみ、数値/所要時間は lt/gt/leq/geq/eq を許可します。
content.task.success_when[].traceroute_status[].target string 状態 reached/partial/failed。e2e_status ではさらに unknown を許可します。
content.task.config_vars array 任意。デフォルトは []。NetPath では [] のみ許可、mobile は非サポート。変更時は入力集合を再バインドします。DNS が参照する id はすべて現在のワークスペースの有効な変数に属している必要があり、サイレントフィルタリングではありません。
content.task.config_vars[].id string DNS はこれらのフィールドで型を検証します。グローバル変数の UUID。type=global の場合は必須です。
content.task.config_vars[].type string DNS はこれらのフィールドで型を検証します。グローバルの global または現在のタスクのローカル型。ブラウザの機密情報種別 secret/password/secure には独立した保持ルールがあります。
content.task.config_vars[].name string DNS はこれらのフィールドで型を検証します。テンプレート参照変数名。
content.task.config_vars[].value string DNS はこれらのフィールドで型を検証します。ローカル変数値。安全なソースから注入してください。該当しないフィールドは省略します。
content.task.config_vars[].example string DNS はこれらのフィールドで型を検証します。プレビュー/例の値であり、実際の対象ソースの代替ではありません。
content.task.config_vars[].secure boolean DNS はこれらのフィールドで型を検証します。安全な変数かどうか。型はブール値です。
content.task.address string mobile では必須。trim 後、空でなく 2048 文字以下。変数は許可されません。HTTP ではユーザー名/パスワードおよび空白/制御文字を禁止し、有効なポート/パス/Query を許可します。TCP では有効なポートが必須です。ping ではポートを追加できません。
content.task.nodeSelection json mobile では必須。mode/ids/sampleCount の 3 つのキーのみを持ちます。スナップショットを保存し、テンプレートに動的に追従しません。nodes は ID 構造のみを検証して元の ID/順序を保持し、リアルタイムの存在やマッピング済みであることを保証しません。groups は現在のグループとメンバーを照会し、ノード集合を照合します。
content.task.nodeSelection.mode string mobile では必須。nodes はノードを指定し、groups はノードグループを指定します。
content.task.nodeSelection.ids array mobile では必須。空でなく一意の文字列配列。対応するリソース id を取得し、region UUID ではありません。
content.task.nodeSelection.ids[] string mobile では必須。単一の現在のノードまたはグループ id。nodes は英数字、アンダースコア、ハイフンのみです。
content.task.nodeSelection.sampleCount integer mobile では必須。各ノードで独立したサンプリング回数 1..5。選択したノード/グループメンバー数には制限されません。
content.task.protocolOptions json 任意。デフォルトは {}。完全置換。HTTP に従来の検出フィールドが存在する場合、変更時はオブジェクトを明示的に提供する必要があります。オブジェクト内で検出フィールドを省略した場合にのみクリアされ、空文字列/null/空配列はクリア指示ではありません。HTTP のデフォルトは httpMethod=GET、ping のデフォルトは pingType=1 で、その他の数値は Studio がデフォルトを補いません。
content.task.protocolOptions.httpMethod string http のみ。任意。省略時はプラットフォームのデフォルトに従います。GET/POST。
content.task.protocolOptions.body string http のみ。任意。省略時はプラットフォームのデフォルトに従います。リクエストボディ文字列。
content.task.protocolOptions.httpHost json http のみ。任意。省略時はプラットフォームのデフォルトに従います。文字列マッピング。対象 Host の設定に従います。
content.task.protocolOptions.httpHost.キー名 string 動的な文字列メンバー。変数テンプレートは許可されません(expectedResponseBody を除く)。
content.task.protocolOptions.httpParams json http のみ。任意。省略時はプラットフォームのデフォルトに従います。Query パラメーターの文字列マッピング。
content.task.protocolOptions.httpParams.キー名 string 動的な文字列メンバー。変数テンプレートは許可されません(expectedResponseBody を除く)。
content.task.protocolOptions.httpHeader json http のみ。任意。省略時はプラットフォームのデフォルトに従います。リクエストヘッダーの文字列マッピング。
content.task.protocolOptions.httpHeader.キー名 string 動的な文字列メンバー。変数テンプレートは許可されません(expectedResponseBody を除く)。
content.task.protocolOptions.expectedResponseBody string http のみ。任意。省略時はプラットフォームのデフォルトに従います。空でない原文の包含一致。trim せず、その中のテンプレートマーカーも解釈しません。
content.task.protocolOptions.expectedResponseCode array http のみ。任意。省略時はプラットフォームのデフォルトに従います。空でない JSON 整数配列。許可するコード集合。テキスト正規表現と混用しないでください。複数の検出の組み合わせ判定は実行プラットフォームの実際の契約に従います。
content.task.protocolOptions.expectedResponseCode[] integer http のみ。任意。省略時はプラットフォームのデフォルトに従います。単一の JSON 整数コード。文字列/ブール値は使用できません。
content.task.protocolOptions.dnsHost string dns のみ。任意。省略時はプラットフォームのデフォルトに従います。DNS サーバー/ホスト文字列。
content.task.protocolOptions.dnsIpVerify string dns のみ。任意。省略時はプラットフォームのデフォルトに従います。期待する DNS 解決 IP 文字列。
content.task.protocolOptions.tcpHost string tcp のみ。任意。省略時はプラットフォームのデフォルトに従います。TCP 対象 Host 設定。
content.task.protocolOptions.tcpTimeoutMs integer tcp のみ。任意。省略時はプラットフォームのデフォルトに従います。タイムアウト 1..10000 ミリ秒。
content.task.protocolOptions.tcpData string tcp のみ。任意。省略時はプラットフォームのデフォルトに従います。送信データテキスト。
content.task.protocolOptions.tcpVerify string tcp のみ。任意。省略時はプラットフォームのデフォルトに従います。期待するレスポンステキスト。
content.task.protocolOptions.pingType integer ping のみ。任意。省略時はプラットフォームのデフォルトに従います。1/2、省略時は 1。
content.task.protocolOptions.pingCount integer ping のみ。任意。省略時はプラットフォームのデフォルトに従います。送信回数 1..10。
content.task.protocolOptions.pingTimeoutMs integer ping のみ。任意。省略時はプラットフォームのデフォルトに従います。タイムアウト 1..10000 ミリ秒。
content.task.protocolOptions.taskTimeoutMs integer http/dns/tcp/ping のみ。任意。省略時はプラットフォームのデフォルトに従います。タスクタイムアウト 1..10000 ミリ秒。
content.task.protocolOptions.flowLimit integer http/dns/tcp/ping のみ。任意。省略時はプラットフォームのデフォルトに従います。プラットフォームの流量制限整数 1..10。Studio では追加の単位換算を定義していません。
content.tagInfo array<object> 有効なタグの概要。空は []。通常の変更では省略される場合があり、mobile の変更では返却されます。読み取り時の id はデータベースの数値で、書き込み時に生成される概要の id はタグ UUID 文字列の場合があります。
content.tagInfo[].id integer または string 読み取り時はデータベース番号。書き込み時はタグ UUID。
content.tagInfo[].uuid string 読み取ったタグ UUID。書き込み分岐では省略される場合があります。
content.tagInfo[].name string タグ名。
content.tagInfo[].description string 読み取ったタグ説明。
content.tagInfo[].colour string 読み取ったタグ色。
content.tagInfo[].scope array<string> 書き込み概要には正規化されたスコープが含まれる場合があります。
content.tagInfo[].scope[] string 単一のスコープ。
content.declaration object 共通宣言。
{
  "code": 200,
  "content": {
    "id": null,
    "uuid": "dial_example",
    "workspaceUUID": "wksp_example",
    "type": "http",
    "status": 0,
    "isLocked": false,
    "regions": [
      "reg_example"
    ],
    "regionsInfo": [
      "reg_example"
    ],
    "task": {
      "name": "サイト可用性",
      "frequency": "5m",
      "method": "GET",
      "url": "https://example.com/health",
      "success_when": [
        {
          "status_code": [
            {
              "is": "200"
            }
          ]
        }
      ],
      "status": "ok"
    },
    "creator": "wsak_example",
    "updator": "wsak_example",
    "createAt": 1785427200,
    "updateAt": 1785427200,
    "deleteAt": -1,
    "tagInfo": [],
    "declaration": {}
  },
  "errorCode": "",
  "message": "",
  "success": true,
  "traceId": "TRACE-EXAMPLE"
}

DNS リクエスト例(変更時は type を削除し、パスには既存の dns タスクを使用します):

curl --request POST '<Endpoint>/api/v1/dialing_task/add' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  -H 'Content-Type: application/json' \
  --data-raw '{"type":"dns","regions":["reg_example"],"task":{"name":"DNS チェック","frequency":"5m","domain":"example.com","dns_server":"resolver.example.net","protocol":"dot","port":"853","timeout":"10s","success_when_logic":"and","success_when":[{"at_least_one_record":{"of_type_a":[{"is":"203.0.113.10"}]}}]},"tags":[]}'

NetPath リクエスト例(変更時は既存の netpath タスクに対応している必要があります):

curl --request POST '<Endpoint>/api/v1/dialing_task/add' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  -H 'Content-Type: application/json' \
  --data-raw '{"type":"netpath","regions":["reg_example"],"task":{"name":"パスチェック","frequency":"5m","protocol":"tcp","host":"example.com","port":"443","advance_options":{"timeout":"10s","max_ttl":30,"e2e_queries":10,"traceroute_queries":3},"success_when_logic":"and","success_when":[{"e2e_rtt_avg":[{"op":"lt","target":"100ms"}]}]},"tags":[]}'

モバイルリクエスト例: まずモバイルリソースから NODE-ID を置き換え、利用規約を確認します。変更は既存の同一プロトコルの mobile タスクにのみ使用します。

curl --request POST '<Endpoint>/api/v1/dialing_task/add' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  -H 'Content-Type: application/json' \
  --data-raw '{"type":"mobile","regions":[],"task":{"name":"モバイル HTTPS チェック","frequency":"5m","protocol":"http","address":"https://example.com/health","nodeSelection":{"mode":"nodes","ids":["NODE-ID"],"sampleCount":1},"protocolOptions":{"httpMethod":"GET","taskTimeoutMs":10000,"expectedResponseCode":[200]}},"tags":[]}'

通常タスクの成功設定レスポンス(プロトコルごとの task 構造は上表に従います):

{
  "code": 200,
  "content": {
    "id": null,
    "uuid": "dial_example",
    "workspaceUUID": "wksp_example",
    "type": "http",
    "status": 0,
    "isLocked": false,
    "regions": [
      "reg_example"
    ],
    "regionsInfo": [
      "reg_example"
    ],
    "task": {
      "name": "サイト可用性",
      "frequency": "5m",
      "method": "GET",
      "url": "https://example.com/health",
      "success_when": [
        {
          "status_code": [
            {
              "is": "200"
            }
          ]
        }
      ],
      "status": "ok"
    },
    "creator": "wsak_example",
    "updator": "wsak_example",
    "createAt": 1785427200,
    "updateAt": 1785427200,
    "deleteAt": -1,
    "tagInfo": [],
    "declaration": {}
  },
  "errorCode": "",
  "message": "",
  "success": true,
  "traceId": "TRACE-EXAMPLE"
}

エラーレスポンス

認証、レート制限、共通リクエストエラーについては共通エラー定義を参照してください。

通常の Synthetic テスト SDK は、ダウンストリームの 4xx 時に実際の HTTP と error_code/message を保持します。固定エラーテーブルにないダウンストリームコードも返される可能性があります。ノードエラーコード dialtesting.invalidRegion は ft.DialingRegionError にマッピングされ、実際の HTTP を保持します。通常のダウンストリーム >=500 は一律 500 ft.InternalServerError に変換されます。SDK 内部の 503 名から公開ステータスを推測しないでください。モバイルエラーの content には reason/outcomeUnknown/taskUUID/localSaved/localStatus/remoteStatus が含まれる場合があり、unknown はリモート未実行を意味しません。再試行前に必ず確認してください。

HTTP ステータス errorCode 発生条件 メッセージまたはレスポンス説明 対処方法
406 ft.ParameterValidationFailed リクエストフィールドの欠落、またはフィールド値が宣言された検証条件に違反 パラメーター解析失敗 パラメーターの位置、フィールド名、型、値を確認します。
400 ft.RequestJsonFormatError リクエスト JSON の構文が無効 リクエスト JSON の形式エラー content.reason、line、column に従って JSON を修正します。
400 ft.JsonFormatError Body のトップレベルが JSON オブジェクトではない 一部の json ファイル形式エラー regions/task などのフィールドを含む完全な JSON オブジェクトを送信します。
400 ft.InvalidDialingRegion 通常タスクの regions が空 無効な Synthetic テスト地域 利用可能なノード一覧から少なくとも 1 つの実際のノード UUID を選択します。モバイルタスクは例外として [] が必須です。
400 ft.ParamsValidateError 名前、DNS/NetPath/TCP 条件、モバイルプロトコル/ノード選択/数値範囲、または保護フィールドが不一致 パラメーター検証失敗: {} message/任意の content.field に従って修正し、プロトコルごとのホワイトリストと単位に注意します。
406 ft.MissingSuccessWhen 対応プロトコルで success_when が欠落し、サポートされるスクリプト代替もない 利用可能な判定 success_when がありません プロトコルに従って完全な可用性判定を送信します。
406 ft.MissingMethod HTTP で空でない method が提供されていない リクエストメソッド method が指定されていません 実際の対象インターフェースに従って HTTP メソッドを入力します。
400 ft.MissingCustomParameters SSL で host/port が欠落、NetPath の必須フィールドが欠落、または Cron モードで crontab が欠落 {} フィールドが欠落 対応プロトコルの必須フィールドを補完し、モバイルと通常設定を混用しないでください。
406 ft.InvalidCrontabFormat カスタム Cron を解析できない 無効な crontab 形式 完全な式を修正します。
406 ft.ExceedMaxCharacterLimit WebSocket message が 128KiB UTF-8 を超過 {} が最大文字長制限を超過 メッセージを短縮し、文字数をバイト数の代わりにしないでください。
400 ft.TaskNameRepeat このワークスペースの削除されていないタスクに同名が既に存在(すべての Synthetic テスト種別を横断) 現在のワークスペースに同名タスク {} が既に存在します 既存の UUID を変更するか名前を変更します。名前は trim 後に比較されます。
403 ft.InvalidTimeFrequency 無料/体験ワークスペースでサポートされていない頻度を使用 時間頻度が無効 30m/1h/6h/12h/24h に変更するか、バージョンのサポートを確認します。
404 ft.ObjectNotExists DNS 変数 id がこのワークスペースの有効な変数にすべて一致しない 指定されたオブジェクトが存在しません このワークスペースの変数を再取得します。他のワークスペース/削除済み変数を参照することはできません。
400 ft.TagScopeMismatch タグを dialing スコープに使用できない タグスコープの不一致 all/dialing タグを使用するか、確認のうえスコープを更新します。
406 ft.NotFoundWorkspace 書き込みロック時にワークスペースレコードが存在しない 指定されたワークスペースが見つかりません ワークスペースの状態を確認し、解放済みワークスペースへの書き込みを停止します。
400 ft.InvalidAction モバイル Synthetic テストが有効化されていない、または操作状態が許可されていない 無効な操作 content.reason を確認し、管理者がサービスの可用性とタスク復旧状態を確認します。
403 ft.MobileDialTermsNotAccepted モバイルタスクの作成/復旧前にワークスペースで利用規約が確認されていない 先にワークスペース Owner または管理者がモバイル Synthetic テストの利用規約を確認してください。 ログイン状態のワークスペース Owner/管理者がプロダクト内で閲覧して確認します。API Key は承諾の代替にはなりません。
409 ft.MobileDialingOperationBusy モバイルタスクがワークスペースの同時操作ロックを待機してタイムアウトし、今回は実行されなかった 現在のワークスペースで別の操作が進行中です。今回の操作は実行されていません。しばらくしてから再試行してください。 content.operationExecuted=false/retryable=true の場合は少し待ってバックオフ再試行します。同時に上書きしないでください。
401 ft.WKSPNotExistOrReleased モバイル操作の待機後にワークスペースが利用不可 ワークスペースが存在しない/または解放済み 再試行を停止し、ワークスペースがまだ有効か確認します。
403 ft.WorkspaceIsLocked モバイル操作の待機後にワークスペースがロック済み ワークスペースがロックされているため操作できません 先にワークスペースのロック解除と操作可能状態を確認します。
400 ft.DialingServerError モバイルプラットフォーム/バインド/ノード選択/レスポンスの不一致または呼び出し失敗、あるいは通常のダウンストリームが対応する 400 を返却 Synthetic テストサービス API の呼び出し失敗 content.reason/outcomeUnknown/taskUUID/localSaved に従ってローカルとリモートの状態を確認します。不明な結果をむやみに再構築しないでください。
400 ft.DialingRegionError 通常のダウンストリーム 400 で dialtesting.invalidRegion と判定 現在のタスクに一部の Synthetic テストノードの失効があります。設定を更新して再保存してください。 失効したノードを交換して再保存します。その他の HTTP は以下のエラー範囲に従って処理します。
500 ft.InternalServerError 捕捉されていないストレージ/型エラー、通常の Synthetic テストのダウンストリーム 5xx、接続タイムアウト、またはコミット後の処理失敗 内部エラー まずタスク UUID/名前で読み戻して配信状態を確認し、その後再試行を判断します。traceId を保持してください。
406 ft.DialingBrandNoSetError 通常タスクの配信に必要なワークスペースブランドの Synthetic テストサービスが未設定 {} ブランドの Synthetic テスト設定が未設定です。 管理者が現在のワークスペースに対応する Synthetic テストサービス設定を確認します。
400 ft.DialingAKNoSetError 通常タスクの配信に必要な署名認証情報が未設定 Synthetic テストの AK 情報が未設定です。Launcher のアクティベーション設定を確認してください 管理者が Synthetic テストサービスのアクティベーションと認証情報設定を確認します。クライアントはこの Body でこれらの認証情報を提供しません。
406 ft.InvalidDialingTask browser に必須スクリプトが欠落、または通常追加失敗後の補償で invalidTask を返却 無効な task パラメーター browser は現在の公開ホワイトリスト制限を受けます。その他の場合は、まずタスクと配信が既に存在するか確認します。

フィードバック

このページは役に立ちましたか?