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

Edge Security Acceleration:ドメイン名設定機能

最終更新日:Nov 27, 2025

BatchSetDcdnDomainConfigs 操作を呼び出すことで、複数の高速化ドメイン名に対して一度に機能を設定できます。このトピックでは、この API 操作を呼び出して設定できる機能と、それに対応するパラメーターについて説明します。

説明

基本情報

dynamic

  • 機能の説明:DCDN 関連の設定。この機能の詳細については、コンソールの設定に関するトピック「静的および動的コンテンツアクセラレーションのルール」をご参照ください。

  • 機能 ID (FunctionID/FuncId):46。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    enable

    String

    はい

    静的アクセラレーションの有効化:

    • on:この機能を有効にします。

    • off:この機能を無効にします。

    on

    static_route_type

    String

    いいえ

    静的コンテンツアクセラレーションのファイル拡張子。

    .txt

    static_route_url

    String

    いいえ

    静的コンテンツアクセラレーションの URI。

    /domain/detail/log.txt

    static_route_path

    String

    いいえ

    静的コンテンツアクセラレーションのファイルのパス。

    説明

    ワイルドカード文字 (アスタリスク (*) や疑問符 (?) など) を使用して、静的ファイルパスのあいまい一致を行うことができます。アスタリスク (*) は 0 文字以上の文字に一致します。疑問符 (?) は 1 文字に一致します。

    /abc/test/*

    dynamic_route_origin

    String

    いいえ

    動的コンテンツのオリジンプロトコルポリシー。有効値:

    • http:DCDN は HTTP を使用してオリジンサーバーからリソースをリクエストします。

    • https:DCDN は HTTPS を使用してオリジンサーバーからリソースをリクエストします。

    • follow:DCDN はクライアントと同じプロトコルを使用してオリジンサーバーからリソースをリクエストします。

    • follow-port:DCDN はオリジンサーバーのポートに対応するプロトコルを使用してオリジンサーバーからリソースをリクエストします。

    説明

    dynamic_route_origin を設定しない場合、デフォルト値の follow が使用されます。

    https

    dynamic_route_round_robin

    String

    いいえ

    ロードバランシングを有効にするかどうかを指定します。有効値:

    • on:この機能を有効にします。

    • off (デフォルト):この機能を無効にします。

    off

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "static_route_type",
                "argValue": ".txt"
            }, {
                "argName": "static_route_url",
                "argValue": "/domain/detail/log.txt"
            },{
                "argName": "static_route_path",
                "argValue": "/abc/test/*"
            }, {
                "argName": "dynamic_route_origin",
                "argValue": "https"
            }, {
                "argName": "dynamic_route_round_robin",
                "argValue": "off"
            }],
            "functionName": "dynamic"
        }],
        "DomainNames": "example.com"
    }

ipv6

  • 機能の説明:IPv6 アクセス構成。この機能の詳細については、コンソールの設定に関するトピック「IPv6 の有効化」をご参照ください。

  • 機能 ID (FunctionID/FuncId):194。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    switch

    String

    はい

    IPv6 アクセスの有効化:

    • on:この機能を有効にします。

    • off:この機能を無効にします。

    on

    region

    String

    はい

    IPv6 を有効にするリージョン。ワイルドカード文字 (*) がサポートされています。

    説明
    • アスタリスク (*) は、すべてのリージョンで IPv6 が有効であることを示します。現在、IPv6 はすべてのリージョンでのみ有効にできます。特定のリージョンで IPv6 を有効にする場合は、チケットを送信して申請してください。

    • このパラメーターを設定しない場合、デフォルトですべてのリージョンで IPv6 が有効になります。

    *

  • 設定例:

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

オリジン設定

set_req_host_header

  • 機能の説明:back-to-origin ホストを設定します。この機能の詳細については、コンソールの設定に関するトピック「デフォルトの back-to-origin ホストの設定」をご参照ください。

  • 機能 ID (FunctionID/FuncId):18。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    domain_name

    String

    はい

    back-to-origin ホストヘッダーのコンテンツ。

    example.com

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "domain_name",
                "argValue": "example.com"
            }],
            "functionName": "set_req_host_header"
        }],
        "DomainNames": "example.com"
    }

forward_scheme

  • 機能の説明:back-to-origin プロトコルポリシーを設定します。この機能の詳細については、コンソールの設定に関するトピック「back-to-origin のための静的プロトコルフォローアップの設定」をご参照ください。

  • 機能 ID (FunctionID/FuncId):47。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    enable

    String

    はい

    back-to-origin プロトコルポリシーを有効にするかどうかを指定します。有効値:

    • on:この機能を有効にします。

    • off:この機能を無効にします。

    on

    scheme_origin

    String

    いいえ

    back-to-origin プロトコルポリシー。有効値:

    • http:DCDN は HTTP を使用して back-to-origin を行います。

    • https:DCDN は HTTPS を使用して back-to-origin を行います。

    • follow:DCDN はクライアントリクエストと同じプロトコルを使用して back-to-origin を行います。

    説明

    scheme_origin を設定しない場合、デフォルト値の follow が使用されます。

    follow

    scheme_origin_port

    String

    いいえ

    カスタムオリジンポート。このパラメーターは scheme_origin パラメーターと一緒に使用する必要があります。有効値:

    • scheme_origin を http に設定した場合、HTTP オリジンポートのみを設定する必要があります。例:80。

    • scheme_origin を https に設定した場合、HTTPS オリジンポートのみを設定する必要があります。例:443。

    • scheme_origin を follow に設定した場合、HTTP と HTTPS の両方のオリジンポートを設定する必要があります。コロン (:) で区切ります。例:80:443。

    80:443

  • 設定例 1:DCDN はクライアントリクエストと同じプロトコルを使用して back-to-origin を行います。オリジンポートはプロトコルのデフォルトポートです。HTTP にはポート 80、HTTPS にはポート 443 が使用されます。

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "scheme_origin",
                "argValue": "follow"
            }],
            "functionName": "forward_scheme"
        }],
        "DomainNames": "example.com"
    }
  • 設定例 2:DCDN はクライアントリクエストと同じプロトコルを使用して back-to-origin を行います。オリジンポートはカスタムポートです。HTTP にはポート 8080、HTTPS にはポート 4433 が使用されます。

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

l2_oss_key

  • 機能の説明:プライベートバケットからのオリジンフェッチを設定します。注意:この機能を初めて使用する場合、ワンクリックでデフォルトのアクセスポリシーを有効にする必要があります。ポリシーを有効にすると、DCDN はご利用の Alibaba Cloud アカウントに属するすべての OSS バケットへの読み取り専用アクセス権を付与されます。この機能の詳細については、コンソールの設定に関するトピック「プライベート OSS バケットからのオリジンフェッチ」をご参照ください。

  • 機能 ID (FunctionID/FuncId):85。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    private_oss_auth

    String

    はい

    プライベートバケットからのオリジンフェッチを有効にするかどうかを指定します。有効値:

    • on:この機能を有効にします。

    • off:この機能を無効にします。

    この機能を有効にすると、システムは自動的に Security Token Service (STS) トークンを設定します。これにより、設定が簡素化されます。ただし、この方法は、DCDN 高速化ドメイン名と同じ Alibaba Cloud アカウントに属するプライベート OSS バケットからのオリジンフェッチのみをサポートします。STS トークンの詳細については、「STS とは」をご参照ください。

    on

    perm_private_oss_tbl

    String

    いいえ

    永続的なセキュリティトークンの設定。フォーマットは access_id=123 access_secret=123abc です。パラメーターはスペースで区切ります。

    永続的なセキュリティトークンを設定すると、DCDN 高速化ドメイン名と同じ Alibaba Cloud アカウントに属するプライベート OSS バケットからのオリジンフェッチ、および別の Alibaba Cloud アカウントに属するプライベート OSS バケットからのオリジンフェッチを設定できます。永続的なセキュリティトークンの詳細については、「AccessKey の作成」をご参照ください。

    access_id=123 access_secret=123abc

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "private_oss_auth",
                "argValue": "on"
            },{
                "argName": "perm_private_oss_tbl",
                "argValue": "access_id=123 access_secret=123abc"
            }],
            "functionName": "l2_oss_key"
        }],
        "DomainNames": "example.com"
    }

oss_key_list

  • 機能の説明:OSS からのオリジンフェッチ用の秘密鍵のリスト。1 つ以上のルールを設定して、複数のプライベート OSS バケットとそれに対応するセキュリティトークンを指定できます。

  • 機能 ID (FunctionID/FuncId):183。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    host

    String

    はい

    OSS バケットの完全なアドレス。

    example.oss-cn-hangzhou.aliyuncs.com

    key

    String

    はい

    永続的なセキュリティトークンの設定。フォーマットは access_id=123 access_secret=123abc です。パラメーターはスペースで区切ります。

    永続的なセキュリティトークンを設定すると、DCDN 高速化ドメイン名と同じ Alibaba Cloud アカウントに属するプライベート OSS バケットからのオリジンフェッチ、および別の Alibaba Cloud アカウントに属するプライベート OSS バケットからのオリジンフェッチを設定できます。永続的なセキュリティトークンの詳細については、「AccessKey の作成」をご参照ください。

    access_id=123 access_secret=123abc

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "host",
                "argValue": "example.oss-cn-hangzhou.aliyuncs.com"
            },{
                "argName": "key",
                "argValue": "access_id=123 access_secret=123abc"
            }],
            "functionName": "oss_key_list"
        }],
        "DomainNames": "example.com"
    }

https_origin_sni

  • 機能の説明:オリジン SNI を設定します。特定のオリジンサーバーに特定のオリジン SNI を設定できます。この機能の詳細については、コンソールの設定に関するトピック「特定のオリジン SNI の設定」をご参照ください。この機能の詳細については、コンソールの設定に関するトピック「オリジン SNI の設定」をご参照ください。

  • 機能 ID (FunctionID/FuncId):114。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    enabled

    String

    はい

    オリジン SNI 機能を有効にするかどうかを指定します。有効値:

    • on:この機能を有効にします。

    • off:この機能を無効にします。

    on

    https_origin_sni

    String

    はい

    back-to-origin リクエストに含まれる SNI 情報。これは、back-to-origin リクエストがアクセスする必要のあるオリジンサーバーのアドレスです。

    origin.example.com

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "https_origin_sni",
                "argValue": "origin.example.com"
            }, {
                "argName": "enabled",
                "argValue": "on"
            }],
            "functionName": "https_origin_sni"
        }],
        "DomainNames": "example.com"
    }

forward_timeout

  • 機能の説明:back-to-origin リクエストタイムアウトを設定します。この機能の詳細については、コンソールの設定に関するトピック「back-to-origin リクエストタイムアウト」をご参照ください。

  • 機能 ID (FunctionID/FuncId):124。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    forward_timeout

    Integer

    はい

    リクエストのタイムアウト期間。単位:秒。

    説明

    タイムアウト期間は 100 秒未満に設定することを推奨します。

    30

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "forward_timeout",
                "argValue": "30"
            }],
            "functionName": "forward_timeout"
        }],
        "DomainNames": "example.com"
    }

advanced_origin

  • 機能の説明:高度なオリジンを設定します。この機能の詳細については、コンソールの設定に関するトピック「高度なオリジン」をご参照ください。この機能は、ホワイトリストに追加されたユーザーのみが利用できます。この機能を利用するには、チケットを送信してください。

  • 機能の競合:高度なオリジン機能は、条件付きオリジン機能 (関数:origin_dns_host、機能 ID:212) と競合します。どちらか一方しか有効にできません。一方の機能が設定されている場合、もう一方の機能を利用するには、その設定を削除する必要があります。機能のスイッチパラメーターが `off` に設定されていても、その機能は設定済みと見なされます。DeleteDcdnSpecificConfig 操作を呼び出して、ドメイン名の特定の設定を削除できます。

  • 機能 ID (FunctionID/FuncId):235。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    variable_type

    String

    はい

    変数のタイプ。有効値:

    • header:ユーザーリクエストに含まれるリクエストヘッダー。

    • arg:ユーザーリクエスト URL に含まれるクエリ文字列パラメーター。

    • uri:ユーザーリクエスト URL に含まれるパス。

    • cookie:ユーザーリクエストに含まれるリクエスト Cookie。

    uri

    variable

    String

    はい

    変数の名前。

    説明

    variable_type を uri に設定した場合、variable を uri に設定する必要があります。

    uri

    conditions

    String

    はい

    条件。有効値:

    • ==:等しい。

    • !=:等しくない。

    ==

    value

    String

    はい

    変数の値。

    /image

    origin

    String

    はい

    back-to-origin 中の DNS クエリに使用されるドメイン名。これはユーザーリクエスト内の変数の値です。値が一致する場合、リクエストは指定されたオリジン URL にリダイレクトされます。

    origin.example.com

  • 設定例:

    {
     "Functions": [{
      "functionArgs": [{
       "argName": "conditions",
       "argValue": "=="
      }, {
       "argName": "variable_type",
       "argValue": "uri"
      }, {
       "argName": "value",
       "argValue": "/image"
      }, {
       "argName": "origin",
       "argValue": "origin.example.com"
      }, {
       "argName": "variable",
       "argValue": "uri"
      }],
      "functionName": "advanced_origin"
     }],
     "DomainNames": "example.com",
    }

follow_302

  • 機能の説明:back-to-origin の 302 リダイレクトを設定します。この機能の詳細については、コンソールの設定に関するトピック「back-to-origin の 301/302 リダイレクトの設定」をご参照ください。この機能は、ホワイトリストに追加されたユーザーのみが利用できます。この機能を利用するには、チケットを送信してください。

  • 機能 ID (FunctionID/FuncId):219。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    enable

    String

    はい

    back-to-origin の 302 リダイレクトを有効にするかどうかを指定します。有効値:

    • on:この機能を有効にします。

    • off:この機能を無効にします。

    on

    max_tries

    Integer

    いいえ

    302 リダイレクトの最大回数。

    • デフォルト値:2。

    • 有効値:[1,5]。

    説明

    back-to-origin の回数 - 1 = 302 リダイレクトの回数。つまり、デフォルトの back-to-origin の最大回数は 3 で、有効範囲は [2,6] です。

    2

    retain_args

    String

    いいえ

    宛先オリジンサーバーにリダイレクトする際に、元のリクエストパラメーターを保持するかどうかを指定します。有効値:

    • on:パラメーターを保持します。

    • off (デフォルト):パラメーターを保持しません。

    off

    retain_header

    String

    いいえ

    宛先オリジンサーバーにリダイレクトする際に、元のリクエストヘッダーを保持するかどうかを指定します。有効値:

    • On:保持します。

    • off (デフォルト):ヘッダーを保持しません。

    off

    response_header

    String

    いいえ

    302 リダイレクト応答ヘッダー。これは、オリジンサーバーが DCDN に送信する 302 リダイレクト応答ヘッダーの名前です。デフォルトのヘッダー名は Location です。

    X-Alicdn-Redirect

    retain_host

    String

    いいえ

    302 リダイレクトのオリジンドメイン名を保持します。有効にすると、DCDN は 302 リダイレクト中にオリジンドメイン名を保持します。これは、宛先ドメイン名にリダイレクトする場合にのみ有効です。有効値:

    • on:この機能を有効にします。

    • off (デフォルト):この機能を無効にします。

    off

    modify_host

    String

    いいえ

    302 リダイレクトのオリジンドメイン名を変更します。DCDN は 302 リダイレクト中にオリジンドメイン名を変更します。これは、宛先ドメイン名にリダイレクトする場合にのみ有効です。デフォルトでは、オリジンドメイン名は変更されません。

    example.com

    cache

    String

    いいえ

    302 リダイレクト結果をキャッシュします。有効にすると、DCDN は 302 リダイレクト中に同じ URL のリダイレクト結果をキャッシュし、DCDN の応答パフォーマンスを向上させます。有効値:

    • on:この機能を有効にします。

    • off (デフォルト):この機能を無効にします。

    off

    expired_time

    Integer

    いいえ

    302 リダイレクト結果をキャッシュするタイムアウト期間。これは、DCDN が 302 リダイレクト中に同じ URL のリダイレクト結果をキャッシュするタイムアウト期間です。このパラメーターはキャッシュ機能と一緒に使用する必要があります。単位:秒。デフォルト値:3600。

    7200

    follow_origin_host

    String

    いいえ

    302 リダイレクトの back-to-origin ホストとしてオリジンドメイン名を使用します。有効にすると、DCDN はオリジンドメイン名を back-to-origin ホストとして使用します。プライマリ/セカンダリのスイッチオーバー後も、最新のオリジンドメイン名が使用されます。有効値:

    • on:この機能を有効にします。

    • off (デフォルト):この機能を無効にします。

    off

    follow_5xx_retry_origin

    String

    いいえ

    プライマリ/セカンダリオリジンサーバーのスイッチオーバー。有効にすると、DCDN はオリジンサーバーから 5xx ステータスコードを受信した場合、次に利用可能なオリジンサーバーに切り替えます。有効値:

    • on:この機能を有効にします。

    • off (デフォルト):この機能を無効にします。

    off

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "max_tries",
                "argValue": 2
            }, {
                "argName": "retain_args",
                "argValue": "off"
            }, {
                "argName": "retain_header",
                "argValue": "off"
            }, {
                "argName": "response_header",
                "argValue": "X-Alicdn-Redirect"
            }, {
                "argName": "retain_host",
                "argValue": "off"
            }, {
                "argName": "modify_host",
                "argValue": "example.com"
            }, {
                "argName": "cache",
                "argValue": "off"
            }, {
                "argName": "expired_time",
                "argValue": "7200"
            }, {
                "argName": "follow_origin_host",
                "argValue": "off"
            }, {
                "argName": "follow_5xx_retry_origin",
                "argValue": "off"
            }],
            "functionName": "follow_302"
        }],
        "DomainNames": "example.com"
    }
    

set_req_header

  • 機能の説明:カスタム back-to-origin HTTP ヘッダーを設定します。この機能の詳細については、コンソールの設定に関するトピック「インバウンドリクエストヘッダーの変更」をご参照ください。

    説明

    `set_req_header` は v1 です。v2 の `origin_request_header` を使用することを推奨します。v2 は、カスタム back-to-origin HTTP ヘッダーのより多くの機能をサポートしています。

  • 機能 ID (FunctionID/FuncId):39。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    key

    String

    はい

    back-to-origin ヘッダーの名前。

    Accept-Encoding

    value

    String

    はい

    back-to-origin ヘッダーの値。back-to-origin ヘッダーを削除するには、その値を null に設定します。

    gzip

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "value",
                "argValue": "gzip"
            }, {
                "argName": "key",
                "argValue": "Accept-Encoding"
            }],
            "functionName": "set_req_header"
        }],
        "DomainNames": "example.com"
    }

origin_request_header

  • 機能の説明:back-to-origin HTTP リクエストヘッダー (新規) を設定します。この機能の詳細については、コンソールの設定に関するトピック「back-to-origin HTTP リクエストヘッダーの設定」をご参照ください。この機能は、ホワイトリストに追加されたユーザーのみが利用できます。この機能を利用するには、チケットを送信してください。

  • 機能 ID (FunctionID/FuncId):228。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    header_operation_type

    String

    はい

    リクエストヘッダーの操作。有効値:

    • add:新しいエントリを追加します。

    • delete:削除します。

    • Modify

    • rewrite の代わりに replace を使用します。

    add

    header_name

    String

    はい

    リクエストヘッダーの名前。

    Accept-Encoding

    header_value

    String

    いいえ

    リクエストヘッダーの値。リクエストヘッダーパラメーターに複数の値を設定できます。複数の値はカンマ (,) で区切ります。

    gzip

    duplicate

    String

    いいえ

    同じ名前のリクエストヘッダーの追加を許可するかどうかを指定します。header_operation_type を add に設定した場合、重複を許可するかどうかを指定する必要があります。有効値:

    • On:許可します。

    • Off:無効です。

    off

    header_source

    String

    いいえ

    置き換えられるパラメーター値。header_operation_type を rewrite に設定した場合、このパラメーターを設定する必要があります。正規表現がサポートされています。

    value1

    header_destination

    String

    いいえ

    新しいパラメーター値。header_operation_type を rewrite に設定した場合、このパラメーターを設定する必要があります。

    value123

    match_all

    String

    いいえ

    一致モード。header_operation_type を rewrite に設定した場合、一致モードを設定する必要があります。有効値:

    • on:すべての値に一致します。一致したすべての値が置き換えられます。

    • off:最初の値のみに一致します。一致した最初の値のみが置き換えられます。

    off

  • 設定例:高速化ドメイン名 example.com にカスタム back-to-origin リクエストヘッダーを追加します。リクエストヘッダー名は `Accept-Encoding` に、リクエストヘッダー値は `gzip` に設定されます。

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "header_operation_type",
                "argValue": "add"
            }, {
                "argName": "header_name",
                "argValue": "Accept-Encoding"
            }, {
                "argName": "header_value",
                "argValue": "gzip"
            }, {
                "argName": "duplicate",
                "argValue": "off"
            }],
            "functionName": "origin_request_header"
        }],
        "DomainNames": "example.com"
    }

origin_response_header

  • 機能の説明:back-to-origin HTTP 応答ヘッダーを設定します。この機能の詳細については、コンソールの設定に関するトピック「インバウンド応答ヘッダーの変更」をご参照ください。この機能は、ホワイトリストに追加されたユーザーのみが利用できます。この機能を利用するには、チケットを送信してください。

  • 機能 ID (FunctionID/FuncId):229。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    header_operation_type

    String

    はい

    応答ヘッダーの操作。有効値:

    • add:項目を追加します。

    • Delete:項目を削除します。

    • 変更するには、変更を加えます。

    • 置換。

    add

    header_name

    String

    はい

    応答ヘッダーの名前。

    Cache-Control

    header_value

    String

    いいえ

    応答ヘッダーの値。応答ヘッダーパラメーターに複数の値を設定できます。複数の値はカンマ (,) で区切ります。

    no-cache

    duplicate

    String

    いいえ

    同じ名前の応答ヘッダーの追加を許可するかどうかを指定します。header_operation_type を add に設定した場合、重複を許可するかどうかを指定する必要があります。有効値:

    • on:重複を許可します。

    • off:重複を許可しません。

    off

    header_source

    String

    いいえ

    置き換えられるパラメーター値。header_operation_type を rewrite に設定した場合、このパラメーターを設定する必要があります。正規表現がサポートされています。

    value1

    header_destination

    String

    いいえ

    新しいパラメーター値。header_operation_type を rewrite に設定した場合、このパラメーターを設定する必要があります。

    value123

    match_all

    String

    いいえ

    一致モード。header_operation_type を rewrite に設定した場合、一致モードを設定する必要があります。有効値:

    • on:すべての値に一致します。一致したすべての値が置き換えられます。

    • off:最初の値のみに一致します。一致した最初の値のみが置き換えられます。

    off

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "header_operation_type",
                "argValue": "add"
            }, {
                "argName": "header_name",
                "argValue": "Cache-Control"
            }, {
                "argName": "header_value",
                "argValue": "no-cache"
            }, {
                "argName": "duplicate",
                "argValue": "off"
            }],
            "functionName": "origin_response_header"
        }],
        "DomainNames": "example.com"
    }

back_to_origin_url_rewrite

  • 機能の説明:オリジン URI を書き換えます。この機能の詳細については、コンソールの設定に関するトピック「オリジン URI の書き換え」をご参照ください。この機能は、ホワイトリストに追加されたユーザーのみが利用できます。この機能を利用するには、チケットを送信してください。

  • 機能 ID (FunctionID/FuncId):225。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    source_url

    String

    はい

    書き換えられる URI。

    ^/hello$

    target_url

    String

    はい

    宛先 URI。

    /hello/test

    flag

    String

    いいえ

    書き換え操作の実行ルール。有効値:

    • Empty:このパラメーターが設定されていない場合、現在のルールが実行された後、後続の書き換えルールが引き続き実行されます。

    • break:現在のルールが実行された後、後続の書き換えルールは実行されません。

    • enhance_break:break と同様ですが、パラメーター付きのリクエストを処理し、FLV ライブストリームにも有効です。

    break

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "flag",
                "argValue": "break"
            }, {
                "argName": "source_url",
                "argValue": "^/hello$"
            }, {
                "argName": "target_url",
                "argValue": "/hello/test"
            }],
            "functionName": "back_to_origin_url_rewrite"
        }],
        "DomainNames": "example.com",
    }

back_to_origin_argument_rewrite

  • 機能の説明:オリジンパラメーターを書き換えます。この機能の詳細については、コンソールの設定に関するトピック「オリジンパラメーターの書き換え」をご参照ください。この機能は、ホワイトリストに追加されたユーザーのみが利用できます。この機能を利用するには、チケットを送信してください。

    説明

    オリジンパラメーターの書き換えは、back-to-origin リクエスト URL のクエリパラメーターを変更します。複数の書き換えルールを設定できます。書き換え操作の優先順位は次のとおりです:追加 > 削除 > 保持のみ > 変更。異なる書き換えルールが同じパラメーターに適用される場合、最も優先度の高いルールのみが有効になります。

  • 機能 ID (FunctionID/FuncId):224。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    delete_argument

    String

    いいえ

    削除するパラメーターのリスト。複数のパラメーターはスペースで区切ります。

    code1

    save_argument

    String

    いいえ

    保持するパラメーターのリスト。複数のパラメーターはスペースで区切ります。リストされたパラメーターのみが保持されます。追加および削除のパラメーター操作は引き続き有効です。

    Empty

    ignore_all_argument

    String

    いいえ

    すべてのパラメーターを無視するかどうかを指定します。有効値:

    • on:すべてのパラメーターを無視します。追加パラメーター機能のみが有効になります。削除、保持のみ、および変更パラメーター機能は無効になります。

    • off (デフォルト):すべてのパラメーターを無視しません。保持、追加、および削除パラメーター機能は有効のままです。

    on

    add_argument

    String

    いいえ

    追加するパラメーター。これは最も高い優先度を持ちます。複数のパラメーターはスペースで区切ります。

    value=123

    modify_argument

    String

    いいえ

    変更するパラメーター。これは最も低い優先度を持ちます。パラメーターが削除された場合、それは保持されません。複数のパラメーターはスペースで区切ります。

    value=321

    enable

    String

    はい

    オリジンパラメーターの書き換えを有効にするかどうかを指定します。有効値:

    • on:この機能を有効にします。

    • off:この機能を無効にします。

    on

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "delete_argument",
                "argValue": ""
            }, {
                "argName": "save_argument",
                "argValue": ""
            }, {
                "argName": "add_argument",
                "argValue": ""
            }, {
                "argName": "modify_argument",
                "argValue": ""
            }, {
                "argName": "ignore_all_argument",
                "argValue": "on"
            }, {
                "argName": "enable",
                "argValue": "on"
            }],
            "functionName": "back_to_origin_argument_rewrite"
        }],
        "DomainNames": "example.com"
    }

aws_s3_bucket

  • 機能の説明:署名用の Amazon S3 バケットを設定します。この機能は、ホワイトリストに追加されたユーザーのみが利用できます。この機能を利用するには、チケットを送信してください。

  • 機能 ID (FunctionID/FuncId):186。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    enabled

    String

    はい

    Amazon S3 バケット認証の有効化:

    • L2 が有効です。

    • off:この機能を無効にします。

    l2

    bucketname

    String

    いいえ

    Amazon S3 バケットの名前。

    /

    accesskey

    String

    はい

    AWS AccessKey。

    123456789

    secretkey

    String

    はい

    AWS SecretKey。

    12345678

    region

    String

    はい

    Amazon S3 ストレージリージョン。

    us-east-2

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enabled",
                "argValue": "l2"
            }, {
                "argName": "accesskey",
                "argValue": "123456789"
            }, {
                "argName": "secretkey",
                "argValue": "123456789"
            }, {
                "argName": "region",
                "argValue": "us-east-2"
            }],
            "functionName": "aws_s3_bucket"
        }],
        "DomainNames": "example.com"
    }

origin_certificate_verification

  • 機能の説明:オリジン証明書の検証 (SNI ホワイトリスト) を設定します。この機能の詳細については、コンソールの設定に関するトピック「コモンネームホワイトリストの設定」をご参照ください。この機能は、ホワイトリストに追加されたユーザーのみが利用できます。この機能を利用するには、チケットを送信してください。

  • 機能 ID (FunctionID/FuncId):223。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    enabled

    String

    はい

    オリジン証明書の検証を有効にするかどうかを指定します。有効値:

    • on:この機能を有効にします。

    • off:この機能を無効にします。

    on

    common_name_whitelist

    String

    いいえ

    証明書のホワイトリストに登録されたドメイン名のリスト。複数のドメイン名を設定できます。カンマ (,) で区切ります。これらのホワイトリストに登録されたドメイン名に一致する証明書は、検証をパスできます。

    example.com

  • 設定例:

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

origin_dns_host

  • 機能の説明:条件付きオリジンを設定します。この機能は、ルールエンジン機能 (関数:condition、機能 ID:250) と組み合わせて使用することで、ユーザーリクエストのパス、URL パラメーター、リクエストヘッダーなどの情報に基づいて、リクエストを特定のオリジンサーバーにリダイレクトできます。この機能は、ホワイトリストに追加されたユーザーのみが利用できます。この機能を利用するには、チケットを送信してください。

  • 前提条件:条件付きオリジンを設定する前に、ルールエンジン用に少なくとも 1 つのルール条件を作成する必要があります。条件付きオリジンを設定する際には、それをルール条件に関連付ける必要があります。詳細については、「ルールエンジン」をご参照ください。条件付きオリジンの設定をルール条件に関連付けないと、すべての DCDN back-to-origin トラフィックがこの単一のオリジン URL に転送されます。これにより、ルール条件でオリジン URL を制御するという目的が達成されなくなります。

  • 機能の競合:条件付きオリジン機能は、高度なオリジン機能 (関数:advanced_origin、機能 ID:235) と競合します。どちらか一方しか有効にできません。一方の機能が設定されている場合、もう一方の機能を利用するには、その設定を削除する必要があります。機能のスイッチパラメーターが `off` に設定されていても、その機能は設定済みと見なされます。DeleteDcdnSpecificConfig 操作を呼び出して、ドメイン名の特定の設定を削除できます。

  • 機能 ID (FunctionID/FuncId):212。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    ali_origin_dns_host

    String

    はい

    back-to-origin 中の DNS クエリに使用されるドメイン名。

    example.com

  • 設定例:`parentid` を、ルールエンジン機能 (関数:condition、機能 ID:250) を使用して作成されたルール条件を参照するように設定します。参照は、設定が追加されたときに生成された `configid` を通じて行われます。これにより、ユーザーリクエストがこのルール条件にヒットした場合、指定されたオリジン URL にリダイレクトされることが保証されます。

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "ali_origin_dns_host",
                "argValue": "example.com"
            }],
            "functionName": "origin_dns_host",
            "parentId":30119730104****
        }],
        "DomainNames": "example.com"
    }

origin_host

  • 機能の説明:特定のオリジンサーバーの back-to-origin ホストを設定します。特定のオリジンサーバーに特定の back-to-origin ホストを設定できます。この機能は、ホワイトリストに追加されたユーザーのみが利用できます。この機能を利用するには、チケットを送信してください。

  • 機能 ID (FunctionID/FuncId):242。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    origin

    String

    はい

    特定のオリジン URL。origin パラメーターを all に設定することで、これを指定しないこともできます。これはすべてのオリジンサーバーを表します。

    example.com

    host

    String

    はい

    特定のホスト。host パラメーターを ali_follow_origin に設定することで、これを指定しないこともできます。これは、ホスト値がオリジン URL に従うことを意味します。

    host.example.com

  • 設定例 1:ユーザーリクエストがオリジンサーバー example.com にリダイレクトされると、使用される `host` 値は host.example.com です。

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "origin",
                "argValue": "example.com"
            }, {
                "argName": "host",
                "argValue": "host.example.com"
            }],
            "functionName": "origin_host"
        }],
        "DomainNames": "example.com"
    }
  • 設定例 2:すべてのオリジンサーバー (`all` で表される) にリダイレクトされたユーザーリクエストは、同じ `host` 値 host.example.com を使用します。

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "origin",
                "argValue": "all"
            }, {
                "argName": "host",
                "argValue": "host.example.com"
            }],
            "functionName": "origin_host"
        }],
        "DomainNames": "example.com"
    }
  • 設定例 3: すべてのソースサーバー (`all`) にリダイレクトされたユーザーリクエストの場合、`host` の値はソース URL をフォローします (ali_follow_origin)。

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "origin",
                "argValue": "all"
            }, {
                "argName": "host",
                "argValue": "ali_follow_origin"
            }],
            "functionName": "origin_host"
        }],
        "DomainNames": "example.com"
    }

ali_origin_port_scheme

  • 機能の説明:オリジンポートとプロトコルを設定します。この機能は、ホワイトリストに追加されたユーザーのみが利用できます。この機能を利用するには、チケットを送信してください。

  • 機能 ID (FunctionID/FuncId):276。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    port

    String

    はい

    オリジンポート。

    説明

    scheme を follow に設定した場合、http:80|https:443 の形式を使用する必要があります。

    80

    scheme

    String

    はい

    オリジンプロトコル。オリジンプロトコルをカスタマイズできます。有効値:http、https、follow、https_sm、follow_sm。

    • http:back-to-origin は HTTP 経由で実行されます。

    • https:back-to-origin は国際アルゴリズムを使用して HTTPS 経由で実行されます。

    • follow:Alibaba Cloud CDN は、クライアントが使用するプロトコル (HTTP または HTTPS) に従います。HTTPS プロトコルを使用する場合、Rivest-Shamir-Adleman (RSA) アルゴリズムのみがサポートされます。

      • クライアントが HTTP を使用する場合、back-to-origin も HTTP を使用します。

      • クライアントは HTTPS プロトコルを使用して通信します。

        • クライアントが国際アルゴリズムを使用する場合、back-to-origin は国際アルゴリズムを使用して HTTPS を使用します。

        • クライアントが中国暗号アルゴリズムを使用する場合、back-to-origin は国際アルゴリズムを使用して HTTPS を使用します。

    • https_sm:back-to-origin は中国暗号アルゴリズムを使用して HTTPS 経由で実行されます。

    • follow_sm:サービスは、クライアントが使用するプロトコル (HTTP または HTTPS) に従います。RSA と SM の両方のアルゴリズムがサポートされています。

      • クライアントは back-to-origin に HTTP プロトコルを使用します。

      • クライアントは HTTPS プロトコルを使用します。

        • クライアントが国際アルゴリズムを使用する場合、back-to-origin は HTTPS と国際アルゴリズムを使用します。

        • クライアントが中国暗号アルゴリズムを使用する場合、back-to-origin は HTTPS と中国暗号アルゴリズムを使用します。

    説明

    国際アルゴリズムは国際標準の暗号化アルゴリズムです。中国暗号アルゴリズムは、中国国家暗号管理局によって認定された国内の暗号化アルゴリズムです。

    http

  • 設定例 1:オリジンプロトコルを `http` に、オリジンポートを 80 に設定します。

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "port",
                "argValue": "80"
            }, {
                "argName": "scheme",
                "argValue": "http"
            }],
            "functionName": "ali_origin_port_scheme"
        }],
        "DomainNames": "example.com"
    }
  • 設定例 2:オリジンプロトコルはユーザーリクエストで使用されるプロトコルに従います。back-to-origin が HTTP 経由で実行される場合、リクエストはオリジンサーバーのポート 80 にリダイレクトされます。back-to-origin が HTTPS 経由で実行される場合、リクエストはオリジンサーバーのポート 443 にリダイレクトされます。

    {
    "Functions":[{
    "functionArgs": [{
    "argName": "port",
    "argValue": "http:80|https:443"
      }, {
    "argName": "scheme",
    "argValue": "follow"
      }],
      "functionName":"ali_origin_port_scheme"
    }],
      "DomainNames":"example.com"
    }

origin_sni

  • 機能の説明:特定のオリジン SNI を設定します。特定のオリジンサーバーに特定のオリジン SNI を設定できます。この機能の詳細については、コンソールの設定に関するトピック「特定のオリジン SNI の設定」をご参照ください。この機能は、ホワイトリストに追加されたユーザーのみが利用できます。この機能を利用するには、チケットを送信してください。

  • 機能 ID (FunctionID/FuncId):262。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    origin

    String

    はい

    オリジン URL。origin パラメーターを all に設定することで、これを指定しないこともできます。

    example.com

    sni_host

    String

    はい

    SNI ホスト値:

    • 静的フィールドに設定できます。例:example.org

    • オリジン URL を SNI として使用するには、ali_follow_origin に設定します。

    • back-to-origin ホストを SNI として使用するには、ali_follow_host に設定します。

    example.org

    keepalive_sni

    String

    いいえ

    持続的接続の SNI マッチングを有効にするかどうかを指定します。有効値:

    • on:この機能を有効にします。

    • off:この機能を無効にします。

    説明

    この機能を有効にすると、異なるオリジン SNI には異なる持続的接続が使用されます。

    /

  • 設定例 1:ユーザーリクエストがオリジンサーバー origin.example.com にリダイレクトされると、使用される SNI 値は host.example.com です。

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "origin",
                "argValue": "origin.example.com"
            }, {
                "argName": "sni_host",
                "argValue": "host.example.com"
            }],
            "functionName": "origin_sni"
        }],
        "DomainNames": "example.com"
    }
  • 設定例 2:すべてのオリジンサーバー (all で表される) にリダイレクトされたユーザーリクエストは、同じ SNI 値 host.example.com を使用します。

    {
    "Functions": [{
    "functionArgs": [{
    "argName": "origin",
    "argValue": "all"
      }, {
    "argName": "sni_host",
    "argValue": "host.example.com"
    }],
    "functionName":"origin_sni"
     }],
     "DomainNames":"example.com"
    }
  • 設定例 3:すべてのオリジンサーバー (all で表される) にリダイレクトされたユーザーリクエストの場合、SNI 値はオリジン URL (パラメーター値 ali_follow_origin で表される) に従います。

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "origin",
                "argValue": "all"
            }, {
                "argName": "sni_host",
                "argValue": "ali_follow_origin"
            }],
            "functionName": "origin_sni"
        }],
        "DomainNames": "example.com"
    }
  • 設定例 4:すべてのオリジンサーバー (all で表される) にリダイレクトされたユーザーリクエストの場合、SNI 値は back-to-origin ホスト (パラメーター値 ali_follow_host で表される) に従います。

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "origin",
                "argValue": "all"
            }, {
                "argName": "sni_host",
                "argValue": "ali_follow_host"
            }],
            "functionName": "origin_sni"
        }],
        "DomainNames": "example.com"
    }

source_group

  • 機能の説明:オリジングループ設定を構成します。この機能は、ホワイトリストに追加されたユーザーのみが利用できます。この機能を利用するには、チケットを送信してください。

  • 機能 ID (FunctionID/FuncId):294。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    source_group_name

    String

    はい

    オリジングループの名前。小文字、数字、アンダースコア (_) を含めることができます。最大長は 128 バイトです。

    example_origin

    source_info

    String

    はい

    オリジンサーバーに関する情報。フォーマット:オリジンサーバーアドレス_優先度_重み_ポート。異なるパラメーターの値はアンダースコア (_) で区切ります。複数のオリジンサーバーはカンマ (,) で区切ります。

    • オリジンサーバーアドレス:IPv4、IPv6、およびドメイン名をサポートします。

    • 優先度:有効値は 1 から 65535 です。値が小さいほど優先度が高くなります。

    • 重み:有効値は 1 から 100 です。DCDN は、重みに基づいてリクエストを異なるオリジンサーバーに分散します。

    • ポート:有効値は 1 から 65535 です。

    • 単一ソース: 192.168.0.1_10_33_80

    • 複数ソース: 192.168.0.1_10_33_80,192.0.2.1_10_67_80

    retry_times

    Integer

    いいえ

    back-to-origin のリトライ試行回数。

    3

    retry_status_rule

    Integer

    いいえ

    back-to-origin のリトライをトリガーするステータスコード。現在、4xx、5xx、404、404-or-5xx、4xx-or-5xx の 5 つの値のみがサポートされています。いずれか 1 つを設定できます。

    404-or-5xx

    failback_source

    String

    いいえ

    バックアップに基本的なオリジン情報を使用します。有効値:

    • on:オリジングループ内のすべてのオリジンサーバーが利用できない場合、基本情報 - オリジン情報のオリジン URL が使用されます。

    • off:オリジングループ内のすべてのオリジンサーバーが利用できない場合、オリジンサーバーが利用できないことを示す 5xx ステータスコードが直接クライアントに返されます。

    on

    説明

    back-to-origin のリトライロジック:

    • リトライ回数:back-to-origin をリトライする回数。

      • リトライは、同じオリジングループ内の異なる IP アドレス間でのみ試行されます。

      • 実際のリトライの最大回数は、同じオリジングループで利用可能な IP アドレスの数によって制限されます。

      • `retry_times` が設定されていない場合、デフォルトのリトライ回数は 3 と利用可能なオリジン IP アドレスの数のうち小さい方です。

      • `retry_times` が設定されている場合、リトライ回数は設定値と利用可能なオリジン IP アドレスの数のうち小さい方です。

    • リトライのステータスコード:ノードは、特定のステータスコードを受信するとリトライします。

      • `retry_status_rule` が設定されていない場合、オリジンサーバーが 5xx ステータスコードで応答すると、デフォルトでリトライがトリガーされます。

      • `retry_status_rule` が設定されている場合、設定されたステータスコードに基づいてフェールオーバーリトライがトリガーされます。現在、4xx、5xx、404、404-or-5xx、4xx-or-5xx の 5 つの値のみがサポートされています。いずれか 1 つを設定できます。

      • `retry_status_rule` を設定した後も、デフォルトの 5xx ステータスコードは有効です。たとえば、`404` を設定した場合、DCDN ノードは 404 または 5xx ステータスコードを受信するとリトライします。

    • back-to-origin のリトライ順序:リトライは、同じオリジングループ内の IP アドレスの優先度の降順で試行されます。

    • back-to-origin のタイムアウトシナリオ:オリジンサーバーがリトライステータスコードでアクティブに応答すると、DCDN ノードはリクエストをリトライします。オリジンサーバーがリトライステータスコードで応答しない場合、DCDN ノードはタイムアウト処理プロセスに従い、タイムアウト期間が経過した後にリクエストをリトライします。

      • オリジン TCP 接続タイムアウト:10 秒。

      • オリジン書き込みタイムアウト:30 秒。これは、オリジンサーバーとの接続が確立された後のコンテンツ書き込みのタイムアウトです。

      • オリジン読み取りタイムアウト:30 秒。このタイムアウトは、オリジンサーバーが指定された期間内に DCDN ノードによって要求された完全なコンテンツを送信できなかった場合に発生します。

    • オリジンプロービングロジック

      • 異常なレイヤー 4 接続:DCDN ノードがオリジン IP アドレスとのレイヤー 4 接続を確立できない場合、そのオリジン IP アドレスをデッドテーブルに追加します。後続の back-to-origin リクエストはこのオリジン IP アドレスにアクセスしません。DCDN ノードは、5 秒ごとにレイヤー 4 でオリジン IP アドレスをプローブします。接続が正常に確立されると、オリジン IP アドレスは利用可能なリストに復元されます。

      • 通常のレイヤー 4 接続:DCDN ノードがオリジン IP アドレスと通常のレイヤー 4 接続を持っているが、オリジンサーバーからリトライステータスコード (5xx など) を受信した場合、リトライロジックがトリガーされます。ただし、オリジン IP アドレスは利用可能なリストに残り、次のアクセスリクエストは重みに基づいてこのオリジンサーバーに送信されます。つまり、レイヤー 4 接続が正常な場合、レイヤー 7 の例外はオリジン IP アドレスを自動的にブロックしません。オリジン IP アドレスをアクティブにブロックするには、レイヤー 7 オリジンモニタリングとヘルスチェック機能を設定する必要があります。

  • 設定例:

    {
    "Functions":[{
     "functionArgs":[{
     "argName":"source_group_name",
     "argValue":"test_yidong"
    },{
     "argName":"source_info",
      "argValue":"192.168.0.1_10_33_80,192.0.2.1_10_67_80"
    },{
    "argName":"retry_times",
    "argValue":"3"
     },{
    "argName":"retry_status_rule",
    "argValue":"404,502"
    },{
    "argName":"failback_source",
      "argValue":"on"
    }],
    "functionName":"source_group"
    }],
     "DomainNames":"example.com"
    }

ipv6_origin

  • 機能の説明:IPv6 経由での back-to-origin を設定します。この機能の詳細については、コンソールの設定に関するトピック「IPv6 経由での back-to-origin の設定」をご参照ください。この機能は、ホワイトリストに追加されたユーザーのみが利用できます。この機能を利用するには、チケットを送信してください。

  • 機能 ID (FunctionID/FuncId):265

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    enable

    String

    はい

    IPv6 経由のオリジンフェッチを有効にするかどうかを指定します。

    • on:この機能を有効にします。

    • off:この機能を無効にします。

    説明

    この機能が有効な場合、DCDN はオリジンフェッチのために IPv6 サービスを提供します。

    • DCDN POP (Point of Presence) とオリジンサーバーの両方にアクティブな IPv6 アドレスがある場合、DCDN は IPv6 経由で接続を確立します。

    • 次のシナリオでは、DCDN は IPv4 経由で接続を確立します:

      • DCDN POP にアクティブな IPv6 アドレスがない。

      • オリジンサーバーにアクティブな IPv6 アドレスがない。

      • DCDN POP とオリジンサーバーのどちらにもアクティブな IPv6 アドレスがない。

    on

    follow

    String

    はい

    クライアントリクエストの IP プロトコルバージョンに、バックツーオリジンリクエストを追従させるかどうかを指定します。

    • on:この機能は有効になります。

    • off:この機能は無効になります。

    説明

    この機能が有効な場合、DCDN のバックツーオリジンリクエストはクライアントリクエストの IP プロトコルバージョンに追従します。

    • クライアントリクエストが IPv6 を使用する場合、DCDN はバックツーオリジンリクエストに IPv6 オリジンサーバーを優先的に使用します。利用可能な IPv6 オリジンサーバーがない場合、DCDN は IPv4 オリジンサーバーを使用します。

    • クライアントリクエストが IPv4 を使用する場合、DCDN はバックツーオリジンリクエストに IPv4 オリジンサーバーを優先的に使用します。利用可能な IPv4 オリジンサーバーがない場合、DCDN は IPv6 オリジンサーバーを使用します。

    on

    ipv6_v4_mix_used

    文字列

    いいえ

    オリジン IPv4/IPv6 アドレスポーリング機能を有効にするかどうかを指定します。

    • on:有効。

    • off:無効。

    説明
    • オリジン IPv4/IPv6 アドレスポーリング機能は、IPv6 経由でのオリジンフェッチ機能およびオリジンフェッチにおけるクライアント IP プロトコル追従機能と相互排他的です。オリジン IPv4/IPv6 アドレスポーリングが有効になっている場合、他の 2 つの機能は無効になります。

    • この機能は、ポーリングメソッドを使用して、設定されているすべての IPv4 および IPv6 オリジンサーバーアドレスにオリジンフェッチリクエストを送信します。このプロセスは、クライアントが IPv4 と IPv6 のどちらを使用しているかに関係なく、すべてのクライアントリクエストに適用されます。

    • IPv4 アドレスと IPv6 アドレスに重みが設定されている場合、オリジンフェッチリクエストはそれらの重みに従って分散されます。

    オフ

  • 設定例:

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

cos_auth

  • 説明:Tencent Cloud Object Storage (COS) の認証バケットを設定します。この機能は、ホワイトリストに登録されたユーザーのみが利用できます。アクセスをリクエストするには、チケットを送信してください。

  • 関数 ID (FunctionID/FuncId):288。

  • パラメーター:

    パラメーター

    タイプ

    必須

    説明

    値の例

    enable

    文字列

    はい

    Tencent Cloud COS の認証バケットを有効にするかどうかを指定します。

    • on:有効化

    • off:無効化

    on

    cos_valid_period

    文字列

    いいえ

    認証署名の有効期間 (秒) です。デフォルト値は 3600 秒です。

    /

    cos_secret_id

    文字列

    はい

    Tencent Cloud の認証 ID です。

    123456789

    cos_secret_key

    文字列

    はい

    Tencent Cloud の認証キーです。

    12345678

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "cos_secret_id",
                "argValue": "123456789"
            }, {
                "argName": "cos_secret_key",
                "argValue": "123456789"
            }],
            "functionName": "cos_auth"
        }],
        "DomainNames": "example.com"
    }

oss_auth

  • 機能説明:DCDN のオリジンフェッチで使用される Object Storage Service (OSS) バケットの認証情報を設定します。

  • 関数 ID (FunctionID/FuncId):10。

  • 注:プラットフォームは、OSS バケットを高速化ドメイン名のオリジンとして設定すると、自動的に `oss_auth` 構成を追加します。この構成を手動で追加または削除しないでください。この構成を削除すると、DCDN オリジントラフィックの課金免除が適用されなくなります。また、プライベートバケット認証が有効になっている場合、DCDN からプライベート OSS バケットへのオリジンフェッチは失敗します。

  • パラメーター:

    パラメーター

    タイプ

    必須

    説明

    値の例

    oss_bucket_id

    String

    はい

    OSS バケットのパブリックドメイン名。

    dcdn-test.oss-cn-hongkong.aliyuncs.com

    oss_pri_buckets

    String

    はい

    OSS バケットのパブリックドメイン名と、それに対応するバケット名。

    dcdn-test.oss-cn-hongkong.aliyuncs.com|dcdn-test

  • 設定例:

    {
        "Functions": [
                {
                  "ArgValue": "dcdn-test.oss-cn-hongkong.aliyuncs.com",
                  "ArgName": "oss_bucket_id"
                },
                {
                  "ArgValue": "dcdn-test.oss-cn-hongkong.aliyuncs.com|dcdn-test",
                  "ArgName": "oss_pri_buckets"
                }
              ],
            "functionName": "oss_auth"
        }],
        "DomainNames": "example.com"
    }

キャッシュ設定

filetype_based_ttl_set

  • ファイル拡張子に基づいてファイルのキャッシュの有効期限を指定します。詳細については、「キャッシュの TTL (生存時間) の設定」をご参照ください。

  • 関数 ID (FunctionID/FuncId): 6。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    ttl

    整数

    はい

    キャッシュ期間 (秒単位)。値は 1 から 99999999 までの整数である必要があります (3 年強に相当します)。

    500000

    file_type

    文字列

    はい

    ファイルタイプ。このパラメーターでは大文字と小文字が区別されます。複数のファイルタイプはコンマ (,) で区切ります。例:jpg,txt。

    jpg

    weight

    整数

    いいえ

    重み。有効値:1~99。

    説明

    デフォルト値は 1 です。値が大きいほど優先度が高くなります。

    1

    swift_origin_cache_high

    文字列

    いいえ

    オリジンサーバーのキャッシュポリシーを優先します。このパラメーターを `on` に設定すると、オリジンサーバーが `Cache-Control` や `Pragma` などのキャッシュ関連のヘッダーを返す場合、オリジンサーバーのキャッシュポリシーが優先されます。有効値:

    • `on`:有効

    • `off` (デフォルト):無効

    off

    swift_no_cache_low

    文字列

    いいえ

    オリジンサーバーからの `no-cache` 応答ヘッダーを無視します。このパラメーターを `on` に設定すると、オリジンサーバーからの次の `no-cache` 応答ヘッダーは無視されます。

    • Cache-Control: no-store

    • Cache-Control: no-cache

    • Cache-Control: max-age=0

    • Pragma: no-cache

    有効値:

    • `on`:有効

    • `off` (デフォルト):無効

    off

    swift_follow_cachetime

    文字列

    いいえ

    クライアントが DCDN キャッシュポリシーに従うことを許可します。このパラメーターを `on` に設定すると、最終的な DCDN キャッシュポリシーがクライアントに返されます。有効値:

    • `on`:有効

    • `off` (デフォルト):無効

    off

    force_revalidate

    文字列

    いいえ

    TTL が 0 の場合にコンテンツ検証を強制します。有効値:

    • `on`:有効。TTL が 0 の場合、コンテンツは POP (Point of Presence) にキャッシュされ、各リクエストはキャッシュされたコンテンツを検証するためにオリジンフェッチを必要とします。

    • `off` (デフォルト):無効。TTL が 0 の場合、コンテンツは POP にキャッシュされず、各リクエストはコンテンツを取得するためにオリジンフェッチを必要とします。

    off

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "file_type",
                "argValue": "jpg"
            }, {
                "argName": "weight",
                "argValue": "1"
            }, {
                "argName": "ttl",
                "argValue": "500000"
            }, {
                "argName": "swift_origin_cache_high",
                "argValue": "off"
            }, {
                "argName": "swift_no_cache_low",
                "argValue": "off"
            }, {
                "argName": "swift_follow_cachetime",
                "argValue": "off"
            },{
                "argName": "force_revalidate",
                "argValue": "off"
            }],
            "functionName": "filetype_based_ttl_set"
        }],
        "DomainNames": "example.com"
    }
    

path_based_ttl_set

  • 説明:フォルダーのキャッシュの有効期限を設定します。詳細については、「キャッシュの有効期限の設定」をご参照ください。

  • 関数 ID (FunctionID/FuncId): 7。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    ttl

    整数

    はい

    キャッシュ期間 (秒単位)。値は 1 から 99999999 までの整数である必要があります (3 年強に相当します)。

    500000

    path

    文字列

    はい

    フォルダーパス。パスはスラッシュ (/) で始まる必要があります。

    /example/demo

    weight

    整数

    いいえ

    重み。有効値:1~99。

    説明

    デフォルト値は 1 です。値が大きいほど優先度が高くなります。

    1

    swift_origin_cache_high

    文字列

    いいえ

    オリジンサーバーのキャッシュポリシーを優先します。このパラメーターを `on` に設定すると、オリジンサーバーが `Cache-Control` や `Pragma` などのキャッシュ関連のヘッダーを返す場合、オリジンサーバーのキャッシュポリシーが優先されます。有効値:

    • `on`:有効

    • `off` (デフォルト):無効

    off

    swift_no_cache_low

    文字列

    いいえ

    オリジンサーバーからの `no-cache` 応答ヘッダーを無視します。このパラメーターを `on` に設定すると、オリジンサーバーからの次の `no-cache` 応答ヘッダーは無視されます。

    • Cache-Control: no-store

    • Cache-Control: no-cache

    • Cache-Control: max-age=0

    • Pragma: no-cache

    有効値:

    • `on`:有効

    • `off` (デフォルト):無効

    off

    swift_follow_cachetime

    文字列

    いいえ

    クライアントが DCDN キャッシュポリシーに従うことを許可します。このパラメーターを `on` に設定すると、最終的な DCDN キャッシュポリシーがクライアントに返されます。有効値:

    • `on`:有効

    • `off` (デフォルト):無効

    off

    force_revalidate

    文字列

    いいえ

    TTL が 0 の場合にコンテンツ検証を強制します。有効値:

    • `on`:有効。TTL が 0 の場合、コンテンツは POP (Point of Presence) にキャッシュされ、各リクエストはキャッシュされたコンテンツを検証するためにオリジンフェッチを必要とします。

    • `off` (デフォルト):無効。TTL が 0 の場合、コンテンツは POP にキャッシュされず、各リクエストはコンテンツを取得するためにオリジンフェッチを必要とします。

    off

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "path",
                "argValue": "/example/demo"
            }, {
                "argName": "weight",
                "argValue": "1"
            }, {
                "argName": "ttl",
                "argValue": "500000"
            }, {
                "argName": "swift_origin_cache_high",
                "argValue": "off"
            }, {
                "argName": "swift_no_cache_low",
                "argValue": "off"
            }, {
                "argName": "swift_follow_cachetime",
                "argValue": "off"
            }, {
                "argName": "force_revalidate",
                "argValue": "off"
            }],
            "functionName": "path_based_ttl_set"
        }],
        "DomainNames": "example.com"
    }
    

filetype_force_ttl_code

  • ステータスコードのキャッシュの有効期限を設定します。詳細については、「ステータスコードの有効期限の設定」をご参照ください。

  • 関数 ID (FunctionID/FuncId): 63。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    file_type

    文字列

    はい

    ファイルタイプ。このパラメーターでは大文字と小文字が区別されます。複数のファイルタイプはコンマ (,) で区切ります。例:jpg,txt。

    jpg

    code_string

    文字列

    はい

    ステータスコードとそのキャッシュ期間 (秒単位)。最大期間は 3 年です。複数のエントリはコンマ (,) で区切ります。例:302=0,301=0,4xx=2。

    403=10

    swift_code_origin_cache_high

    文字列

    いいえ

    オリジンサーバーのキャッシュポリシーを優先します。このパラメーターを `on` に設定すると、オリジンサーバーが `Cache-Control` や `Pragma` などのキャッシュ関連のヘッダーを返す場合、オリジンサーバーのキャッシュポリシーが優先されます。有効値:

    • `on`:有効

    • `off` (デフォルト):無効

    off

    swift_code_no_cache_low

    文字列

    いいえ

    オリジンサーバーからの `no-cache` 応答ヘッダーを無視します。このパラメーターを `on` に設定すると、オリジンサーバーからの次の `no-cache` 応答ヘッダーは無視されます。

    • Cache-Control: no-store

    • Cache-Control: no-cache

    • Cache-Control: max-age=0

    • Pragma: no-cache

    有効値:

    • `on`:有効

    • `off` (デフォルト):無効

    off

    swift_code_follow_cachetime

    文字列

    いいえ

    クライアントが DCDN キャッシュポリシーに従うことを許可します。このパラメーターを `on` に設定すると、最終的な DCDN キャッシュポリシーがクライアントに返されます。有効値:

    • `on`:有効

    • `off` (デフォルト):無効

    off

    force_revalidate

    文字列

    いいえ

    TTL が 0 の場合にコンテンツ検証を強制します。有効値:

    • `on`:有効。TTL が 0 の場合、コンテンツは POP (Point of Presence) にキャッシュされ、各リクエストはキャッシュされたコンテンツを検証するためにオリジンフェッチを必要とします。

    • `off` (デフォルト):無効。TTL が 0 の場合、コンテンツは POP にキャッシュされず、各リクエストはコンテンツを取得するためにオリジンフェッチを必要とします。

    off

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "file_type",
                "argValue": "jpg"
            }, {
                "argName": "code_string",
                "argValue": "403=10"
            }, {
                "argName": "swift_code_origin_cache_high",
                "argValue": "off"
            }, {
                "argName": "swift_code_no_cache_low",
                "argValue": "off"
            }, {
                "argName": "swift_code_follow_cachetime",
                "argValue": "off"
            }, {
                "argName": "force_revalidate",
                "argValue": "off"
            }],
            "functionName": "filetype_force_ttl_code"
        }],
        "DomainNames": "example.com"
    }

path_force_ttl_code

  • 特定のパスのステータスコードのキャッシュの有効期限を設定します。詳細については、「ステータスコードの有効期限の設定」をご参照ください。

  • 関数 ID (FunctionID/FuncId): 65。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    path

    文字列

    はい

    フォルダーパス。パスはスラッシュ (/) で始まる必要があります。例:/image。

    /example/demo

    code_string

    文字列

    はい

    ステータスコードとそのキャッシュ期間 (秒単位)。値は 1 から 99999999 までの整数である必要があります (3 年強に相当します)。複数のエントリはコンマ (,) で区切ります。例:302=0,301=0,4xx=2。

    403=10,404=15

    swift_code_origin_cache_high

    文字列

    いいえ

    オリジンサーバーのキャッシュポリシーを優先します。このパラメーターを `on` に設定すると、オリジンサーバーが `Cache-Control` や `Pragma` などのキャッシュ関連のヘッダーを返す場合、オリジンサーバーのキャッシュポリシーが優先されます。有効値:

    • `on`:有効

    • `off` (デフォルト):無効

    off

    swift_code_no_cache_low

    文字列

    いいえ

    オリジンサーバーからの `no-cache` 応答ヘッダーを無視します。このパラメーターを `on` に設定すると、オリジンサーバーからの次の `no-cache` 応答ヘッダーは無視されます。

    • Cache-Control: no-store

    • Cache-Control: no-cache

    • Cache-Control: max-age=0

    • Pragma: no-cache

    有効値:

    • `on`:有効

    • `off` (デフォルト):無効

    off

    swift_code_follow_cachetime

    文字列

    いいえ

    クライアントが DCDN キャッシュポリシーに従うことを許可します。このパラメーターを `on` に設定すると、最終的な DCDN キャッシュポリシーがクライアントに返されます。有効値:

    • `on`:有効

    • `off` (デフォルト):無効

    off

    force_revalidate

    文字列

    いいえ

    TTL が 0 の場合にコンテンツ検証を強制します。有効値:

    • `on`:有効。TTL が 0 の場合、コンテンツは POP (Point of Presence) にキャッシュされ、各リクエストはキャッシュされたコンテンツを検証するためにオリジンフェッチを必要とします。

    • `off` (デフォルト):無効。TTL が 0 の場合、コンテンツは POP にキャッシュされず、各リクエストはコンテンツを取得するためにオリジンフェッチを必要とします。

    off

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "path",
                "argValue": "/example/demo"
            }, {
                "argName": "code_string",
                "argValue": "403=10,404=15"
            }, {
                "argName": "swift_code_origin_cache_high",
                "argValue": "off"
            }, {
                "argName": "swift_code_no_cache_low",
                "argValue": "off"
            }, {
                "argName": "swift_code_follow_cachetime",
                "argValue": "off"
            }, {
                "argName": "force_revalidate",
                "argValue": "off"
            }],
            "functionName": "path_force_ttl_code"
        }],
        "DomainNames": "example.com"
    }
    

default_ttl_code

  • 説明:ステータスコードのキャッシュの有効期限を設定します (オリジン優先)。

  • 関数 ID (FunctionID/FuncId): 207。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    default_ttl_code

    文字列

    はい

    ステータスコードとそのキャッシュ期間 (秒単位)。値は 1 から 99999999 までの整数である必要があります (3 年強に相当します)。複数のステータスコードはコンマ (,) で区切ります。

    4xx=3,200=3600,5xx=1

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "default_ttl_code",
                "argValue": "4xx=3,200=3600,5xx=1"
            }],
            "functionName": "default_ttl_code"
        }],
        "DomainNames": "example.com"
    }

set_resp_header

  • 説明:カスタム HTTP 応答ヘッダーを設定します。詳細については、「アウトバウンド応答ヘッダーの変更」をご参照ください。

  • 関数 ID (FunctionID/FuncId): 27。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    key

    文字列

    はい

    応答ヘッダー。

    Cache-Control

    value

    文字列

    はい

    応答ヘッダーの値。複数の値はコンマ (,) で区切ります。

    説明

    応答ヘッダーを削除するには、その値を null に設定します。

    no-cache

    header_operation_type

    文字列

    いいえ

    リクエストヘッダーに対して実行する操作です。値は次のとおりです。

    • add:エントリを追加します。

    • Delete:削除します。

    • Modify:変更します。

    • `rewrite`:ヘッダーを置き換えます。

    add

    duplicate

    文字列

    いいえ

    同じ名前の応答ヘッダーの追加を許可するかどうかを指定します。このパラメーターは、`header_operation_type` を `add` に設定する場合に必須です。有効値:

    • on:重複を許可します。

    • `off`:許可しません。

    off

    header_source

    文字列

    いいえ

    置き換えられる値。このパラメーターは、`header_operation_type` を `rewrite` に設定する場合に必須です。値には正規表現を使用できます。

    value1

    header_destination

    文字列

    いいえ

    新しい値。このパラメーターは、`header_operation_type` を `rewrite` に設定する場合に必須です。

    value123

    match_all

    文字列

    いいえ

    一致パターン。このパラメーターは、`header_operation_type` を `rewrite` に設定する場合に必須です。有効値:

    • `on`:すべてに一致。一致したすべての値が置き換えられます。

    • `off`:最初に一致。最初に一致した値のみが置き換えられます。

    /

    access_origin_control

    文字列

    いいえ

    クロスドメイン認証を有効にするかどうかを指定します。有効値:

    • `on`:DCDN POP がクロスドメインのユーザーリクエストを認証します。

    • `off`:この機能を無効にします。

    /

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "header_operation_type",
                "argValue": "add"
            }, {
                "argName": "key",
                "argValue": "Cache-Control"
            }, {
                "argName": "value",
                "argValue": "no-cache"
            }, {
                "argName": "duplicate",
                "argValue": "off"
            }],
            "functionName": "set_resp_header"
        }],
        "DomainNames": "example.com"
    }

error_page

  • 説明:カスタムエラーページを設定します。詳細については、「カスタムページの設定」をご参照ください。

  • 関数 ID (FunctionID/FuncId): 15。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    error_code

    整数

    はい

    エラーコード。

    404

    rewrite_page

    文字列

    はい

    リダイレクトページ。

    http://example.aliyundoc.com/error404.html

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "error_code",
                "argValue": "404"
            }, {
                "argName": "rewrite_page",
                "argValue": "http://example.aliyundoc.com/error404.html"
            }],
            "functionName": "error_page"
        }],
        "DomainNames": "example.com"
    }

host_redirect

  • 機能説明:URI 書き換えルールを設定します。コンソールでの詳細な設定手順については、「URI 書き換えルールの設定」をご参照ください。

  • 関数 ID (FunctionID/FuncId): 43。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    regex

    文字列

    はい

    書き換え対象の URL。スラッシュ (/) で始まり、`http://` プロトコルやドメイン名を含まない URI である必要があります。PCRE 正規表現がサポートされています。例:^/hello$。

    ^/hello$

    replacement

    文字列

    はい

    宛先 URL。スラッシュ (/) で始まり、`http://` プロトコルやドメイン名を含まない URI である必要があります。

    /hello/test

    flag

    文字列

    いいえ

    URI が書き換えられた後に DCDN POP が実行するアクション。有効値:

    • :デフォルト値。これは、flag パラメーターが渡されないことを意味します。複数のルールが設定されていて、リクエスト URL があるルールに一致した場合、POP は現在のルールを実行した後、後続のルールとの照合を続行します。

    • break:リクエスト URL がルールに一致した場合、リクエストは宛先 URL に書き換えられます。元の URL のパラメーターは変更されません。現在のルールが実行された後、それ以上のルールは照合されません。

    • redirect:リクエスト URL がルールに一致した場合、リクエストは 302 ステータスコードで宛先 URL にリダイレクトされます。DCDN POP は宛先 URL を `Location` ヘッダーとしてクライアントに返します。元の URL のパラメーターは変更されません。現在のルールが実行された後も、後続のルールは照合されます。

    • enhance_breakbreak に似ていますが、パラメーターを含む URL 全体を書き換えます。

    • enhance_redirectredirect に似ていますが、パラメーターを含む URL 全体を書き換えます。

    説明

    書き換えメソッドおよび他のドメイン名やプロトコルのサポートは、アクションによって異なります:

    • break、および enhance_break は、ユーザーリクエスト URL を直接書き換えます。HTTP から HTTPS への書き換えなど、他のドメイン名やプロトコルへの書き換えはサポートしていません。

    • redirect および enhance_redirect は、302 リダイレクトを使用して URL を書き換えます。他のドメイン名やプロトコルへの書き換えをサポートしています:

      • 302 の `Location` アドレスは、現在の高速化ドメイン名または別のドメイン名に設定できます。たとえば、URL を `example.com` から `aliyundoc.com` に書き換えることができます。

      • 302 の `Location` アドレスは他のプロトコルをサポートしています。たとえば、URL を HTTP から HTTPS に書き換えることができます。

    redirect

    rewrite_method

    文字列

    いいえ

    リダイレクトメソッド。302、303、307 のステータスコードがサポートされています:

    • 302:デフォルトのリダイレクトメソッド。GET リクエストメソッドは変更されません。他のリクエストメソッドは GET に変更される場合があります。

    • 303:GET リクエストメソッドは変更されません。他のリクエストメソッドは GET に変更され、メッセージ本文は失われます。

    • 307:リクエストメソッドとメッセージ本文は変更されません。

    302

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "flag",
                "argValue": "redirect"
            }, {
                "argName": "regex",
                "argValue": "^/hello$"
            }, {
                "argName": "replacement",
                "argValue": "/hello/test"
            }, {
                "argName": "rewrite_method",
                "argValue": "302"
            }],
            "functionName": "host_redirect"
        }],
        "DomainNames": "example.com"
    }

self_defined_cachekey

  • 説明:カスタムキャッシュキーを設定します。詳細については、「カスタムキャッシュキー」をご参照ください。

  • 関数 ID (FunctionID/FuncId): 227。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    uri

    文字列の配列

    いいえ

    リクエスト内のソース URI を宛先 URI に書き換え、その結果をキャッシュキーとして保存します。

    • `uri_to_rewrite` はソース URI を指定します。

    • `ai_uri_regex` は宛先 URI を指定します。

    [{"uri_to_rewrite":"/hello","ai_uri_regex":"/hello/test"}]

    args

    文字列の配列

    いいえ

    リクエストパラメーターに対して追加、削除、変更、または保持の操作を実行し、その結果をキャッシュキーとして保存します。有効値:

    • `args_operation_type`:パラメーターの操作タイプを指定します。サポートされている値は `add`、`delete`、`modify`、`keep` です。

    • `args`:操作のパラメーター値を指定します。

    [{"args":"test=123","args_operation_type":"add"}]

    headers

    文字列

    いいえ

    複数の HTTP ヘッダーを追加し、キャッシュキーに追加します。複数の HTTP ヘッダーはスペースで区切ります。

    example

    variable

    文字列の配列

    いいえ

    カスタム変数。正規表現を使用して、リクエスト URL 内のリクエストパラメーター、HTTP ヘッダー、Cookie、または URI から任意のフィールドを抽出し、そのフィールドをキャッシュキーに追加できます。

    []

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "uri",
                "argValue": [{
                    "uri_to_rewrite": "/hello",
                    "ai_uri_regex": "/hello/test"
                }]
            }, {
                "argName": "args",
                "argValue": [{
                    "args": "test=123",
                    "args_operation_type": "add"
                }]
            }, {
                "argName": "headers",
                "argValue": ""
            }, {
                "argName": "variable",
                "argValue": []
            }],
            "functionName": "self_defined_cachekey"
        }],
        "DomainNames": "example.com"
    }

rewrite_host

  • 説明:共有キャッシュを設定します。

  • 関数 ID (FunctionID/FuncId): 54。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    share_host

    文字列

    はい

    現在のドメイン名とキャッシュを共有できる宛先ドメイン名。この設定は、オリジンフェッチの `Host` ヘッダーを変更しません。キャッシュされたリソースをクエリするためのキャッシュキーを生成するために `share_host` の値のみを使用します。

    example.com

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "share_host",
                "argValue": "example.com"
            }],
            "functionName": "rewrite_host"
        }],
        "DomainNames": "example.com"
    }

serving_stale_content

  • 説明:オリジンサーバーが利用できない場合に、古いコンテンツを配信します。

  • 関数 ID (FunctionID/FuncId): 260。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    origin_error_status_code

    文字列

    いいえ

    オリジンサーバーからのカスタムの異常なステータスコード。

    • 説明:この機能が適用されるオリジンのステータスコードを指定します。

    • デフォルト値:このパラメーターはデフォルトでは指定されません。デフォルトでは、オリジンエラーはタイムアウトまたは任意の 5xx ステータスコードとして定義されます。

    • 設定:あいまい一致には `4xx` または `5xx` を入力でき、完全一致には `502` や `504` などの特定のステータスコードを入力できます。複数のステータスコードを指定するには、コンマ (,) で区切ります。

    502

    extend_expiration_time

    整数

    いいえ

    延長有効期限。

    • 説明:古いキャッシュが有効期限切れになった後、それを保持する最大時間。

    • デフォルト値:このパラメーターはデフォルトでは指定されません。デフォルトの延長有効期限は 1 時間です。

    • 設定:1 以上の正の整数を入力します。単位:秒。

    60

    origin_first

    文字列

    いいえ

    オリジンポリシーを優先します。

    • 説明:このパラメーターを on に設定すると、オリジンポリシーが優先されます。オリジンサーバーが Cache-Control: stale-if-error=xx キャッシュポリシーを持つファイルを返す場合、`stale-if-error` パラメーターで指定された時間が延長有効期限として使用されます。

    • デフォルト値:このパラメーターはデフォルトでは指定されません。これは `off` と同等です。この場合、延長有効期限は `extend_expiration_time` パラメーターによって指定されます。

    • 設定:サポートされている値は on (有効) と off (無効) です。

    on

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "origin_error_status_code",
                "argValue": "502"
            }, {
                "argName": "extend_expiration_time",
                "argValue": "60"
            }, {
                "argName": "origin_first",
                "argValue": "off"
            }],
            "functionName": "serving_stale_content"
        }],
        "DomainNames": "example.com"
    }

HTTPS 構成

https_option

  • 機能説明:基本的な HTTPS パラメーターを設定します。詳細については、「HTTPS 証明書の設定」、「HTTP/2 の設定」、および「OCSP Stapling の設定」をご参照ください。

  • 関数 ID (FunctionID/FuncId):78

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    値の例

    http2

    文字列

    いいえ

    HTTP/2 を有効にするかどうかを指定します。

    • on:この機能を有効にします。

    • off:この機能を無効にします。

    on

    ocsp_stapling

    文字列

    いいえ

    Online Certificate Status Protocol (OCSP) Stapling 機能を有効にするかどうかを指定します。

    • on:この機能を有効にします。

    • off:この機能を無効にします。

    on

  • 設定例:

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

http_force

  • 説明:HTTP への強制リダイレクトを設定します。詳細については、「強制リダイレクトの設定」をご参照ください。

  • 機能の競合:HTTP への強制リダイレクト機能は、HTTPS への強制リダイレクト機能 (関数:https_force、関数 ID:44) と競合します。これらの機能のうち、有効にできるのは 1 つだけです。いずれかの機能がすでに設定されている場合、もう一方の機能を追加で設定する前に、既存の設定を削除する必要があります。機能のスイッチパラメーターが `off` に設定されていても、その機能は設定済みと見なされます。ドメイン名の機能設定を削除するには、DeleteDcdnSpecificConfig 操作を呼び出します。

  • 関数 ID (FunctionID/FuncId):45。

  • パラメーター:

    パラメーター

    タイプ

    必須

    説明

    値の例

    enable

    String

    はい

    強制 HTTP リダイレクトを有効にするかどうかを指定します。

    • on:この機能を有効にします。

    • off:この機能を無効にします。

    on

    http_rewrite

    String

    いいえ

    リダイレクトメソッド。サポートされているステータスコードは 301 と 308 です。

    • 301:GET リクエストメソッドは変更されません。他のリクエストメソッドは GET メソッドに変更される場合があります。

    • 308:リクエストメソッドとメッセージエンティティは変更されません。

    301

  • 設定例:

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

https_force

  • 機能説明:HTTPS への強制リダイレクトを設定します。 詳細については、「強制リダイレクトの設定」をご参照ください。

  • 機能の競合:HTTPS への強制リダイレクト機能は、HTTP への強制リダイレクト機能 (関数:http_force、関数 ID:45) と競合します。 どちらか一方の機能しか有効にできません。 一方の機能がすでに設定されている場合、もう一方の機能を使用するには、既存の設定を削除する必要があります。 スイッチパラメーターが `off` に設定されていても、機能は設定済みと見なされます。 設定を削除するには、DeleteDcdnSpecificConfig 操作を呼び出します。 設定が削除された後、もう一方の機能を設定できます。

  • 関数 ID (FunctionID/FuncId):44

  • パラメーターの説明:

    パラメーター

    必須

    説明

    enable

    String

    はい

    HTTPS への強制リダイレクトを有効にするかどうかを指定します。

    • on:機能を有効にします。

    • off:機能を無効にします。

    on

    https_rewrite

    String

    いいえ

    リダイレクト方式。 有効な値は 301 と 308 です。

    • 301:GET リクエストメソッドは変更されません。 他のリクエストメソッドは GET に変更される場合があります。

    • 308:リクエストメソッドとメッセージエンティティは変更されません。

    301

  • 設定例:

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

https_tls_version

  • 機能説明:TLS バージョンを設定します。詳細については、「TLS バージョンと暗号スイートの設定」をご参照ください。

  • 関数 ID (FuncId):110。

  • パラメーター:

    パラメーター

    タイプ

    必須

    説明

    値の例

    tls10

    文字列

    いいえ

    TLSv1.0 を有効にするかどうかを指定します:

    • on (デフォルト):設定を有効にします。

    • オフ:インスタンスはシャットダウンされています。

    on

    tls11

    文字列

    いいえ

    TLSv1.1 を有効にするかどうかを指定します:

    • on (デフォルト):有効。

    • off:設定を無効にします。

    on

    tls12

    文字列

    いいえ

    TLSv1.2 を有効にするかどうかを指定します:

    • on (デフォルト):設定は有効です。

    • off:設定を無効にします。

    on

    tls13

    文字列

    いいえ

    TLSv1.3 を有効にするかどうかを指定します:

    • on (デフォルト):設定を有効にします。

    • off:設定を無効にします。

    on

    ciphersuitegroup

    文字列

    いいえ

    暗号スイートグループ:

    • all (デフォルト):すべての暗号スイート。

    • strict:強力な暗号スイート。

    • custom:カスタム暗号スイート。

    all

    ciphersuite

    文字列

    いいえ

    カスタム暗号スイート。このパラメーターは、ciphersuitegroup が custom に設定されている場合にのみ有効です。複数の暗号スイートを指定する場合は、コンマ (,) で区切ります。

    TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256,TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256

  • 設定例:

    • デフォルト設定:TLS 1.0、TLS 1.1、TLS 1.2 を有効にし、すべての暗号スイートを使用します。

      {
          "Functions": [{
              "functionArgs": [
                  {
                    "ArgValue": "on",
                    "ArgName": "tls10"
                  },
                  {
                    "ArgValue": "on",
                    "ArgName": "tls11"
                  },
                  {
                    "ArgValue": "on",
                    "ArgName": "tls12"
                  },
                  {
                    "ArgValue": "off",
                    "ArgName": "tls13"
                  },
                  {
                    "ArgValue": "all",
                    "ArgName": "ciphersuitegroup"
                  }
                ],
              "functionName": "https_tls_version"
          }],
          "DomainNames": "example.com"
      }
    • TLS 1.2 と TLS 1.3 を有効にし、強力な暗号スイートを使用します。

      {
          "Functions": [{
              "functionArgs": [
                  {
                    "ArgValue": "off",
                    "ArgName": "tls10"
                  },
                  {
                    "ArgValue": "off",
                    "ArgName": "tls11"
                  },
                  {
                    "ArgValue": "on",
                    "ArgName": "tls12"
                  },
                  {
                    "ArgValue": "on",
                    "ArgName": "tls13"
                  },
                  {
                    "ArgValue": "strict",
                    "ArgName": "ciphersuitegroup"
                  }
                ],
              "functionName": "https_tls_version"
          }],
          "DomainNames": "example.com"
      }
    • TLS 1.2 と TLS 1.3 を有効にし、カスタム暗号スイートを使用します。

      {
          "Functions": [{
              "functionArgs": [
                  {
                    "ArgValue": "off",
                    "ArgName": "tls10"
                  },
                  {
                    "ArgValue": "off",
                    "ArgName": "tls11"
                  },
                  {
                    "ArgValue": "on",
                    "ArgName": "tls12"
                  },
                  {
                    "ArgValue": "on",
                    "ArgName": "tls13"
                  },
                  {
                    "ArgValue": "custom",
                    "ArgName": "ciphersuitegroup"
                  },
                  {
                    "ArgValue": "TLS_ECDHE_ECDSA_WITH_AES_128_CCM_8,TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256,TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256",
                    "ArgName": "ciphersuite"
                  }
                ],
              "functionName": "https_tls_version"
          }],
          "DomainNames": "example.com"
      }

HSTS

  • 説明: HTTP Strict Transport Security (HSTS) を設定します。詳細については、「HSTS を設定する」をご参照ください。

  • Function ID (FunctionID/FuncId) は 112 です。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    サンプル値

    有効

    文字列

    はい

    HSTS の有効化:

    • 有効。

    • オフ:システムをシャットダウンします。

    オン

    https_hsts_max_age

    整数

    はい

    秒単位の有効期限です。

    説明

    5,184,000 s (60 日) を推奨します。

    5184000

    https_hsts_include_subdomains

    文字列

    いいえ

    HTTP Strict Transport Security (HSTS) ヘッダーにサブドメインパラメーターを含めるかどうかを指定します。有効な値は on または off です。

    説明

    このオプションを有効にする前に、高速化ドメイン名のすべてのサブドメインで HTTPS が有効になっていることを確認してください。そうしない場合、サブドメインは自動的に HTTPS にリダイレクトされ、アクセスできなくなります。

    オフ

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enabled",
                "argValue": "on"
            }, {
                "argName": "https_hsts_max_age",
                "argValue": "5184000"
            }, {
                "argName": "https_hsts_include_subdomains",
                "argValue": "off"
            }],
            "functionName": "HSTS"
        }],
        "DomainNames": "example.com"
    }

アクセス制御

referer_white_list_set

  • 説明: Referer ホワイトリストを設定します。コンソールでこの機能 を設定する方法の詳細については、「Referer のホットリンク保護の設定」をご参照ください。

  • 競合: Referer ホワイトリスト機能は、Referer ブラックリスト機能 (関数: referer_black_list_set、関数 ID: 5) と相互に排他的です。どちらか一方しか有効にできません。一方の機能がすでに設定されている場合は、もう一方の機能 を設定する前に、その設定を削除する必要があります。スイッチパラメーターが `off` に設定されていても、機能は設定済みと見なされます。ドメイン名の特定の設定を削除するには、DeleteDcdnSpecificConfig 操作を呼び出します。

  • 関数 ID (FunctionID/FuncId): 1

  • パラメーター:

    パラメーター

    タイプ

    必須

    説明

    refer_domain_allow_list

    String

    はい

    ホワイトリスト。複数のドメイン名をコンマ (,) で区切ります。

    example.aliyundoc.com,demo.aliyundoc.com

    allow_empty

    String

    いいえ

    Referer フィールドが空の場合に DCDN リソースへのアクセスを許可するかどうかを指定します。有効な値は次のとおりです。

    • on: アクセスを許可します。

    • off (デフォルト): アクセスを拒否します。

    off

    redirect_url

    String

    いいえ

    リダイレクト URL。ユーザーリクエストの Referer がホワイトリストのどのドメイン名とも一致しない場合、リクエストはブロックされます。DCDN は 403 エラーを返す代わりに、302 ステータスコードと Location ヘッダーを返します。このパラメーターは Location ヘッダーの値を指定します。URL は http:// または https:// で始まる必要があります。

    http://www.example.com

    disable_ast

    String

    いいえ

    完全一致モードを有効にします。これにより、ホワイトリスト内のドメイン名が完全に一致するかどうかを制御します。このパラメーターを on に設定すると、完全一致が使用されます。

    • on に設定した場合:

      • 完全一致がサポートされます。

        • ホワイトリストに example.com が含まれている場合、example.com に一致します。

        • ホワイトリストに a*b.example.com が含まれている場合、a<任意の文字列>b.example.com に一致します。

      • 後方一致はサポートされません。

    • off (デフォルト) に設定した場合:

      • 完全一致はサポートされません。

      • 後方一致がサポートされます。

        • ホワイトリストに example.com が含まれている場合、example.com<任意の文字列>.example.com に一致します。

        • ホワイトリストに a*b.example.com が含まれている場合、a<任意の文字列>b.example.com<任意の文字列>.a<任意の文字列>b.example.com に一致します。

    off

    ignore_scheme

    String

    いいえ

    スキームを無視するかどうかを指定します。有効にすると、ユーザーリクエストの Referer に HTTP または HTTPS プロトコルヘッダーが含まれていなくても、有効と見なされます。例:

    • on に設定した場合、Referer のフォーマットは次のようになります。

      referer: www.example.com

    • off (デフォルト) に設定した場合、Referer のフォーマットは次のようになります。

      referer: https://www.example.com

    off

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "allow_empty",
                "argValue": "off"
            }, {
                "argName": "refer_domain_allow_list",
                "argValue": "example.aliyundoc.com,demo.aliyundoc.com"
            }],
            "functionName": "referer_white_list_set"
        }],
        "DomainNames": "example.com"
    }

referer_black_list_set

  • 説明: Referer ブラックリストを設定します。コンソールでこの機能 を設定する方法の詳細については、「Referer のホットリンク保護の設定」をご参照ください。

  • 競合: Referer ブラックリスト機能は、Referer ホワイトリスト機能 (関数: referer_white_list_set、関数 ID: 1) と相互に排他的です。どちらか一方しか有効にできません。一方の機能がすでに設定されている場合は、もう一方の機能 を設定する前に、その設定を削除する必要があります。スイッチパラメーターが `off` に設定されていても、機能は設定済みと見なされます。ドメイン名の特定の設定を削除するには、DeleteDcdnSpecificConfig 操作を呼び出します。

  • 関数 ID (FunctionID/FuncId): 5

  • パラメーター:

    パラメーター

    タイプ

    必須

    説明

    refer_domain_deny_list

    String

    はい

    ブラックリスト。複数のドメイン名をコンマ (,) で区切ります。

    example.aliyundoc.com,demo.aliyundoc.com

    allow_empty

    String

    いいえ

    Referer フィールドが空の場合に DCDN リソースへのアクセスを許可するかどうかを指定します。

    • on: アクセスを許可します。

    • off: アクセスを拒否します。

    off

    redirect_url

    String

    いいえ

    リダイレクト URL。ユーザーリクエストの Referer がブラックリストのドメイン名と一致する場合、リクエストはブロックされます。DCDN は 403 エラーを返す代わりに、302 ステータスコードと Location ヘッダーを返します。このパラメーターは Location ヘッダーの値を指定します。URL は http:// または https:// で始まる必要があります。

    http://www.example.com

    disable_ast

    String

    いいえ

    完全一致モードを有効にします。これにより、ブラックリスト内のドメイン名が完全に一致するかどうかを制御します。このパラメーターを on に設定すると、完全一致が使用されます。

    • on に設定した場合:

      • 完全一致がサポートされます。

        • ブラックリストに example.com が含まれている場合、example.com に一致します。

        • ブラックリストに a*b.example.com が含まれている場合、a<任意の文字列>b.example.com に一致します。

      • 後方一致はサポートされません。

    • off (デフォルト) に設定した場合:

      • 完全一致はサポートされません。

      • 後方一致がサポートされます。

        • ブラックリストに example.com が含まれている場合、example.com<任意の文字列>.example.com に一致します。

        • ブラックリストに a*b.example.com が含まれている場合、a<任意の文字列>b.example.com<任意の文字列>.a<任意の文字列>b.example.com に一致します。

    off

    ignore_scheme

    String

    いいえ

    スキームを無視するかどうかを指定します。有効にすると、ユーザーリクエストの Referer に HTTP または HTTPS プロトコルヘッダーが含まれていなくても、有効と見なされます。例:

    • on に設定した場合、Referer のフォーマットは次のようになります。

      referer: www.example.com

    • off (デフォルト) に設定した場合、Referer のフォーマットは次のようになります。

      referer: https://www.example.com

    off

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "allow_empty",
                "argValue": "off"
            }, {
                "argName": "refer_domain_deny_list",
                "argValue": "example.aliyundoc.com,demo.aliyundoc.com"
            }],
            "functionName": "referer_black_list_set"
        }],
        "DomainNames": "example.com"
    }

aliauth

  • 説明: URL 署名を設定します。コンソールでこの機能 を設定する方法の詳細については、「URL 署名の設定」をご参照ください。

  • 関数 ID (FunctionID/FuncId): 25

  • パラメーター:

    パラメーター

    タイプ

    必須

    説明

    auth_m3u8

    String

    いいえ

    M3U8 コンテンツの書き換えを有効にします。これにより、M3U8 ファイル内の TS ファイルに必要な署名パラメーターが追加され、アクセス失敗を防ぎます。有効な値は on (デフォルト) と off です。

    on

    auth_type

    String

    はい

    署名メソッド。有効な値は次のとおりです。

    • no_auth: 署名なし。

    • type_a: タイプ A 署名。

    • type_b: タイプ B 署名。

    • type_c: タイプ C 署名。

    • type_f: タイプ F 署名。

    type_a

    auth_key1

    String

    はい

    暗号化キー 1。キーは 16~128 文字で、大文字、小文字、数字を含めることができます。

    1234567890123456789

    auth_key2

    String

    いいえ

    暗号化キー 2。キーは 16~128 文字で、大文字、小文字、数字を含めることができます。

    1234567890123456789

    ali_auth_delta

    Integer

    いいえ

    署名付き URL の有効期間。デフォルト値: 1800。単位: 秒。

    1800

    req_auth_ip_white

    String

    いいえ

    IP ホワイトリスト。このリスト内の IP アドレスは署名検証から除外されます。

    複数の IP アドレスを入力できます。コンマ (,) で区切ります。

    192.168.0.1

    req_auth_ip_acl_xfwd

    String

    いいえ

    ホワイトリストのクライアント IP アドレスを取得するメソッド。有効な値は次のとおりです。

    • on: デフォルトのモードです。DCDN は、ユーザーリクエストの X-Forwarded-For ヘッダーの左端の最初の IP アドレスを検証します。この IP アドレスは、クライアントの送信元 IP アドレスです。

    • off: DCDN は、クライアントと DCDN の POP (Point of Presence) との間の接続を確立するために使用される IP アドレスを検証します。

    • all: DCDN は、次の両方の IP アドレスを検証します。

      • ユーザーリクエストの X-Forwarded-For ヘッダーの左端の最初の IP アドレス。これはクライアントの送信元 IP アドレスです。

      • クライアントと DCDN の POP (Point of Presence) との間の接続を確立するために使用される IP アドレス。

    all

    sign_param

    String

    いいえ

    署名パラメーターの名前。このパラメーターは、`auth_type` が `type_f` に設定されている場合にのみ有効です。

    sign

    time_param

    String

    いいえ

    タイムスタンプパラメーターの名前。このパラメーターは、`auth_type` が `type_f` に設定されている場合にのみ有効です。

    time

    time_format

    String

    いいえ

    タイムスタンプのフォーマット。このパラメーターは、`auth_type` が `type_f` に設定されている場合にのみ有効です。

    • dec: 10 進数

    • hex: 16 進数

    hec

    path_encoding

    String

    いいえ

    URL エンコーディングを有効にするかどうかを指定します。有効な値: on と off。このパラメーターは、`auth_type` が `type_f` に設定されている場合にのみ有効です。

    on

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "auth_type",
                "argValue": "type_a"
            }, {
                "argName": "auth_key1",
                "argValue": "1234567890123456789"
            }, {
                "argName": "auth_key2",
                "argValue": "1234567890123456789"
            }, {
                "argName": "ali_auth_delta",
                "argValue": 1800
            }, {
                "argName": "req_auth_ip_white",
                "argValue": "192.168.0.1"
            }, {
                "argName": "req_auth_ip_acl_xfwd",
                "argValue": "all"   
            }, {
                "argName": "sign_param",
                "argValue": "sign"
            }, {
                "argName": "time_param",
                "argValue": "time"
            }, {
                "argName": "time_format",
                "argValue": "hec"
            }, {
                "argName": "path_encoding",
                "argValue": "on"
            }],
            "functionName": "aliauth"
        }],
        "DomainNames": "example.com"
    }

cdn_remote_auth

  • 説明: リモート認証を設定します。

  • 関数 ID (FunctionID/FuncId): 258

  • パラメーター:

    パラメーター

    タイプ

    必須

    説明

    enable

    String

    はい

    リモート認証を有効にするかどうかを指定します。有効な値は次のとおりです。

    • 有効。

    • off: 無効にします。

    on

    remote_auth_addr

    String

    はい

    認証サーバーのアドレス。フォーマット: https://dcdn.aliyun.com/auth または http://10.10.10.10/auth

    https://example.aliyundoc.com/auth

    remote_auth_method

    String

    はい

    リクエストメソッド。有効な値: get、post、head。

    get

    remote_auth_type

    String

    はい

    認証が必要なファイルタイプ。`all` はすべてのファイルタイプを示します。複数のファイルタイプを指定するには、縦棒 (|) で区切ります。ファイルタイプでは大文字と小文字が区別されます。たとえば、jpg と JPG は異なります。

    all

    remote_auth_reserve_args

    String

    はい

    リクエストで保持するパラメーター。複数のパラメーターを指定するには、縦棒 (|) で区切ります。パラメーターでは大文字と小文字が区別されません。たとえば、key と KEY は同じです。

    • all: すべてのパラメーターを保持します。

    • ali_delete_all_args: すべての URL パラメーターを削除します。

    all

    remote_auth_custom_args

    String

    いいえ

    追加するカスタムパラメーター。複数のパラメーターを指定するには、縦棒 (|) で区切ります。パラメーターでは大文字と小文字が区別されます。たとえば、key と KEY は異なります。

    empty

    remote_auth_reserve_header

    String

    はい

    保持するリクエストヘッダー。複数のヘッダーを指定するには、縦棒 (|) で区切ります。ヘッダーでは大文字と小文字が区別されません。たとえば、http_remote_addr と HTTP_Remote_Addr は同じです。

    • all: すべてのリクエストヘッダーを保持します。

    • ali_delete_all_headers: すべてのリクエストヘッダーを削除します。

    all

    remote_auth_custom_header

    String

    いいえ

    追加するカスタムリクエストヘッダー。複数のヘッダーを指定するには、縦棒 (|) で区切ります。ヘッダーでは大文字と小文字が区別されます。たとえば、http_remote_addr と HTTP_Remote_Addr は同じです。

    empty

    remote_auth_success_code

    Integer

    はい

    認証成功のステータスコード。これは、認証成功後に認証サーバーが DCDN に返す結果です。例: 200。複数のステータスコードを指定できます。コンマ (,) で区切ります。

    200

    remote_auth_fail_code

    Integer

    はい

    認証失敗のステータスコード。これは、認証失敗後に認証サーバーが DCDN に返す結果です。例: 403。複数のステータスコードを指定できます。コンマ (,) で区切ります。

    403,404

    remote_auth_other_code_act

    String

    いいえ

    認証サーバーから返されたステータスコードが成功または失敗のコードでない場合に、DCDN がユーザーリクエストに対して実行する操作。有効な値は次のとおりです。

    • pass (デフォルト): リクエストを許可します。

    • reject: リクエストを拒否します。

    pass

    remote_auth_fail_resp_code

    Integer

    はい

    認証失敗後に DCDN がユーザーに返すレスポンスステータスコード。例: 403。

    403

    remote_auth_timeout

    Integer

    はい

    認証タイムアウト期間。単位: ms。最大値は 3000 です。

    500

    remote_auth_timeout_action

    String

    はい

    認証がタイムアウトしたときに実行する操作。有効な値は次のとおりです。

    • pass: DCDN はユーザーリクエストを許可します。

    • reject: DCDN は指定された `remote_auth_fail_resp_code` をユーザーに返します。

    pass

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "remote_auth_addr",
                "argValue": "https://example.aliyundoc.com/auth"
            }, {
                "argName": "remote_auth_method",
                "argValue": "get"
            }, {
                "argName": "remote_auth_type",
                "argValue": "all"
            }, {
                "argName": "remote_auth_reserve_args",
                "argValue": "all"
            }, {
                "argName": "remote_auth_custom_args",
                "argValue": ""
            }, {
                "argName": "remote_auth_reserve_header",
                "argValue": "all"
            }, {
                "argName": "remote_auth_custom_header",
                "argValue": ""
            }, {
                "argName": "remote_auth_success_code",
                "argValue": "200"
            }, {
                "argName": "remote_auth_fail_code",
                "argValue": "403"
            }, {
                "argName": "remote_auth_other_code_act",
                "argValue": "pass"
            }, {
                "argName": "remote_auth_fail_resp_code",
                "argValue": "403"
            }, {
                "argName": "remote_auth_timeout",
                "argValue": 500
            }, {
                "argName": "remote_auth_timeout_action",
                "argValue": "pass"
            }],
            "functionName": "cdn_remote_auth"
        }],
        "DomainNames": "example.com"
    }

ip_allow_list_set

  • 説明: IP ホワイトリストを設定します。コンソールでこの機能 を設定する方法の詳細については、「IP ブラックリストとホワイトリストの設定」をご参照ください。

  • 競合: IP ホワイトリスト機能は、IP ブラックリスト機能 (関数: ip_black_list_set、関数 ID: 13) と相互に排他的です。どちらか一方しか有効にできません。一方の機能がすでに設定されている場合は、もう一方の機能 を設定する前に、その設定を削除する必要があります。スイッチパラメーターが `off` に設定されていても、機能は設定済みと見なされます。ドメイン名の特定の設定を削除するには、DeleteDcdnSpecificConfig 操作を呼び出します。

  • 関数 ID (FunctionID/FuncId): 69

  • パラメーター:

    パラメーター

    タイプ

    必須

    説明

    ip_list

    String

    はい

    IP リスト。複数の IP アドレスまたは CIDR ブロックをコンマ (,) で区切ります。

    192.168.0.1/24

    customize_response_status_code

    String

    いいえ

    カスタムレスポンスステータスコード。デフォルト値は空で、レスポンスステータスコードが 403 であることを示します。3 桁の数字を入力して、カスタムレスポンスステータスコードを設定できます。

    429

    ip_acl_xfwd

    String

    いいえ

    X-Forwarded-For ヘッダーの IP アドレスを使用するかどうかを指定します。有効な値は次のとおりです。

    • on: デフォルト値です。DCDN は、ユーザーリクエストの x-forwarded-for ヘッダーの左端の最初の IP アドレスを検証に使用します。

    • off: 実際のクライアント IP アドレスを使用します。

    • all: DCDN は、x-forwarded-for ヘッダーと接続の IP アドレスの両方を検証に使用します。

    all

  • 設定例:

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

ip_black_list_set

  • 説明: IP ブラックリストを設定します。コンソールでこの機能 を設定する方法の詳細については、「IP ブラックリストとホワイトリストの設定」をご参照ください。

  • 競合: IP ブラックリスト機能は、IP ホワイトリスト機能 (関数: ip_allow_list_set、関数 ID: 69) と相互に排他的です。どちらか一方しか有効にできません。一方の機能がすでに設定されている場合は、もう一方の機能 を設定する前に、その設定を削除する必要があります。スイッチパラメーターが `off` に設定されていても、機能は設定済みと見なされます。ドメイン名の特定の設定を削除するには、DeleteDcdnSpecificConfig 操作を呼び出します。

  • 関数 ID (FunctionID/FuncId): 13

  • パラメーター:

    パラメーター

    タイプ

    必須

    説明

    ip_list

    String

    はい

    IP リスト。複数の IP アドレスまたは CIDR ブロックをコンマ (,) で区切ります。

    192.168.0.1

    customize_response_status_code

    String

    いいえ

    カスタムレスポンスステータスコード。デフォルト値は空で、レスポンスステータスコードが 403 であることを示します。3 桁の数字を入力して、カスタムレスポンスステータスコードを設定できます。

    429

    ip_acl_xfwd

    String

    いいえ

    X-Forwarded-For ヘッダーの IP アドレスを使用するかどうかを指定します。有効な値は次のとおりです。

    • on: デフォルト値です。DCDN は、ユーザーリクエストの x-forwarded-for ヘッダーの左端の最初の IP アドレスを検証に使用します。

    • off: 実際の送信元 IP アドレスを使用します。

    • all: DCDN は、x-forwarded-for ヘッダーと接続の IP アドレスの両方を検証に使用します。

    all

  • 設定例:

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

ali_ua

  • 説明: User-Agent ヘッダーに基づいてアクセス制御を設定します。コンソールでこの機能 を設定する方法の詳細については、「User-Agent ブラックリストとホワイトリストの設定」をご参照ください。

  • 関数 ID (FunctionID/FuncId): 58

  • パラメーター:

    パラメーター

    タイプ

    必須

    説明

    ua

    String

    はい

    User-Agent 文字列。ワイルドカード文字 (*) を使用して任意の文字列に一致させることができます。複数の値を指定するには、縦棒 (|) で区切ります。例: *curl*|*IE*|*chrome*|*firefox*

    *curl*|*IE*|*chrome*|*firefox*

    type

    String

    はい

    リストのタイプ。有効な値は次のとおりです。

    • black: ブラックリスト。

    • white: ホワイトリスト。

    説明

    ブラックリストとホワイトリストは相互に排他的です。一度に有効にできるのは 1 つのタイプのみです。

    black

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "ua",
                "argValue": "*curl*|*IE*|*chrome*|*firefox*"
            }, {
                "argName": "type",
                "argValue": "black"
            }],
            "functionName": "ali_ua"
        }],
        "DomainNames": "example.com"
    }

パフォーマンスの最適化

tesla

  • 機能説明:ページの最適化を設定して、ページの読み込みを高速化します。詳細については、「ページの最適化」をご参照ください。

  • 機能 ID (FunctionID/FuncId):16。

  • パラメーター:

    パラメーター

    タイプ

    必須

    説明

    enable

    String

    はい

    ページの最適化のための高速化を有効にするかどうかを指定します。

    • on:機能を有効にします。

    • off:機能を無効にします。

    on

    trim_js

    String

    いいえ

    HTML 内のインライン JavaScript (JS) コードを最適化するかどうかを指定します。

    • on:機能を有効にします。

    • off (デフォルト):最適化を無効にします。

    off

    trim_css

    String

    いいえ

    HTML 内のインライン Cascading Style Sheets (CSS) コードを最適化するかどうかを指定します。

    • on:最適化を有効にします。

    • off (デフォルト):無効状態です。

    off

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "trim_css",
                "argValue": "off"
            }, {
                "argName": "trim_js",
                "argValue": "off"
            }],
            "functionName": "tesla"
        }],
        "DomainNames": "example.com"
    }

gzip

  • 機能説明:Gzip 圧縮を使用してページを最適化します。この機能の詳細については、「Gzip 圧縮」をご参照ください。

  • 機能 ID (FunctionID/FuncId):35。

  • パラメーター:

    パラメーター

    タイプ

    必須

    説明

    enable

    String

    はい

    ページの Gzip 最適化を有効にするかどうかを指定します。

    • on:機能を有効にします。

    • off:機能を無効にします。

    on

  • 設定例:

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

brotli

  • 機能説明:ページの Brotli 圧縮を設定します。この機能の詳細については、「Brotli 圧縮」をご参照ください。

  • 機能 ID (FunctionID/FuncId):97。

  • パラメーター:

    パラメーター

    タイプ

    必須

    説明

    enable

    String

    はい

    ページの Brotli 圧縮を有効にするかどうかを指定します。

    • on:機能を有効にします。

    • off:機能を無効にします。

    on

  • 設定例:

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

set_hashkey_args

  • 機能説明:指定されたパラメーターのみを保持することで URL パラメーターを無視する機能を設定します。この機能の詳細については、「パラメーターを無視」をご参照ください。

  • 機能の競合:URL パラメーターの無視 (保持) 機能は、URL パラメーターの無視 (削除) 機能 (関数:ali_remove_args、機能 ID:75) と競合します。これらの機能は、一度に 1 つしか有効にできません。一方の機能がすでに設定されている場合は、もう一方の機能 を設定する前に、その設定を削除する必要があります。`enable` パラメーターが `off` に設定されていても、機能は設定済みと見なされます。ドメイン名の機能設定を削除するには、DeleteDcdnSpecificConfig 操作を呼び出します。

  • 機能 ID (FunctionID/FuncId):19。

  • パラメーター:

    パラメーター

    タイプ

    必須

    説明

    hashkey_args

    String

    いいえ

    保持するパラメーターのリスト。複数のパラメーターはコンマ (,) で区切ります。最大 10 個のパラメーターを指定できます。

    key1,key2

    disable

    String

    はい

    すべてのパラメーターを無視するかどうかを指定します。

    • on:すべてのパラメーターを無視します。パラメーターを削除、保持、変更する機能は無効になります。パラメーターを追加する機能のみが有効なままです。

    • off (デフォルト):機能を無効にします。パラメーターを保持、追加、削除する機能は有効なままです。

    説明

    キャッシュハッシュキーのすべてのパラメーターを無視する優先度は、キャッシュパラメーターのリストを保持する優先度よりも低くなります。

    on

    keep_oss_args

    String

    はい

    オリジンフェッチリクエストのパラメーターを保持するかどうかを指定します。

    • on:オリジンフェッチリクエストのすべてのパラメーターを保持します。

    • off:オリジンフェッチリクエストのパラメーターは、キャッシュハッシュキーのパラメーターと同じです。

    on

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "hashkey_args",
                "argValue": ""
            }, {
                "argName": "keep_oss_args",
                "argValue": "on"
            }, {
                "argName": "disable",
                "argValue": "on"
            }],
            "functionName": "set_hashkey_args"
        }],
        "DomainNames": "example.com"
    }

ali_remove_args

  • 機能説明:指定されたパラメーターを削除することで URL パラメーターを無視する機能を設定します。この機能の詳細については、「パラメーターを無視」をご参照ください。

  • 機能の競合:URL パラメーターの無視 (削除) 機能は、URL パラメーターの無視 (保持) 機能 (関数:set_hashkey_args、機能 ID:19) と競合します。これらの機能は、一度に 1 つしか有効にできません。一方の機能がすでに設定されている場合は、もう一方の機能 を設定する前に、その設定を削除する必要があります。`enable` パラメーターが `off` に設定されていても、機能は設定済みと見なされます。ドメイン名の機能設定を削除するには、DeleteDcdnSpecificConfig 操作を呼び出します。

  • 機能 ID (FunctionID/FuncId):75。

  • パラメーター:

    パラメーター

    タイプ

    必須

    説明

    ali_remove_args

    String

    はい

    削除するパラメーター。複数のパラメーターはスペースで区切ります。

    説明

    残りのパラメーターは、ハッシュキーの URL 引数として使用されます。

    test

    keep_oss_args

    String

    はい

    オリジンフェッチリクエストのパラメーターを保持するかどうかを指定します。

    • on:オリジンフェッチリクエストのすべてのパラメーターを保持します。

    • off:オリジンフェッチリクエストのパラメーターは、キャッシュハッシュキーのパラメーターと同じです。

    off

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "ali_remove_args",
                "argValue": "test"
            }, {
                "argName": "keep_oss_args",
                "argValue": "off"
            }],
            "functionName": "ali_remove_args"
        }],
        "DomainNames": "example.com"
    }

image_transform

  • 機能説明:DCDN の画像変換を設定します。この機能の詳細については、「画像編集のメソッドと利点」をご参照ください。

  • 機能 ID (FunctionID/FuncId):239。

  • パラメーター:

    パラメーター

    タイプ

    必須

    説明

    enable

    String

    はい

    画像変換を有効にするかどうかを指定します。

    • on:機能を有効にします。

    • off:機能を無効にします。

    on

    filetype

    String

    はい

    トランスコードをサポートする画像フォーマット。複数のフォーマットは縦棒 (|) で区切ります。次の値がサポートされています:

    • JPEG:JPEG 画像フォーマット。

    • JPG:JPG 画像フォーマット。

    • PNG:PNG 画像フォーマット。

    • WEBP:WEBP 画像フォーマット。

    • BMP:BMP 画像フォーマット。

    • GIF:GIF 画像フォーマット。

    • TIFF:TIFF 画像フォーマット。

    • JP2:JPEG 2000 画像フォーマット。

    jpg|jpeg|png

    webp

    String

    いいえ

    WebP への自動変換を有効にするかどうかを指定します。

    • on:変換を有効にします。

    • オフ: インスタンスがシャットダウンされています。

    on

    orient

    String

    いいえ

    画像の自動回転を有効にするかどうかを指定します。

    • on:機能は有効です。

    • off:機能を無効にします。

    説明

    この機能は、回転プロパティを持つ画像に対してのみ機能します。

    on

    slim

    Integer

    いいえ

    画像軽量化。軽量化率を設定します。値の範囲は 0 から 100 です。この機能は、解像度、ディメンション、またはフォーマットを変更せずに画質を低下させて、トラフィックを節約します。

    10

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "filetype",
                "argValue": "jpg|jpeg|png"
            }, {
                "argName": "webp",
                "argValue": "on"
            }, {
                "argName": "orient",
                "argValue": "on"
            }, {
                "argName": "slim",
                "argValue": ""
            }, {
                "argName": "enable",
                "argValue": "on"
            }],
            "functionName": "image_transform"
        }],
        "DomainNames": "example.com"
    }

ビデオ機能

range

  • 機能説明: Range オリジンフェッチを設定します。 詳細については、「Range オリジンフェッチの設定」をご参照ください。

  • 関数 ID: 31

  • パラメーター:

    パラメーター

    タイプ

    必須

    説明

    enable

    文字列

    はい

    Range オリジンフェッチを有効にするかどうかを指定します。

    • on: 有効化します。

    • off: 無効化します。

    • force: 強制的に有効化します。

    on

  • 設定例:

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

video_seek

  • 説明: シーク再生を設定します。 コンソールでの設定詳細については、「シーク再生」をご参照ください。

  • 関数 ID: 30

  • パラメーター:

    パラメーター

    タイプ

    必須

    説明

    enable

    文字列

    はい

    シーク再生を有効にするかどうかを指定します。

    • on: 有効化します。

    • off: 無効化します。

    on

    flv_seek_by_time

    文字列

    いいえ

    FLV ファイルの時間によるシークを有効にするかどうかを指定します。

    • on: 有効化します。

    • off: 無効化します。

    on

    mp4_seek_start

    文字列

    いいえ

    MP4 ファイルのカスタム開始パラメーターです。

    mp4starttime

    mp4_seek_end

    文字列

    いいえ

    MP4 ファイルのカスタム終了パラメーターです。

    mp4endtime

    flv_seek_start

    文字列

    いいえ

    FLV ファイルのカスタム開始パラメーターです。

    flvstarttime

    flv_seek_end

    文字列

    いいえ

    FLV ファイルのカスタム終了パラメーターです。

    flvendtime

  • 設定例:

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

ali_video_split

  • 説明: オーディオのみの再生を設定します。

  • 関数 ID: 204

  • パラメーター:

    パラメーター

    タイプ

    必須

    説明

    enable

    文字列

    はい

    オーディオのみの再生を有効にするかどうかを指定します。

    • on: 有効化します。

    • off: 無効化します。

    on

  • 設定例:

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

ali_video_preview

  • 説明: ビデオプレビューを設定します。

  • 関数 ID: 205

  • パラメーター:

    パラメーター

    タイプ

    必須

    説明

    enable

    文字列

    はい

    ビデオプレビューを有効にするかどうかを指定します。

    • on: 有効化します。

    • off: 無効化します。

    説明

    TS および MP3 ファイルを使用でき、FLV および MP4 ファイルをドラッグアンドドロップできます。

    on

    ali_video_preview_argument

    文字列

    はい

    ビデオプレビューのカスタムパラメーター名です。 このパラメーターの値は秒単位である必要があります。

    fds

  • 設定例:

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

hls_token_rewrite

  • 説明: M3U8 の暗号化と書き換えを設定します。

  • 関数 ID: 253

  • パラメーター:

    パラメーター

    タイプ

    必須

    説明

    enable

    文字列

    はい

    M3U8 の暗号化と書き換えを有効にするかどうかを指定します。

    • on: 有効化します。

    • off: 無効化します。

    on

    hls_token_arg_name

    文字列

    いいえ

    HLS トークンのカスタムパラメーター名です。 このパラメーターを設定しない場合、デフォルトのパラメーター名として `MtsHlsUriToken` が使用されます。

    example

  • 設定例:

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

セキュリティ構成

ddos_domain

  • 機能説明: Anti-DDoS スケジューリングを設定します。詳細については、「緩和設定」をご参照ください。

  • 関数 ID (FuncId): 209。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    enable

    String

    はい

    Anti-DDoS 対策を有効にするかどうかを指定します:

    • on: 有効化

    • off: 無効化

    on

    dispatch_qps

    String

    いいえ

    1 秒あたりのクエリ数 (QPS) のしきい値。

    • 値の範囲: 2000~50000。

    • デフォルト値: 20000。

    20000

    auto_dispatch

    String

    いいえ

    インテリジェントなトラフィックスクラビングを有効にします。この機能を有効にすると、QPS のしきい値を指定する必要はありません。DCDN システムがトラフィックスクラビングパターンを有効にするかどうかを自動的に判断します。

    • on: 有効化

    • off: 無効化

    on

    checkurl

    String

    はい

    ドメイン名配下でのヘルスチェック用のパス。

    デフォルト値: / (ドメイン名のルートディレクトリ)。

    /*/examplefile.txt

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "dispatch_qps",
                "argValue": "20000"
            }, {
                "argName": "checkurl",
                "argValue": "/*/examplefile.txt"
            }],
            "functionName": "ddos_domain"
        }],
        "DomainNames": "example.com"
    }

