すべてのプロダクト
Search

このプロダクト

    Web Application Firewall:DescribeInstance

    ドキュメントセンター

    Web Application Firewall:DescribeInstance

    最終更新日:Aug 12, 2026

    現在の Alibaba Cloud アカウントの WAF インスタンスの詳細を取得します。

    今すぐお試しください

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

    テスト

    RAM 認証

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

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

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

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

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

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

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

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

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

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    yundun-waf:DescribeInstance

    get

    *すべてのリソース。

    *
    • acs:ResourceGroupId
    		 なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    任意

    WAF インスタンスが存在するリージョン。有効な値:

    cn-hangzhou
    ResourceManagerResourceGroupId

    string

    任意

    Alibaba Cloud リソースグループの ID。

    rg-acfm***q

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    Status

    integer

    インスタンスの現在のステータス。有効な値:

    • 1: 正常。

    • 2: 期限切れ。

    • 3: リリース済み。

    1
    Details

    object

    インスタンスの詳細。

    DefenseObjectInGroupMaxCount

    integer

    1 つの保護グループに含めることができる保護オブジェクトの最大値。

    100
    Tamperproof

    boolean

    Web 改ざん防止がサポートされているかどうかを示します。有効な値:

    true
    BotApp

    string

    シナリオ固有のアプリクローラー対策がサポートされているかどうかを示します。有効な値:

    • true: サポートされています。

    • false: サポートされていません。

    true
    IpBlacklistRuleInTemplateMaxCount

    integer

    1 つのブラックリストテンプレートに含めることができる保護ルールの最大値。

    100
    WhitelistRuleCondition

    string

    ホワイトリストルールの一致フィールドのフォーマット。詳細については、 CreateDefenseRule の ホワイトリストルール (whitelist) 条件 のパラメーターの説明を参照してください。

    URL
    CustomRuleCondition

    string

    カスタムルールの一致条件のフォーマット。詳細については、 CreateDefenseRule の カスタムルール (custom_acl) 条件 のパラメーターの説明を参照してください。

    URL
    CustomResponse

    boolean

    カスタムレスポンスがサポートされているかどうかを示します。有効な値:

    • true: サポートされています。

    • false: サポートされていません。

    true
    HttpPorts

    string

    利用可能な HTTP ポート範囲。詳細については、WAF でサポートされるポート を参照してください。

    80
    Gslb

    boolean

    Global Server Load Balancing (GSLB) がサポートされているかどうかを指定します。有効な値:

    true
    Ipv6

    boolean

    IPv6 がサポートされているかどうかを示します。有効な値:

    true
    Bot

    boolean

    ボット管理がサポートされているかどうかを示します。有効な値:

    true
    CustomRule

    boolean

    カスタムルールがサポートされているかどうかを指定します。有効な値:

    • true: サポートされています。

    • false: サポートされていません。

    true
    IpBlacklist

    boolean

    IP ブラックリストがサポートされているかどうかを示します。有効な値:

    • true: サポートされています。

    • false: サポートされていません。

    true
    CnameResourceMaxCount

    integer

    追加できる CNAME の最大値。

    1000
    BackendMaxCount

    integer

    設定できるバックツーオリジン IP アドレスの最大値。

    20
    ExclusiveIp

    boolean

    排他的 IP アドレスがサポートされているかどうかを示します。有効な値:

    true
    CustomResponseRuleInTemplateMaxCount

    integer

    1 つのカスタム応答テンプレートに含めることができる保護ルールの最大値。

    100
    IpBlacklistIpInRuleMaxCount

    integer

    ブラックリストルールに追加できる IP アドレスの最大値。

    200
    AclRuleMaxIpCount

    integer

    一致コンテンツに追加できる IP アドレスのフォーマットおよび最大値。一致コンテンツの詳細については、一致条件の説明 を参照してください。

    100
    BotTemplateMaxCount

    integer

    設定できるボット管理保護テンプレートの最大値。

    50
    DefenseGroupMaxCount

    integer

    設定できる保護グループの最大値。

    100
    VastIpBlacklistInFileMaxCount

    integer

    1 回の一括インポートで IP ブラックリストにインポートできる IP アドレスの最大値。

    2000
    AntiScanTemplateMaxCount

    integer

    設定できるスキャン保護テンプレートの最大値。

    20
    WhitelistLogical

    string

    ホワイトリストルールの論理演算子のログ。詳細については、 CreateDefenseRule の ホワイトリストルール (whitelist) 条件 のパラメーターの説明を参照してください。

    contain
    CustomRuleTemplateMaxCount

    integer

    設定できるカスタムルールテンプレートの最大値。

    20
    TamperproofTemplateMaxCount

    integer

    設定できる Web 改ざん防止保護テンプレートの最大値。

    50
    IpBlacklistTemplateMaxCount

    integer

    設定できるブラックリストテンプレートの最大値。

    20
    HttpsPorts

    string

    利用可能な HTTPS ポート範囲。詳細については、WAF でサポートされるポート を参照してください。

    443
    DlpTemplateMaxCount

    integer

    設定できる情報漏えい防止イベントテンプレートのフォーマットおよび最大値。

    50
    CustomRuleRatelimitor

    string

    カスタムルールのレート制限オブジェクト。

    header
    DefenseObjectMaxCount

    integer

    設定できる保護オブジェクトの最大値。

    20000
    Dlp

    boolean

    データ漏えい防止がサポートされているかどうかを指定します。有効な値:

    • true: サポートされています。

    • false: サポートされていません。

    true
    DefenseObjectInTemplateMaxCount

    integer

    1 つのテンプレートに関連付けることができる保護オブジェクトの最大値。

    100
    CustomRuleAction

    string

    カスタムルールに含まれる文字列。

    block
    TamperproofRuleInTemplateMaxCount

    integer

    1 つの Web 改ざん防止テンプレートに含めることができる保護ルールの最大値。

    50
    DlpRuleInTemplateMaxCount

    integer

    1 つの情報漏えい防止イベントテンプレートに含めることができる保護ルールのフォーマットおよび最大値。

    50
    WhitelistTemplateMaxCount

    integer

    設定できるホワイトリストテンプレートの最大値。

    20
    MajorProtection

    boolean

    重大イベント保護がサポートされているかどうかを指定します。有効な値:

    • true: サポートされています。

    • false: サポートされていません。

    true
    BaseWafGroupRuleTemplateMaxCount

    integer

    設定できる基本保護ルールテンプレートの最大値。

    20
    BotWeb

    string

    シナリオ固有の Web クローラー対策がサポートされているかどうかを指定します。有効な値:

    • true: サポートされています。

    • false: サポートされていません。

    true
    CustomRuleInTemplateMaxCount

    integer

    1 つのカスタムルールテンプレートに含めることができる保護ルールの最大値。

    100
    VastIpBlacklistInOperationMaxCount

    integer

    1 回のページ操作で IP ブラックリストに追加できる IP アドレスの最大値。

    500
    WhitelistRuleInTemplateMaxCount

    integer

    1 つのホワイトリストテンプレートに含めることができる保護ルールの最大値。

    100
    AntiScan

    boolean

    スキャン保護がサポートされているかどうかを指定します。有効な値:

    true
    CustomResponseTemplateMaxCount

    integer

    設定可能なカスタム応答テンプレートの最大値。

    20
    BaseWafGroupRuleInTemplateMaxCount

    integer

    単一の基本保護ルールテンプレートに含めることができる保護ルールの最大値。

    100
    MajorProtectionTemplateMaxCount

    integer

    設定可能な重大イベント保護テンプレートの最大値。

    20
    BaseWafGroup

    boolean

    基本保護ルールがサポートされているかどうかを指定します。有効な値:

    • true: サポートされています。

    • false: サポートされていません。

    true
    Whitelist

    boolean

    IP ホワイトリストがサポートされているかどうかを指定します。有効な値:

    • true: サポートされています。

    • false: サポートされていません。

    true
    LogService

    boolean

    ログサービスがサポートされているかどうかを指定します。有効な値:

    true
    VastIpBlacklistMaxCount

    integer

    単一ユーザーが設定できる IP ブラックリストエントリの最大値。

    50000
    FreeQps

    integer

    サブスクリプションプランに含まれる無料 QPS 値。詳細については、「WAF 3.0 エディション」を参照してください。

    説明

    このパラメーターは、従量課金インスタンスでは実質的な意味を持ちません。

    1000
    ExtendQps

    integer

    サブスクリプションインスタンスの拡張 QPS 値。詳細については、「WAF 3.0 エディション」を参照してください。

    説明

    このパラメーターは、従量課金インスタンスには適用されません。

    10000
    ElasticQps

    integer

    バースト可能容量に対する従量課金制のサブスクリプションインスタンスのバースト可能 QPS 値です。詳細については、「WAF 3.0 エディション」を参照してください。

    説明

    このパラメーターは、従量課金 インスタンスでは実質的な意味を持ちません。

    2000
    QpsBillingCap

    integer

    従量課金エディションの QPS 課金保護しきい値。詳細については、従量課金の「トラフィック課金保護」を参照してください。

    説明

    このパラメーターは、サブスクリプションインスタンスでは実質的な意味を持ちません。

    2000
    HybridCloud

    boolean

    ハイブリッドクラウドが有効かどうかを示します。

    true
    HybridCloudNodeExtend

    integer

    ハイブリッドクラウド拡張ノードの数。

    3
    Apisec

    boolean

    API セキュリティが有効かどうかを示します。

    false
    AgenticApisec

    boolean

    Agentic API セキュリティが有効かどうかを示します。

    true
    ResourceDirectory

    boolean

    マルチアカウント管理機能がサポートされているかどうかを示します。

    true
    RequestId

    string

    リクエストの ID。

    66A98669-CC6E-4F3E-80A6-3014697B11AE
    EndTime

    integer

    インスタンスの有効期限切れ時間。値は UNIX タイムスタンプです。単位: ミリ秒。フォーマット: ms。

    4809859200000
    InstanceId

    string

    WAF インスタンスの ID。

    waf-cn-xxx
    InDebt

    string

    現在のインスタンスに支払い遅延があるかどうかを示します。有効な値:

    1
    StartTime

    integer

    購入時間。値はミリ秒単位の UNIX タイムスタンプです。

    1668496310000
    RegionId

    string

    WAF インスタンスが属するリージョン。有効な値:

    • cn-hangzhou: 中国本土。

    • ap-southeast-1: 中国本土以外。

    cn-hangzhou
    PayType

    string

    インスタンスの課金方法。有効な値:

    POSTPAY
    Edition

    string

    WAF のエディション。

    デフォルト_version
    ProcessStatus

    string

    インスタンスの実行ステータス。有効な値:

    • commodity_converting: 商品の変換中。

    • commodity_convert_check_failed: 商品変換チェックに失敗しました。

    • commodity_convert_process_failed: 商品変換に失敗しました。

    • order_create_failed: 注文の作成に失敗しました。

    • order_pending_payment: 注文は支払い待ちです。

    注文_pending_payment

    例

    成功レスポンス

    JSONJSON

    {
  "Status": 1,
  "Details": {
    "DefenseObjectInGroupMaxCount": 100,
    "Tamperproof": true,
    "BotApp": "true",
    "IpBlacklistRuleInTemplateMaxCount": 100,
    "WhitelistRuleCondition": "URL",
    "CustomRuleCondition": "URL",
    "CustomResponse": true,
    "HttpPorts": "80",
    "Gslb": true,
    "Ipv6": true,
    "Bot": true,
    "CustomRule": true,
    "IpBlacklist": true,
    "CnameResourceMaxCount": 1000,
    "BackendMaxCount": 20,
    "ExclusiveIp": true,
    "CustomResponseRuleInTemplateMaxCount": 100,
    "IpBlacklistIpInRuleMaxCount": 200,
    "AclRuleMaxIpCount": 100,
    "BotTemplateMaxCount": 50,
    "DefenseGroupMaxCount": 100,
    "VastIpBlacklistInFileMaxCount": 2000,
    "AntiScanTemplateMaxCount": 20,
    "WhitelistLogical": "contain",
    "CustomRuleTemplateMaxCount": 20,
    "TamperproofTemplateMaxCount": 50,
    "IpBlacklistTemplateMaxCount": 20,
    "HttpsPorts": "443",
    "DlpTemplateMaxCount": 50,
    "CustomRuleRatelimitor": "header",
    "DefenseObjectMaxCount": 20000,
    "Dlp": true,
    "DefenseObjectInTemplateMaxCount": 100,
    "CustomRuleAction": "block",
    "TamperproofRuleInTemplateMaxCount": 50,
    "DlpRuleInTemplateMaxCount": 50,
    "WhitelistTemplateMaxCount": 20,
    "MajorProtection": true,
    "BaseWafGroupRuleTemplateMaxCount": 20,
    "BotWeb": "true",
    "CustomRuleInTemplateMaxCount": 100,
    "VastIpBlacklistInOperationMaxCount": 500,
    "WhitelistRuleInTemplateMaxCount": 100,
    "AntiScan": true,
    "CustomResponseTemplateMaxCount": 20,
    "BaseWafGroupRuleInTemplateMaxCount": 100,
    "MajorProtectionTemplateMaxCount": 20,
    "BaseWafGroup": true,
    "Whitelist": true,
    "LogService": true,
    "VastIpBlacklistMaxCount": 50000,
    "FreeQps": 1000,
    "ExtendQps": 10000,
    "ElasticQps": 2000,
    "QpsBillingCap": 2000,
    "HybridCloud": true,
    "HybridCloudNodeExtend": 3,
    "Apisec": false,
    "AgenticApisec": true,
    "ResourceDirectory": true
  },
  "RequestId": "66A98669-CC6E-4F3E-80A6-3014697B11AE",
  "EndTime": 4809859200000,
  "InstanceId": "waf-cn-xxx",
  "InDebt": "1",
  "StartTime": 1668496310000,
  "RegionId": "cn-hangzhou",
  "PayType": "POSTPAY",
  "Edition": "デフォルト_version",
  "ProcessStatus": "注文_pending_payment"
}

    エラーコード

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

    変更履歴

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