すべてのプロダクト
Search

このプロダクト

    Alibaba Cloud DNS:AddDnsGtmAddressPool

    ドキュメントセンター

    Alibaba Cloud DNS:AddDnsGtmAddressPool

    最終更新日:Sep 09, 2025

    アドレスプールを追加します。

    今すぐお試しください

    この 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:AddDnsGtmAddressPool

    create

    *gtmInstance

    acs:alidns::{#accountId}:gtmInstance/{#gtmInstanceId}

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Lang

    string

    任意

    返される一部のパラメーターの言語。デフォルト値：en。有効な値：en、zh、ja。

    en
    InstanceId

    string

    必須

    インスタンス ID。 インスタンス ID を取得するには、DescribeDnsGtmInstances を呼び出します。

    gtm-cn-cs02xyk****
    Name

    string

    必須

    アドレスプールの名前。

    test
    Type

    string

    必須

    アドレスプールの種類。有効な値：

    • IPV4: IPv4 アドレス

    • IPV6: IPv6 アドレス

    • DOMAIN: ドメイン名

    IPV4
    LbaStrategy

    string

    必須

    負荷分散ポリシー。有効な値：

    • ALL_RR: すべてのアドレスを返します。

    • RATIO: 重みによってアドレスを返します。

    ALL_RR
    MonitorStatus

    string

    任意

    ヘルスチェック機能の状態。デフォルト値：CLOSE。このパラメーターを OPEN に設定すると、ヘルスチェック構成が検証されます。それ以外の場合は、構成は無視されます。

    • OPEN: 有効

    • CLOSE: 無効

    OPEN
    ProtocolType

    string

    任意

    ヘルスチェックプロトコル。有効な値：

    • HTTP

    • HTTPS

    • PING

    • TCP

    TCP
    Interval

    integer

    任意

    ヘルスチェック間隔。単位：秒。

    60
    EvaluationCount

    integer

    任意

    ヘルスチェックの連続失敗回数。

    2
    Timeout

    integer

    任意

    タイムアウト期間。単位：ミリ秒。

    2000
    MonitorExtendInfo

    string

    任意

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

    • HTTP および HTTPS:

      • port: ヘルスチェックポート。

      • host: ホスト設定。

      • path: URL パス。

      • code: リターンコード。この値よりも大きい状態コードを持つ応答は異常とみなされます。有効な値：400 および 500。

      • failureRate: 失敗率。

      • sni: サーバー名表示 ( SNI ) を有効にするかどうかを指定します。このパラメーターは、HTTPS プロトコルでのみ使用できます。

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

        • その他の値: SNI を無効にします。

      • nodeType: アドレスプールタイプが DOMAIN の場合のヘルスチェックノードのタイプ。有効な値:

        • IPV4

        • IPV6

    • PING:

      • failureRate: 失敗率。

      • packetNum: ping パケットの数。

      • packetLossRate: パケット損失率。

      • nodeType: アドレスプールタイプが DOMAIN の場合のヘルスチェックノードのタイプ。有効な値:

        • IPV4

        • IPV6

    • TCP:

      • port: ヘルスチェックポート。

      • failureRate: 失敗率。

      • nodeType: アドレスプールタイプが DOMAIN の場合のヘルスチェックノードのタイプ。有効な値:

        • IPV4

        • IPV6

    {"failureRate":50,"port":80}
    Addr

    array<object>

    必須

    アドレスプール内のアドレスのリスト。

    object

    任意

    AttributeInfo

    string

    必須

    アドレスのソースリージョン。このパラメーターは JSON 文字列です。

    • lineCode: ソースリージョンの回線コード。

    • lineCodeRectifyType: 回線コードの修正タイプ。デフォルト値：AUTO。

      • NO_NEED: 修正は行われません。

      • RECTIFIED: 回線コードが修正されます。

      • AUTO: 回線コードは自動的に修正されます。

    {"lineCodeRectifyType":"AUTO", "lineCode":[]}
    Remark

    string

    任意

    備考。

    test
    LbaWeight

    integer

    任意

    重み。

    1
    Addr

    string

    必須

    アドレス。

    223.5.XX.XX
    Mode

    string

    必須

    モード。有効な値：

    • SMART: スマートリターン

    • ONLINE: 常時オンライン

    • OFFLINE: 常時オフライン

    SMART
    IspCityNode

    array<object>

    任意

    ヘルスチェックノードのリスト。MonitorStatus が OPEN に設定されている場合、少なくとも 1 つの有効なヘルスチェックノードを指定する必要があります。

    object

    任意

    CityCode

    string

    任意

    都市コード。MonitorStatus が OPEN に設定されている場合、CityCode は必須です。

    有効な値については、DescribeDnsGtmMonitorAvailableConfig 操作のレスポンスを参照してください。

    503
    IspCode

    string

    任意

    MonitorStatus が OPEN に設定されている場合、IspCode は必須です。有効な値については、DescribeDnsGtmMonitorAvailableConfig 操作のレスポンスを参照してください。

    465

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    一意のリクエスト ID。

    6856BCF6-11D6-4D7E-AC53-FD5799335**B
    AddrPoolId

    string

    アドレスプールの ID。

    hrbv**
    MonitorConfigId

    string

    ヘルスチェック構成の ID。

    hra**a

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "6856BCF6-11D6-4D7E-AC53-FD5799335**B",
  "AddrPoolId": "hrbv**",
  "MonitorConfigId": "hra**a"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 DnsGtmSystemBusyness

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

    変更履歴

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