この操作では、 サイトモニタリングタスクを修正します。
現在、サイトモニタリングでは、HTTP、Ping、TCP、UDP、DNS、SMTP、POP3、FTP のプロトコルがサポートされています。各プロトコルには、OptionsJson パラメーターで指定された特定の拡張オプションがあります。 各プロトコルでサポートされている拡張オプションは下表のとおりです。
HTTP
パラメーター |
データ型 |
説明 |
---|---|---|
http_method |
String |
HTTP メソッド。 GET、POST、HEAD の HTTP メソッドがサポートされています。 既定値 : GET 。 |
header |
String |
ユーザー定義の HTTP ヘッダー。 ヘッダーを改行 ("\n") で区切ります。 各行のヘッダーの形式は、HTTP プロトコルの要件を満たす必要があります (ヘッダーの名前と値をコロン (:) で区切ります) 。 |
cookie |
String |
HTTP クッキー。 HTTP 要求標準に準拠してこのパラメーターを設定します。 |
request_content |
String |
要求のコンテンツ。 コンテンツは、JSON 形式またはフォーム形式にすることができます。 このパラメーターが指定されていない場合、本文なしの要求になります。 |
response_content |
String |
レスポンスにおいて予期されるコンテンツまたは予期されないコンテンツ。 HTTP サーバーから返されるコンテンツの最初の 64 KB は、モニタリングプロセスでチェックされます。 |
match_rule |
String |
マッチングルール。 レスポンスに response_content パラメーターで指定されたコンテンツが含まれていない場合、値が 0 であればモニタリングが成功したことを示します。 レスポンスに response_content パラメーターで指定されたコンテンツが含まれている場合、値が 1 であればモニタリングが成功したことを示します。 |
username |
String |
HTTP 要求の認証に使用されるユーザー名。 このパラメーターが指定されている場合、HTTP 要求には基本認証ヘッダーが含まれます。 |
password |
String |
HTTP 要求の認証に使用されるパスワード。 |
time_out |
Integer |
タイムアウトの値。 単位 : ミリ秒。 既定値 : 5000 。 |
max_redirect |
Integer |
リダイレクトの最大数。 既定値は ECS 検出ポイントの場合は 5、キャリア検出ポイントの場合は 2 になります。 リダイレクトを無効化するには、このパラメーターを 0 に設定します。 有効値 : 0 ~ 50 。 |
パラメーター |
データ型 |
説明 |
---|---|---|
failure_rate |
Integer |
失敗率のしきい値。 失敗率がこの値を超えるとモニタリングは失敗し、エラー 610 (PingAllFail) または 615 (PingPartialFail) が返されます。 既定値 : 0.1 。 |
ping_num |
Integer |
ターゲット URL または IP アドレスが ping された回数。 既定値 : 20 。 有効値 : 1 ~ 100 。 |
パラメーター |
データ型 |
説明 |
---|---|---|
dns_server |
String |
DNS サーバーのドメイン名または IP アドレス。 |
dns_type |
String |
照会する DNS レコードの種類。 有効値 : A、NS、CNAME、MX、TXT、ANY。 |
expect_value |
String |
期待値のリスト。 期待値をスペースで区切ります。 |
match_rule |
String |
期待値リストと返される DNS レコードリストのリレーションシップ。 2 つのリストが指定されたリレーションシップを満たしていない場合、モニタリングは失敗します。 空の文字列または IN_DNS : 期待値のリストは返された DNS レコードリストのサブセットです。 DNS_IN : 返された DNS レコードリストは期待値リストのサブセットです。 EQUAL : 返された DNS レコードリストは期待値リストと同一です。 ANY : 返された DNS レコードリストは期待値リストと交差します。 |
パラメーター |
データ型 |
説明 |
---|---|---|
port |
Integer |
FTP サーバーのポート番号。 このパラメーターが指定されていない場合、既定のポート番号が使用されます。 既定のポート番号は FTP の場合は 21、FTPS の場合は 990 です。 |
username |
String |
FTP サーバーへのログオンに使用されるユーザー名。 このパラメーターが指定されていない場合は、匿名ログオンが使用されます。 匿名ログオンの際のユーザー名とパスワードはは、匿名、ftp@example.com になります。 |
password |
String |
FTP サーバーへのログオンに使用されるパスワード。 |
パラメーター |
データ型 |
説明 |
---|---|---|
port |
Integer |
POP3 サーバーのポート番号。 既定のポート番号は、POP3 の場合は 110、POP3S の場合は 995 です。 |
username |
String |
サーバーへのログオンに使用されるユーザー名。 |
password |
String |
サーバーへのログオンに使用されるパスワード。 |
パラメーター |
データ型 |
説明 |
---|---|---|
port |
Integer |
モニタリングする TCP または UDP ポート番号。 |
request_content |
String |
要求のコンテンツ。 request_format パラメーターの値が 16 進数の場合、request_content パラメーターの値は 16 進数形式である必要があります。 |
request_format |
String |
要求コンテンツの形式。 request_format パラメーターの値が16 進数でない場合、request_content パラメーターの値は共通テキストとしてサーバーに送信されます。 |
response_content |
String |
予想されるレスポンスコンテンツ。 サーバーのレスポンスに response_content パラメーターで指定されたコンテンツが含まれていない場合、モニタリングは失敗します。 response_format パラメーターの値が 16 進数の場合、response_content パラメーターの値は 16 進数である必要があります。 response_format パラメーターの値が 16 進数でない場合、response_content パラメーターの値は共通テキストとして解釈されます。 |
デバッグ
API の使用を簡素化するため、Alibaba Cloud は OpenAPI Explorer を提供しています。 OpenAPI Explorerで API の検索、API の呼び出し、SDK サンプルコードの動的な生成を行うことができます。
リクエストパラメーター
パラメーター | データ型 | 必須/省略可能 | 例 | 説明 |
---|---|---|---|---|
Action | String | 必須 | ModifySiteMonitor |
実行する操作。 このパラメーターを ModifySiteMonitor に設定します。 |
TaskId | String | 必須 | 49f7b317-7645-4cc9-94fd-ea42e522**** |
サイトモニタリングタスクの ID。 |
Address | String | 省略可能 | http://www.aliyun.com |
サイトモニタリングタスクによってモニタリングされる URL または IP アドレス。 |
AlertIds | String | 省略可能 | 49f7c317-7645-4cc9-94fd-ea42e122**** |
サイトモニタリングタスクに関連付ける既存のアラート ルールの ID 。 |
Interval | String | 省略可能 | 1 |
サイトモニタリングタスクのモニタリング実行間隔。 単位 : 分。 有効値 : 1、5、15。 既定値 : 1 。 |
IspCities | String | 省略可能 | [{"city":"546","isp":"465"},{"city":"572","isp":"465"},{"city":"738","isp":"465"}] |
JSON 配列内の検出ポイント。 例えば、 DescribeISPAreaCity を呼び出して、検出ポイント情報を照会できます。 このパラメーターが指定されていない場合、モニタリングの 3 つの検出ポイントがランダムに選択されます。 |
OptionsJson | String | 省略可能 | {"time_out":5000} |
サイトモニタリングタスクのプロトコルの拡張オプション。 オプションはプロトコルによって異なります。 |
TaskName | String | 省略可能 | ウェブサイトモニタリングの変更 |
サイトモニタリングタスクの名前。 名前の長さは 4 ~ 100 文字である必要があります。 名前には、文字、数字、アンダースコアが仕様可能です。 |
レスポンスパラメーター
パラメーター | データ型 | 例 | 説明 |
---|---|---|---|
Code | String | 200 |
HTTP ステータスコード。 値が 200 の場合、呼び出しが成功したことを示します。 |
Data | String | {"count": 0} |
無効化されたサイトモニタリングタスクの数。 |
Message | String | successful |
エラー メッセージ。 |
RequestId | String | 68192f5d-0d45-4b98-9724-892813f86c71 |
リクエストの ID 。 |
Success | String | true |
呼び出しが成功したかを示します。 |
例
リクエストの例
http(s)://[Endpoint]/? Action=ModifySiteMonitor
&TaskId=49f7b317-7645-4cc9-94fd-ea42e522****
&<Common request parameters>
通常のレスポンス例
XML
形式
<ModifySiteMonitorResponse>
<Data>
<count>1</count>
</Data>
<Message>successful</Message>
<RequestId>B6593DD0-73E6-48EF-8019-ED4687ED378D</RequestId>
<Success>true</Success>
<Code>200</Code>
</ModifySiteMonitorResponse>
JSON
形式
{
"Data":{
"count":1
},
"Message":"successful",
"RequestId":"B6593DD0-73E6-48EF-8019-ED4687ED378D",
"Success":true,
"Code": "200"
}