DescribeDnsProductInstances - - Centre de documentation Alibaba Cloud

Obtient la liste des instances de produits DNS payants qui correspondent aux paramètres spécifiés.

Description de l'opération

Remarque

Si la réponse ne contient pas de nom de domaine, l'instance Alibaba Cloud DNS n'est associée à aucun nom de domaine.

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:DescribeDnsProductInstances

get

*Instance

acs:alidns:*:{#accountId}:instance/*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
Lang	string	Non	La langue de la réponse. Valeurs valides : zh : chinois en : anglais Valeur par défaut : en.	en
UserClientIp	string	Non	L'adresse IP du client.	192.0.2.0
PageNumber	integer	Non	Le numéro de page. Les pages commencent à 1. Valeur par défaut : 1.	1
PageSize	integer	Non	Le nombre d'entrées à renvoyer sur chaque page. Valeur maximale : 100. Valeur par défaut : 20.	20
VersionCode	string	Non	Le code d'édition de l'instance Alibaba Cloud DNS.	version1
DomainType	string	Non	Le type de nom de domaine. Ce paramètre n'est pas sensible à la casse. Valeurs valides : PUBLIC : nom de domaine faisant autorité (par défaut) CACHE : nom de domaine proxy faisant autorité	PUBLIC
OrderBy	string	Non	Le champ par lequel trier les résultats. Valeurs valides : createDate : trie les résultats par heure de création. Il s'agit de la valeur par défaut. expireDate : trie les résultats par heure d'expiration.	createDate
Direction	string	Non	L'ordre de tri. Valeurs valides : DESC : ordre décroissant. Il s'agit de la valeur par défaut. ASC : ordre croissant.	DESC

Éléments de réponse

Élément	Type	Description	Exemple
	object
TotalCount	integer	Le nombre total d'instances qui correspondent à la requête.	2
DomainType	string	Le type de nom de domaine. Valeurs valides : PUBLIC : nom de domaine faisant autorité (par défaut) CACHE : nom de domaine proxy faisant autorité	PUBLIC
PageSize	integer	Le nombre d'entrées sur la page actuelle.	2
RequestId	string	L'identifiant de la requête.	536E9CAD-DB30-4647-AC87-AA5CC38xxxxx
PageNumber	integer	Le numéro de page.	1
DnsProducts	object
DnsProduct	array<object>	La liste des instances Alibaba Cloud DNS.
	object
OverseaLine	string	The DNS resolution line for regions outside mainland China.	海外大洲
PaymentType	string	The billing method.	Subscription
MonitorNodeCount	integer	The number of monitoring nodes.	5
InBlackHole	boolean	Indicates whether the domain name is in a blackhole filtering state. true: The domain name is in a blackhole filtering state. false: The domain name is not in a blackhole filtering state.	false
BindDomainUsedCount	integer	The number of domain names that are associated with the instance. This parameter applies to the Personal and Ultimate editions.	3
ISPRegionLines	string	The ISP resolution lines by province. China Telecom (province) China Mobile (province) China Unicom (province) China Education and Research Network (province)	电信_浙江
TTLMinValue	integer	The minimum time to live (TTL) value, in seconds.	10
ISPLines	string	The ISP resolution lines. China Telecom China Mobile China Unicom China Education and Research Network China Broadcasting Network Dr. Peng	中国电信
SearchEngineLines	string	The search engine resolution lines. Google Baidu Bing Youdao	谷歌
EndTimestamp	integer	The expiration time of the instance, as a UNIX timestamp.	1474335170000
VersionName	string	The edition name of the Alibaba Cloud DNS instance.	企业旗舰版
VersionCode	string	The edition code of the Alibaba Cloud DNS instance.	version1
MonitorTaskCount	integer	The number of monitoring jobs.	2
BindUsedCount	integer	The number of times the domain name has been changed for the instance. This parameter applies to the Custom Edition.	1
Domain	string	The associated domain name.	example.com
MonitorFrequency	integer	The monitoring frequency, in minutes.	50
InClean	boolean	Indicates whether the domain name is in a traffic scrubbing state.	false
URLForwardCount	integer	The number of URL forwarding rules.	20
StartTimestamp	integer	The purchase time of the instance, as a UNIX timestamp.	1474335170000
DDosDefendQuery	integer	The DDoS protection capacity in queries per second (QPS). The value is in units of 10,000. This parameter applies to the Custom Edition.	50
InstanceId	string	The instance ID.	i-8fj
DDosDefendFlow	integer	The DDoS protection bandwidth, in GB.	50
BindCount	integer	The number of times the domain name can be changed for the instance. This parameter applies to the Custom Edition.	3
SubDomainLevel	integer	The number of supported subdomain levels.	6
BindDomainCount	integer	The number of domain names that can be associated with the instance. This parameter applies to the Personal and Ultimate editions.	5
EndTime	string	The expiration time of the instance.	2015-12-12T00:00Z
StartTime	string	The purchase time of the instance.	2015-11-12T09:23Z
OverseaDDosDefendFlow	integer	The DDoS protection bandwidth for traffic from outside mainland China, in GB.	1
RegionLines	boolean	Indicates whether regional resolution lines are supported. true: Regional resolution lines are supported. false: Regional resolution lines are not supported.	true
Gslb	boolean	Indicates whether Global Server Load Balancing (GSLB) is supported. true: GSLB is supported. false: GSLB is not supported.	true
DnsSecurity	string	The DNS security level. Valid values: no: not required basic: basic DNS attack protection advanced: advanced DNS attack protection	no
DnsSLBCount	integer	The Server Load Balancer (SLB) capacity. This is the number of IP addresses that can be configured for a single domain name on a single resolution line.	15
AutoRenewal	boolean	The auto-renewal status. true: Auto-renewal is enabled. false: Auto-renewal is disabled.	true

Exemples

JSON format

{
  "TotalCount": 2,
  "DomainType": "PUBLIC",
  "PageSize": 2,
  "RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38xxxxx",
  "PageNumber": 1,
  "DnsProducts": {
    "DnsProduct": [
      {
        "OverseaLine": "海外大洲",
        "PaymentType": "Subscription",
        "MonitorNodeCount": 5,
        "InBlackHole": false,
        "BindDomainUsedCount": 3,
        "ISPRegionLines": "电信_浙江",
        "TTLMinValue": 10,
        "ISPLines": "中国电信",
        "SearchEngineLines": "谷歌",
        "EndTimestamp": 1474335170000,
        "VersionName": "企业旗舰版",
        "VersionCode": "version1",
        "MonitorTaskCount": 2,
        "BindUsedCount": 1,
        "Domain": "example.com",
        "MonitorFrequency": 50,
        "InClean": false,
        "URLForwardCount": 20,
        "StartTimestamp": 1474335170000,
        "DDosDefendQuery": 50,
        "InstanceId": "i-8fj",
        "DDosDefendFlow": 50,
        "BindCount": 3,
        "SubDomainLevel": 6,
        "BindDomainCount": 5,
        "EndTime": "2015-12-12T00:00Z",
        "StartTime": "2015-11-12T09:23Z",
        "OverseaDDosDefendFlow": 1,
        "RegionLines": true,
        "Gslb": true,
        "DnsSecurity": "no",
        "DnsSLBCount": 15,
        "AutoRenewal": true
      }
    ]
  }
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.