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

Web Application Firewall:DescribeDomain

最終更新日:Apr 01, 2026

Web Application Firewall (WAF) に追加されたドメイン名の設定を照会します。

デバッグ

OpenAPI Explorer でこの操作を呼び出すことを推奨します。OpenAPI Explorer は自動的に署名値を計算します。OpenAPI Explorer は、さまざまな SDK の操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメータータイプ必須説明
ActionStringはいDescribeDomain実行する操作。値を DescribeDomain に設定します。
DomainStringはいwww.example.comDescribeDomainNames照会するドメイン名。WAF に追加されたドメイン名を取得するには、 操作を呼び出します。
InstanceIdStringはいwaf-cn-7pp26f1****WAF インスタンスの ID です。インスタンス ID を取得するには、DescribeInstanceInfo 操作を呼び出します。

すべての Alibaba Cloud API リクエストには、共通リクエストパラメーターを含める必要があります。詳細については、「共通リクエストパラメーター」をご参照ください。

レスポンス要素

パラメータータイプ説明
RequestIdStringD827FCFE-90A7-4330-9326-D33C8B4C7726リクエスト ID。
DomainStructドメイン名の設定。

Domain

パラメータータイプ説明
AccessHeaderModeInteger1実際のクライアント IP アドレスを取得するために使用されるメソッド。有効な値:0: WAF は X-Forwarded-For (XFF) ヘッダーの最初の値を読み取ります。1: WAF はカスタムヘッダーフィールドの値を読み取ります。IsAccessProduct1 の場合にのみ返されます。
AccessHeadersList["X-Client-IP"]実際のクライアント IP アドレスを取得するために使用されるカスタムヘッダーフィールド。AccessHeaderMode1 の場合にのみ返されます。
AccessTypeStringwaf-cloud-dnsドメイン名を WAF に追加するために使用されるモード。有効な値:waf-cloud-dns: CNAME レコードモード。waf-cloud-native: 透過型プロキシモード。
ClusterTypeInteger0WAF 保護クラスターのタイプ。有効な値:0: 共有クラスター。1: 専用クラスター。AccessTypewaf-cloud-dns の場合にのみ返されます。
CnameStringkdmqyi3ck7xogegxpiyfpb0fj21mgkxn.****.comWAF によってドメイン名に割り当てられた CNAME。AccessTypewaf-cloud-dns の場合にのみ返されます。
ConnectionTimeInteger5WAF クラスターの接続タイムアウト期間。単位:秒。AccessTypewaf-cloud-dns の場合にのみ返されます。
Http2PortList[443,8443]HTTP/2 ポート。AccessTypewaf-cloud-dns で、HttpsPort が指定されている場合にのみ返されます。
HttpPortList[80]HTTP ポート。AccessTypewaf-cloud-dns の場合にのみ返されます。
HttpToUserIpInteger0オリジンサーバーへのリクエストに対して HTTPS から HTTP へのリダイレクトが有効になっているかどうかを指定します。有効な値:0: 無効。1: 有効。AccessTypewaf-cloud-dns で、HttpsPort が指定されている場合にのみ返されます。
HttpsPortList[443,8443]HTTPS ポート。AccessTypewaf-cloud-dns の場合にのみ返されます。
HttpsRedirectInteger0HTTP から HTTPS へのリダイレクトが有効になっているかどうかを指定します。有効な値:0: 無効。1: 有効。AccessTypewaf-cloud-dns で、HttpsPort が指定されている場合にのみ返されます。
IpFollowStatusInteger1WAF がリクエストと同じ IP アドレスタイプを使用してオリジンサーバーにリクエストを転送するかどうかを指定します。有効な値:0: 無効。1: 有効。AccessTypewaf-cloud-dns の場合にのみ返されます。
IsAccessProductInteger1WAF の前にレイヤー 7 プロキシが設定されているかどうかを指定します。レイヤー 7 プロキシには、Anti-DDoS Pro、Anti-DDoS Premium、Alibaba Cloud CDN が含まれます。有効な値:0: レイヤー 7 プロキシは設定されていません。1: レイヤー 7 プロキシが設定されています。
KeepaliveBooleantrue持続的接続が有効になっているかどうかを指定します。有効な値:true (デフォルト)。false
KeepaliveRequestsInteger1000持続的接続あたりの最大リクエスト数。有効な値:60~1000。
KeepaliveTimeoutInteger15持続的接続のアイドルタイムアウト期間。単位:秒。有効な値:1~60。デフォルト値:15。
LoadBalancingInteger2オリジンサーバーにリクエストを転送するための負荷分散アルゴリズム。有効な値:0: IP ハッシュ。1: ラウンドロビン。2: 最小時間。AccessTypewaf-cloud-dns の場合にのみ返されます。
ReadTimeInteger120WAF クラスターの読み取り接続タイムアウト期間。単位:秒。AccessTypewaf-cloud-dns の場合にのみ返されます。
ResourceGroupIdStringrg-acfm2mkrunv****WAF インスタンスが属するリソースグループの ID。
RetryBooleantrue転送失敗後、WAF がオリジンサーバーへのリクエスト転送を再試行するかどうかを指定します。有効な値:true (デフォルト)。false
SniHostStringwaf.example.comカスタムの Server Name Indication (SNI) フィールド値。空の場合、Host ヘッダーの値が使用されます。SniStatus1 の場合にのみ返されます。
SniStatusInteger1オリジン SNI が有効になっているかどうかを指定します。オリジン SNI は、WAF がオリジンサーバーにリクエストを転送するときに、TLS ハンドシェイク中に HTTPS 接続を確立するために使用されるドメイン名です。有効な値:0: 無効。1: 有効。AccessTypewaf-cloud-dns で、HttpsPort が指定されている場合にのみ返されます。
SourceIpsList["39.XX.XX.197"]オリジンサーバーの IP アドレス。AccessTypewaf-cloud-dns の場合にのみ返されます。
VersionLong40ドメイン名設定のバージョン番号。
WriteTimeInteger120WAF クラスターの書き込み接続タイムアウト期間。単位:秒。AccessTypewaf-cloud-dns の場合にのみ返されます。