レート制限

limit_rate

  • 機能の説明:単一リクエストのレート制限を設定します。

  • 機能 ID:72。

  • パラメーターの説明:

    `ali_limit_rate` を使用した固定レート制限、リクエスト URL 内のパラメーターに基づく動的レート制限、または時間ベースのレート制限を設定できます。

    リクエスト URL 内のパラメーターに基づいてレートを制限するには、`traffic_limit_arg` パラメーターと `traffic_limit_unit` パラメーターを一緒に使用します。

    レート制限の開始時刻と終了時刻を設定するには、`ali_limit_start_hour` パラメーターと `ali_limit_end_hour` パラメーターを一緒に使用します。

    パラメーター

    必須

    説明

    値の例

    ali_limit_rate

    文字列

    はい

    単一リクエストのレート制限を指定します。値は数値と単位で構成されます。サポートされる単位は、KB/s を表す `k` と MB/s を表す `m` です。

    最小値は `100k` です。`100k` 未満の値は `100k` として処理されます。

    • `1m`:単一リクエストのレート制限を 1 MB/s に設定します。

    • `100k`:単一リクエストのレート制限を 100 KB/s に設定します。

    ali_limit_rate_after

    文字列

    いいえ

    レート制限が開始されるまでに送信するデータ量。値は数値と単位で構成されます。サポートされる単位は、KB を表す `k` と MB を表す `m` です。

    1000

    traffic_limit_arg

    文字列

    いいえ

    レート制限パラメーターの名前。レートは URL から取得した引数に基づいて制限されます。例:`rate`。

    リクエストにこのパラメーターが含まれていない場合、`ali_limit_rate` で指定されたデフォルトのレート制限が使用されます。リクエストにこのパラメーターがない場合にレート制限を無効にするには、`ali_limit_rate` を `0k` に設定します。

    rate

    traffic_limit_unit

    文字列

    いいえ

    `traffic_limit_arg` パラメーターの単位。サポートされる単位は `m` (MB/s) と `k` (KB/s) です。たとえば、このパラメーターが `m` に設定され、リクエスト URL に `rate=1` が含まれている場合、実際のレート制限は 1 MB/s になります。

    最小値は `100k` です。`100k` 未満の値は `100k` として処理されます。

    m

    ali_limit_start_hour

    整数

    いいえ

    レート制限の開始時刻。値は 0 から 24 までの整数で、終了時刻より小さくする必要があります。デフォルト値は 0 です。

    説明

    これは 24 時間形式の時刻を表します。たとえば、`0` は 00:00:00 を表し、`24` は 24:00:00 を表します。

    20

    ali_limit_end_hour

    整数

    いいえ

    レート制限の終了時刻。値は 0 から 24 までの整数で、開始時刻より大きくする必要があります。デフォルト値は 24 です。

    23

  • 設定例 1:単一リクエストのレート制限を 1 MB/s に設定します。

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "ali_limit_rate",
                "argValue": "1m"
            }],
            "functionName": "limit_rate"
        }],
        "DomainNames": "example.com"
    }
  • 設定例 2:単一リクエストのデフォルトのレート制限は 1 MB/s です。リクエスト URL に `rate` パラメーターが含まれている場合、レートはそのパラメーターの値に基づいて制限されます。たとえば、リクエストに `rate=200` が含まれている場合、実際のレート制限は 200 KB/s になります。

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "ali_limit_rate",
                "argValue": "1m"
            },{
                "argName": "traffic_limit_arg",
                "argValue": "rate"
            },{
                "argName": "traffic_limit_unit",
                "argValue": "k"
            }],
            "functionName": "limit_rate"
        }],
        "DomainNames": "example.com"
    }

