Tous les produits
Search
Centre de documentation

:AddVodDomain

Dernière mise à jour :Aug 05, 2026

Ajoute un nom de domaine pour l'accélération CDN dans ApsaraVideo VOD.

Description de l'opération

  • Actuellement, la seule adresse de service prise en charge est Chine (Shanghai).\n- Avant de créer un nom de domaine accéléré, vous devez activer ApsaraVideo VOD et le nom de domaine accéléré doit disposer d'un dépôt ICP valide. \n- Le contenu d'origine non hébergé sur Alibaba Cloud nécessite une vérification, qui sera effectuée avant le jour ouvrable suivant.\n- Vous ne pouvez soumettre qu'un seul nom de domaine accéléré à la fois. Chaque utilisateur peut ajouter jusqu'à 20 noms 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.

vod:AddVodDomain

create

*All Resource

*

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

DomainName

string

Oui

Le nom de domaine accéléré à ajouter à ApsaraVideo VOD. Les noms de domaine génériques sont pris en charge, commençant par un point (.), comme .example.com.

example.com

Sources

string

Oui

La liste des adresses d'origine. Pour plus d'informations sur les paramètres, consultez le tableau Sources ci-dessous.

[{"content":"1.1.1.1","type":"ipaddr","priority":"20","port":80}]

CheckUrl

string

Non

L'URL de vérification de l'état.

www.example.com/test.html

Scope

string

Non

Ce paramètre est valide pour les utilisateurs internationaux et les utilisateurs de Chine continentale de niveau L3 ou supérieur. Valeurs valides :\n- domestic (par défaut) : la Chine continentale.\n- overseas : Hong Kong (Chine), Macao (Chine), Taïwan (Chine) et les régions en dehors de la Chine.\n- global : accélération mondiale.

domestic

TopLevelDomain

string

Non

Le nom de domaine de premier niveau.

example.com

Sources

NomTypeObligatoireDescription
typeStringOuiLe type d'origine. Valeurs valides :
ipaddr : origine IP.
domain : origine de nom de domaine.
oss : origine de compartiment OSS.







contentStringOuiL'adresse d'origine, qui peut être une adresse IP ou un nom de domaine.
portIntegerNonLe numéro de port. Vous pouvez spécifier 443 ou 80. Valeur par défaut : 80. Le port 443 utilise HTTPS pour les requêtes de retour à l'origine. Vous pouvez également spécifier un port personnalisé.
priorityStringNonLa priorité correspondant aux adresses du serveur d'origine. Valeurs valides : 20 et 30. Valeur par défaut : 20. 20 indique le serveur d'origine principal. 30 indique le serveur d'origine secondaire.

Éléments de réponse

Élément

Type

Description

Exemple

object

RequestId

string

L'identifiant de la requête.

15C66C7B-671A-4297-****-2C4477247A74

Exemples

JSON format

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

Codes d'erreur

Code de statut HTTP

Code d'erreur

Message d'erreur

Description

400 InvalidDomainName.Malformed Specified DomainName is malformed.
400 MissingParameter The input parameter cdnType that is mandatory for processing this request is not supplied.
400 InvalidCdnType.Malformed Specified CdnType is malformed.
400 InvalidSources.Malformed Specified Sources is malformed. The origin information is in an invalid format.
400 InvalidSourceStr.Malformed Specified SourceStr is malformed. The format of the incoming source information is incorrect.
400 InvalidSourceType.Malformed Specified CdnType is malformed.
400 InvalidSource.Priority.Malformed The specified Source Priority is invalid.
400 InvalidTypeAndContent.MissMatch The specified source type does not match the specified source content.
400 InvalidScope.Malformed Specified Scope is malformed.
400 DomainOverLimit The Number of Domain is over the limit
400 DomainAlreadyExist This domain name is exist already
400 DomainNotRegistration The Domain name is not registered
400 InvaildParameter Source name can not equal to domain name
400 IllegalSources The specified origin site information is invalid. The origin information of the accelerated domain name is incorrect.
400 SourceIp.Exceed The Certificate you provided is malformed!
400 InvalidCertificate The Certificate you provided is malformed!
400 InvalidCertificate.TooLong The Certificate you provided is over the max length!
400 InnerAddDomainDenied Your account haven't bind aoneId, can not add domain.
400 CheckSourceHealthFailed sources ip or source domain check health failed,please input right source.
400 ExtensiveAndAllBothExist Extensive domain and the domain begins with 'all.' can not exist at the same time.
400 CdnTypeNotSupportExtensiveDomain Extensive domain not supported for this cdn type.
400 ExtensiveAndSpecificDomainConflict Extensive domain and corresponding specific domain are mutually exclusive. Wildcard domain names and specific domain names of the same level as the wildcard domain names are mutually exclusive. Enter another domain name.
400 DomainReserved The root domain of your domain is reserved by another account. Submit a ticket to contact customer support. The root domain name is already in use. Submit a ticket.
400 InvalidDomainNameLevel Domain name suffixed with alicdn.com only support third level.
400 InvalidTopLevelDomain.Malformed Specified TopLevelDomain is malformed.
400 TopLevelDomain.NotFound The specified TopLevelDomain does not exist.
400 EntityNotExists.ResourceGroup The resource group does not exist.
400 InvalidStatus.ResourceGroup It's now allowed to do this operation because of the current status of resource-group.
400 NotInternationRealIdentity You need to do real name authentication when you use Chinese mainland resources. You have not passed real-name verification. According to the regulations issued by MIIT, you must pass real-name verification if you want to purchase IT services in the Chinese mainland. 
400 TopLevelDomain.Mismatch The specified TopLevelDomain does not match webSiteType.
400 DomainOwnerVerifyFail Owner verification of the root domain failed. Failed to verify domain ownership.

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

Notes de version

Consultez Notes de version pour la liste complète.