作成¶
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 は現在の公開ホワイトリスト制限を受けます。その他の場合は、まずタスクと配信が既に存在するか確認します。 |