WebSocket

websocket

  • 説明: WebSocket を設定します。詳細については、「WebSocket の設定」をご参照ください。

  • 関数 ID (FunctionID/FuncId): 144。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    値の例

    enabled

    文字列

    はい

    WebSocket を有効にするかどうかを指定します。

    • on: この機能を有効にします。

    • off: この機能を無効にします。

    on

    origin_scheme

    文字列

    いいえ

    WebSocket のオリジンフェッチリクエストのプロトコル。有効な値は次のとおりです。

    • http: WebSocket は HTTP を使用してオリジンフェッチを行います。

    • https: WebSocket は HTTPS を使用してオリジンフェッチを行います。オリジンサーバーはポート 443 をサポートしている必要があります。

    • follow: WebSocket はクライアントのリクエストと同じプロトコルを使用します。オリジンサーバーはポート 443 またはポート 80 をサポートしている必要があります。

    説明

    このパラメーターを設定しない場合、デフォルト値は follow です。

    http

    heartbeat

    文字列

    いいえ

    接続タイムアウト。

    • 値の範囲: 1~300

    • 単位: 秒

    • デフォルト値: 60

    60

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enabled",
                "argValue": "on"
            }, {
                "argName": "origin_scheme",
                "argValue": "http"
            }, {
                "argName": "heartbeat",
                "argValue": "60"
            }],
            "functionName": "websocket"
        }],
        "DomainNames": "example.com"
    }