CloudNativeInstances (AccessTypewaf-cloud-native の場合にのみ返されます)

パラメータータイプ説明
CloudNativeProductNameStringALBクラウドサービスインスタンスのタイプ。有効な値:SLB: Classic Load Balancer (CLB) インスタンス、旧称 Server Load Balancer (SLB)。ECS: Elastic Compute Service (ECS) インスタンス。ALB: Application Load Balancer (ALB) インスタンス。
IPAddressListString["39.XX.XX.197"]クラウドサービスインスタンスのパブリック IP アドレス。
InstanceIdStringalb-s65nua68wdedsp****クラウドサービスインスタンスの ID。

ProtocolPortConfigs (CloudNativeInstances 内)

パラメータータイプ説明
PortsString[80]ポート。
ProtocolStringhttpプロトコル。有効な値:httphttps
RedirectionTypeNameStringALBトラフィックリダイレクションポートのタイプ。有効な値:SLB-L4: CLB インスタンスのレイヤー 4 リスニングポート。SLB-L7: CLB インスタンスのレイヤー 7 リスニングポート。ECS: ECS インスタンスのリスニングポート。ALB: ALB インスタンスの HTTP および HTTPS リスニングポート。

LogHeaders (ドメイン名のトラフィックマーキングが有効になっている場合にのみ返されます)

パラメータータイプ説明
kStringALIWAF-TAGカスタムヘッダーフィールドの名前。
vStringYesカスタムヘッダーフィールドの値。

リクエストの例

http(s)://[Endpoint]/?Action=DescribeDomain
&Domain=www.example.com
&InstanceId=waf-cn-7pp26f1****
&<共通リクエストパラメーター>

正常なレスポンスの例

XML フォーマット

<DescribeDomainResponse>
      <RequestId>D827FCFE-90A7-4330-9326-D33C8B4C7726</RequestId>
      <Domain>
            <HttpToUserIp>0</HttpToUserIp>
            <HttpPort>80</HttpPort>
            <IsAccessProduct>1</IsAccessProduct>
            <AccessHeaderMode>1</AccessHeaderMode>
            <ResourceGroupId>rg-acfm2mkrunv****</ResourceGroupId>
            <AccessHeaders>X-Client-IP</AccessHeaders>
            <ReadTime>120</ReadTime>
            <SourceIps>39.XX.XX.197</SourceIps>
            <IpFollowStatus>1</IpFollowStatus>
            <ClusterType>0</ClusterType>
            <LoadBalancing>2</LoadBalancing>
            <Cname>kdmqyi3ck7xogegxpiyfpb0fj21mgkxn.****.com</Cname>
            <LogHeaders>
                  <v>Yes</v>
                  <k>ALIWAF-TAG</k>
            </LogHeaders>
            <WriteTime>120</WriteTime>
            <Http2Port>443</Http2Port>
            <Http2Port>8443</Http2Port>
            <Version>40</Version>
            <HttpsRedirect>0</HttpsRedirect>
            <ConnectionTime>5</ConnectionTime>
            <AccessType>waf-cloud-dns</AccessType>
            <HttpsPort>443</HttpsPort>
            <HttpsPort>8443</HttpsPort>
            <Keepalive>true</Keepalive>
            <KeepaliveTimeout>15</KeepaliveTimeout>
            <Retry>true</Retry>
            <KeepaliveRequests>1000</KeepaliveRequests>
      </Domain>
</DescribeDomainResponse>

JSON フォーマット

{
  "RequestId": "D827FCFE-90A7-4330-9326-D33C8B4C7726",
  "Domain": {
    "HttpToUserIp": 0,
    "HttpPort": [
      80
    ],
    "IsAccessProduct": 1,
    "AccessHeaderMode": 1,
    "ResourceGroupId": "rg-acfm2mkrunv****",
    "AccessHeaders": [
      "X-Client-IP"
    ],
    "ReadTime": 120,
    "SourceIps": [
      "39.XX.XX.197"
    ],
    "IpFollowStatus": 1,
    "ClusterType": 0,
    "LoadBalancing": 2,
    "Cname": "kdmqyi3ck7xogegxpiyfpb0fj21mgkxn.****.com",
    "LogHeaders": [
      {
        "v": "Yes",
        "k": "ALIWAF-TAG"
      }
    ],
    "WriteTime": 120,
    "Http2Port": [
      443,
      8443
    ],
    "Version": 40,
    "HttpsRedirect": 0,
    "ConnectionTime": 5,
    "AccessType": "waf-cloud-dns",
    "HttpsPort": [
      443,
      8443
    ],
    "Keepalive": true,
    "KeepaliveTimeout": 15,
    "SniStatus": 0,
    "Retry": true,
    "KeepaliveRequests": 1000
  }
}

エラーコード

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