AddRecursionRecord - - Centre de documentation Alibaba Cloud

Ajoute un enregistrement faisant autorité pour la résolution récursive.

Description de l'opération

Vous pouvez spécifier un nom de domaine (DomainName), un numéro de page (PageNumber) et une taille de page (PageSize) pour récupérer la liste des enregistrements DNS pour ce nom de domaine.
Pour rechercher des enregistrements DNS contenant un mot-clé spécifique, vous pouvez spécifier le mot-clé pour l'enregistrement d'hôte (RRKeyWord), le type d'enregistrement (TypeKeyWord) ou la valeur de l'enregistrement (ValueKeyWord).
Par défaut, la liste des enregistrements DNS est triée du plus récent au plus ancien.
Vous pouvez spécifier un identifiant de groupe de domaines (GroupId). Le groupe Tous les domaines inclut tous les noms de domaine. Le groupe Groupe par défaut inclut les noms de domaine qui ne sont pas attribués à un groupe.

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.

pubdns:AddRecursionRecord

create

*recursionZone

acs:pubdns::{#accountId}:recursionZone/{#zoneId}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
UserClientIp	string	Non	L'adresse IP du client.	192.168.0.1
ZoneId	string	Oui	L'identifiant de la zone.	173671468000011
Rr	string	Non	L'enregistrement d'hôte. L'enregistrement d'hôte est le préfixe d'un nom de domaine. Les exemples courants incluent www, @, * (pour les DNS génériques) et mail (pour les boîtes aux lettres). Par exemple, pour résoudre @.example.com, définissez l'enregistrement d'hôte sur "@", et non sur une chaîne vide.	www
Type	string	Non	Le type d'enregistrement DNS. Les types d'enregistrement suivants sont pris en charge : A : un enregistrement IPv4 qui mappe un nom de domaine à une adresse IPv4. AAAA : un enregistrement IPv6 qui mappe un nom de domaine à une adresse IPv6. CNAME : un enregistrement de nom canonique qui pointe un nom de domaine vers un autre nom de domaine. MX : un enregistrement d'échangeur de courrier qui pointe un nom de domaine vers l'adresse d'un serveur de courrier. TXT : un enregistrement texte qui contient n'importe quel texte lisible par l'homme. SRV : un enregistrement de service qui identifie un serveur fournissant un service spécifique. Ceci est courant dans la gestion d'annuaires pour les systèmes Microsoft. NS : un enregistrement de serveur de noms qui délègue un sous-domaine à un autre fournisseur DNS pour la résolution. CAA : un enregistrement d'autorisation d'autorité de certification qui restreint les autorités de certification (CA) autorisées à émettre des certificats pour un domaine. URL : un enregistrement URL qui pointe un nom de domaine vers un site existant. SVCB : un enregistrement de liaison de service utilisé pour la découverte de services. Il fournit des informations sur les protocoles pris en charge et les paramètres de service via un enregistrement DNS. HTTPS : un type d'enregistrement spécifique aux services HTTPS. Un enregistrement HTTPS peut définir des protocoles de connexion HTTPS sécurisés et des adresses de point de terminaison de service optimales.	A
RequestSource	string	Non	La ligne de résolution DNS. La valeur par défaut est default. Pour plus d'informations, consultez : Lignes de résolution DNS	default
Weight	integer	Non	Le poids de l'enregistrement. Les valeurs valides sont des entiers de 1 à 100. La valeur par défaut est 1. Définissez des poids différents pour chaque adresse. Les requêtes DNS renvoient ensuite les adresses en fonction du rapport de poids spécifié.	2
Priority	integer	Non	La priorité de l'enregistrement MX. Une valeur plus petite indique une priorité plus élevée. Valeurs valides : 1 à 99.	1
Ttl	integer	Non	La durée de vie (TTL) en secondes. Il s'agit de la durée pendant laquelle l'enregistrement est mis en cache. Valeurs prises en charge : 5, 30, 60, 3600 (1 heure), 43200 (12 heures) et 86400 (24 heures). Valeur par défaut : 60.	60
Value	string	Non	La valeur de l'enregistrement. Saisissez une valeur correspondant au type d'enregistrement spécifié.	1.1.1.1
ClientToken	string	Non	Un jeton client pour garantir l'idempotence de la requête. Générez une valeur unique sur votre client. Le jeton doit être unique pour chaque requête. Il ne peut contenir que des caractères ASCII et ne doit pas dépasser 64 caractères.	6447728c8578e66aacf062d2df4446dc

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant unique de la requête.	29D0F8F8-5499-4F6C-9FDC-1EE13BF55925
Success	boolean	Indique si l'opération a réussi : true : l'opération a réussi. false : l'opération a échoué.	true
RecordId	string	L'identifiant de l'enregistrement DNS.	173671468000010

Exemples

JSON format

{
  "RequestId": "29D0F8F8-5499-4F6C-9FDC-1EE13BF55925",
  "Success": true,
  "RecordId": "173671468000010"
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.