1 回限りの合成監視タスクを作成します。
操作説明
ネットワーク分析とモニタリングを有効化している Alibaba Cloud アカウントのみが、1 回限りの合成監視タスクを作成できます。
この Topic では、1 回限りの合成監視タスクを作成する例を示します。タスク名は task1、モニタリング対象アドレスは http://www.aliyun.com、タスクタイプは HTTP、検出ポイント数は 1 です。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
cms:CreateInstantSiteMonitor |
create |
*すべてのリソース。
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| Address |
string |
必須 |
合成監視タスクの URL または IP アドレス。 |
http://www.aliyun.com。 |
| TaskType |
string |
必須 |
合成監視タスクのタイプ。 有効な値: HTTP、PING、TCP、UDP、DNS。 |
HTTP。 |
| TaskName |
string |
必須 |
合成監視タスクの名前。 名前の長さは 4～100 文字で、英字、数字、およびアンダースコア (_) を含めることができます。 |
task1 |
| IspCities |
string |
任意 |
検出ポイント情報。このパラメーターが空の場合、システムはランダムに 3 つの検出ポイントを選択します。 値は type フィールドは検出ポイントタイプを指定します。AgentGroup が PC に設定されている場合、有効な値は IDC および LASTMILE です。IDC はデータセンターにデプロイされた検出ポイントを示します。LASTMILE は固定回線ネットワークを使用するエンドユーザーの自宅にデプロイされた検出ポイントを示します。type フィールドは任意であり、デフォルトは IDC です。AgentGroup が MOBILE に設定されている場合、このフィールドを指定する必要はありません。 検出ポイント情報の取得方法については、「 DescribeSiteMonitorISPCityList 」を参照してください。 説明
|
[{"city":"546","isp":"465"},{"city":"572","isp":"465"},{"city":"738","isp":"465"}] |
| OptionsJson |
string |
任意 |
合成監視タスクのプロトコルタイプの詳細拡張オプション。プロトコルタイプごとに異なる拡張オプションが対応しています。 |
{"time_out":5000} |
| RandomIspCity |
integer |
任意 |
検出ポイントの数。 説明
|
1 |
| AgentGroup |
string |
任意 |
検出ポイントのタイプ。有効な値: PC、MOBILE。PC は固定回線ネットワークの検出ポイントを示します。MOBILE はモバイルネットワークの検出ポイントを示します。デフォルト値: PC。 列挙値:
|
PC |
TaskType の詳細パラメーター設定
以下の表は、TaskType における HTTP、PING、TCP、UDP、DNS の詳細パラメーターの設定方法について説明しています。
HTTP
| パラメーター | タイプ | 説明 |
| http_method | String | HTTP リクエストメソッド。有効な値: GET、POST、HEAD。デフォルト値: GET。 |
| header | String | 改行 (\n) で区切られたカスタム HTTP ヘッダー。 各ヘッダー行は HTTP プロトコルのフォーマット (半角コロンで区切られたキーと値のペア) に準拠している必要があります。 |
| cookie | String | 標準的な HTTP リクエストフォーマットで記述された Cookie。 |
| request_content | String | リクエストコンテンツ。JSON と form の 2 つのフォーマットがサポートされています。指定しない場合、リクエストにはボディが含まれません。 |
| response_content | String | 期待されるレスポンスコンテンツ。検出時に、HTTP サーバーから返される最初の 64 バイトがチェックされます。 |
| match_rule | String | 0: レスポンスに response_content が含まれていない場合、検出は成功となります。 1: レスポンスに response_content が含まれている場合、検出は成功となります。 |
| username | String | ユーザー名が指定されている場合、BasicAuth ヘッダーが HTTP リクエストに含まれます。 |
| password | String | HTTP リクエスト認証用のパスワード。 |
| time_out | int | タイムアウト時間。単位: ミリ秒。デフォルト値: 30000。 |
| max_redirect | int | リダイレクトの最大回数。ECS プローブのデフォルト値は 5、キャリア検出ポイントのデフォルト値は 2 です。 リダイレクトを無効にするには、このパラメーターを 0 に設定します。 有効な値: 0～50。 |
PING
| パラメーター | タイプ | 説明 |
| failure_rate | int | PING の失敗率がこの値を超えると、検出は失敗したとみなされ、610 (PingAllFail) または 615 (PingPartialFail) を返します。 デフォルト値: 0.1。 |
| ping_num | int | PING の試行回数。デフォルト値: 20。 有効な値: 1～100。 |
TCP または UDP
| パラメーター | タイプ | 説明 |
| port | int | TCP または UDP サーバーのポート。 |
| request_content | string | リクエストコンテンツ。request_format が hex に設定されている場合、request_content の値は 16 進数のコンパクトフォーマットになります。 |
| request_format | string | request_format が他の値に設定されている場合、request_content はプレーンな文字列として TCP または UDP サーバーに送信されます。 |
| response_content | string | レスポンスコンテンツ。TCP または UDP サーバーから返されるコンテンツに response_content が含まれていない場合、検出は失敗します。 response_format が hex に設定されている場合、response_content の値は 16 進数のコンパクトフォーマットになります。 response_content が他の値に設定されている場合、response_content はプレーンな文字列です。 |
DNS
| パラメーター | タイプ | 説明 |
| dns_server | string | DNS サーバーのアドレス。ドメイン名または IP アドレスを指定できます。 |
| dns_type | string | DNS クエリタイプ。有効な値: A、NS、CNAME、MX、TXT、ANY。 |
| expect_value | string | 空白文字で区切られた期待値のリスト。 |
| match_rule | string | 期待値リストと DNS リストの関係。指定された関係が満たされない場合、検出は失敗します。 空の文字列または IN_DNS: 期待値リストは DNS リストのサブセットです。 DNS_IN: DNS リストは期待値リストのサブセットです。 EQUAL: DNS リストは期待値リストと等しいです。 ANY: DNS リストと期待値リストの共通部分が空ではありません。 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| Code |
string |
状態コード。 説明
値が 200 の場合は成功を示します。 |
200 |
| Message |
string |
返されるメッセージ。 |
successful。 |
| RequestId |
string |
リクエスト ID。 |
68192f5d-0d45-4b98-9724-892813f86c71 |
| Success |
string |
操作が成功したかどうかを示します。有効な値:
|
true。 |
| CreateResultList |
array<object> |
1 回限りの合成監視タスク作成の結果リスト。 |
|
|
object |
1 回限りの合成監視タスク作成の結果リスト。 |
||
| TaskId |
string |
合成監視タスクの ID。 |
2c8dbdf9-a3ab-46a1-85a4-f094965e**** |
| TaskName |
string |
合成監視タスクの名前。 |
task1 |
例
成功レスポンス
JSONJSON
{
"Code": "200",
"Message": "successful",
"RequestId": "68192f5d-0d45-4b98-9724-892813f86c71",
"Success": "true",
"CreateResultList": [
{
"TaskId": "2c8dbdf9-a3ab-46a1-85a4-f094965e****",
"TaskName": "task1"
}
]
}エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | InvalidQueryParameter | %s | |
| 400 | IllegalAddress | Illegal HTTP address | |
| 400 | OperationError | Operation failed | |
| 400 | TaskNotExists | Task does not exist | |
| 400 | OperatorInvalid | Operator invalid | |
| 400 | OperatorCityInvalid | Operator City invalid | |
| 400 | NameRepeat | Task name repeat | |
| 400 | CreateAlarmError | Create alarm error | |
| 400 | NameNotExists | Task name not exists | |
| 400 | Illegal Task Name | The task name of the sitemonitor task is illegal. | サイトモニタリングタスク名が無効です。 |
| 401 | AccessDeniedException | You donot have sufficient access to perform this action. | |
| 500 | InternalError | %s | |
| 402 | LimitExceeded | The quota for this customer had been reached. | |
| 403 | %s | %s | |
| 403 | Forbidden | %s | |
| 503 | %s | %s | |
| 406 | ExceedingQuota | Exceeding quota limits. | タスク数がクォータを超過しています。 |
| 409 | %s | %s |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。