すべてのプロダクト
Search

このプロダクト

    :BatchSetVodDomainConfigs

    ドキュメントセンター

    :BatchSetVodDomainConfigs

    最終更新日:Dec 15, 2025

    1 つ以上の CDN ドメイン名を設定します。

    操作説明

    説明

    この操作は、中国 (上海) リージョンでのみ利用可能です。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    vod:BatchSetVodDomainConfigs

    update

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    DomainNames

    string

    必須

    CDN のドメイン名。複数のドメイン名をコンマ (,) で区切ります。

    example.com
    Functions

    string

    必須

    設定する機能。

    • このパラメーターは、次の形式で設定します：[{"functionArgs":[{"argName":"domain_name","argValue":"www.example.com"}],"functionName":"set_req_host_header"}]。

    • filetype_based_ttl_set などの特定の機能は、複数の設定レコードをサポートします。設定レコードの 1 つを更新するには、configId フィールドを使用してレコードを指定します。[{"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"}]

    機能の説明

    すべてのパラメーター値は文字列型です。

    機能説明パラメーター
    referer_white_list_setreferer ホワイトリストを指定します。refer_domain_allow_list：ホワイトリストに追加する referer。複数の referer をコンマ (,) で区切ります。

    allow_empty：空の referer を許可するかどうかを指定します。有効値：on と off。

    referer_black_list_setreferer ブラックリストを指定します。refer_domain_deny_list：ブラックリストに追加する referer。複数の referer をコンマ (,) で区切ります。

    allow_empty：空の referer を許可するかどうかを指定します。有効値：on と off。

    filetype_based_ttl_setファイルの有効期限が切れるまでの期間を指定します。ttl：キャッシュされたコンテンツの有効期限。単位：秒。

    file_type：ファイルタイプ。複数のファイルタイプをコンマ (,) で区切ります。例：txt,jpg。

    weight：キャッシュ内のファイルの重み。有効値：1～199。



    path_based_ttl_setディレクトリの有効期限が切れるまでの期間を指定します。ttl：キャッシュされたコンテンツの有効期限。単位：秒。

    path：ディレクトリ。先頭にスラッシュ (/) を付ける必要があります。

    weight：キャッシュ内のディレクトリの重み。有効値：1～99。



    oss_authObject Storage Service (OSS) バケットへのアクセスの認証を設定します。oss_bucket_id：バケットの ID。
    ip_black_list_setIP アドレスブラックリストを指定します。ip_list：ホワイトリストに追加する IP アドレス。複数の IP アドレスをコンマ (,) で区切ります。
    ip_allow_list_setIP アドレスホワイトリストを指定します。ip_list：ホワイトリストに追加する IP アドレス。複数の IP アドレスをコンマ (,) で区切ります。
    ip_white_list_setレート制限の自己定義ルールを指定します。ip_list：ホワイトリストに追加する IP アドレス。複数の IP アドレスをコンマ (,) で区切ります。
    error_pageエラーページを指定されたページにリダイレクトします。error_code：エラーコード。

    rewrite_page：エラーページのリダイレクト先ページ。

    set_req_host_headerback-to-origin リクエストのカスタムヘッダーを変更します。domain_name：back-to-origin リクエストのカスタムホストヘッダー。
    set_hashkey_args指定された URL パラメーターを無視します。hashkey_args：予約するパラメーター。複数のパラメーターをコンマ (,) で区切ります。

    disable：すべてのパラメーターを無視するかどうかを指定します。値 on はすべてのパラメーターが無視されることを示します。値 off はどのパラメーターも無視されないことを示します。

    aliauthAlibaba Cloud 認証を設定します。auth_type：認証タイプ。有効値：no_auth、type_a、type_b、type_c。

    auth_key1：プライマリ認証キー。

    auth_key2：セカンダリ認証キー。

    ali_auth_delta：認証用のカスタムバッファー時間。

    ali_auth_remote_desc：パターンマッチング文字列。







    set_resp_headerレスポンスヘッダーを指定します。設定を検証するには、ブラウザでレスポンスメッセージを確認します。key：レスポンスヘッダーの名前。有効値：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：レスポンスヘッダーのコンテンツ。ヘッダーを削除する場合は、null と入力します。

    https_forceHTTPS への強制リダイレクトを設定します。enable：HTTPS への強制リダイレクトを有効にするかどうかを指定します。有効値：on と off。
    http_forceHTTP への強制リダイレクトを設定します。enable：HTTP への強制リダイレクトを有効にするかどうかを指定します。有効値：on と off。
    l2_oss_keyL2 ノードからプライベート OSS バケットへの back-to-origin リクエストの秘密鍵認証を設定します。private_oss_auth：プライベート OSS バケットへのアクセスを認証するかどうかを指定します。有効値：on と off。
    green_managerポルノ検出を設定します。enable：ポルノ検出を有効にするかどうかを指定します。有効値：on と off。
    rangeオブジェクトチャンキングを設定します。enable：オブジェクトチャンキングを有効にするかどうかを指定します。有効値：on、off、force。
    video_seekシーク再生を設定します。enable：シーク再生を有効にするかどうかを指定します。有効値：on と off。
    set_hashkey_args指定された URL パラメーターを無視します。hashkey_args：予約するパラメーター。複数のパラメーターをコンマ (,) で区切ります。

    disable：すべてのパラメーターを無視するかどうかを指定します。値 on はすべてのパラメーターが無視されることを示します。値 off はどのパラメーターも無視されないことを示します。

    tmd_signatureレート制限の自己定義ルールを指定します。name：ルールの名前。ドメイン名内で一意である必要があります。

    path：URI パス。重複した URI パスを指定できます。ただし、その有効性を検証する必要があります。

    pathType：マッチング ルール。有効値：0 と 1。値 0 はプレフィックスマッチを示します。値 1 は完全一致を示します。

    interval：データが監視される間隔。単位：秒。間隔は 10 秒以上である必要があります。

    count：IP アドレスからのアクセス数。

    action：指定された条件が満たされた後に実行される操作。有効値：0 と 1。値 0 はブロックを示します。値 1 はボット検出を示します。

    ttl：アクセスがブロックされる期間。単位：秒。











    ali_businessカスタム機能を設定します。ali_business_type：必須。ビジネスタイプ。

    ali_business_table：パターンマッチング文字列。

    hls_token_rewriteM3U8 の暗号化と書き換えを設定します。enable：必須。M3U8 の暗号化と書き換えを有効にするかどうかを指定します。有効値：on と off。

    hls_token_arg_name：追加されるパラメーターの名前。名前を指定しない場合、パラメーター名 MtsHlsUriToken が使用されます。

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエスト ID。

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

    例

    成功レスポンス

    JSONJSON

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

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    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.
    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.

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。