この操作では、 サイトモニタリングタスクを修正します。

現在、サイトモニタリングでは、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 。

Ping

パラメーター

データ型

説明

failure_rate

Integer

失敗率のしきい値。 失敗率がこの値を超えるとモニタリングは失敗し、エラー 610 (PingAllFail) または 615 (PingPartialFail) が返されます。 既定値 : 0.1 。

ping_num

Integer

ターゲット URL または IP アドレスが ping された回数。 既定値 : 20 。 有効値 : 1 ~ 100 。

DNS

パラメーター

データ型

説明

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 レコードリストは期待値リストと交差します。

FTP

パラメーター

データ型

説明

port

Integer

FTP サーバーのポート番号。 このパラメーターが指定されていない場合、既定のポート番号が使用されます。 既定のポート番号は FTP の場合は 21、FTPS の場合は 990 です。

username

String

FTP サーバーへのログオンに使用されるユーザー名。 このパラメーターが指定されていない場合は、匿名ログオンが使用されます。 匿名ログオンの際のユーザー名とパスワードはは、匿名、ftp@example.com になります。

password

String

FTP サーバーへのログオンに使用されるパスワード。

POP3 または SMTP

パラメーター

データ型

説明

port

Integer

POP3 サーバーのポート番号。 既定のポート番号は、POP3 の場合は 110、POP3S の場合は 995 です。

username

String

サーバーへのログオンに使用されるユーザー名。

password

String

サーバーへのログオンに使用されるパスワード。

TCP または UDP

パラメーター

データ型

説明

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 配列内の検出ポイント。 例えば、[{"city":"546","isp":"465"},{"city":"572","isp":"465"},{"city":"738","isp":"465"}]は、北京、杭州、青島のそれぞれの検出ポイントを示します。

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"
}

エラーコード

エラー コードを表示