すべてのプロダクト
Search

このプロダクト

    Quota Center:GetProductQuota

    ドキュメントセンター

    Quota Center:GetProductQuota

    最終更新日:Sep 19, 2025

    指定された Alibaba Cloud プロダクトのクォータの詳細をクエリします。

    今すぐお試しください

    この 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 ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    quotas:GetProductQuota

    get

    *Quota

    acs:quotas:{#regionId}:{#accountId}:quota/{#ProductCode}/{#QuotaActionCode}

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    ProductCode

    string

    必須

    Alibaba Cloud プロダクト名の略称です。

    説明

    詳細については、「ListProducts」の ProductCode パラメーターをご参照ください。

    ecs
    QuotaActionCode

    string

    必須

    クォータ ID です。

    説明

    詳細については、「ListProductQuotas」の QuotaActionCode パラメーターをご参照ください。

    q_security-groups
    Dimensions

    array<object>

    任意

    クォータディメンション。 クォータディメンションは、クォータのプロパティです。Dimensions と QuotaActionCode の組み合わせは、クォータを一意に識別します。

    説明

    一部の Alibaba Cloud プロダクトでは、ディメンションが必要です。ListProductQuotaDimensions 操作を呼び出してクォータのディメンションをクエリし、ディメンションが必要かどうかを確認できます。レスポンスの Requisite パラメーターは、ディメンションが必要かどうかを示します。

    {\"regionId\":\"cn-beijing\"}

    object

    任意

    クォータディメンション。

    Key

    string

    任意

    クォータディメンションのキーです。

    説明

    Dimensions.N.Key と Dimensions.N.Value は同時に指定する必要があります。N の値は、Alibaba Cloud プロダクトがサポートするディメンションの数によって決まります。ListProductQuotaDimensions 操作を呼び出して、サポートされているディメンションをクエリできます。N の値は、返された配列の長さです。

    regionId
    Value

    string

    任意

    クォータディメンションの値です。

    説明

    Dimensions.N.Key と Dimensions.N.Value は同時に指定する必要があります。N の値は、Alibaba Cloud プロダクトがサポートするディメンションの数によって決まります。ListProductQuotaDimensions 操作を呼び出して、サポートされているディメンションをクエリできます。N の値は、返された配列の長さです。

    cn-hangzhou

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスパラメーターです。

    Quota

    object

    クォータの詳細です。

    Adjustable

    boolean

    クォータが調整可能かどうかを示します。有効値:

    • true: クォータは調整可能です。

    • false: クォータは調整できません。

    true
    ApplicableRange

    array

    クォータの調整可能な範囲です。

    number

    クォータの調整可能な範囲です。例: [802,10000]。

    802
    ApplicableType

    string

    調整可能なクォータのタイプ。有効値:

    • continuous: クォータ値は連続しています。

    • discontinuous: クォータ値は不連続です。

    continuous
    ApplyReasonTips

    string

    クォータ引き上げリクエストの理由の例です。

    The business xxx is expected to grow by 50%.
    Consumable

    boolean

    使用済みクォータが表示されるかどうかを示します。有効値:

    • true: 使用済みクォータが表示されます。

    • false: 使用済みクォータは表示されません。

    true
    Dimensions

    object

    クォータディメンション。フォーマット: {"regionId":"リージョン ID"}。

    {"regionId":"cn-hangzhou"}
    EffectiveTime

    string

    クォータが有効になる UTC 時間です。

    2022-09-28T06:06:00Z
    ExpireTime

    string

    クォータの有効期限が切れる UTC 時間です。

    2022-09-29T06:06:00Z
    GlobalQuota

    boolean

    クォータがグローバルクォータであるかどうかを示します。有効値:

    • true: クォータはすべてのリージョンで共有されます。

    • false: クォータは各リージョンで独立しています。

    true
    Period

    object

    クォータの計算期間です。

    PeriodUnit

    string

    計算期間の単位。有効値:

    • second

    • minute

    • hour

    • day

    • week

    day
    PeriodValue

    integer

    計算期間の値です。

    1
    ProductCode

    string

    Alibaba Cloud プロダクト名の略称です。

    ecs
    QuotaActionCode

    string

    クォータ ID です。

    q_security-groups
    QuotaArn

    string

    クォータの Alibaba Cloud リソースネーム (ARN) です。

    acs:quotas:cn-hangzhou:120886317861****:quota/ecs/q_security-groups/
    QuotaCategory

    string

    クォータのカテゴリ。有効値:

    • CommonQuota: 一般的なクォータ。

    • FlowControl: API レート制限。

    • WhiteListLabel: 特権。

    CommonQuota
    QuotaDescription

    string

    クォータの説明です。

    The maximum number of security groups that can be owned by the current account.
    QuotaItems

    array<object>

    クォータの詳細です。

    object

    クォータタイプです。

    Quota

    string

    クォータ値です。

    801
    QuotaUnit

    string

    クォータの単位です。

    説明

    クォータの単位はさまざまです。たとえば、Container Service for Kubernetes (ACK) の q_cbdch3 クォータ (クラスターの最大数) の単位は Cluster です。Elastic Compute Service (ECS) の q_security-groups クォータ (セキュリティグループの最大数) の単位は Count です。

    Count
    Type

    string

    クォータタイプ。有効値:

    • BaseQuota

    • ReservedQuota

    BaseQuota
    Usage

    string

    使用済みクォータです。

    26
    QuotaName

    string

    クォータの名前です。

    Maximum Number of Security Groups
    QuotaType

    string

    クォータのタイプ。有効値:

    • privilege

    • normal

    normal
    QuotaUnit

    string

    クォータの単位です。

    説明

    クォータの単位はさまざまです。たとえば、Container Service for Kubernetes (ACK) の q_cbdch3 クォータ (クラスターの最大数) の単位は Cluster です。Elastic Compute Service (ECS) の q_security-groups クォータ (セキュリティグループの最大数) の単位は Count です。

    Count
    SupportedRange

    array

    クォータでサポートされているクォータ値の範囲です。クォータテンプレートを設定する際に、この範囲を参照できます。

    number

    クォータでサポートされているクォータ値の範囲です。クォータテンプレートを設定する際に、この範囲を参照できます。

    • ApplicableType が continuous に設定され、このパラメーターの値が [802,1000] の場合、クォータ値は 802 から 1000 までの任意の整数にすることができます。

    • ApplicableType が discontinuous に設定され、このパラメーターの値が [10,20,50,100] の場合、クォータ値は 10、20、50、または 100 にすることができます。

    [802,1000]
    TotalQuota

    number

    クォータ値です。

    801
    TotalUsage

    number

    使用済みクォータです。

    26
    UnadjustableDetail

    string

    クォータが調整できない理由。有効値:

    • nonactivated: サービスがアクティブ化されていません。

    • applicationProcess: クォータ引き上げリクエストが処理中です。

    • limitReached: クォータ制限に達しました。

    • supportTicketRequired: クォータ引き上げをリクエストするには、チケットを送信する必要があります。

    limitReached
    UsageMetric

    object

    CloudMonitor でのクォータ使用量のモニタリングに関する情報です。

    説明

    このパラメーターが空の場合、CloudMonitor で利用可能なモニタリングデータはありません。

    MetricDimensions

    object

    CloudMonitor でクォータ使用量をモニタリングするためのディメンション。

    フォーマット: キーと値のペアのコレクション。例: {"productCode":"***","metricKey":"***","regionId":"***","label":"***"}。

    string

    CloudMonitor でクォータ使用量をモニタリングするためのディメンションの値です。

    ecs
    MetricName

    string

    CloudMonitor でクォータ使用量をモニタリングするためのメトリックの名前です。

    Usage
    MetricNamespace

    string

    CloudMonitor でクォータ使用量をモニタリングするためのメトリックの名前空間です。

    acs_quotas_flowcontrol
    RequestId

    string

    リクエスト ID です。

    8FF8CAF0-29D9-4F11-B6A4-FD2CBCA016D3

    例

    成功レスポンス

    JSONJSON

    {
  "Quota": {
    "Adjustable": true,
    "ApplicableRange": [
      802
    ],
    "ApplicableType": "continuous",
    "ApplyReasonTips": "The business xxx is expected to grow by 50%.",
    "Consumable": true,
    "Dimensions": {
      "regionId": "cn-hangzhou"
    },
    "EffectiveTime": "2022-09-28T06:06:00Z",
    "ExpireTime": "2022-09-29T06:06:00Z",
    "GlobalQuota": true,
    "Period": {
      "PeriodUnit": "day",
      "PeriodValue": 1
    },
    "ProductCode": "ecs",
    "QuotaActionCode": "q_security-groups",
    "QuotaArn": "acs:quotas:cn-hangzhou:120886317861****:quota/ecs/q_security-groups/",
    "QuotaCategory": "CommonQuota",
    "QuotaDescription": "The maximum number of security groups that can be owned by the current account.",
    "QuotaItems": [
      {
        "Quota": "801",
        "QuotaUnit": "Count",
        "Type": "BaseQuota",
        "Usage": "26"
      }
    ],
    "QuotaName": "Maximum Number of Security Groups",
    "QuotaType": "normal",
    "QuotaUnit": "Count",
    "SupportedRange": [
      0
    ],
    "TotalQuota": 801,
    "TotalUsage": 26,
    "UnadjustableDetail": "limitReached",
    "UsageMetric": {
      "MetricDimensions": {
        "key": "ecs"
      },
      "MetricName": "Usage",
      "MetricNamespace": "acs_quotas_flowcontrol"
    }
  },
  "RequestId": "8FF8CAF0-29D9-4F11-B6A4-FD2CBCA016D3"
}

    エラーコード

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

    変更履歴

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