【モバイル Synthetic テスト】タスクのクローン¶
POST /api/v1/dialing_task/{task_uuid}/clone
概要¶
既存のモバイル Synthetic テストから独立した新しいタスクを作成します。
呼び出し前の準備と使用手順¶
本ワークスペースに既存の mobile ソースのみをサポートします。ソースから書き込み可能なプロトコル/アドレス/頻度/ノード選択のスナップショットをコピーし、内部プラットフォームバインディング/レポート認証情報/実行状態を削除したうえで、新しい名前と新しいタスク UUID でリモートタスクを再作成します。スナップショットバックアップではなく、ソースタスクも変更しません。
新タスクは成功時にデフォルトで有効になり、定期実行と費用が増える可能性があります。ソースの stop 状態をコピーしてコピー先の停止を保証することはできません。tags を省略するとソースの現在のタグを継承し、[] は明示的にタグなしとします。モバイル作成時の契約、ノード選択/規約/クォータ頻度および名前の検証を再実行します。旧 HTTP の非 HTTPS など過去の設定で回避することはできません。失敗時はローカル保存済み、またはリモート結果が不明な可能性があるため、content.taskUUID/localSaved/outcomeUnknown に従ってまず読み戻し、重複クローンを避けてください。
ルートパラメータ¶
| パラメータ名 | 型 | 必須 | 説明 |
|---|---|---|---|
| task_uuid | string | Y | クローン元タスク。通常タスクは拒否されます。テンプレートやリモート id ではありません。 例: dial_example取得/入力方法: タスク一覧から本ワークスペースの type=mobile タスクの uuid を取得します。 |
リクエストヘッダー¶
| パラメータ名 | 型 | 必須 | 説明 |
|---|---|---|---|
| DF-API-KEY | string | Y | ワークスペースの OpenAPI 認証情報。 例: <DF-API-KEY>取得/入力方法: 対象ワークスペースの API Key 管理から、この操作権限を持つ OpenAPI Key を取得します。 |
Body リクエストパラメータ¶
| パラメータ名 | 型 | 必須 | 説明 |
|---|---|---|---|
| tags[*] | string | 名前の重複排除に使用し、tag_ UUID ではありません。Synthetic テストのスコープに合わない場合はエラーになります。 例: production取得/入力方法: 単一のビジネスタグ名を取得します。 |
|
| name | string | Y | 必須。trim 後 1..256 文字。コピー接尾辞は自動付与されません。 例: 移动HTTPS检查副本取得/入力方法: 新タスクに本ワークスペースで未使用の名前を指定します。 |
| tags | array | 任意。完全に省略するとソースの現在のタグを継承し、明示的な [] はタグなしです。ソースと同名のタスクを保持するものではありません。 例: ["production"]取得/入力方法: 必要に応じて dialing スコープに適用できるタグ名を指定します。 |
リクエスト例¶
curl --request POST 'https://openapi.guance.com/api/v1/dialing_task/dial_example/clone' \
-H 'DF-API-KEY: <DF-API-KEY>' \
-H 'Content-Type: application/json' \
--data-raw '{"name":"移动HTTPS检查副本"}'
レスポンス¶
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 | 作成者。 |
| content.updator | string | 更新者。 |
| 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 では任意。1 ラウンドあたりの送信パケット数です。実際のノード制約は実行側で確認され、mobile の pingCount には使用しません。 |
| content.task.host | string | 対応するプロトコルでは業務上必須です。NetPath では trim 後が空でない必要があります。HTTP URL スキームを含める必要はありません。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 を固定する場合、元のサービスアイデンティティを保持し、IP を直接入力して SNI の代わりにしないでください。 |
| content.task.timeout | string | TCP では 1s..60s の整数秒文字列です。DNS のデフォルトは 10s で、実行側の範囲は (0,60s] であり、変数テンプレートを使用できます。ICMP/SSL は実行側のサポートに従い、Studio は統一デフォルトを補完しません。NetPath は advance_options.timeout を使用します。 |
| content.task.ignore_server_certificate_error | boolean | SSL では任意。省略時は実行側の安全なデフォルトに従います。DNS の証明書無視スイッチは certificate 内に置きます。 |
| content.task.message | string | WebSocket では業務上必要で、UTF-8 で 128KiB を超えてはなりません。モバイル TCP の tcpData には使用しません。 |
| content.task.post_mode | string | 任意。実行側の選択方式です。Studio の HTTP で success_when が必要かどうかは、実際には post_script が空でないかで判断され、このフィールドだけでは決まりません。 |
| content.task.post_script | string | 任意。空文字列はスクリプトを提供しないことを示します。HTTP では空でない場合、success_when を省略できます。DNS/NetPath/mobile ではスクリプトによって専用の許可リストと検証を回避できません。 |
| content.task.advance_options | json | 任意のオブジェクト。NetPath では必須で、厳密に本ページの 6 フィールドのみを許可します。HTTP リクエスト、証明書/プロキシなどは実行側の実際のサポートに従う必要があり、プロトコル検証をオンラインテストと同一視しないでください。 |
| content.task.advance_options_headless | json | 公開宣言として保持されますが、必須の browser_config を代替できません。現在の公開 API ではブラウザの追加/変更時に完全な設定を渡せないため、このオブジェクトをブラウザスクリプトの入口として扱わないでください。 |
| 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 に適用。任意。動的リクエストヘッダー値。名前は実際の API で必要なヘッダーを使用します。 |
| 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 ユーザー名。対象 API の管理者が提供します。 |
| 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。サポート状況はノードのバージョンに依存します。HTTP/3 では同時にプロキシを設定しないでください。 |
| 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 に適用。任意。プロキシ専用の文字列ヘッダーマッピング。 |
| 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 | 任意。ヘッダー名から条件集合へのマッピング。 |
| content.task.success_when[].status_code | array | HTTP では任意のステータスアサーション集合。実行側のプロトコルに従って文字列を比較します。 |
| content.task.success_when[].status_code[].is | string | 単一のステータスコードアサーション操作。モバイルの expectedResponseCode 整数配列と混用しないでください。 |
| content.task.success_when[].status_code[].is_not | string | 単一のステータスコードアサーション操作。モバイルの expectedResponseCode 整数配列と混用しないでください。 |
| content.task.success_when[].status_code[].match_regex | string | 単一のステータスコードアサーション操作。モバイルの expectedResponseCode 整数配列と混用しないでください。 |
| content.task.success_when[].status_code[].not_match_regex | string | 単一のステータスコードアサーション操作。モバイルの 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。論理サーバーアイデンティティを保持し、省略時は実行側が解決します。 |
| 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": 101,
"uuid": "dial_clone_example",
"workspaceUUID": "wksp_example",
"type": "mobile",
"status": 0,
"isLocked": false,
"regions": [],
"regionsInfo": [],
"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
]
},
"status": "ok"
},
"creator": "wsak_example",
"updator": "wsak_example",
"createAt": 1785427200,
"updateAt": 1785427200,
"deleteAt": -1,
"tagInfo": [],
"remoteStatus": "unknown",
"declaration": {}
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
エラー応答¶
認証、レート制限、共通リクエストエラーについては共通エラー定義を参照してください。
モバイルのリモート/ローカル失敗には taskUUID/localSaved/localStatus/remoteStatus/outcomeUnknown が付く場合があります。まずコピーが保存済みか、リモートで作成済みかを確認し、失敗レスポンスを完全に未実行のものとして扱わないでください。
| HTTP ステータス | errorCode | 発生条件 | メッセージまたはレスポンス説明 | 対応方法 |
|---|---|---|---|---|
| 406 | ft.ParameterValidationFailed | リクエストフィールドの欠落、またはフィールド値が宣言された検証条件に違反 | パラメータ解析失敗 | パラメータの位置、フィールド名、型、値を確認してください。 |
| 400 | ft.RequestJsonFormatError | リクエスト JSON の構文が無効 | リクエスト JSON の形式エラー | content.reason、line、column に従って JSON を修正してください。 |
| 400 | ft.JsonFormatError | Body がオブジェクトではない | 一部の JSON ファイル形式エラー | name および任意の tags を含む JSON オブジェクトを送信してください。 |
| 400 | ft.ParamsValidateError | 識別子、ノード選択の構造/範囲、名前、テンプレート数、またはプロトコルパラメータが現在の契約に適合しない | パラメータ検証失敗: {} | message と任意の content.reason/field に従って修正し、まず本ワークスペースの一覧から対象を再取得してください。 |
| 400 | ft.InvalidAction | モバイル Synthetic テストが現在無効、または許可されない操作/トランザクション状態が存在 | 無効な操作 | 管理者がモバイル Synthetic テスト機能を確認してください。テンプレートの読み取り/削除は、スイッチが無効だからといって自動的に禁止されるものではありません。 |
| 400 | ft.DialingServerError | モバイルサービス呼び出しの失敗、リソース返却形状/バインディング情報の不一致 | Synthetic テストサービス API 呼び出し失敗 | reason、outcomeUnknown を確認し、traceId と合わせて照合してください。静的マッピングの欠落で上流の失敗を覆い隠さないでください。 |
| 409 | ft.MobileDialingOperationBusy | ワークスペースの排他ロック待機がタイムアウトし、今回は実行されなかった | 現在のワークスペースで他の操作が進行中のため、今回の操作は実行されませんでした。しばらくしてから再試行してください。 | operationExecuted=false/retryable=true の場合はバックオフして再試行し、並行して上書きしないでください。 |
| 401 | ft.WKSPNotExistOrReleased | 待機後にワークスペースが存在しない/解放済み | ワークスペースが存在しない/または解放済み | 再試行を停止し、有効なワークスペースを確認してください。 |
| 403 | ft.WorkspaceIsLocked | 待機後にワークスペースがロック済み | ワークスペースがロックされているため操作できません | ロック解除と操作可能状態を確認してください。 |
| 404 | ft.NotFoundDialTask | クローン元タスクが本ワークスペースの非削除集合に属していない | 指定されたクラウド Synthetic テストが見つかりません | 一覧から mobile ソースを再取得してください。 |
| 400 | ft.TaskNameRepeat | 新しい名前が本ワークスペースの既存の非削除 Synthetic テストと競合 | 現在のワークスペースには同名のタスク{}が既に存在します |
一意の名前に変更し、同じ不明結果のリクエストを重複送信しないでください。 |
| 403 | ft.MobileDialTermsNotAccepted | ワークスペースがモバイル Synthetic テスト規約に同意していない | 先にワークスペースの Owner または管理者がモバイル Synthetic テスト利用規約を確認してください。 | ログイン状態の Owner/管理者が読んで確認してください。 |
| 403 | ft.InvalidTimeFrequency | ソース頻度が現在の無料/体験版でサポートされていない | 時間頻度が無効 | 先に許可された頻度に調整するか、バージョンを確認してください。 |
| 400 | ft.TagScopeMismatch | 指定/継承されたタグが Synthetic テストに適用できない | タグスコープが一致しません | 有効な dialing/all タグを使用してください。 |
| 500 | ft.InternalServerError | ストレージ読み取り、過去の設定、またはローカル静的マッピングのフォーマット例外 | 内部エラー | 具体的なタスク/テンプレートまたはフィルターに絞り込み、継続的に失敗する場合は traceId を保持して読み取り段階を照合してください。 |