すべてのプロダクト
Search
ドキュメントセンター

:BatchSetLiveDomainConfigs

最終更新日:Jan 12, 2026

一度に複数のドメイン名を設定します。

操作説明

設定するドメイン名を取得し、この操作を呼び出してドメイン名を一括で設定します。

QPS 制限

この操作は、アカウントごとに毎秒 30 回まで呼び出すことができます。 この制限を超えたリクエストはドロップされ、サービス中断が発生します。 この操作を呼び出す際は、この制限に注意することを推奨します。

今すぐお試しください

この 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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

live:BatchSetLiveDomainConfigs

update

*Domain

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

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

DomainNames

string

必須

一括設定するドメイン名。 サポートされているドメイン名には、アップストリーミングドメイン、メインストリーミングドメイン、サブストリーミングドメインが含まれます。 複数のドメイン名はコンマ (,) で区切ります。

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

Functions

string

必須

機能のリストです。

filetype_based_ttl_set などの一部の機能は、複数の構成レコードをサポートします。 構成レコードの 1 つを更新するには、configId を使用してレコードを識別します。 詳細については、Functions パラメーターのフォーマットおよび Functions パラメーターで指定される機能をご参照ください。

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

Functions パラメーターのフォーマット

  • 例: [{"functionArgs":[{"argName":"domain_name","argValue":"developer.aliyundoc.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":506***}]

Functions パラメーターで指定される機能

機能属性
referer_white_list_set:Referer ホワイトリストを指定します。refer_domain_allow_list:ホワイトリストに追加する Referer。 複数の Referer はコンマ (,) で区切ります。allow_empty:空の Referer を許可するかどうかを指定します。 有効な値:on および off
referer_black_list_set:Referer ブラックリストを指定します。refer_domain_deny_list:ブラックリストに追加する Referer。 複数の Referer はコンマ (,) で区切ります。allow_empty:空の Referer を許可するかどうかを指定します。 有効な値:on および off
filetype_based_ttl_set:ファイルの有効期限が切れるまでの期間を指定します。ttl:キャッシュ期間。 単位:秒。 有効な値:1~99999999 (3 年以上)。file_type:ファイルタイプ。 複数のファイルタイプはコンマ (,) で区切ります。weight:ファイルタイプの重み。 有効な値:1~99
path_based_ttl_set:ディレクトリの有効期限が切れるまでの期間を指定します。ttl:キャッシュ期間。 単位:秒。 有効な値:1~99999999 (3 年以上)。path:ディレクトリ。スラッシュ (/) で始まる必要があります。weight:ディレクトリの重み。 有効な値:1~99
oss_auth:Object Storage Service (OSS) バケットへのアクセスを認証します。oss_bucket_id:ご利用の OSS バケットのパス。
ip_black_list_set:IP アドレスブラックリストを指定します。ip_list:ブラックリストに追加する IP アドレス。 複数の IP アドレスはコンマ (,) で区切ります。
ip_allow_list_set:IP アドレスホワイトリストを指定します。ip_list:ホワイトリストに追加する IP アドレス。 複数の IP アドレスはコンマ (,) で区切ります。
ip_white_list_set:レート制限用の IP アドレスホワイトリストを指定します。ip_list:ホワイトリストに追加する IP アドレス。 複数の IP アドレスはコンマ (,) で区切ります。
error_page:エラーページを指定されたページにリダイレクトします。error_code:エラーコード。rewrite_page:エラーページのリダイレクト先ページ。
set_req_host_header:back-to-origin リクエストの Host ヘッダーを変更します。domain_name:back-to-origin リクエストの Host ヘッダー。
set_hashkey_args:指定された URL パラメーターを無視します。hashkey_args:保持するパラメーター。 複数のパラメーターはコンマ (,) で区切ります。disable:すべてのパラメーターを無視するかどうかを指定します。 有効な値:on および off。 on の値は、すべてのパラメーターが無視されることを指定します。 off の値は、どのパラメーターも無視されないことを指定します。
aliauth:Alibaba Cloud 認証を設定します。auth_type:認証タイプ。 有効な値:type_a および no_auth。 type_a の値は、認証タイプ A が有効であることを指定します。 no_auth の値は、認証が無効であることを指定します。auth_key1:プライマリ認証キー。 認証キーには文字と数字を含めることができます。 認証キーは 8~32 文字の値に設定することを推奨します。auth_key2:セカンダリ認証キー。ali_auth_delta:認証用のカスタムバッファー時間。 単位:秒。 値は 60 秒以上に設定することを推奨します。auth_m3u8:M3U8 再書き込みを有効にするかどうかを指定します。 M3U8 再書き込みを有効にすると、システムは M3U8 プレイリスト内の TS セグメントの認証を完了し、TS セグメントへのアクセス失敗を防ぎます。 有効な値:on (デフォルト) および off
remote_auth:ライブストリーミングのリモート認証を設定します。enable:リモート認証を有効にするかどうかを指定します。 この属性は必須です。 有効な値:on および off。remote_auth_path:認証サーバのアドレス。 この属性は必須です。remote_auth_pattern:認証モード。 次のフィールドが利用可能です:- param:アップストリーミング URL のパラメーターを認証サーバに渡すかどうかを指定します。 有効な値:pass (デフォルト) および fail。- args_white:渡したいパラメーター。 複数のパラメーターはコンマ (,) で区切ります。- args_black:渡したくないパラメーター。 複数のパラメーターはコンマ (,) で区切ります。- code:HTTP ステータスコード。 認証が成功すると、認証サーバから ApsaraVideo Live に code=XXX の形式の値が返されます。 例:code=200。 認証が失敗すると、認証サーバから ApsaraVideo Live に code=~XXX の形式の値が返されます。 例:code=~403。- delta:認証のタイムアウト期間。- retry:認証タイムアウト時のリトライ回数。- timeout:認証タイムアウト時に実行する操作。 有効な値:pass および failpass:ApsaraVideo Live はリクエストを渡します。 fail:ApsaraVideo Live は失敗を示す HTTP ステータスコード 403 を返します。- async:非同期認証を有効にするかどうかを指定します。 有効な値:on および off (デフォルト)。
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_force:HTTPS への強制リダイレクトを設定します。enable:この機能を有効にするかどうかを指定します。 有効な値:on および off。 https_force 機能と http_force 機能は相互排他です。 両方を設定することはできません。 いずれかの機能を設定している場合は、もう一方の機能を設定する前にそれを削除する必要があります。
http_force:HTTP への強制リダイレクトを設定します。enable:この機能を有効にするかどうかを指定します。 有効な値:on および off。 https_force 機能と http_force 機能は相互排他です。 両方を設定することはできません。 いずれかの機能を設定している場合は、もう一方の機能を設定する前にそれを削除する必要があります。
forward_scheme:適応型 back-to-origin を設定します。enable:この機能を有効にするかどうかを指定します。 有効な値:on および offscheme_origin:オリジンのプロトコル。 有効な値:http、https、および follow。scheme_origin_port:オリジンのポート番号。 有効な値:80、443、および 80:443。
green_manager:ポルノ検出を設定します。enable:ポルノ検出を有効にするかどうかを指定します。 有効な値:on および off
tmd_signature:カスタムレート制限ルールを設定します。name:ルールの名前。グローバルで一意である必要があります。path:URI (Uniform Resource Identifier)。 重複した URI を指定できますが、その有効性を検証する必要があります。pathType:一致ルール。 有効な値:0 および 1。 0 の値はプレフィックス一致を指定します。 1 の値は完全に一致を指定します。interval:データが監視される間隔。 単位:秒。 間隔は 10 秒以上である必要があります。count:IP アドレスからの訪問回数。action:指定された条件が満たされた後に実行する操作。 有効な値:0 および 1。 0 の値はアクセスがブロックされることを指定します。 1 の値はボット検出が実行されることを指定します。ttl:アクセスがブロックされる期間。 単位:秒。
l2_oss_key:L2 ノードから非公開 OSS バケットへの back-to-origin リクエストに対する秘密鍵認証を設定します。private_oss_auth:非公開 OSS バケットへのアクセスを認証するかどうかを指定します。 有効な値:on および off
video_seek:シーク再生を設定します。enable:この機能を有効にするかどうかを指定します。 有効な値:on および off
gzip:Gzip 圧縮を設定します。enable:この機能を有効にするかどうかを指定します。 有効な値:on および off
tesla:アクセスを高速化するためのページ最適化を設定します。enable:この機能を有効にするかどうかを指定します。 有効な値:on および off
ali_ua:User-Agent ベースのアクセスの制御を設定します。ua:User-Agent。type:リストのタイプ。 有効な値:black および white
host_redirect:URL 再書き込みを設定します。regex:再書き込みされる URL。 例:^/$.replacement:宛先 URL。 例:/go/act/sale/tbzlsy.php。flag:フラグ。 有効な値:redirect および break。
ipv6:IPv6 を設定します。switch:IPv6 を有効にするかどうかを指定します。 この属性は必須です。 有効な値:on および off。 この機能が有効になった後に無効にしたい場合は、コンソールでこの機能の選択を解除してください。 設定を削除しないでください。削除すると、機能は有効のままになります。region:IPv6 を有効にしたいリージョン。 有効な値:cn-beijing、cn-shanghai、cn-shenzhen、cn-qingdao、apsoutheast-1、eu-central-1、ap-northeast-1、および ap-southeast-5。それぞれ中国 (北京)、中国 (上海)、中国 (深セン)、中国 (青島)、シンガポール、ドイツ (フランクフルト)、日本 (東京)、インドネシア (ジャカルタ) を示します。
ali_location:リージョンベースのアクセスの制御を設定します。location:リージョン。type:リストのタイプ。 有効な値:black および white
cc_defense:HTTP フラッド攻撃に対する保護を設定します。enable:HTTP フラッド攻撃に対する保護を有効にするかどうかを指定します。 有効な値:on および off
alilive:ライブストリーミング設定を設定します。notify_url:ApsaraVideo Live からの通知を受信するための URL。enable:この機能を有効にするかどうかを指定します。 有効な値:on および offlive_forbid_flv:Flash Video (FLV) の再生を禁止するかどうかを指定します。 有効な値:on および offlive_forbid_rtmp:リアルタイムメッセージングプロトコル (RTMP) ビデオの再生を禁止するかどうかを指定します。 有効な値:on および offlive_forbid_hls:HTTP Live Steaming (HLS) ビデオの再生を禁止するかどうかを指定します。 有効な値:on および off
ali_grtn:Global Realtime Transport Network (GRTN) に接続するかどうかを指定します。grtn_rts_pub:リアルタイムストリーミング (RTS) 経由のアップストリーミングを有効にするかどうかを指定します。 この属性はアップストリーミングドメインに適用されます。 有効な値:on および offgrtn_rts_play:RTS 経由のストリーミングを有効にするかどうかを指定します。 この属性はストリーミングドメインに適用されます。 有効な値:on および offgrtn_rts_transcode:RTS ベースの HTML5 再生のための自動トランスコードを有効にするかどうかを指定します。 有効な値:on および off
edge_function:エッジ関数を設定します。必須属性:rule:DSL (Domain-Specific Language) ルール。pri:ルールの優先度。enable:ルールを有効にするかどうかを指定します。 有効な値:on および off。オプション属性:name:ルールの名前。pos:ルールを実行する位置。brk:ルールがヒットした後、指定された位置以降のルールはスキップされます。option:オプション。grammar:文法。 有効な値:es2 および js。 この属性を空にすることもできます。jsmode:JavaScript でドメイン名ホワイトリストを管理するモード。 有効な値:redirect および bypass
https_tls_version:Transport Layer Security (TLS) プロトコルのバージョンを設定します。tls10:TLS 1.0 を有効にするかどうかを指定します。 デフォルト値:on。 有効な値:on および offtls11:TLS 1.1 を有効にするかどうかを指定します。 デフォルト値:on。 有効な値:on および offtls12:TLS 1.2 を有効にするかどうかを指定します。 デフォルト値:on。 有効な値:on および offtls13:TLS 1.3 を有効にするかどうかを指定します。 デフォルト値:on。 有効な値:on および off
https_option:HTTP 設定を設定します。http2:HTTP/2 を有効にするかどうかを指定します。 デフォルト値:off。 有効な値:on および offlive_http2:live_http2 を有効にするかどうかを指定します。 デフォルト値:off。 有効な値:on および off

レスポンスフィールド

フィールド

説明

object

RequestId

string

リクエスト ID。

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

成功レスポンス

JSONJSON

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

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

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.

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

変更履歴

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