すべてのプロダクト
Search

このプロダクト

    Cloud Firewall:DescribeUserBuyVersion

    ドキュメントセンター

    Cloud Firewall:DescribeUserBuyVersion

    最終更新日:May 08, 2026

    ユーザーのバージョン情報を取得します。

    操作説明

    この操作は、ご利用の Cloud Firewall インスタンスに関する情報を照会します。

    QPS 制限

    この操作は、ユーザーあたり秒間 10 回 (QPS) に制限されています。この制限を超えると API 呼び出しがスロットルされ、ビジネスに影響を及ぼす可能性があります。適切な頻度でこの操作を呼び出すことを推奨します。

    今すぐお試しください

    この 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-cloudfirewall:DescribeUserBuyVersion

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    InstanceId

    string

    任意

    インスタンス ID。このパラメーターを指定すると、インスタンス ID に基づいてクエリが実行されます。このパラメーターを空のままにすると、デフォルトで最新のインスタンスが照会されます。

    cfw_elasticity_public_cn-*******

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    AliUid

    integer

    Alibaba Cloud アカウントの ID。

    119898001566xxxx
    InstanceId

    string

    Cloud Firewall インスタンスの ID。

    説明

    このパラメーターは、トライアルエディションには適用されません。

    vipcloudfw-cn-xxxxx
    StartTime

    integer

    Cloud Firewall インスタンスが有効になった時刻。

    説明

    値は、ミリ秒単位の UNIX タイムスタンプです。

    1692504764000
    RequestId

    string

    リクエストの ID。

    F71B03EE-xxxxx-91D79CC6AA1A
    Version

    integer

    Cloud Firewall インスタンスのエディション。有効な値は次のとおりです。

    • 2: Premium Edition

    • 3: Enterprise Edition

    • 4: Ultimate Edition

    • 10: 従量課金

    2
    UserStatus

    boolean

    Cloud Firewall インスタンスのステータス。有効な値は次のとおりです。

    • true: インスタンスは有効です。

    • false: インスタンスは無効です。

    true
    Expire

    integer

    Cloud Firewall インスタンスの有効期限。

    説明

    値は、ミリ秒単位の UNIX タイムスタンプです。

    説明

    このパラメーターは、従量課金エディションには適用されません。

    1726934400000
    LogStatus

    boolean

    ログ配信が有効かどうかを示します。有効な値は次のとおりです。

    • true: 有効

    • false: 無効

    true
    InstanceStatus

    string

    Cloud Firewall インスタンスの運用ステータス。有効な値は次のとおりです。

    • normal: インスタンスは正常に動作しています。

    • init: インスタンスは初期化中です。

    • deleting: インスタンスは削除中です。

    • abnormal: インスタンスは異常な状態です。

    • free: 有効なインスタンスが利用できません。

    normal
    MaxOverflow

    integer

    超過トラフィックに対するエラスティック課金が有効かどうかを示します。有効な値は次のとおりです。

    • 1000000: 有効

    • 0: 無効

    説明

    このパラメーターは、サブスクリプションインスタンスにのみ適用されます。

    0
    VpcNumber

    integer

    購入済みの VPC ファイアウォールの数。

    説明

    このパラメーターは、サブスクリプションインスタンスにのみ適用されます。

    21
    IpNumber

    integer

    保護可能なパブリック IP アドレスの数。

    説明

    このパラメーターは、サブスクリプションインスタンスにのみ適用されます。

    63
    LogStorage

    integer

    購入済みのログストレージ容量。

    説明

    このパラメーターは、サブスクリプションインスタンスにのみ適用されます。

    3000
    InternetBandwidth

    integer

    インターネット境界ファイアウォール用に購入したトラフィック処理能力。

    3000
    VpcBandwidth

    integer

    VPC ファイアウォール用に購入したトラフィック処理能力。

    3000
    NatBandwidth

    integer

    NAT ファイアウォール用に購入したトラフィック処理能力。

    3000
    MajorVersion

    integer

    メジャーバージョン。

    1
    DefaultBandwidth

    integer

    エディションのデフォルト帯域幅。

    1000
    ExtensionBandwidth

    integer

    拡張帯域幅。

    1000
    TemporaryBandwidth

    integer

    一時的な帯域幅。

    1000
    GeneralInstance

    integer

    汎用インスタンスの数。

    10
    ThreatIntelligence

    integer

    脅威インテリジェンスが有効かどうかを示します。

    1
    Sdl

    integer

    データ漏えい防止が有効かどうかを示します。

    1
    PrivateDnsConnectorQuota

    integer

    非公開 DNS コネクタのクォータ。

    5
    AckClusterConnectorQuota

    integer

    ACK クラスターコネクタのクォータ。

    5

    例

    成功レスポンス

    JSONJSON

    {
  "AliUid": 0,
  "InstanceId": "vipcloudfw-cn-xxxxx",
  "StartTime": 1692504764000,
  "RequestId": "F71B03EE-xxxxx-91D79CC6AA1A",
  "Version": 2,
  "UserStatus": true,
  "Expire": 1726934400000,
  "LogStatus": true,
  "InstanceStatus": "normal",
  "MaxOverflow": 0,
  "VpcNumber": 21,
  "IpNumber": 63,
  "LogStorage": 3000,
  "InternetBandwidth": 3000,
  "VpcBandwidth": 3000,
  "NatBandwidth": 3000,
  "MajorVersion": 1,
  "DefaultBandwidth": 1000,
  "ExtensionBandwidth": 1000,
  "TemporaryBandwidth": 1000,
  "GeneralInstance": 10,
  "ThreatIntelligence": 1,
  "Sdl": 1,
  "PrivateDnsConnectorQuota": 5,
  "AckClusterConnectorQuota": 5
}

    エラーコード

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

    変更履歴

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