Tous les produits
Search

Ce produit

    ApsaraVideo VOD:Paramètres de fonctionnalité pour les noms de domaine

    Centre de documentation

    ApsaraVideo VOD:Paramètres de fonctionnalité pour les noms de domaine

    Dernière mise à jour :Aug 10, 2026

    Appelez l'opération BatchSetVodDomainConfigs pour configurer simultanément les fonctionnalités de plusieurs noms de domaine. Les sections suivantes répertorient les fonctionnalités disponibles ainsi que les paramètres associés à chacune d'elles.

    Remarque

    Ces fonctionnalités peuvent être référencées lors de l'appel des opérations API suivantes : BatchSetVodDomainConfigs et DescribeVodDomainConfigs.

    Paramètres de base

    ipv6

    • Configure le protocole IPv6. Pour plus d'informations, consultez la rubrique Configuration du protocole IPv6.

    • Paramètres :

      Paramètre

      Type

      Obligatoire

      Description

      Exemple

      switch

      String

      Oui

      Indique si le protocole IPv6 doit être activé.

      • on

      • off

      on

      region

      String

      Oui

      Région dans laquelle le protocole IPv6 est activé.

      Remarque

      • Vous pouvez saisir un astérisque (*) pour spécifier toutes les régions. Pour activer le protocole IPv6 dans une région spécifique, soumettez un ticket.

      • Si ce paramètre est laissé vide, le protocole IPv6 est activé dans toutes les régions.

      *

    • Exemple de code :

      {
    "Functions": [{
        "functionArgs": [{
            "argName": "switch",
            "argValue": "on"
        }, {
            "argName": "region",
            "argValue": "*"
        }],
        "functionName": "ipv6"
    }],
    "DomainNames": "example.com"
}

    Paramètres de retour à l'origine

    set_req_host_header

    forward_scheme

    • Définissez la politique de protocole d'origine. Pour plus d'informations, consultez la rubrique Configurer la politique de protocole d'origine.

    • Exemple de code :

      {
    "Functions": [{
        "functionArgs": [{
            "argName": "enable",
            "argValue": "on"
        }, {
            "argName": "scheme_origin",
            "argValue": "follow"
        }],
        "functionName": "forward_scheme"
    }],
    "DomainNames": "example.com"
}

    l2_oss_key

    https_origin_sni

    forward_timeout

    advanced_origin

    follow_302

    ipv6_origin

    origin_request_header

    origin_response_header

    back_to_origin_url_rewrite

    • Réécrivez les URL dans les requêtes de retour à l'origine. Pour plus d'informations, consultez la rubrique Réécrire les URL dans les requêtes de retour à l'origine.

    • Paramètres :

      Paramètre

      Type

      Obligatoire

      Description

      Exemple

      source_url

      String

      Oui

      URL à réécrire.

      ^/hello$

      target_url

      String

      Oui

      URL réécrite.

      /hello/test

      flag

      String

      Non

      Indicateur de réécriture. Valeurs valides :

      • None : Le système continue de faire correspondre l'URL avec d'autres règles.

      • break : Le système ignore les règles restantes.

      • enhance_break : Similaire à break, mais écrit également les paramètres d'URL. Prend effet pour la diffusion en direct Flash Video (FLV).

      break

    Paramètres de cache

    filetype_based_ttl_set

    • Définit la durée de vie (TTL) des fichiers. Pour plus d'informations, consultez la section Paramètres de cache.

    path_based_ttl_set

    • Définit la durée de vie (TTL) des répertoires. Pour plus d'informations, consultez la section Paramètres de cache.

    filetype_force_ttl_code

    path_force_ttl_code

    set_resp_header

    error_page

    rewrite_host

    • Active le partage de cache.

    Paramètres HTTPS

    https_option

    • Configure les paramètres HTTPS de base. Seule la version HTTP/2 est prise en charge. Pour plus d'informations, consultez la section Activer HTTP/2.

    • Paramètres :

      Paramètre

      Type

      Obligatoire

      Description

      Exemple

      http2

      String

      Non

      Indique si HTTP/2 doit être activé.

      • on

      • off

      on

    • Exemple de code :

      {
    "Functions": [{
        "functionArgs": [{
            "argName": "http2",
            "argValue": "on"
        }],
        "functionName": "https_option"
    }],
    "DomainNames": "example.com"
}

    http_force

    • Redirige automatiquement les requêtes vers HTTP. Pour plus d'informations, consultez la section Redirection forcée.

      Remarque

      • La redirection automatique vers HTTP entre en conflit avec la redirection automatique vers HTTPS (fonction : https_force). Vous ne pouvez utiliser qu'une seule de ces deux fonctionnalités à la fois.

      • Pour basculer d'une fonctionnalité à l'autre, supprimez d'abord la configuration existante. Vous pouvez appeler l'opération DeleteVodSpecificConfig pour supprimer les configurations d'un nom de domaine. Si le paramètre d'activation d'une fonctionnalité est défini sur off, la fonctionnalité est toujours considérée comme configurée.

    https_force

    • Redirige automatiquement les requêtes vers HTTPS. Pour plus d'informations, consultez la section Redirection forcée.

      Remarque

      • La redirection automatique vers HTTPS entre en conflit avec la redirection automatique vers HTTP (fonction : https_force). Vous ne pouvez utiliser qu'une seule de ces deux fonctionnalités à la fois.

      • Pour basculer d'une fonctionnalité à l'autre, supprimez d'abord la configuration existante. Vous pouvez appeler l'opération DeleteVodSpecificConfig pour supprimer les configurations d'un nom de domaine. Si le paramètre d'activation d'une fonctionnalité est défini sur off, la fonctionnalité est toujours considérée comme configurée.

    https_tls_version

    Paramètres de contrôle d'accès

    referer_white_list_set

    • Configure une liste blanche de Referer. Pour plus d'informations, consultez la rubrique Protection contre le hotlinking.

      Remarque

      • La fonctionnalité de liste blanche de Referer entre en conflit avec la fonctionnalité de liste noire de Referer (fonction : referer_black_list_set). Vous ne pouvez utiliser qu'une seule de ces deux fonctionnalités à la fois.

      • Pour basculer d'une fonctionnalité à l'autre, supprimez d'abord la configuration existante. Appelez l'opération DeleteVodSpecificConfig afin de supprimer les configurations d'un nom de domaine. Si le paramètre d'activation d'une fonctionnalité est défini sur off, celle-ci est toujours considérée comme configurée.

    • Exemple de code :

      {
  "Functions": [
    {
      "functionArgs": [
        {
          "argName": "allow_empty",
          "argValue": "off"
        },
        {
          "argName": "refer_domain_allow_list",
          "argValue": "example.aliyundoc.com,demo.aliyundoc.com"
        },
        {
          "argName": "disable_ast",
          "argValue": "on"
        },
        {
          "argName": "ignore_scheme",
          "argValue": "on"
        },
        {
          "argName": "redirect_url",
          "argValue": "http://www.example.com"
        }
      ],
      "functionName": "referer_white_list_set"
    }
  ],
  "DomainNames": "example.com"
}

    referer_black_list_set

    • Configure une liste noire de Referer. Pour plus d'informations, consultez la rubrique Protection contre le hotlinking.

      Remarque

      • La fonctionnalité de liste noire de Referer entre en conflit avec la fonctionnalité de liste blanche de Referer (fonction : referer_white_list_set). Vous ne pouvez utiliser qu'une seule de ces deux fonctionnalités à la fois.

      • Pour basculer d'une fonctionnalité à l'autre, supprimez d'abord la configuration existante. Appelez l'opération DeleteVodSpecificConfig afin de supprimer les configurations d'un nom de domaine. Si le paramètre d'activation d'une fonctionnalité est défini sur off, celle-ci est toujours considérée comme configurée.

    • Exemple de code :

      {
  "Functions": [
    {
      "functionArgs": [
        {
          "argName": "allow_empty",
          "argValue": "off"
        },
        {
          "argName": "refer_domain_deny_list",
          "argValue": "example.aliyundoc.com,demo.aliyundoc.com"
        },
        {
          "argName": "disable_ast",
          "argValue": "on"
        },
        {
          "argName": "ignore_scheme",
          "argValue": "on"
        },
        {
          "argName": "redirect_url",
          "argValue": "http://www.example.com"
        }
      ],
      "functionName": "referer_black_list_set"
    }
  ],
  "DomainNames": "example.com"
}

    aliauth

    • Configure la signature d'URL. Pour plus d'informations, consultez la rubrique Signature d'URL.

    cdn_remote_auth

    ip_allow_list_set

    • Configure une liste blanche d'adresses IP. Pour plus d'informations, consultez la rubrique Liste noire ou liste blanche d'adresses IP.

      Remarque

      • La fonctionnalité de liste blanche d'adresses IP entre en conflit avec la fonctionnalité de liste noire d'adresses IP (fonction : ip_black_list_set). Vous ne pouvez utiliser qu'une seule de ces deux fonctionnalités à la fois.

      • Pour basculer d'une fonctionnalité à l'autre, supprimez d'abord la configuration existante. Appelez l'opération DeleteVodSpecificConfig afin de supprimer les configurations d'un nom de domaine. Si le paramètre d'activation d'une fonctionnalité est défini sur off, celle-ci est toujours considérée comme configurée.

    • Exemple de code :

      {
  "Functions": [
    {
      "functionArgs": [
        {
          "argName": "ip_list",
          "argValue": "192.168.0.1/24"
        },
        {
          "argName": "ip_acl_xfwd",
          "argValue": "all"
        }
      ],
      "functionName": "ip_allow_list_set"
    }
  ],
  "DomainNames": "example.com"
}

    ip_black_list_set

    • Configure une liste noire d'adresses IP. Pour plus d'informations, consultez la rubrique Liste noire ou liste blanche d'adresses IP.

      Remarque

      • La fonctionnalité de liste noire d'adresses IP entre en conflit avec la fonctionnalité de liste blanche d'adresses IP (fonction : ip_allow_list_set). Vous ne pouvez utiliser qu'une seule de ces deux fonctionnalités à la fois.

      • Pour basculer d'une fonctionnalité à l'autre, supprimez d'abord la configuration existante. Appelez l'opération DeleteVodSpecificConfig afin de supprimer les configurations d'un nom de domaine. Si le paramètre d'activation d'une fonctionnalité est défini sur off, celle-ci est toujours considérée comme configurée.

    • Exemple de code :

      {
  "Functions": [
    {
      "functionArgs": [
        {
          "argName": "ip_list",
          "argValue": "192.168.0.1"
        },
        {
          "argName": "ip_acl_xfwd",
          "argValue": "all"
        }
      ],
      "functionName": "ip_black_list_set"
    }
  ],
  "DomainNames": "example.com"
}

    ali_ua

    Paramètres EdgeScript

    edge_function

    Améliorations des performances

    set_hashkey_args

    • Conserve les paramètres URL. Pour plus d'informations, consultez la rubrique Filtrage des paramètres.

      Remarque

      • La fonction de conservation des paramètres URL entre en conflit avec la fonction de suppression des paramètres URL (fonction : ali_remove_args). Vous ne pouvez utiliser qu'une seule de ces deux fonctions à la fois.

      • Pour basculer d'une fonction à l'autre, supprimez d'abord la configuration existante. Vous pouvez appeler l'opération DeleteVodSpecificConfig pour supprimer les configurations d'un nom de domaine. Si le paramètre d'activation d'une fonction est défini sur off, la fonction est toujours considérée comme configurée.

    ali_remove_args

    • Supprime les paramètres URL. Pour plus d'informations, consultez la rubrique Filtrage des paramètres.

      Remarque

      • La fonction de suppression des paramètres URL entre en conflit avec la fonction de conservation des paramètres URL (fonction : set_hashkey_args). Vous ne pouvez utiliser qu'une seule de ces deux fonctions à la fois.

      • Pour basculer d'une fonction à l'autre, supprimez d'abord la configuration existante. Vous pouvez appeler l'opération DeleteVodSpecificConfig pour supprimer les configurations d'un nom de domaine. Si le paramètre d'activation d'une fonction est défini sur off, la fonction est toujours considérée comme configurée.

    image_transform

    • Configure le traitement des images. Pour plus d'informations, consultez la rubrique Traitement des images.

    Paramètres liés à la vidéo

    range

    video_seek

    • Configure la recherche vidéo. Pour plus d'informations, consultez la rubrique Recherche vidéo.

    • Paramètres :

      Paramètre

      Type

      Obligatoire

      Description

      Exemple

      enable

      String

      Oui

      Indique si la recherche vidéo est activée. Valeurs valides :

      • on

      • off

      on

    • Exemple de code :

      {
    "Functions": [{
        "functionArgs": [{
            "argName": "enable",
            "argValue": "on"
        }],
        "functionName": "video_seek"
    }],
    "DomainNames": "example.com"
}

    ali_video_split

    • Configure l'extraction audio. Pour plus d'informations, consultez la rubrique Extraction audio.

    ali_video_preview

    hls_token_rewrite