Tous les produits
Search
Centre de documentation

:BatchSetVodDomainConfigs

Dernière mise à jour :Aug 05, 2026

Configure plusieurs noms de domaine accélérés par lot.

Description de l'opération

  • Actuellement, la seule région de service prise en charge est Chine (Shanghai).

  • Vous pouvez configurer jusqu'à 50 noms de domaine à la fois.

  • Après avoir appelé cette opération pour configurer certaines fonctionnalités pour les noms de domaine, un ConfigId unique est généré. Vous pouvez utiliser le ConfigId pour mettre à jour ou supprimer les configurations de noms de domaine. Cette opération ne renvoie pas le ConfigId. Pour obtenir le ConfigId, appelez l'opération DescribeVodDomainConfigs.

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:BatchSetVodDomainConfigs

update

*All Resource

*

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

DomainNames

string

Oui

Les noms de domaine accélérés pour ApsaraVideo VOD. Séparez les noms de domaine multiples par des virgules (,). Vous pouvez configurer jusqu'à 50 noms de domaine à la fois.

example.com

Functions

string

Oui

La liste des fonctionnalités.

  • functionName (nom de la fonctionnalité, requis) : Pour les fonctionnalités pouvant être configurées et leurs paramètres de nom de fonctionnalité, consultez Fonctionnalités de configuration des noms de domaine.

  • argName (nom du paramètre, requis) : Les éléments de configuration de functionName. Vous pouvez configurer plusieurs éléments de configuration.

  • argValue (valeur du paramètre, requis) : Les valeurs des éléments de configuration de functionName.

Pour des informations détaillées sur les fonctionnalités pouvant être configurées pour les noms de domaine accélérés, y compris les noms des fonctionnalités et les noms des paramètres, consultez Fonctionnalités de configuration des noms de domaine.

Remarque

Certaines fonctionnalités, telles que filetype_based_ttl_set (délai d'expiration des fichiers), prennent en charge plusieurs règles de configuration. Pour mettre à jour une règle de configuration spécifique, spécifiez le configId de cette règle. Exemple : [{"functionArgs":[{"argName":"file_type","argValue":"jpg"},{"argName":"ttl","argValue":"18"},{"argName":"weight","argValue":"30"}],"functionName":"filetype_based_ttl_set","configId":5068995}]

[{"functionArgs":[{"argName":"domain_name","argValue":"www.example.com"}],"functionName":"set_req_host_header"}]

Éléments de réponse

Élément

Type

Description

Exemple

object

Les paramètres de réponse.

RequestId

string

L'identifiant de la requête.

04F0F334-1335-436C-****-6C044FE73368

Exemples

JSON format

{
  "RequestId": "04F0F334-1335-436C-****-6C044FE73368"
}

Codes d'erreur

Code de statut HTTP

Code d'erreur

Message d'erreur

Description

400 InvalidFunctions.Malformed The specified Functions is incorrectly formatted.
400 InvalidArgValue.Malformed The specified ArgValue is invalid.
400 Invalid%s.ValueNotSupported [%s] is not supported.
400 Invalid%s.Malformed The specified ArgValue [%s] is invalid.
400 MissingParameter%s The specified value of ArgName[%s] is missing.
400 InvalidFunctionArgs.Malformed The specified FunctionArgs is invalid.
400 MissingParameter The specified ArgValue is missing.
400 InvalidHeaderKey.ValueNotSupported The specified value of parameter HeaderKey is not supported.
400 TooManyDomains The count of domain is over 50.
400 InvalidRule.Malformed %s
400 InvalidFunction.NotSupported The domain is not supported to set the function.
400 InvalidDomain.BelongToConfigGroup This Domain activated in configuration group and should modify by config group.
400 EntityNotExist.Role EntityNotExist.Role
400 MissingParameterFunctions The specified value of Functions is missing.
400 NoPermission.SLR The current user does not have permission to create servicelinkedrole. Please contact the Alibaba Cloud account or administrator to authorize AliyunCDNFullAccess or custom policy:Service Name:cdn-ddos.cdn.aliyuncs.com,Role: AliyunServiceRoleForCDNAccessingDDoS,Permission: ram: CreateServiceLinkedRole
400 ConfigExceedLimit Count of config entries exceeds the limit.
400 EdgeScriptCountExceedLimit The number of rules exceeds the default limit (1). To increase the limit, submit a ticket. You can configure only one script. To increase the limit, submit a ticket.
400 EdgeScripOptionsHasInnerConfig The extension has a background configuration or a parameter of this configuration is invalid. For more information, submit a ticket.
400 EdgeScriptGrammarNotSupport A background customization rule exists or a parameter of this configuration is invalid. For more information, submit a ticket.
400 EdgeScriptNotSupportJs JavaScript rules are not supported. For more information, submit a ticket.
400 ServiceInvokeFailed Failed to invoke service.
400 ConfigurationConflicts Failed to modify the parameter settings in the production environment because the parameter settings are different from those in the staging environment. Set parameters in the staging environment before you publish them to the production environment. Failed to modify the parameter settings in the production environment because the parameter settings are different from those in the staging environment. Set parameters in the staging environment before you publish them to the production environment.

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

Notes de version

Consultez Notes de version pour la liste complète.