IP アプリケーションアクセラレーション

protogw

  • 機能説明:IP アプリケーションアクセラレーションを設定します。詳細については、「IP アプリケーションアクセラレーションとは」をご参照ください。

  • 機能 ID (FunctionID/FuncId):163。

  • パラメーター:

    パラメーター

    必須

    説明

    realip

    文字列

    はい

    クライアントの送信元 IP アドレスを渡すために使用されるプロトコルを指定します。有効な値:

    • off:シャットダウン状態。

    • toa:クライアントの送信元 IP アドレスを渡します。オリジンサーバーに TOA カーネルモジュールをインストールする必要があります。サービスプログラムの変更は不要です。

    • pp:クライアントの送信元 IP アドレスを渡します。このプロトコルは、デフォルトでオープンソースの Nginx によってサポートされています。他のオリジンサーバーソフトウェアに互換性があることを確認する必要があります。

    toa

    port

    文字列

    はい

    アクセラレーションポート。

    説明
    • アクセラレーションは、次のポートではサポートされていません:22、123、161~162、179、830、2049、2601、2605、3389、5049、7547、8082、8087、8182、8888、9998、15772、15776、15778~15779、18053、18098~18099、18888、19313、19777、56667。

    • ポート 80 または 443 を追加するには、チケットを送信してください。

    8443

    mux

    文字列

    いいえ

    ポートの多重化を有効にするかどうかを指定します。有効な値:

    • on:有効。

    • off:無効。

    off

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "realip",
                "argValue": "toa"
            }, {
                "argName": "port",
                "argValue": "8443"
            }, {
                "argName": "mux",
                "argValue": "off"
            }],
            "functionName": "protogw"
        }],
        "DomainNames": "example.com"
    }

