Tous les produits
Search

Ce produit

    :BatchSetLiveDomainConfigs

    Centre de documentation

    :BatchSetLiveDomainConfigs

    Dernière mise à jour :Sep 07, 2026

    Configure des noms de domaine par lots.

    Description de l'opération

    Obtenez les noms de domaine de diffusion en direct que vous souhaitez configurer, puis appelez cette opération pour configurer les noms de domaine par lots.

    Limite de QPS

    Le nombre maximal de requêtes par seconde (QPS) par utilisateur pour cette opération est de 30. Si cette limite est dépassée, les appels d'API sont limités, ce qui peut affecter votre activité. Appelez cette opération selon vos besoins.

    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.

    live:BatchSetLiveDomainConfigs

    update

    *Domain.

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

    		 Aucune Aucune

    Paramètres de requête

    Paramètre

    Type

    Requis

    Description

    Exemple
    DomainNames

    string

    Oui

    Les noms de domaine que vous souhaitez configurer par lots. La valeur peut être un domaine d'ingestion, un domaine de diffusion principal ou un domaine de diffusion secondaire. Séparez plusieurs noms de domaine par des virgules (,).

    demo.aliyundoc.com,example.aliyundoc.com,example.com
    Functions

    string

    Oui

    La liste des fonctionnalités.

    Certaines fonctionnalités, telles que filetype_based_ttl_set, prennent en charge plusieurs enregistrements. Pour mettre à jour un enregistrement spécifique, spécifiez le configId de cet enregistrement. Pour plus d'informations, consultez les tableaux Description du format des fonctions et Description des fonctionnalités des fonctions ci-dessous.

    [{"functionArgs":[{"argName":"file_type","argValue":"jpg"},{"argName":"ttl","argValue":"18"},{"argName":"weight","argValue":"30"}],"functionName":"filetype_based_ttl_set","configId":506***}]
    DryRun

    boolean

    Non

    Indique si un test à blanc uniquement doit être effectué sans exécuter réellement l'opération. Valeurs valides :

    • true : envoie une requête de test à blanc. L'opération n'est pas réellement exécutée après la réussite de la validation de la requête.

    • false (par défaut) : envoie une requête normale. L'opération est réellement exécutée après la réussite de la validation de la requête.

    Le test à blanc valide la validité des paramètres, les autorisations RAM et l'état des ressources. Si le test à blanc échoue, le code d'erreur correspondant est renvoyé. Si le test à blanc réussit, l'opération n'est pas réellement exécutée.

    false

    Description du format des fonctions

    • Exemple : [{"functionArgs":[{"argName":"domain_name","argValue":"developer.aliyundoc.com"}],"functionName":"set_req_host_header"}]

    • Certaines fonctionnalités, telles que filetype_based_ttl_set, prennent en charge plusieurs enregistrements. Pour mettre à jour un enregistrement spécifique, spécifiez le configId de cet enregistrement. Exemple : [{"functionArgs":[{"argName":"file_type","argValue":"jpg"},{"argName":"ttl","argValue":"18"},{"argName":"weight","argValue":"30"}],"functionName":"filetype_based_ttl_set","configId":506***}]

    Description des fonctionnalités des fonctions

    NomParamètres
    referer_white_list_set : Liste blanche Referer.refer_domain_allow_list : La liste blanche. Séparez les valeurs multiples par des virgules (,).
    allow_empty : Indique si un Referer vide est autorisé. Valeurs valides : on ou off.

    referer_black_list_set : Liste noire Referer.refer_domain_deny_list : La liste noire. Séparez les valeurs multiples par des virgules (,).
    allow_empty : Indique si un Referer vide est autorisé. Valeurs valides : on ou off.

    filetype_based_ttl_set : Paramètres de délai d'expiration des fichiers.ttl : Le temps de mise en cache. Unité : secondes. Valeurs valides : 1 à 99999999 (un peu plus de 3 ans).
    file_type : Le type de fichier. Séparez les valeurs multiples par des virgules (,).
    weight : Le poids. Valeurs valides : 1 à 99.




    path_based_ttl_set : Paramètres de délai d'expiration des répertoires.ttl : Le temps de mise en cache. Unité : secondes. Valeurs valides : 1 à 99999999 (un peu plus de 3 ans).
    path : Le répertoire. Il doit commencer par une barre oblique (/).
    weight : Le poids. Valeurs valides : 1 à 99.




    oss_auth : Bucket d'authentification OSS.oss_bucket_id : L'adresse du bucket utilisateur.
    ip_black_list_set : Liste noire IP.ip_list : La liste IP. Séparez les valeurs multiples par des virgules (,).
    ip_allow_list_set : Liste blanche IP.ip_list : La liste IP. Séparez les valeurs multiples par des virgules (,).
    ip_white_list_set : Exemption de contrôle de fréquence d'accès.ip_list : La liste IP. Séparez les valeurs multiples par des virgules (,).
    error_page : Redirection de page d'erreur.error_code : Le code d'erreur.
    rewrite_page : La page de redirection.

    set_req_host_header : Modifie l'en-tête d'hôte de retour à l'origine.domain_name : Le contenu de l'en-tête d'hôte de retour à l'origine.
    set_hashkey_args : Ignore les paramètres d'URL.hashkey_args : La liste des paramètres à conserver. Séparez les valeurs multiples par des virgules (,).
    disable : Indique s'il faut ignorer tous les paramètres. Valeurs valides : on (ignorer tous les paramètres) ou off (ne pas ignorer).

    aliauth : Authentification Alibaba Cloud.auth_type : Le type d'authentification. Valeurs valides : type_a (type d'authentification A), no_auth (désactiver l'authentification).
    auth_key1 : Clé d'authentification 1. La clé prend en charge les lettres majuscules, les lettres minuscules et les chiffres. Nous vous recommandons de définir une longueur de 8 à 32 caractères.
    auth_key2 : Clé d'authentification 2.
    ali_auth_delta : Le temps de tampon d'authentification personnalisé. Unité : secondes. Nous recommandons une valeur minimale de 60 secondes. Il n'y a pas de limite supérieure.
    auth_m3u8 : Indique s'il faut activer la réécriture de contenu M3U8, qui ajoute des informations d'authentification aux segments TS dans le fichier M3U8 pour éviter les échecs d'authentification d'accès TS. Valeurs valides : on (par défaut) ou off.










    remote_auth : Authentification à distance des flux en direct.enable : Indique si l'authentification à distance doit être activée. Ce paramètre est requis. Valeurs valides : on ou off.
    remote_auth_path : L'adresse du serveur d'authentification. Ce paramètre est requis.
    remote_auth_pattern : La chaîne du mode d'authentification. Les paramètres suivants sont disponibles :
    - param : Indique si les paramètres de l'URL d'ingestion doivent être transmis au serveur d'authentification. Valeurs valides : pass (par défaut) ou fail.
    - args_white : Les paramètres spécifiés à transmettre. Séparez les paramètres multiples par des virgules (,).
    - args_black : Les paramètres spécifiés à ne pas transmettre. Séparez les paramètres multiples par des virgules (,).
    - code : Le code d'état d'authentification. code=XXX spécifie le code d'état HTTP renvoyé par le serveur d'authentification à ApsaraVideo Live en cas d'authentification réussie. Exemple : code=200. code=~XXX spécifie le code d'état HTTP renvoyé en cas d'échec de l'authentification. Exemple : code=~403.
    - delta : Le délai d'attente de l'authentification.
    - retry : Le nombre de tentatives en cas de délai d'attente de l'authentification.
    - timeout : Le comportement en cas de délai d'attente de l'authentification. Valeurs valides : pass ou fail. pass : ApsaraVideo Live transmet directement la requête de l'utilisateur. fail : ApsaraVideo Live répond avec le code d'état d'échec de l'authentification (403) à l'utilisateur.
    - async : Authentification asynchrone. Valeurs valides : on (activer l'authentification asynchrone) ou off (par défaut, désactiver l'authentification asynchrone).




























    set_resp_header : Définit les en-têtes de réponse (visibles côté navigateur).key : L'en-tête de réponse. Valeurs valides :
    Content-Type.
    Cache-Control.
    Content-Disposition.
    Content-Language.
    Expires.
    Access-Control-Allow-Origin.
    Access-Control-Allow-Methods.
    Access-Control-Allow-Headers.
    Access-Control-Max-Age.
    Access-Control-Expose-Headers.
    value : Le contenu de l'en-tête de réponse. Définissez cette valeur sur null pour supprimer l'en-tête.

































    https_force : Force la redirection HTTPS.enable : Le commutateur de fonctionnalité. Valeurs valides : on ou off. https_force et http_force sont mutuellement exclusifs. Un seul peut exister à la fois. Pour configurer l'autre, supprimez d'abord la configuration existante.
    http_force : Force la redirection HTTP.enable : Le commutateur de fonctionnalité. Valeurs valides : on ou off. https_force et http_force sont mutuellement exclusifs. Un seul peut exister à la fois. Pour configurer l'autre, supprimez d'abord la configuration existante.
    forward_scheme : Retour à l'origine adaptatif.enable : Le commutateur de fonctionnalité. Valeurs valides : on ou off.
    scheme_origin : Le protocole de retour à l'origine (http, https ou follow).
    scheme_origin_port : Le port du protocole de retour à l'origine (80, 443 ou 80:443).




    green_manager : Modération de contenu.enable : Indique si la modération de contenu doit être activée. Valeurs valides : on ou off.
    tmd_signature : Règles personnalisées de contrôle de fréquence d'accès.name : Le nom de la règle. Il doit être unique au sein du domaine.
    path : Peut être répété. La validité du chemin URI est vérifiée.
    pathType : La règle de correspondance. 0 : correspondance de préfixe. 1 : correspondance exacte.
    interval : La durée de surveillance. Unité : secondes. La valeur doit être ≥ 10.
    count : Le nombre de visites à partir d'une seule adresse IP.
    action : Le type de blocage. 0 : bloquer. 1 : identification homme-machine.
    ttl : La durée de blocage. Unité : secondes.
















    l2_oss_key : Clé privée de retour à l'origine OSS L2.private_oss_auth : Indique si l'authentification OSS privée doit être activée. Valeurs valides : on ou off.
    video_seek : Commutateur de recherche de segments vidéo.enable : Le commutateur de fonctionnalité. Valeurs valides : on ou off.
    gzip : Optimisation Gzip des pages.enable : Le commutateur de fonctionnalité. Valeurs valides : on ou off.
    tesla : Accélération de l'optimisation des pages.enable : Le commutateur de fonctionnalité. Valeurs valides : on ou off.
    ali_ua : Restriction d'accès User-Agent.ua : Le User-Agent.
    type : Le type de liste. Valeurs valides : black ou white.

    host_redirect : Fonctionnalité de réécriture.regex : L'URL à réécrire. Exemple : ^/$.
    replacement : L'URL cible. Exemple : /go/act/sale/tbzlsy.php.
    flag : Seuls redirect ou break sont pris en charge.




    ipv6 : Configuration IPv6.switch : Le commutateur (requis). Valeurs valides : on ou off. Une fois activé, pour le désactiver, désélectionnez l'option au lieu de supprimer la configuration. Sinon, la modification ne prend pas effet.
    region : La région où IPv6 est activé. Valeurs valides : cn-beijing (Pékin), cn-shanghai (Shanghai), cn-shenzhen (Shenzhen), cn-qingdao (Qingdao), apsoutheast-1 (Singapour), eu-central-1 (Allemagne), ap-northeast-1 (Tokyo), ap-southeast-5 (Jakarta).

    ali_location : Restriction d'accès basée sur la région.location : La liste des régions.
    type : Le type de liste. Valeurs valides : black ou white.

    cc_defense : Protection anti-CC.enable : Active ou désactive la protection contre les attaques CC. Valeurs valides : on ou off.
    alilive : Configuration ApsaraVideo Live.notify_url : L'URL de notification de flux en direct.
    enable : Le commutateur de fonctionnalité. Valeurs valides : on ou off.
    live_forbid_flv : Indique si la lecture FLV doit être interdite. Valeurs valides : on ou off.
    live_forbid_rtmp : Indique si la lecture RTMP doit être interdite. Valeurs valides : on ou off.
    live_forbid_hls : Indique si la lecture HLS doit être interdite. Valeurs valides : on ou off.










    ali_grtn : Commutateur d'accès au service GRTN.grtn_rts_pub : Le commutateur d'ingestion de flux RTS, utilisé pour les domaines d'ingestion. Valeurs valides : on ou off.
    grtn_rts_play : Le commutateur de diffusion RTS, utilisé pour les domaines de diffusion. Valeurs valides : on ou off.
    grtn_rts_transcode : Le commutateur de transcodage automatique pour la lecture RTS H5. Valeurs valides : on ou off.




    edge_function : Fonction edge.Paramètres requis :
    rule : La règle DSL.
    pri : La priorité.
    enable : Indique si cette règle prend effet. Valeurs valides : on ou off.
    Paramètres facultatifs :
    name : Le nom de la règle.
    pos : La position d'exécution de la règle.
    brk : Si cette règle est atteinte, les règles restantes à la position d'exécution actuelle sont ignorées.
    option : Le contrôle d'option.
    grammar : Le contrôle de grammaire. Valeurs valides : empty, es2 ou js.
    jsmode : Le contrôle de liste blanche de domaine JS. Valeurs valides : redirect ou bypass.




























    https_tls_version : Version du protocole TLS.tls10 : Active TLSv1.0. Valeur par défaut : on. Valeurs valides : on ou off.
    tls11 : Active TLSv1.1. Valeur par défaut : on. Valeurs valides : on ou off.
    tls12 : Active TLSv1.2. Valeur par défaut : on. Valeurs valides : on ou off.
    tls13 : Active TLSv1.3. Valeur par défaut : on. Valeurs valides : on ou off.







    https_option : Paramètres du protocole HTTP.http2 : Indique si HTTP/2 doit être activé. Valeur par défaut : off. Valeurs valides : on ou off.
    live_http2 : Indique si live_http2 doit être activé. Valeur par défaut : off. Valeurs valides : on ou off.

    Éléments de réponse

    Élément

    Type

    Description

    Exemple

    object

    RequestId

    string

    L'identifiant de la requête.

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

    Exemples

    JSON format

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

    Codes d'erreur

    Code de statut HTTP

    Code d'erreur

    Message d'erreur

    Description
    400 InvalidFunctions.Malformed Specified Functions is malformed.
    400 InvalidFunctionArgs.Malformed The specified FunctionArgs is invalid.
    400 InvalidArgValue.Malformed Specified ArgValue is malformed.
    400 Invalid%s.ValueNotSupported FunctionName [%s] is not supported.
    400 Invalid%s.Malformed ArgValue [%s] is malformed.
    400 MissingParameter%s The specified value of ArgName[%s] is missing.
    400 FunctionMutex Function is mutex with other function.
    400 RewriteHostRely Domain name is configured as rewrite host by others.
    400 ConfigurationConflicts The staging environment has a configuration in effect and cannot modify the production environment configuration. L'environnement de déploiement canari possède des configurations actives. Vous ne pouvez pas modifier la configuration de l'environnement de production.

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

    Notes de version

    Consultez Notes de version pour la liste complète.