コンテンツにスキップ

変更



POST /api/v1/dialing_task/{task_uuid}/modify

概要

既存の Synthetic テスト設定、実行ノード、タグを全体更新します。

呼び出し前の確認と使用手順

まず GET で完全なタスクとタグをバックアップし、元の type を明確にしてから全体を変更します。本入口では通常のプロトコルタイプを変更できません。task サブフィールドの省略は保持を意味しません。tags を省略するとクリアされ、regions は全体置換され、削除されたノードには停止が配信されます。モバイルの protocol は変更できません。既存の HTTP 検出ルールがある場合、完全な protocolOptions を明示的に指定する必要があります({} も可能で、オブジェクト内でフィールドを省略するとクリアされます)。空文字列/null/[] はクリアとして扱われません。

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

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

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

ルートパラメータ

パラメータ名 型 必須 説明
task_uuid string Y 変更対象の dial_ UUID。リモートプラットフォーム ID ではありません。タイプはこのエンティティに準拠します。
例: dial_example
取得または入力方法: このワークスペースのタスク一覧 content.data[].uuid から取得します。

リクエストヘッダー

パラメータ名 型 必須 説明
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 ではこれらのフィールドで型を検証します。安全な変数か。型は boolean。
例: 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 整数コード。文字列/boolean は不可。
例: 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
辞書長上限: 65536
例: {"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 を保持し、IP を直接入力して SNI の代替にしないでください。
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 を取得し、選択したノードからアクセスできる必要があります。

パラメータ補足説明

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

リクエスト例

curl --request POST 'https://openapi.guance.com/api/v1/dialing_task/dial_example/modify' \
  -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":[]}'

レスポンス

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 一部の通常書き込みレスポンスにはサーバー側タスク ID が含まれる場合があります。list/get ではこの内部キーが削除され、書き込み可能フィールドとして扱われません。
content.task.owner_external_id string 一部の通常書き込みレスポンスにはサーバー側ワークスペース ID が含まれる場合があります。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 を保持し、IP を直接入力して SNI の代替にしないでください。
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 ではこれらのフィールドで型を検証します。安全な変数か。型は boolean。
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 整数コード。文字列/boolean は不可。
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": 100,
    "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,
    "declaration": {}
  },
  "errorCode": "",
  "message": "",
  "success": true,
  "traceId": "TRACE-EXAMPLE"
}

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

curl --request POST '<Endpoint>/api/v1/dialing_task/dial_example/modify' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  -H 'Content-Type: application/json' \
  --data-raw '{"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/dial_example/modify' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  -H 'Content-Type: application/json' \
  --data-raw '{"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/dial_example/modify' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  -H 'Content-Type: application/json' \
  --data-raw '{"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": 100,
    "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,
    "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 テストサービスインターフェースの呼び出し失敗 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 は現在の公開ホワイトリストの制限を受けます。その他の場合は先にタスクと配信が既に存在するか確認してください。
404 ft.NotFoundDialTask 現在のワークスペースで変更対象タスクが存在しない/削除済み 指定されたクラウド Synthetic テストタスクが見つからない 一覧から有効なタスク UUID を取得してください。ノードやリモート ID を使用しないでください。

フィードバック

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