DescribeDomainRecords - - Centre de documentation Alibaba Cloud

Obtient les enregistrements DNS pour un domaine racine spécifié en fonction des paramètres d'entrée.

Description de l'opération

Vous pouvez spécifier le nom de domaine (DomainName), le numéro de page (PageNumber) et la taille de la page (PageSize) pour obtenir une liste d'enregistrements DNS.
Vous pouvez spécifier un mot-clé pour l'enregistrement d'hôte (RRKeyWord), le type d'enregistrement (TypeKeyWord) ou la valeur d'enregistrement (ValueKeyWord) pour interroger les enregistrements DNS contenant le mot-clé.
Par défaut, les enregistrements DNS sont triés par ordre décroissant en fonction de leur date d'ajout.
Vous pouvez spécifier un identifiant de groupe de domaines (GroupId) pour interroger les enregistrements DNS d'un groupe spécifique.

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

get

*Domain

acs:alidns::{#accountId}:domain/{#DomainName}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
Lang	string	Non	La langue de la requête et de la réponse. Valeur par défaut : zh. Valeurs valides : zh : chinois en : anglais	en
DomainName	string	Oui	Le nom de domaine. Pour plus d'informations, consultez DescribeDomains.	example.com
PageNumber	integer	Non	Le numéro de page. La valeur commence à 1. Valeur par défaut : 1.	1
PageSize	integer	Non	Le nombre d'entrées à renvoyer sur chaque page pour une requête paginée. Valeur maximale : 500. Valeur par défaut : 20.	20
KeyWord	string	Non	Le mot-clé.	test
RRKeyWord	string	Non	Le mot-clé pour l'enregistrement d'hôte. La recherche utilise un modèle de correspondance approximative et n'est pas sensible à la casse.	www
TypeKeyWord	string	Non	Le mot-clé pour le type d'enregistrement. La recherche utilise une correspondance exacte et n'est pas sensible à la casse.	MX
ValueKeyWord	string	Non	Le mot-clé pour la valeur d'enregistrement. La recherche utilise un modèle de correspondance approximative et n'est pas sensible à la casse.	com
OrderBy	string	Non	La méthode de tri. Les enregistrements sont triés par ordre décroissant en fonction de leur date d'ajout.	default
Direction	string	Non	Le sens du tri. Valeurs valides : DESC, ASC. Valeur par défaut : DESC.	DESC
SearchMode	string	Non	Le mode de recherche. Valeurs valides : LIKE, EXACT, ADVANCED et COMBINATION. Si vous définissez ce paramètre sur LIKE ou EXACT, utilisez le paramètre KeyWord. Les paramètres RRKeyWord, TypeKeyWord, ValueKeyWord, Type, Line et Status sont invalides. Si vous définissez ce paramètre sur ADVANCED, utilisez les paramètres RRKeyWord, TypeKeyWord, ValueKeyWord, Type, Line et Status. Les paramètres RRKeyWord et ValueKeyWord prennent en charge la correspondance approximative. Si vous définissez ce paramètre sur COMBINATION, utilisez les paramètres RRKeyWord, TypeKeyWord, ValueKeyWord, Type, Line et Status. Tous ces paramètres ne prennent en charge que la correspondance exacte. Si vous ne spécifiez pas ce paramètre : Si vous spécifiez le paramètre keyWord, le mode de recherche est défini sur LIKE. Si vous ne spécifiez pas le paramètre keyWord, RRKeyWord et ValueKeyWord prennent en charge la correspondance approximative, et TypeKeyWord, Type, Line et Status prennent en charge la correspondance exacte.	LIKE
GroupId	integer	Non	L'identifiant du groupe de domaines. Si vous ne spécifiez pas GroupId, la requête est effectuée sur tous les noms de domaine. Si vous définissez GroupId sur 0, un résultat vide est renvoyé. Si vous définissez GroupId sur -1, la requête est effectuée sur le groupe par défaut. Le groupe par défaut inclut les noms de domaine qui ne sont pas attribués à un groupe. Si vous définissez GroupId sur -2, la requête est effectuée sur tous les noms de domaine. Si vous spécifiez une autre valeur pour GroupId, la requête est effectuée sur le groupe spécifié. Pour plus d'informations, consultez DescribeDomainGroups.	2****
Type	string	Non	Le type d'enregistrement DNS. Pour plus d'informations, consultez : Types d'enregistrements DNS	A
Line	string	Non	La ligne de résolution DNS. Valeur par défaut : default. Pour plus d'informations, consultez : Énumération des lignes de résolution DNS	cn_mobile_anhui
Status	string	Non	L'état de l'enregistrement DNS. Valeurs valides : Enable : l'enregistrement DNS est activé. Disable : l'enregistrement DNS est désactivé.	Enable

Éléments de réponse

Élément	Type	Description	Exemple
	object
TotalCount	integer	Le nombre total d'enregistrements DNS.	2
PageSize	integer	Le nombre d'enregistrements DNS renvoyés dans cette requête.	20
RequestId	string	L'identifiant de la requête.	536E9CAD-DB30-4647-AC87-AA5CC38C5382
DomainRecords	object
Record	array<object>	La liste des enregistrements DNS.
	object
Status	string	The status of the DNS record.	Enable
Type	string	The record type.	MX
Remark	string	The remarks.	备注
TTL	integer	The time to live (TTL). Unit: seconds.	600
RecordId	string	The ID of the DNS record.	9*******
Priority	integer	The priority of the MX record.	5
RR	string	The host record.	www
DomainName	string	The domain name.	example.com
Weight	integer	The weight for load balancing.	2
Value	string	The record value.	mail1.hichina.com
Line	string	The DNS resolution line.	default
Locked	boolean	The lock status of the DNS record.	false
CreateTimestamp	integer	The time when the record was created. This is a UNIX timestamp.	1666501957000
UpdateTimestamp	integer	The time when the record was last updated. This is a UNIX timestamp.	1676872961000
LbaStatus	boolean	Indicates whether a load balancing policy is configured. true: Weight-based false: Polling-based	true
PageNumber	integer	Le numéro de page actuel.	1

Exemples

JSON format

{
  "TotalCount": 2,
  "PageSize": 20,
  "RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382",
  "DomainRecords": {
    "Record": [
      {
        "Status": "Enable",
        "Type": "MX",
        "Remark": "备注",
        "TTL": 600,
        "RecordId": "9*******",
        "Priority": 5,
        "RR": "www",
        "DomainName": "example.com",
        "Weight": 2,
        "Value": "mail1.hichina.com",
        "Line": "default",
        "Locked": false,
        "CreateTimestamp": 1666501957000,
        "UpdateTimestamp": 1676872961000,
        "LbaStatus": true
      }
    ]
  },
  "PageNumber": 1
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.