Tous les produits
Search
Centre de documentation

:BatchAddDcdnDomain

Dernière mise à jour :Oct 26, 2026

Ajoute plusieurs noms de domaine à DCDN.

Description de l'opération

Avant de commencer :

  • Avant de créer un nom de domaine accéléré, vous devez d'abord activer DCDN.

  • Si la région d'accélération est définie sur la Chine continentale ou mondiale, le nom de domaine accéléré 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:BatchAddDcdnDomain

create

*Domain

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

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

DomainName

string

Oui

Les noms de domaine accélérés pour DCDN. Vous pouvez ajouter jusqu'à 20 noms de domaine pour chaque utilisateur. Séparez les noms de domaine multiples par des virgules (,).

example.com,example.org

ResourceGroupId

string

Non

L'identifiant du groupe de ressources. Si vous ne spécifiez pas ce paramètre, l'identifiant du groupe de ressources par défaut est utilisé.

testID

Sources

string

Oui

La liste des adresses d'origine.

[{"content":"10.10.10.10","type":"ipaddr","priority":"20","port":80,"weight":"15"}]

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 (par défaut) : la Chine continentale.

  • overseas : mondial (à l'exclusion de la Chine continentale).

  • global : mondial.

domestic

TopLevelDomain

string

Non

Le nom de domaine de premier niveau.

example.com

Les champs dans Sources sont décrits comme suit :

ParamètreTypeRequisDescription
typeStringOuiLe type de serveur d'origine. Valeurs valides :
ipaddr : une adresse IP.
domain : un nom de domaine.
oss : un compartiment OSS.
fc_domain : un nom de domaine Function Compute.










contentStringOuiL'adresse de retour à l'origine. La valeur peut être une adresse IP ou un nom de domaine.
portIntegerNonLe numéro de port. Valeurs valides :
80 : le port par défaut.
443 : le port pour les requêtes de retour à l'origine HTTPS.
Port personnalisé.







priorityStringNonLa priorité des adresses du serveur d'origine. Valeurs valides :
20 : serveur d'origine principal (par défaut).
30 : serveur d'origine secondaire.




weightStringNonLe poids de retour à l'origine. La valeur varie de 0 à 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 InvalidSources.Malformed The specified Sources is invalid. Le format du paramètre Sources est incorrect. La valeur peut être des adresses IP ou un nom de domaine. Vous pouvez spécifier jusqu'à 20 adresses IP séparées par des virgules, ou spécifier un seul nom de domaine. Vous ne pouvez pas spécifier à la fois des adresses IP et un nom de domaine.
400 InvalidScope.Malformed The specified Scope is invalid. Le Scope est incorrect. Spécifiez un Scope valide et réessayez.
400 InvalidSource.Priority.Malformed The specified Source Priority is invalid. Le format de Source Priority est incorrect. Spécifiez un format valide.
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 TopLevelDomain.NotFound The specified TopLevelDomain does not exist. Le domaine d'accès de premier niveau n'existe pas.
400 EntityNotExists.ResourceGroup The resource group does not exist. Le groupe de ressources spécifié n'existe pas.
400 EntityNotExist.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 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 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 DomainOverLimit The maximum number of domains is exceeded. Le nombre de noms de domaine a atteint la limite supérieure.
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.

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

Notes de version

Consultez Notes de version pour la liste complète.