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