すべてのプロダクト
Search
ドキュメントセンター

Alibaba Cloud DNS:UpdateCloudGtmMonitorTemplate

最終更新日:Mar 26, 2026

指定されたパラメーターに基づいてヘルスチェックテンプレートを更新します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

alidns:UpdateCloudGtmMonitorTemplate

update

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

AcceptLanguage

string

任意

応答の言語。有効値:

  • zh-CN:中国語

  • en-US (デフォルト):英語

en-US

ClientToken

string

任意

リクエストのべき等性を保証するために使用されるクライアント生成トークン。各リクエストでトークンが一意であることを確認してください。トークンは最大 64 文字の ASCII 文字列です。

1ae05db4-10e7-11ef-b126-00163e24****

TemplateId

string

必須

変更するヘルスチェックテンプレートの一意の ID。

mtp-89518052425100****

Name

string

任意

ヘルスチェックテンプレートの名前。識別しやすくするために、ヘルスチェックプロトコルに基づいてテンプレートに名前を付けます。

Ping-IPv4

Interval

integer

任意

ヘルスチェックの間隔 (秒単位)。デフォルト値は 60 です。最小間隔は 15 秒です。この機能は Ultimate Edition インスタンスでのみ利用可能です。

60

Timeout

integer

任意

ヘルスチェックのタイムアウト期間 (ミリ秒単位)。指定されたタイムアウト期間内にパケットが返されない場合、ヘルスチェックは失敗します。有効値:

  • 2000

  • 3000

  • 5000

  • 10000

5000

EvaluationCount

integer

任意

アプリケーションサービスが異常と見なされるまでに発生する必要がある連続したヘルスチェック失敗の回数。これにより、ネットワークジッターなどの一時的な問題による誤報を防ぐことができます。有効値:

  • 1

  • 2

  • 3

2

FailureRate

integer

任意

失敗した検出ポイントの割合。ヘルスチェックに失敗した検出ポイントの割合がこのしきい値を超えると、エンドポイントは異常と見なされます。有効値:

  • 20

  • 50

  • 80

  • 100

50

ExtendInfo

string

任意

JSON 文字列形式の拡張情報。パラメーターはヘルスチェックプロトコルによって異なります。

  • HTTP および HTTPS:

    host:HTTP または HTTPS ヘルスチェックを実行する際、このパラメーターは HTTP リクエストヘッダーの Host フィールドを指定します。ターゲットの Web サイトを識別します。デフォルト値はプライマリドメイン名です。ターゲットの Web サイトが Host フィールドに特定の要件を持つ場合は、必要に応じてこのパラメーターを変更します。

    path:HTTP または HTTPS ヘルスチェックのパス。デフォルト値は / です。

    code:HTTP または HTTPS ヘルスチェックを実行する際、システムは Web サーバーからのリターンコードを使用してそのステータスを判断します。リターンコードが指定されたしきい値を超えると、アプリケーションサービスは異常と見なされます。

    • 400:不正なリクエスト。HTTP または HTTPS リクエストに無効なパラメーターが含まれている場合、Web サーバーは 400 以上のコードを返します。しきい値を 400 に設定する場合は、正確な URL パスを指定してください。

    • 500:サーバーエラー。Web サーバーでエラーが発生した場合、500 以上のコードを返します。デフォルトのしきい値は 500 です。

    sni:サーバ名表示 (SNI) を有効にするかどうかを指定します。このパラメーターは HTTPS ヘルスチェックでのみ使用されます。SNI は Transport Layer Security (TLS) プロトコルの拡張機能です。クライアントは TLS ハンドシェイクの開始時に接続しようとしているホスト名を指定できます。TLS ハンドシェイクは HTTP データが送信される前に行われるため、SNI によってサーバーは証明書を送信する前にクライアントがどのサービスにアクセスしようとしているかを知ることができます。これにより、サーバーはクライアントに正しい証明書を提示できます。

    • true:SNI を有効にします。

    • false:SNI を無効にします。

    followRedirect:3xx リダイレクトに従うかどうかを指定します。

    • true:検出ポイントが 3xx ステータスコード (301、302、303、307、または 308) を受信した場合、リダイレクトに従います。

    • false:リダイレクトに従いません。

  • Ping:

    packetNum:各 PING ヘルスチェックで送信する ICMP パケットの数。有効値:20、50、100。

    packetLossRate:アラームをトリガーするパケット損失率。各 PING ヘルスチェックで、システムはパケット損失率を計算します。パケット損失率 = (損失パケット数 / 送信された ICMP パケットの総数) × 100%。パケット損失率がこのしきい値に達するとアラームがトリガーされます。有効値:10、30、40、80、90、100。

{\"code\":200,\"path\":\"\\index.htm\",\"host\":\"aliyun.com\"}

IspCityNodes

array<object>

任意

検出ポイントのリスト。ListCloudGtmMonitorNodes を呼び出して情報を取得します。

object

任意

検出ポイント。

CityCode

string

任意

検出ポイントの都市コード。

503

IspCode

string

任意

検出ポイントのキャリアコード。

465

レスポンスフィールド

フィールド

説明

object

RequestId

string

一意のリクエスト ID。

6856BCF6-11D6-4D7E-AC53-FD579933522B

Success

boolean

操作が成功したかどうかを示します。

  • true:操作は成功しました。

  • false:操作は失敗しました。

true

成功レスポンス

JSONJSON

{
  "RequestId": "6856BCF6-11D6-4D7E-AC53-FD579933522B",
  "Success": true
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。