AddVodDomain - - Centre de documentation Alibaba Cloud

Ajoute un nom de domaine accéléré pour ApsaraVideo VOD.

Description de l'opération

Actuellement, le point de terminaison du service prend uniquement en charge Chine (Shanghai).
Avant de créer un nom de domaine accéléré, vous devez activer ApsaraVideo VOD et effectuer le dépôt ICP pour le nom de domaine accéléré.
Lorsque vous ajoutez un nouveau nom de domaine pour la première fois, vous devez vérifier la propriété du nom de domaine. Pour vérifier la propriété à l'aide d'enregistrements DNS, appelez l'opération DescribeVodVerifyContent pour obtenir la valeur de l'enregistrement, ajoutez un enregistrement TXT dans les paramètres DNS du nom de domaine, et attendez que l'enregistrement DNS prenne effet. Ensuite, appelez cette opération pour ajouter le nom de domaine. Vous pouvez également vérifier la propriété à l'aide d'un fichier de vérification. Pour plus d'informations, consultez la documentation sur la vérification de la propriété des noms de domaine.
Contenu du serveur d'origine. Si le contenu n'est pas hébergé sur Alibaba Cloud, il doit être examiné. L'examen sera terminé avant le prochain jour ouvrable.
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

*Toutes les ressources.

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
DomainName	string	Oui	Le nom de domaine accéléré que vous souhaitez ajouter à ApsaraVideo VOD. 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
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 pour les contrôles d'intégrité.	www.example.com/test.html
Scope	string	Non	La région d'accélération. Ce paramètre est valide pour les utilisateurs en dehors de la Chine continentale et les utilisateurs en Chine continentale de niveau 3 ou supérieur. Valeurs valides : domestic (par défaut) : la Chine continentale. overseas : Hong Kong (Chine), Macao (Chine), Taïwan (Chine) et les régions en dehors de la Chine. global : accélération mondiale.	domestic
TopLevelDomain	string	Non	Le nom de domaine de premier niveau.	example.com

Sources

Nom	Type	Obligatoire	Description
type	String	Oui	Le type de serveur d'origine. Valeurs valides : ipaddr : une adresse IP. domain : un nom de domaine. oss : un compartiment OSS.
content	String	Oui	L'adresse d'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 443 ou 80. Valeur par défaut : 80. Le port 443 est utilisé pour les requêtes back-to-origin HTTPS. Vous pouvez également spécifier un port personnalisé.
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, et une valeur de 30 spécifie 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.	Le format des informations du serveur d'origine n'est pas valide.
400	InvalidSourceStr.Malformed	Specified SourceStr is malformed.	Le format des informations du serveur d'origine n'est pas valide.
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.	Les informations du serveur d'origine du nom de domaine accéléré ne sont pas valides.
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.	Un nom de domaine générique et un nom de domaine exact de même niveau sont mutuellement exclusifs. Veuillez ajouter à nouveau le nom de domaine.
400	DomainReserved	The root domain of your domain is reserved by another account. Submit a ticket to contact customer support.	Le nom de domaine racine est déjà utilisé. Soumettez un ticket pour obtenir de l'assistance.
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.	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 une vérification de leur identité réelle.
400	TopLevelDomain.Mismatch	The specified TopLevelDomain does not match webSiteType.
400	DomainOwnerVerifyFail	Owner verification of the root domain failed.	Échec de la vérification du nom de domaine.

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

Notes de version

Consultez Notes de version pour la liste complète.