Tous les produits
Search
Centre de documentation

:DescribeDnsGtmAccessStrategy

Dernière mise à jour :Aug 06, 2026

Obtient les détails d'une stratégie d'accès spécifiée.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

  • Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.

  • API : l'API que vous pouvez appeler pour exécuter l'action.

  • Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.

  • Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.

    • Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.

    • Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.

  • Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.

  • Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

alidns:DescribeDnsGtmAccessStrategy

get

*gtmInstance

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

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

Lang

string

Non

La langue de certains paramètres renvoyés. La valeur par défaut est en. Valeurs valides : en, zh et ja.

en

StrategyId

string

Oui

L'identifiant de la stratégie d'accès. Pour plus d'informations, consultez DescribeDnsGtmAccessStrategies.

hr****

Éléments de réponse

Élément

Type

Description

Exemple

object

FailoverMinAvailableAddrNum

integer

Le nombre minimum d'adresses disponibles dans le groupe de pools d'adresses secondaire.

1

DefaultAddrPoolType

string

Le type du pool d'adresses principal. Valeurs valides :

  • IPV4

  • IPV6

  • DOMAIN

IPV4

DefaultAvailableAddrNum

integer

Le nombre d'adresses disponibles dans le pool d'adresses principal.

1

StrategyId

string

L'identifiant de la stratégie d'accès.

hr***

FailoverAddrPoolGroupStatus

string

L'état du groupe de pools d'adresses secondaire. Valeurs valides :

  • AVAILABLE

  • NOT_AVAILABLE

AVAILABLE

FailoverAvailableAddrNum

integer

Le nombre d'adresses disponibles dans le pool d'adresses secondaire.

1

FailoverLbaStrategy

string

La stratégie de répartition de charge pour le groupe de pools d'adresses secondaire. Valeurs valides :

  • ALL_RR : renvoie toutes les adresses.

  • RATIO : renvoie les adresses en fonction du poids.

ALL_RR

DefaultMaxReturnAddrNum

integer

Le nombre maximal d'adresses pouvant être renvoyées par le groupe de pools d'adresses principal.

1

StrategyMode

string

Le type de la stratégie d'accès. Valeurs valides :

  • GEO : stratégie d'accès basée sur la géolocalisation.

  • LATENCY : stratégie d'accès basée sur la latence.

GEO

CreateTimestamp

integer

L'heure à laquelle la stratégie d'accès a été créée. Cette valeur est un horodatage UNIX.

1533773400000

DefaultLbaStrategy

string

La stratégie de répartition de charge pour le groupe de pools d'adresses principal. Valeurs valides :

  • ALL_RR : renvoie toutes les adresses.

  • RATIO : renvoie les adresses en fonction du poids.

ALL_RR

DefaultAddrPoolGroupStatus

string

L'état du groupe de pools d'adresses principal. Valeurs valides :

  • AVAILABLE

  • NOT_AVAILABLE

AVAILABLE

FailoverAddrPoolType

string

Le type du pool d'adresses secondaire. Valeurs valides :

  • IPV4

  • IPV6

  • DOMAIN

IPV4

RequestId

string

L'identifiant unique de la requête.

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

InstanceId

string

L'identifiant de l'instance Global Traffic Manager (GTM) associée.

gtm-cn-wwo3a3hbz**

FailoverAddrPools

object

FailoverAddrPool

array<object>

La liste des pools d'adresses secondaires.

object

LbaWeight

integer

The weight.

1

Name

string

The name of the address pool.

test

AddrCount

integer

The number of addresses in the address pool.

1

Id

string

The ID of the address pool.

po**

DefaultLatencyOptimization

string

Indique si la planification basée sur la latence est activée pour le groupe de pools d'adresses principal. Valeurs valides :

  • OPEN : activée.

  • CLOSE : désactivée.

OPEN

EffectiveAddrPoolGroupType

string

Le type du groupe de pools d'adresses actuellement en vigueur. Valeurs valides :

  • DEFAULT : le groupe de pools d'adresses principal.

  • FAILOVER : le groupe de pools d'adresses secondaire.

DEFAULT

CreateTime

string

L'heure à laquelle la stratégie d'accès a été créée.

2018-08-09T00:10Z

DefaultAddrPools

object

DefaultAddrPool

array<object>

La liste des pools d'adresses principaux.

object

LbaWeight

integer

The weight.

1

Name

string

The name of the address pool.

test

AddrCount

integer

The number of addresses in the address pool.

1

Id

string

The ID of the address pool.

po***

DefaultMinAvailableAddrNum

integer

Le nombre minimum d'adresses disponibles dans le groupe de pools d'adresses principal.

1

FailoverLatencyOptimization

string

Indique si la planification basée sur la latence est activée pour le groupe de pools d'adresses secondaire. Valeurs valides :

  • OPEN : activée.

  • CLOSE : désactivée.

OPEN

StrategyName

string

Le nom de la stratégie d'accès.

strategyName1

FailoverMaxReturnAddrNum

integer

Le nombre maximal d'adresses pouvant être renvoyées par le groupe de pools d'adresses secondaire.

1

AccessMode

string

La stratégie de basculement pour le groupe de pools d'adresses. Valeurs valides :

  • AUTO : basculement automatique.

  • DEFAULT : le groupe de pools d'adresses principal.

  • FAILOVER : le groupe de pools d'adresses secondaire.

AUTO

Lines

object

Line

array<object>

La liste des régions sources pour les requêtes DNS.

object

GroupName

string

The name of the source region group.

Global

LineCode

string

The code of the source region.

default

LineName

string

The name of the source region.

Global

GroupCode

string

The code of the source region group.

DEFAULT

Exemples

JSON format

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

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.