AddDcdnDomain - - Centre de documentation Alibaba Cloud

Ajoute un nom de domaine.

Description de l'opération

Avant d'ajouter un nom de domaine, vous devez activer DCDN. Pour plus d'informations, consultez OpenDcdnService.
Si la région d'accélération est définie sur la Chine continentale ou mondiale, le nom de domaine doit disposer d'un dépôt ICP.
Lorsque vous ajoutez un nouveau nom de domaine à Alibaba Cloud DCDN pour la première fois, vous devez vérifier la propriété du nom de domaine. Pour plus d'informations, consultez VerifyDcdnDomainOwner.
Vous ne pouvez ajouter qu'un seul nom de domaine accéléré à la fois. Par défaut, chaque utilisateur peut ajouter jusqu'à 50 noms de domaine. Pour ajouter d'autres noms de domaine, demandez une augmentation de quota dans Quota Center.
Chaque utilisateur peut appeler cette opération jusqu'à 100 fois par heure.

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.

dcdn:AddDcdnDomain

create

*Domain

acs:dcdn:*:{#accountId}:domain/{#DomainName}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
DomainName	string	Oui	Le nom de domaine accéléré à ajouter. Vous ne pouvez ajouter qu'un seul nom de domaine à la fois. Les noms de domaine génériques sont pris en charge. Un nom de domaine générique doit commencer par un point (.), par exemple .example.com.	example.com
ResourceGroupId	string	Non	L'identifiant du groupe de ressources. Si vous ne spécifiez pas ce paramètre, le système utilise automatiquement l'identifiant du groupe de ressources par défaut.	rg-acfmyuji4b6r4**
Sources	string	Non	La liste des adresses d'origine.	[{"content":"10.10.10.10","type":"ipaddr","priority":"20","port":80}]
CheckUrl	string	Non	L'URL pour les vérifications d'état.	www.example.com/test.html
Scope	string	Non	La région d'accélération. Valeurs valides : domestic : La Chine continentale. overseas : Mondial (hors Chine continentale). global : Mondial. Valeur par défaut : domestic.	domestic
TopLevelDomain	string	Non	Le nom de domaine de premier niveau.	yourTopLevelDomain
Tag	array<object>	Non	Les informations de balise. Vous pouvez ajouter jusqu'à 20 balises.
	object	Non
Key	string	Non	La clé de la balise.	env
Value	string	Non	La valeur de la balise.	value
FunctionType	string	Non	Le type de service de calcul. Valeurs valides : routine : Routine. image : Image. cloudFunction : Fonction.	routine

Le tableau suivant décrit les champs du paramètre Sources.

Paramètre	Type	Requis	Description
type	String	Oui	Le type de serveur d'origine. Valeurs valides : ipaddr : adresse IP. domain : nom de domaine. oss : compartiment OSS.
content	String	Oui	L'adresse de retour à l'origine. Il peut s'agir d'une adresse IP ou d'un nom de domaine.
port	Integer	Non	Le numéro de port. Vous pouvez spécifier le port 443, le port 80 ou un port personnalisé. Valeur par défaut : 80. Le port 443 est utilisé pour les requêtes de retour à l'origine HTTPS.
priority	String	Non	La priorité des adresses du serveur d'origine. Valeurs valides : 20 et 30. Valeur par défaut : 20. Une valeur de 20 spécifie le serveur d'origine principal. Une valeur de 30 spécifie le serveur d'origine secondaire.
weight	String	Non	Le poids de retour à l'origine. La valeur doit être un nombre entier compris entre 1 et 100. Valeur par défaut : 10.

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	15C66C7B-671A-4297-9187-2C4477247A74

Exemples

JSON format

{
  "RequestId": "15C66C7B-671A-4297-9187-2C4477247A74"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidDomainName.Malformed	The specified DomainName is invalid.	Le nom de domaine spécifié n'est pas valide.
400	InvalidSource.Content.Malformed	The specified Source Content is invalid.	Les informations du serveur d'origine sont incorrectes. Spécifiez des informations valides.
400	MissingSource.Content	The Source Content must be specified.	Le paramètre Source Content est requis. Spécifiez ce paramètre et réessayez.
400	MissingSource.Type	The Source Type must be specified.	Le paramètre Source Type est requis. Spécifiez ce paramètre et réessayez.
400	InvalidSource.Type.Malformed	The specified Source Type is invalid.	Le format de Source Type est incorrect. Spécifiez un format valide.
400	InvalidSource.Priority.Malformed	The specified Source Priority is invalid.	Le format de Source Priority est incorrect. Spécifiez un format valide.
400	InvalidScope.Malformed	The specified Scope is invalid.	Le Scope est incorrect. Spécifiez un Scope valide et réessayez.
400	SourceIp.Exceed	The maximum number of back-to-origin IP addresses is exceeded.	Le nombre d'adresses IP de retour à l'origine dépasse la limite.
400	InvalidCertificate	The specified certificate format is invalid.	Le format du certificat n'est pas valide. Saisissez un certificat valide et réessayez.
400	InvalidCertificate.TooLong	The maximum length of the certificate is exceeded.	La longueur du certificat dépasse la limite.
400	CheckSourceHealthFailed	Error checking the security. Provide the valid origin site information.	La vérification du serveur d'origine a échoué. Fournissez des informations valides pour le serveur d'origine.
400	ExtensiveAndAllBothExist	A wildcard domain name and a domain name with an all. prefix cannot be both specified.	Un nom de domaine générique et un nom de domaine commençant par « all. » ne peuvent pas coexister.
400	CdnTypeNotSupportExtensiveDomain	Wildcard domain names are not supported.	Les noms de domaine génériques ne sont pas pris en charge.
400	ExtensiveAndSpecificDomainConflict	The wildcard domain name overlaps a domain name at the same level.	Un nom de domaine générique et un nom de domaine exact au même niveau s'excluent mutuellement. Ajoutez-les à nouveau.
400	InvalidResourceGroupId.Malformed	The specified ResourceGroupId is invalid.	Le ResourceGroupId est incorrect. Spécifiez un ResourceGroupId valide.
400	DomainReserved	The root domain of your domain is reserved by another account. Submit a ticket to contact customer support.	Le domaine racine de ce nom de domaine est déjà utilisé par un autre compte. Pour l'ajouter, soumettez un ticket.
400	InvalidDomainNameLevel	The alicdn.com domain supports a maximum of three levels of domain.	alicdn.com (pour les noms de domaine génériques) prend en charge jusqu'aux noms de domaine de troisième niveau.
400	EntityNotExists.ResourceGroup	The resource group does not exist.	Le groupe de ressources spécifié n'existe pas.
400	InvalidStatus.ResourceGroup	The current status of the resource group does not support this operation.	L'état actuel du groupe de ressources n'autorise pas cette opération.
400	NotInternationRealIdentity	Real-name registration is required for services offered in Mainland China.	Conformément aux lois de la République populaire de Chine, les utilisateurs qui achètent et utilisent des services d'information en Chine doivent effectuer l'enregistrement de leur identité réelle.
400	TopLevelDomain.NotFound	The specified TopLevelDomain does not exist.	Le domaine d'accès de premier niveau n'existe pas.
400	RecordCheckNotAvailable	The ICP filing interface is unavailable. Please try again later.	Une exception s'est produite lors de la vérification du dépôt ICP. Réessayez plus tard.
400	IcpBlack	The domain is on the ICP blacklist.	Le nom de domaine figure sur la liste noire du MIIT.
400	IspBlack	The domain is on the ISP blacklist.	Le nom de domaine figure sur la liste noire d'Alibaba Cloud.
400	InvalidCheckUrl.Malformed	The specified CheckUrl is invalid.	Le paramètre CheckUrl n'est pas valide.
400	DomainOwnerVerifyFail	Owner verification of the root domain failed.	Lorsque vous ajoutez un nouveau nom de domaine à Alibaba Cloud DCDN pour la première fois, vous devez vérifier la propriété du nom de domaine. Le nom de domaine ne pourra être ajouté avec succès qu'après avoir configuré la résolution DNS ou la vérification par fichier, comme requis.
400	TopLevelDomain.Mismatch	The specified TopLevelDomain does not match webSiteType.	Le domaine d'accès de premier niveau ne correspond pas au type de nom de domaine.
400	DomainInBlacklist	The domain is in the blacklist.	Le nom de domaine figure sur la liste noire.
400	DomainOverLimit	The maximum number of domains is exceeded.	Le nombre de noms de domaine a atteint la limite supérieure.
400	SourceInBlacklist	Source is in the blacklist.	Le serveur d'origine figure dans la liste noire.
400	InvalidTagKey	The key should not be null, start with "acs:" or "aliyun", contain "http://" or "https://" or have special symbols:.!@#$%?/^&*)(+={}[]",'<>~·`?;.
400	InvalidTagValue	The tag value cannot contain these special symbols:http://, https://
400	ReservedTagKey	The tag key is used internally as a reserved field and is not allowed to be used.
400	InvalidFunctionType.Malformed	The specified FunctionType is invalid.
400	InvalidfunctionType.Malformed	FunctionType is malformed.
400	DomainInRiskList	The domain you added may be at risk. If you have any questions, please submit a ticket.	Le nom de domaine que vous ajoutez peut présenter un risque. Si vous avez des questions, soumettez un ticket.
400	RegionNoResource	Resource allocation failed. Please submit a work order to contact customer service.	Aucune ressource correspondante n'est disponible dans la région que vous avez sélectionnée.

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

Notes de version

Consultez Notes de version pour la liste complète.