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

Alibaba Cloud DNS:DescribeGtmInstanceAddressPool

最終更新日: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:DescribeGtmInstanceAddressPool

get

*GtmInstance

acs:alidns::{#accountId}:gtminstance/{#instanceId}

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

Lang

string

任意

言語。

en

AddrPoolId

string

必須

アドレスプールの ID。

hrbpnf

レスポンスフィールド

フィールド

説明

object

Status

string

アドレスプールの可用性ステータス。有効な値:

  • AVAILABLE:アドレスプールは利用可能です。

  • NOT_AVAILABLE:アドレスプールは利用不可です。

AVAILABLE

Addrs

object

Addr

array<object>

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

object

Value

string

IP アドレス。

1.1.XX.XX

UpdateTimestamp

integer

アドレスが最後に更新された時刻。これは UNIX タイムスタンプです。

1527690629357

UpdateTime

string

アドレスが最後に更新された時刻。

2017-12-28T13:08Z

AlertStatus

string

ヘルスチェックステータス。有効な値:

  • OK:正常

  • ALERT:アラートが発生しました。

OK

LbaWeight

integer

重み。

1

CreateTime

string

アドレスが作成された時刻。

2017-12-28T13:08Z

AddrId

integer

アドレスの ID。

123

Mode

string

戻りモード。有効な値:

  • SMART:インテリジェントリターン

  • ONLINE:常にオンライン

  • OFFLINE:常にオフライン

SMART

CreateTimestamp

integer

アドレスが作成された時刻。これは UNIX タイムスタンプです。

1527690629357

RequestId

string

一意のリクエスト ID。

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

CreateTime

string

アドレスプールが作成された時刻。

2017-12-28T13:08Z

AddrCount

integer

アドレスプール内のアドレスの数。

2

Name

string

アドレスプールの名前。

名称

Type

string

アドレスプールのタイプ。有効な値:

  • IP:IP アドレス

  • DOMAIN:ドメイン名

IP

UpdateTime

string

アドレスプールが最後に更新された時刻。

2017-12-28T13:08Z

AddrPoolId

string

アドレスプールの ID。

1234abc

UpdateTimestamp

integer

アドレスプールが最後に更新された時刻。これは UNIX タイムスタンプです。

1527690629357

MonitorConfigId

string

監視設定の ID。

100abc

MinAvailableAddrNum

integer

利用可能なアドレスの最小数。

1

MonitorStatus

string

監視ステータス。有効な値:

  • OPEN:有効

  • CLOSE:無効

  • UNCONFIGURED:未設定

OPEN

CreateTimestamp

integer

アドレスプールが作成された時刻。これは UNIX タイムスタンプです。

1527690629357

成功レスポンス

JSONJSON

{
  "Status": "AVAILABLE",
  "Addrs": {
    "Addr": [
      {
        "Value": "1.1.XX.XX",
        "UpdateTimestamp": 1527690629357,
        "UpdateTime": "2017-12-28T13:08Z",
        "AlertStatus": "OK",
        "LbaWeight": 1,
        "CreateTime": "2017-12-28T13:08Z",
        "AddrId": 123,
        "Mode": "SMART",
        "CreateTimestamp": 1527690629357
      }
    ]
  },
  "RequestId": "6856BCF6-11D6-4D7E-AC53-FD579933522B",
  "CreateTime": "2017-12-28T13:08Z",
  "AddrCount": 2,
  "Name": "名称",
  "Type": "IP",
  "UpdateTime": "2017-12-28T13:08Z",
  "AddrPoolId": "1234abc",
  "UpdateTimestamp": 1527690629357,
  "MonitorConfigId": "100abc",
  "MinAvailableAddrNum": 1,
  "MonitorStatus": "OPEN",
  "CreateTimestamp": 1527690629357
}

エラーコード

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

変更履歴

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