エッジスクリプト/エッジ関数

edge_function

  • 説明:エッジスクリプトを設定します。詳細については、「エッジスクリプトの概要」をご参照ください。

  • 関数 ID (FunctionID または FuncId):180。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    rule

    文字列

    はい

    DSL ルール。

    if eq($uri, '/') {\n rewrite('https://example.com/index.html', 'redirect')\n}

    pri

    整数

    はい

    優先度。有効な値:[0, 999]。値が小さいほど優先度が高くなります。

    説明

    ヘッダー実行とフッター実行の優先度は、それぞれ独立しています。

    0

    enable

    文字列

    はい

    ルールを有効にするかどうかを指定します。有効な値:

    • on:ルールは有効になります。

    • off:ルールは無効になります。

    on

    name

    文字列

    はい

    ルール名。文字とアンダースコア (_) のみがサポートされます。

    test

    pos

    文字列

    いいえ

    ルールが実行される位置。有効な値:

    • head (デフォルト):ルールはリクエスト処理フローの先頭で実行されます。

    • foot:ルールはリクエスト処理フローの末尾で実行されます。

    head

    brk

    文字列

    いいえ

    実行を中断するかどうかを指定します。有効な値:

    • on:このルールにヒットした場合、現在の実行位置にある残りのルールはスキップされます。

    • off (デフォルト):このルールにヒットした場合でも、残りのルールは実行されます。

    off

    option

    文字列

    いいえ

    拡張フィールド。

    empty

    grammar

    文字列

    いいえ

    ルール構文。有効な値:es2 (デフォルト) と js。

    /

    jsmode

    文字列

    いいえ

    JavaScript (JS) 実行モード。有効な値:

    • redirect:ブロックモード。

    • bypass (デフォルト):バイパスモード。

    /

  • 設定例:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "name",
                "argValue": "test"
            }, {
                "argName": "rule",
                "argValue": "if eq($uri, '/') {\n  rewrite('https://example.com/index.html', 'redirect')\n}"
            }, {
                "argName": "pri",
                "argValue": "0"
            }, {
                "argName": "pos",
                "argValue": "head"
            }, {
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "brk",
                "argValue": "off"
            }, {
                "argName": "option",
                "argValue": ""
            }],
            "functionName": "edge_function"
        }],
        "DomainName": "example.com"
    }

