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

Alibaba Cloud DNS:DescribeDnsGtmAccessStrategy

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

get

*gtmInstance

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

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

Lang

string

任意

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

en

StrategyId

string

必須

アクセス ポリシーの ID。 詳細については、DescribeDnsGtmAccessStrategies をご参照ください。

hr****

レスポンスフィールド

フィールド

説明

object

FailoverMinAvailableAddrNum

integer

セカンダリ アドレスプール グループで使用可能なアドレスの最小数。

1

DefaultAddrPoolType

string

プライマリ アドレスプールの種類。有効な値:

  • IPV4

  • IPV6

  • DOMAIN

IPV4

DefaultAvailableAddrNum

integer

プライマリ アドレスプールで使用可能なアドレスの数。

1

StrategyId

string

アクセス ポリシーの ID。

hr***

FailoverAddrPoolGroupStatus

string

セカンダリ アドレスプール グループのステータス。有効な値:

  • AVAILABLE

  • NOT_AVAILABLE

AVAILABLE

FailoverAvailableAddrNum

integer

セカンダリ アドレスプールで使用可能なアドレスの数。

1

FailoverLbaStrategy

string

セカンダリ アドレスプール グループの負荷分散ポリシー。有効な値:

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

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

ALL_RR

DefaultMaxReturnAddrNum

integer

プライマリ アドレスプール グループから返すことができるアドレスの最大数。

1

StrategyMode

string

アクセス ポリシーの種類。有効な値:

  • GEO: 地理位置情報に基づくアクセス ポリシー。

  • LATENCY: 遅延時間に基づくアクセス ポリシー。

GEO

CreateTimestamp

integer

アクセス ポリシーが作成された時刻。 この値は UNIX タイムスタンプです。

1533773400000

DefaultLbaStrategy

string

プライマリ アドレスプール グループの負荷分散ポリシー。有効な値:

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

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

ALL_RR

DefaultAddrPoolGroupStatus

string

プライマリ アドレスプール グループのステータス。有効な値:

  • AVAILABLE

  • NOT_AVAILABLE

AVAILABLE

FailoverAddrPoolType

string

セカンダリ アドレスプールの種類。有効な値:

  • IPV4

  • IPV6

  • DOMAIN

IPV4

RequestId

string

一意のリクエスト ID。

BA1608CA-834C-4E63-8682-8AF0B11ED72D

InstanceId

string

関連付けられている Global Traffic Manager (GTM) インスタンスの ID。

gtm-cn-wwo3a3hbz**

FailoverAddrPools

object

FailoverAddrPool

array<object>

セカンダリ アドレスプールのリスト。

object

LbaWeight

integer

重み。

1

Name

string

アドレスプールの名前。

test

AddrCount

integer

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

1

Id

string

アドレスプールの ID。

po**

DefaultLatencyOptimization

string

プライマリ アドレスプール グループで遅延時間に基づくスケジューリングが有効になっているかどうかを示します。有効な値:

  • OPEN: 有効。

  • CLOSE: 無効。

OPEN

EffectiveAddrPoolGroupType

string

現在有効なアドレスプール グループの種類。有効な値:

  • DEFAULT: プライマリ アドレスプール グループ。

  • FAILOVER: セカンダリ アドレスプール グループ。

DEFAULT

CreateTime

string

アクセス ポリシーが作成された時刻。

2018-08-09T00:10Z

DefaultAddrPools

object

DefaultAddrPool

array<object>

プライマリ アドレスプールのリスト。

object

LbaWeight

integer

重み。

1

Name

string

アドレスプールの名前。

test

AddrCount

integer

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

1

Id

string

アドレスプールの ID。

po***

DefaultMinAvailableAddrNum

integer

プライマリ アドレスプール グループで使用可能なアドレスの最小数。

1

FailoverLatencyOptimization

string

セカンダリ アドレスプール グループで遅延時間に基づくスケジューリングが有効になっているかどうかを示します。有効な値:

  • OPEN: 有効。

  • CLOSE: 無効。

OPEN

StrategyName

string

アクセス ポリシーの名前。

strategyName1

FailoverMaxReturnAddrNum

integer

セカンダリ アドレスプール グループから返すことができるアドレスの最大数。

1

AccessMode

string

アドレスプール グループのスイッチオーバー ポリシー。有効な値:

  • AUTO: 自動スイッチオーバー。

  • DEFAULT: プライマリ アドレスプール グループ。

  • FAILOVER: セカンダリ アドレスプール グループ。

AUTO

Lines

object

Line

array<object>

DNS リクエストの送信元リージョンのリスト。

object

GroupName

string

送信元リージョン グループの名前。

Global

LineCode

string

送信元リージョンのコード。

default

LineName

string

送信元リージョンの名前。

Global

GroupCode

string

送信元リージョン グループのコード。

DEFAULT

成功レスポンス

JSONJSON

{
  "FailoverMinAvailableAddrNum": 1,
  "DefaultAddrPoolType": "IPV4",
  "DefaultAvailableAddrNum": 1,
  "StrategyId": "hr***",
  "FailoverAddrPoolGroupStatus": "AVAILABLE",
  "FailoverAvailableAddrNum": 1,
  "FailoverLbaStrategy": "ALL_RR",
  "DefaultMaxReturnAddrNum": 1,
  "StrategyMode": "GEO",
  "CreateTimestamp": 1533773400000,
  "DefaultLbaStrategy": "ALL_RR",
  "DefaultAddrPoolGroupStatus": "AVAILABLE",
  "FailoverAddrPoolType": "IPV4",
  "RequestId": "BA1608CA-834C-4E63-8682-8AF0B11ED72D",
  "InstanceId": "gtm-cn-wwo3a3hbz**",
  "FailoverAddrPools": {
    "FailoverAddrPool": [
      {
        "LbaWeight": 1,
        "Name": "test",
        "AddrCount": 1,
        "Id": "po**"
      }
    ]
  },
  "DefaultLatencyOptimization": "OPEN",
  "EffectiveAddrPoolGroupType": "DEFAULT",
  "CreateTime": "2018-08-09T00:10Z",
  "DefaultAddrPools": {
    "DefaultAddrPool": [
      {
        "LbaWeight": 1,
        "Name": "test",
        "AddrCount": 1,
        "Id": "po***"
      }
    ]
  },
  "DefaultMinAvailableAddrNum": 1,
  "FailoverLatencyOptimization": "OPEN",
  "StrategyName": "strategyName1",
  "FailoverMaxReturnAddrNum": 1,
  "AccessMode": "AUTO",
  "Lines": {
    "Line": [
      {
        "GroupName": "Global",
        "LineCode": "default",
        "LineName": "Global",
        "GroupCode": "DEFAULT"
      }
    ]
  }
}

エラーコード

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

変更履歴

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