DescDomain - - Centre de documentation Alibaba Cloud

Configure le 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.

dm:DescDomain

get

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
DomainId	integer	Oui	L'identifiant du domaine. Appelez QueryDomainByParam pour l'obtenir.	13464
RequireRealTimeDnsRecords	boolean	Non	Indique si une résolution DNS en temps réel doit être effectuée.	true

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les paramètres de réponse.
SpfRecord	string	La valeur de l'enregistrement SPF depuis la console Direct Mail.	include:spf1.dm.aliyun.com
CnameConfirmStatus	string	Indique si l'enregistrement d'hôte CNAME a été modifié. Une valeur de 1 indique un changement, y compris un retour à la valeur d'origine. Une valeur de 0 indique aucun changement.	0
DefaultDomain	string	Indique s'il s'agit du nom de domaine par défaut.\n\nCe paramètre est obsolète et renvoie toujours 0 (Non).	0
CreateTime	string	L'heure de création du nom de domaine.	2025-03-19T12:49Z
CnameRecord	string	L'enregistrement d'hôte CNAME.	dmtrace
CnameAuthStatus	string	L'état de vérification CNAME. Valeurs valides : 0 (Succès), 1 (Échec).	1
IcpStatus	string	L'état du dépôt ICP. 1 indique que le dépôt est terminé. 0 indique qu'aucun dépôt n'a été trouvé.	1
DnsTxt	string	La valeur de l'enregistrement de propriété résolue depuis le DNS public.	0c40d5f125af4e42892a
DomainName	string	Le nom de domaine.	test.example.net
DomainId	string	L'identifiant du domaine.	158910
DnsSpf	string	La valeur de l'enregistrement SPF résolue depuis le DNS public.	v=xxxx
SpfAuthStatus	string	L'état de vérification SPF. Valeurs valides : 0 (Succès), 1 (Échec).	1
RequestId	string	L'identifiant de la requête.	51B74264-46B4-43C8-A9A0-6B8E8BC04F34
MxRecord	string	La valeur de l'enregistrement MX depuis la console Direct Mail.	mx01.dm.aliyun.com
MxAuthStatus	string	L'état de vérification MX. Valeurs valides : 0 (Succès), 1 (Échec).	1
DnsMx	string	La valeur de l'enregistrement MX résolue depuis le DNS public.	mx01.dm.aliyun.com
DomainStatus	string	L'état de vérification du nom de domaine. Valeurs valides : 0 : Disponible. Le nom de domaine est vérifié. 1 : Indisponible. La vérification du nom de domaine a échoué.	1
TlDomainName	string	Le domaine racine.	example.com
TracefRecord	string	La valeur de l'enregistrement CNAME depuis la console Direct Mail.	tracedm.aliyuncs.com
DomainType	string	La valeur requise pour l'enregistrement de vérification de propriété du domaine, depuis la console Direct Mail.	0c40d5f125af4e42892a
SpfRecordV2	string	L'enregistrement SPF complet. Ce paramètre remplace SpfRecord. Vous pouvez utiliser directement la valeur de SpfRecordV2 sans la construire à partir de la valeur de SpfRecord.	v=spf1 include:spf1.dm.aliyun.com -all
DkimRR	string	L'enregistrement d'hôte DKIM.	aliyun-cn-hangzhou._domainkey.hangzhou26
DkimPublicKey	string	La clé publique pour l'enregistrement DKIM.	v=DKIM1; k=rsa; p=MIGfMA0GCSqGSI..
DkimAuthStatus	string	L'état de vérification DKIM. Valeurs valides : 0 (Vérifié), 1 (Non vérifié).	0
HostRecord	string	L'enregistrement d'hôte pour la vérification de propriété du domaine.	xxx
DmarcRecord	string	La valeur de l'enregistrement DMARC.	v=DMARC1;p=none;rua=mailto:dmarc_report@service.aliyun.com
DnsDmarc	string	La valeur de l'enregistrement DMARC résolue depuis le DNS public.	v=DMARC1;p=none;rua=mailto:dmarc_report@service.aliyun.com
DmarcAuthStatus	integer	L'état de vérification DMARC. Valeurs valides : 0 (Vérifié), 1 (Non vérifié).	1
DmarcHostRecord	string	L'enregistrement d'hôte DMARC.	_dmarc.xxx
DkimRsaLength	integer	La longueur de la clé RSA DKIM, telle que 1024 ou 2048.	1024
DomainVersion	integer

Exemples

JSON format

{
  "SpfRecord": "include:spf1.dm.aliyun.com",
  "CnameConfirmStatus": "0",
  "DefaultDomain": "0",
  "CreateTime": "2025-03-19T12:49Z",
  "CnameRecord": "dmtrace",
  "CnameAuthStatus": "1",
  "IcpStatus": "1",
  "DnsTxt": "0c40d5f125af4e42892a",
  "DomainName": "test.example.net",
  "DomainId": "158910",
  "DnsSpf": "v=xxxx",
  "SpfAuthStatus": "1",
  "RequestId": "51B74264-46B4-43C8-A9A0-6B8E8BC04F34",
  "MxRecord": "mx01.dm.aliyun.com",
  "MxAuthStatus": "1",
  "DnsMx": "mx01.dm.aliyun.com",
  "DomainStatus": "1",
  "TlDomainName": "example.com",
  "TracefRecord": "tracedm.aliyuncs.com",
  "DomainType": "0c40d5f125af4e42892a",
  "SpfRecordV2": "v=spf1 include:spf1.dm.aliyun.com -all",
  "DkimRR": "aliyun-cn-hangzhou._domainkey.hangzhou26",
  "DkimPublicKey": "v=DKIM1; k=rsa; p=MIGfMA0GCSqGSI...",
  "DkimAuthStatus": "0",
  "HostRecord": "xxx",
  "DmarcRecord": "v=DMARC1;p=none;rua=mailto:dmarc_report@service.aliyun.com",
  "DnsDmarc": "v=DMARC1;p=none;rua=mailto:dmarc_report@service.aliyun.com",
  "DmarcAuthStatus": 1,
  "DmarcHostRecord": "_dmarc.xxx",
  "DkimRsaLength": 1024,
  "DomainVersion": 0
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.