EdgeRoutine

edgeroutine

  • 説明: EdgeRoutine を設定します。 詳細については、「エッジ関数とは」をご参照ください。

  • 機能 ID (FunctionID/FuncId): 275。

  • この機能は申請制です。 この機能を使用するには、するか、チケットを送信する必要があります。

ルールエンジン

condition

  • 機能の説明:ルールエンジンを使用すると、さまざまな条件ルールを設定できます。条件ルールは、ユーザーリクエスト内のパラメーターを検出し、特定のリクエストに構成が適用されるかどうかを判断します。これらのルールを使用することで、DCDN の構成ポリシーがどのように実行されるかを、より柔軟かつ正確にコントロールできます。

  • 機能 ID (FunctionID/FuncId):250。

  • パラメーターの説明:

    パラメーター

    タイプ

    必須

    説明

    値の例

    rule

    配列

    はい

    条件ルールの内容で、名前、ステータス、論理演算子、条件式が含まれます。

    ルールの内容:

    {\"match\":{\"logic\":\"and\",\"criteria\":[{\"matchType\":\"clientipVer\",\"matchObject\":\"CONNECTING_IP\",\"matchOperator\":\"equals\",\"matchValue\":\"v6\",\"negate\":false}]},\"name\":\"example\",\"status\":\"enable\"}

    結果:

    • ルール名:example

    • ステータス:enable

    • 論理演算子:and

    • 条件式:クライアントの接続 IP アドレスのプロトコルバージョンが v6 であること。

    次の表に、`argValue` のフォーマットである条件式のフォーマットを示します。

    パラメーター

    説明

    "match":

    `match` は条件マッチ式を指定します。

    "logic":"and"

    `logic` は条件マッチ式の論理演算子を指定します。有効な値は `and` と `or` です。

    "criteria"

    `criteria` は条件式の内容を指定します。

    "matchType":"clientipVer"

    `matchType` は、ユーザーリクエスト内でマッチさせる情報のタイプを指定します。

    "matchObject":"CONNECTING_IP"

    `matchObject` は、マッチタイプをさらに詳細に指定します。例えば、クライアント IP アドレスは、接続 IP アドレスまたは X-Forwarded-For (XFF) IP アドレスとして指定できます。

    "matchOperator":"equals"

    `matchOperator` は、マッチ操作のアクションを指定します。

    "matchValue":"v6"

    `matchValue` は、ユーザーリクエスト内の情報と照合するためのプリセット値を指定します。

    "negate":false

    `negate` は、条件式の結果を否定するかどうかを指定します。有効な値は `true` と `false` です。

    "name":"example"

    `name` は、条件ルールの名前を指定します。

    "status":"enable"

    `status` は、条件ルールのステータスを指定します。

  • 設定例:

    次の例では、OpenAPI を使用して、高速化ドメイン名 example.com にルールエンジンの構成を追加する方法を示します。この構成は、クライアント IP のプロトコルバージョンが IPv6 であるかどうかに基づいてリクエストをマッチングし、フィルタリングします。

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "rule",
                "argValue": "{\"match\":{\"logic\":\"and\",\"criteria\":[{\"matchType\":\"clientipVer\",\"matchObject\":\"CONNECTING_IP\",\"matchOperator\":\"equals\",\"matchValue\":\"v6\",\"negate\":false}]},\"name\":\"example\",\"status\":\"enable\"}"
            }],
            "functionName": "condition"
        }],
        "DomainNames": "example.com"
    }

    ルールエンジンの構成を作成した後、それを他の機能構成と関連付けることができます。これにより、DCDN の構成ポリシーがどのように実行されるかを、より柔軟かつ正確にコントロールできます。

    注意事項:

    • 他の機能からルールエンジンの構成を参照するには、`parentid` パラメーターを条件ルールの `configid` に設定してください。`configid` は、ルールエンジンの構成を追加する際に生成されます。

    • 関数が `condition` (ルールエンジン) の場合、`parentid` パラメーターはサポートされません。

QUIC

iquic

  • 説明: QUIC プロトコルを設定します。 詳細については、「QUIC とは」をご参照ください。

  • 関数 ID: 281

  • パラメーター:

    パラメーター

    タイプ

    必須

    説明

    値の例

    iquic_enable

    文字列

    はい

    QUIC プロトコルを有効にするかどうかを指定します:

    • on: 有効

    • off: 無効

    on

  • 設定例

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