すべてのプロダクト
Search

このプロダクト

    Edge Security Acceleration:DescribeDcdnDomainConfigs

    ドキュメントセンター

    Edge Security Acceleration:DescribeDcdnDomainConfigs

    最終更新日:Jun 10, 2026

    DescribeDcdnDomainConfigs を呼び出して、アクセラレーションドメイン名のコンフィグレーションを取得します。

    操作説明

    説明

    • 1 回のリクエストで複数の機能のコンフィグレーションをクエリできます。

    • 1 ユーザーあたりのリクエストレート制限は 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 ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    dcdn:DescribeDcdnDomainConfigs

    get

    domain

    acs:dcdn:*:{#accountId}:domain/{#domainName}

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    DomainName

    string

    必須

    アクセラレーションドメイン名。一度に1つのドメイン名のみクエリできます。

    example.com
    FunctionNames

    string

    任意

    機能の名前。複数の機能名はカンマ (,) で区切ります。

    filetype_based_ttl_set,set_req_host_header
    ConfigId

    string

    任意

    コンフィグレーションID。

    5003576

    次の表は機能について説明しています。

    名前パラメーター
    referer_white_list_set: Referer ホットリンク保護ホワイトリストrefer_domain_allow_list: ホワイトリスト。複数のドメイン名はカンマ (,) で区切ります。
    allow_empty: 空の Referer ヘッダーを持つリクエストが DCDN リソースにアクセスすることを許可するかどうかを指定します。有効な値: on および off。
    referer_black_list_set: Referer ホットリンク保護ブラックリストrefer_domain_deny_list: ブラックリスト。複数のドメイン名はカンマ (,) で区切ります。
    allow_empty: 空の Referer ヘッダーを持つリクエストが DCDN リソースにアクセスすることを許可するかどうかを指定します。有効な値: on および off。
    filetype_based_ttl_set: ファイルタイプに基づく Time-to-Live (TTL) の構成ttl: キャッシュ期間。単位: 秒。
    file_type: ファイルタイプ。複数のファイルタイプはカンマ (,) で区切ります (例: TXT,JPG)。
    weight: 重み。
    path_based_ttl_set: パスに基づく TTL の構成ttl: キャッシュ期間。単位: 秒。
    path: パス。パスはスラッシュ (/) で始まる必要があります。
    weight: 重み。
    oss_auth: バケットの OSS 認証oss_bucket_id: バケットの URL。
    ip_black_list_set: IP アドレスブラックリストip_list: IP アドレスのリスト。複数の IP アドレスはカンマ (,) で区切ります。
    ip_allow_list_set: IP アドレスホワイトリストip_list: IP アドレスのリスト。複数の IP アドレスはカンマ (,) で区切ります。
    error_page: エラーページのリダイレクトerror_code: エラーコード。
    rewrite_page: リダイレクトページ。
    set_req_host_header: カスタムオリジン回帰 Host ヘッダーの変更domain_name: オリジン回帰 Host ヘッダーの内容。
    set_hashkey_args: URL パラメーターを無視hashkey_args: 保持するパラメーターのリスト。複数のパラメーターはカンマ (,) で区切ります。最大 10 個のパラメーターを指定できます。
    disable: すべてのパラメーターを無視するには on に、無視しないには off に設定します。キャッシュキー内のすべてのパラメーターを無視することは、特定のパラメーターを保持することよりも優先度が低くなります。
    keep_oss_args: オリジン回帰リクエストのすべてのパラメーターを保持するには on に、キャッシュキーと同じパラメーターを使用するには off に設定します。
    aliauth: Alibaba Cloud 認証auth_type: 認証タイプ。no_auth: 認証なし。type_a: 認証方法 A。type_b: 認証方法 B。type_c: 認証方法 C。
    auth_key1: 認証キー 1。auth_key2: 認証キー 2。
    ali_auth_delta: カスタム認証猶予期間。
    set_resp_header: HTTP レスポンスヘッダーの設定 (ブラウザに表示)key (必須): レスポンスヘッダー。
    value (必須): レスポンスヘッダーの内容。ヘッダーを削除するには、これを null に設定します。
    header_operation_type: リクエストヘッダーに対する操作。有効な値: add、delete、modify、および rewrite。
    duplicate: 重複を許可するかどうかを指定します。有効な値: on または off。
    header_source: 検索するヘッダー。
    header_destination: 置換するヘッダー。
    match_all: すべて一致させるかどうかを指定します。有効な値: on または off。
    https_force: HTTPS 強制リダイレクトenable: 機能のスイッチ。有効な値: on または off。
    http_force: HTTP 強制リダイレクトenable: 機能のスイッチ。有効な値: on または off。
    https_option: HTTPS 基本パラメーターhttp2: HTTP/2 スイッチ。有効な値: on または off。
    ocsp_stapling: Online Certificate Status Protocol (OCSP) Stapling スイッチ。有効な値: on または off。
    forward_scheme: オリジン回帰リクエストのプロトコル準拠enable: スイッチ。有効な値: on または off。
    scheme_origin: オリジン回帰リクエストのプロトコル。有効な値: http、https、および follow。
    dynamic: DCDN 関連の構成enable (必須): スイッチ。有効な値: on または off。
    static_route_type: 静的アクセラレーション用のファイル拡張子。
    static_route_url: 静的アクセラレーション用の URI。
    static_route_path: 静的アクセラレーション用のパス。
    dynamic_route_origin: オリジン回帰ルートのスキーム。有効な値: http、https、follow、および follow-port。
    dynamic_route_round_robin: ロードバランシングのスイッチ。有効な値: on または off。
    dynamic_route_adapt_cache: 適応キャッシングのスイッチ。有効な値: on または off。
    set_req_header: カスタムオリジン回帰 HTTP ヘッダーkey: オリジン回帰ヘッダー。
    value: オリジン回帰ヘッダーの内容。
    l2_oss_key: プライベート Alibaba Cloud OSS バケットへのオリジン回帰リクエストprivate_oss_auth: プライベートバケットへのオリジン回帰リクエストのスイッチ。有効な値: on または off。
    range: 範囲ベースのオリジン回帰リクエストenable: スイッチ。有効な値: on および off。
    video_seek: ビデオシークenable (必須): スイッチ。有効な値: on または off。
    flv_seek_by_time: FLV ファイルの時間によるシークを有効にします。有効な値: on または off。
    mp4_seek_start: MP4 シークのカスタム start パラメーター。
    mp4_seek_end: MP4 シークのカスタム end パラメーター。
    flv_seek_start: FLV シークのカスタム start パラメーター。
    flv_seek_end: FLV シークのカスタム end パラメーター。
    websocket: WebSocketenabled (必須): WebSocket を有効にするかどうかを指定します。有効な値: on または off。
    origin_scheme: オリジン回帰リクエストのスキーム。有効な値: http、https、および follow。
    heartbeat: ハートビート間隔。デフォルト値: 60。単位: 秒。有効な値: 1 ～ 300。
    ali_remove_args: URL パラメーターを無視 (削除)ali_remove_args (必須): 削除するパラメーター。複数のパラメーターはスペースで区切ります。残りのパラメーターはキャッシュキーの URL 引数として使用されます。
    keep_oss_args: オリジン回帰リクエストのパラメーターを保持するかどうかを指定します。有効な値: on および off。on はすべてのパラメーターが保持されることを示します。off はパラメーターがキャッシュキー内のものと同じであることを示します。
    https_tls_version: TLS プロトコルバージョンtls10: TLSv1.0 を有効にします。デフォルト値: on。有効な値: on または off。
    tls11: TLSv1.1 を有効にします。デフォルト値: on。有効な値: on または off。
    tls12: TLSv1.2 を有効にします。デフォルト値: on。有効な値: on または off。
    tls13: TLSv1.3 を有効にします。デフォルト値: off。有効な値: on または off。
    HSTS: HTTP Strict Transport Security (HSTS)enabled (必須): スイッチ。デフォルト値: off。有効な値: on または off。
    https_hsts_max_age (必須): 有効期限。単位: ms。5184000000 ms (60 日) の値が推奨されます。
    https_hsts_include_subdomains: HSTS ヘッダーに includeSubDomains パラメーターを含めるかどうかを指定します。有効な値: on または off。この機能は慎重に有効にしてください。有効にする前に、アクセラレーションドメイン名のすべてのサブドメインに対して HTTPS が有効になっていることを確認してください。そうしないと、HTTPS にリダイレクトされた後、サブドメインがアクセスできなくなります。
    filetype_force_ttl_code: ファイルタイプのステータスコードの有効期限file_type (必須): ファイルタイプ。複数のファイルタイプはカンマ (,) で区切ります (例: TXT,JPG)。
    code_string (必須): ステータスコード。複数のステータスコードはカンマ (,) で区切ります。例: 302=0,301=0,4xx=2。
    path_force_ttl_code: パスのステータスコードの有効期限path (必須): パスはスラッシュ (/) で始まる必要があります (例: /image)。
    code_string (必須): ステータスコード。複数のステータスコードはカンマ (,) で区切ります。例: 302=0,301=0,4xx=2。
    gzip: インテリジェント圧縮enable (必須): 機能のスイッチ。有効な値: on または off。
    tesla: HTML 最適化enable (必須): 機能のスイッチ。有効な値: on または off。
    trim_js: 有効な値: on または off。この機能を有効にすると、HTML ページに埋め込まれた JavaScript コードが最適化されます。
    trim_css: 有効な値: on または off。この機能を有効にすると、HTML ページに埋め込まれた CSS コードが最適化されます。
    https_origin_sni: オリジン回帰 SNIenabled: 機能のスイッチ。有効な値: on または off。
    https_origin_sni (必須): オリジン回帰 SNI。
    protogw: IP アプリケーションアクセラレーションrealip (必須): オリジン IP アドレスをパススルーする方法。有効な値: off、toa、および pp。
    port (必須): サービスポート。
    pattern: パターン文字列。
    host_redirect: 書き換え機能regex: 書き換える URL。例: ^/$。
    replacement: 宛先 URL。例: /go/act/sale/tbzlsy.php。
    flag: redirect および break のみがサポートされています。
    forward_timeout: オリジン回帰リクエストのタイムアウト期間forward_timeout: タイムアウト期間。単位: 秒。100 秒を超える値に設定しないでください。
    ipv6: IPv6 構成switch (必須): スイッチ。有効な値: on (IPv6 を有効にする) および off (IPv6 を無効にする)。
    region: IPv6 が有効になっているリージョン。アスタリスク (*) がサポートされています。
    edge_function: EdgeScriptrule (必須): DSL ルール。
    pri (必須): 優先順位。
    enable (必須): ルールが有効かどうかを指定します。有効な値: on または off。
    name: ルール名。
    pos: ルールが実行される位置。DCDN ドメイン名の場合、head のみがサポートされています。foot はサポートされていません。
    brk: このルールがヒットした場合、現在の実行位置の残りのルールはスキップされます。
    option: オプション制御。
    grammar: 文法制御。オプションの値: empty、es2、および js。
    jsmode: JS ドメイン名ホワイトリスト制御。オプションの値: redirect および bypass。
    brotli: Brotli 圧縮enable (必須): 機能のスイッチ。有効な値: on または off。
    brotli_level: 圧縮レベル。有効な値: 1 ～ 11。
    ali_ua: User-Agent ブラックリスト/ホワイトリストua: User-Agent。
    type: リストタイプ。有効な値: black または white。

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエストID。

    F8AA0364-0FDB-4AD5-AC74-D69FAB8924ED
    DomainConfigs

    object

    DomainConfig

    array<object>

    ドメイン名のコンフィグレーション。

    array<object>

    Status

    string

    The status of the configuration. Valid values:

    • success: successful

    • testing: testing

    • failed: The configuration failed.

    • configuring: The configuration is in progress.

    success
    ParentId

    string

    The ID of the advanced condition configuration.

    1234567
    ConfigId

    string

    The ID of the configuration.

    5068995
    FunctionName

    string

    The feature name.

    set_req_host_header
    FunctionArgs

    object

    FunctionArg

    array<object>

    The configurations of the features.

    object

    ArgName

    string

    The name of the configuration.

    ttl
    ArgValue

    string

    The value of the configuration.

    13

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "F8AA0364-0FDB-4AD5-AC74-D69FAB8924ED",
  "DomainConfigs": {
    "DomainConfig": [
      {
        "Status": "success",
        "ParentId": "1234567",
        "ConfigId": "5068995",
        "FunctionName": "set_req_host_header",
        "FunctionArgs": {
          "FunctionArg": [
            {
              "ArgName": "ttl",
              "ArgValue": "13"
            }
          ]
        }
      }
    ]
  }
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 Invalid%s.ValueNotSupported FunctionName [%s] is not supported.

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

    変更履歴

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