GetQuota API を使用してレベル 1 クォータグループ情報を取得 - MaxCompute

指定されたレベル 1 クォータグループに関する情報を取得します。警告: この操作は 2024 年 7 月 31 日に非公開になり、QueryQuota 操作に置き換えられます。 2 つの操作のリクエストパラメーター、レスポンスパラメーター、および機能は同じです。

今すぐお試しください

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

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

odps:GetQuota

get

*Quota

acs:odps:{#regionId}:{#accountId}:quotas/{#NickName}

なし

リクエスト構文

GET /api/v1/quotas/{nickname} HTTP/1.1

リクエストパラメーター

パラメーター	タイプ	必須 / 任意	説明	例
nickname	string	必須	クォータの名前。	quota_a
tenantId `deprecated`	string	任意		520539530998273
region `deprecated`	string	任意		cn-chengdu
AkProven `deprecated`	string	任意		null
mock	boolean	任意	サブモジュールを含めるかどうかを指定します。有効な値: -true: サブモジュールを含めます。 -false (デフォルト): サブモジュールを含めません。	false

レスポンスパラメーター

パラメーター	タイプ	説明	例
	object	PopCompatibleResult
billingPolicy	object	注文情報です。
billingMethod	string	課金方法。 subscription: サブスクリプションクォータを示します。 payasyougo: 従量課金クォータを示します。	subscription
odpsSpecCode	string	次数の仕様。	OdpsStandard
orderId	string	注文 ID です。	45245678
saleTag	object	MaxCompute クォータオブジェクトの識別子です。この識別子は、Alibaba Cloud の請求書の識別子と同じです。このパラメーターは、タグ付けシナリオで使用されます。
resourceIds	array	MaxCompute クォータオブジェクトの識別子です。この識別子は、Alibaba Cloud の課金サブシステムにも存在します。この識別子を使用すると、クォータオブジェクトのコストをタグに関連付けることができます。
	string	MaxCompute クォータオブジェクトの識別子です。この識別子は、Alibaba Cloud の課金サブシステムにも存在します。この識別子を使用すると、クォータオブジェクトのコストをタグに関連付けることができます。	"aaaaaaa-bbbb-4fd0-a8eb-50861590f7dd"
resourceType	string	オブジェクトのタイプ。現在は、クォータとプロジェクトのみがサポートされています。	"quota"
cluster	string	クラスタ ID です。	AT-120N
createTime	integer	リソースが作成された時間。	2022-09-06T02:14:44Z
creatorId	string	リソースの作成者。このパラメーターは、Alibaba Cloud アカウントの UID です。	672863518
requestId	string	リクエスト ID です。	0b87b7a316654730544735643e9200
id	string	クォータ ID です。	0
name	string	クォータ名。	quota_a
nickName	string	クォータのエイリアス。	quota_nickname
parameter	object	クォータの説明。	{"minCU":10, "adhocCU":0, "maxCU":10, "schedulerType":"Fair", }
parentId	string	親リソースの ID です。	null
regionId	string	リージョン ID です。	cn-beijing
scheduleInfo	object	時間共有情報です。
currPlan	string	スケジュール計画に基づいて有効なクォータプランです。	planA
currTime	string	currPlan がスケジュールされた時間。	0800
nextPlan	string	スケジュール計画に基づいて有効になるクォータプランです。	planB
nextTime	string	next_plan がスケジュールされている時間です。	1700
oncePlan	string	すぐに有効になるクォータプランです。ユーザーが curr_plan とは異なるプランをトリガーしてすぐに有効にした場合、このパラメーターは Empty ではありません。	planC
onceTime	string	即時効果プランがトリガーされた時間。	1500
operatorName	string	オペレーターの名前。	userA
timezone	string	タイムゾーン。	UTC+8
status	string	リソースのステータス。	ON
subQuotaInfoList	array<object>	レベル 2 クォータに関する情報です。
	object	データ。
billingPolicy	object	注文情報です。
billingMethod	string	課金方法。 subscription: サブスクリプションクォータを示します。 payasyougo: 従量課金クォータを示します。	subscription
odpsSpecCode	string	次数の仕様。	OdpsStandard
orderId	string	注文 ID です。	45245678
saleTag	object	MaxCompute クォータオブジェクトの識別子です。この識別子は、Alibaba Cloud の請求書の識別子と同じです。このパラメーターは、タギングシナリオで使用されます。
resourceIds	array	MaxCompute クォータオブジェクトの識別子です。この識別子は、Alibaba Cloud の課金サブシステムにも存在します。この識別子を使用すると、クォータオブジェクトのコストをタグに関連付けることができます。
	string	MaxCompute クォータオブジェクトの識別子です。この識別子は、Alibaba Cloud の課金サブシステムにも存在します。この識別子を使用すると、クォータオブジェクトのコストをタグに関連付けることができます。	"aaaaaaa-bbbb-4fd0-a8eb-50861590f7dd"
resourceType	string	オブジェクトのタイプ。現在は、クォータとプロジェクトのみがサポートされています。	"quota"
cluster	string	クラスター ID です。	AT-120N
createTime	integer	リソースが作成された時間です。	2022-09-06T02:14:44Z
creatorId	string	リソースの作成者。このパラメーターは、Alibaba Cloud アカウントの UID です。	672863518
id	string	レベル 2 クォータ ID。	1000048
name	string	レベル 2 クォータの名前。	subquotaA
nickName	string	レベル 2 クォータのエイリアス。	subquotaA
parameter	object	クォータの説明。	{"minCU":10, "adhocCU":0, "maxCU":10, "schedulerType":"Fair", }
enablePriority	boolean	優先機能を有効にします。
forceReservedMin	boolean	排他的使用を有効にするかどうかを指定します。
maxCU	integer	予約済みコンピューティングユニット（ CU ）の上限です。
minCU	integer	保証された予約 CU です。
schedulerType	string	スケジューリングポリシー。
singleJobCULimit	integer	1 つのジョブの CU の上限。
elasticReservedCU	integer	エラスティック予約 CU の値です。
parentId	string	親リソースの ID です。	0
regionId	string	リージョン ID です。	cn-beijing
scheduleInfo	object	時間共有情報です。
currPlan	string	スケジュール計画に基づいて有効なクォータプランです。	planA
currTime	string	currPlan がスケジュールされた時間。	0800
nextPlan	string	スケジュール計画に基づいて有効になるクォータプランです。	planB
nextTime	string	next_plan がスケジュールされている時間。	1700
oncePlan	string	すぐに有効になるクォータプランです。ユーザーが curr_plan とは異なるプランをトリガーしてすぐに有効にした場合、このパラメーターは Empty ではありません。	planC
onceTime	string	即時効果プランがトリガーされた時間。	1500
operatorName	string	オペレーターの名前。	userA
timezone	string	タイムゾーン。	UTC+8
status	string	リソースのステータスです。	ON
tag	string	クォータのリソースタグ。	abc
tenantId	string	テナント ID です。	478403690625249
type	string	このパラメーターは、コントロールクラスターの resourceSystemType フィールドに対応します。	FUXI_ONLINE
version	string	バージョン番号です。	1
tag	string	クォータのリソースタグです。	abc
tenantId	string	テナント ID です。	478403690625249
type	string	このパラメーターは、コントロールクラスターの resourceSystemType フィールドに対応します。	FUXI_ONLINE
version	string	バージョン番号です。	1
data	object	返されるデータ。
id	string	クォータ ID です。	0
name	string	クォータ名。	quota_a
nickName	string	クォータのエイリアス。	quota_nickname
type	string	このパラメーターは、コントロールクラスターの resourceSystemType フィールドに対応します。	FUXI_ONLINE
status	string	リソースステータス。	ON
saleTag	object	MaxCompute クォータオブジェクトの識別子です。この識別子は、Alibaba Cloud の請求書の識別子と同じです。このパラメーターは、タグ付けシナリオで使用されます。
resourceIds	array	MaxCompute クォータオブジェクトの識別子です。この識別子は、Alibaba Cloud の課金サブシステムにも存在します。この識別子を使用すると、クォータオブジェクトのコストをタグに関連付けることができます。
	string	MaxCompute クォータオブジェクトの識別子です。この識別子は、Alibaba Cloud の課金サブシステムにも存在します。この識別子を使用すると、クォータオブジェクトのコストをタグに関連付けることができます。	"aaaaaaa-bbbb-4fd0-a8eb-50861590f7dd"
resourceType	string	オブジェクトのタイプ。現在は、quota と project のみがサポートされています。	"quota"
tenantId	string	テナントID。	478403690625249
regionId	string	リージョン ID です。	cn-beijing
parentId	string	親リソースの ID です。	null
cluster	string	クラスタ ID です。	AT-120N
version	string	バージョン番号です。	1
billingPolicy	object	次数情報です。
odpsSpecCode	string	次数の仕様です。	OdpsStandard
orderId	string	注文 ID です。	45245678
billingMethod	string	課金方法。 subscription: サブスクリプションクォータを示します。 payasyougo: 従量課金制クォータを示します。	subscription
scheduleInfo	object	時間共有情報です。
currPlan	string	スケジュールプランに基づいて有効なクォータプランです。	planA
currTime	string	currPlan がスケジュールされた時間。	0800
nextPlan	string	スケジュール計画に基づいて有効になるクォータプランです。	planB
nextTime	string	next_plan がスケジュールされている時間。	1700
oncePlan	string	すぐに有効になるクォータプランです。ユーザーが curr_plan とは異なるプランをトリガーしてすぐに有効にした場合、このパラメーターは Empty ではありません。	planC
onceTime	string	即時発効プランがトリガーされた時間。	1500
operatorName	string	オペレーターの名前。	userA
timezone	string	タイムゾーン。	UTC+8
parameter	object	クォータの説明。	{"minCU":10, "adhocCU":0, "maxCU":10, "schedulerType":"Fair", }
tag	string	クォータのリソースタグ。	abc
createTime	integer	リソースが作成された日時です。	2022-09-06T02:14:44Z
creatorId	string	リソースの作成者。このパラメーターは、Alibaba Cloud アカウントの UID です。	672863518
subQuotaInfoList	array<object>	レベル 2 クォータに関する情報。
	object	データです。
id	string	レベル 2 クォータ ID。	1000048
name	string	レベル 2 クォータの名前。	subquotaA
saleTag	object	MaxCompute クォータオブジェクトの識別子です。この識別子は、Alibaba Cloud の請求書の識別子と同じです。このパラメーターは、タグ付けシナリオで使用されます。
resourceIds	array	MaxCompute クォータオブジェクトの識別子です。この識別子は、Alibaba Cloud の課金サブシステムにも存在します。この識別子を使用すると、クォータオブジェクトのコストをタグに関連付けることができます。
	string	MaxCompute クォータオブジェクトの識別子です。この識別子は、Alibaba Cloud の課金サブシステムにも存在します。この識別子を使用すると、クォータオブジェクトのコストをタグに関連付けることができます。	"aaaaaaa-bbbb-4fd0-a8eb-50861590f7dd"
resourceType	string	オブジェクトのタイプ。現在は、クォータとプロジェクトのみがサポートされています。	"quota"
nickName	string	レベル 2 クォータのニックネーム。	subquotaA
type	string	このパラメーターは、コントロールクラスターの resourceSystemType フィールドに対応します。	FUXI_ONLINE
status	string	リソースのステータスです。	ON
tenantId	string	テナント ID です。	478403690625249
regionId	string	リージョン ID です。	cn-beijing
parentId	string	親リソースの ID です。	0
cluster	string	クラスタ ID です。	AT-120N
version	string	バージョン番号です。	1
billingPolicy	object	次数情報です。
odpsSpecCode	string	注文の仕様。	OdpsStandard
orderId	string	注文 ID です。	45245678
billingMethod	string	課金方法。 subscription: サブスクリプションクォータを示します。 payasyougo: 従量課金クォータを示します。	subscription
scheduleInfo	object	時間共有情報です。
currPlan	string	スケジュール計画に基づいて有効になっているクォータプランです。	planA
currTime	string	currPlan がスケジュールされた時間。	0800
nextPlan	string	スケジュールに基づいて次に有効になるクォータプランです。	planB
nextTime	string	next_plan がスケジュールされている時間。	1700
oncePlan	string	すぐに有効になるクォータプランです。ユーザーが curr_plan とは異なるプランをトリガーしてすぐに有効にした場合、このパラメーターは Empty ではありません。	planC
onceTime	string	即時効果プランがトリガーされた時間です。	1500
operatorName	string	オペレーターの名前。	userA
timezone	string	時間帯。	UTC+8
parameter	object	クォータの説明。
enablePriority	boolean	優先機能を有効にします。
forceReservedMin	boolean	排他的使用を有効にするかどうかを指定します。
maxCU	integer	予約済みコンピューティングユニット（CU）の上限です。
minCU	integer	保証された予約済みの CU です。
schedulerType	string	スケジューリングポリシーです。
singleJobCULimit	integer	1 つのジョブの CU の上限です。
elasticReservedCU	integer	弾性予約 CU の値です。
tag	string	クォータのリソースタグです。	abc
createTime	integer	リソースが作成された時間です。	2022-09-06T02:14:44Z
creatorId	string	リソースの作成者。このパラメーターは、Alibaba Cloud アカウントの UID です。	672863518

例

成功レスポンス

JSONJSON

{
  "billingPolicy": {
    "billingMethod": "subscription\n",
    "odpsSpecCode": "OdpsStandard",
    "orderId": "45245678"
  },
  "saleTag": {
    "resourceIds": [
      "\"aaaaaaa-bbbb-4fd0-a8eb-50861590f7dd\"\n"
    ],
    "resourceType": "\"quota\""
  },
  "cluster": "AT-120N",
  "createTime": 0,
  "creatorId": "672863518\n",
  "requestId": "0b87b7a316654730544735643e9200",
  "id": "0",
  "name": "quota_a\n",
  "nickName": "quota_nickname",
  "parameter": {
    "test": "test",
    "test2": 1
  },
  "parentId": "null",
  "regionId": "cn-beijing",
  "scheduleInfo": {
    "currPlan": "planA",
    "currTime": "0800",
    "nextPlan": "planB",
    "nextTime": "1700",
    "oncePlan": "planC",
    "onceTime": "1500",
    "operatorName": "userA",
    "timezone": "UTC+8"
  },
  "status": "ON",
  "subQuotaInfoList": [
    {
      "billingPolicy": {
        "billingMethod": "subscription",
        "odpsSpecCode": "OdpsStandard\n",
        "orderId": "45245678\n"
      },
      "saleTag": {
        "resourceIds": [
          "\"aaaaaaa-bbbb-4fd0-a8eb-50861590f7dd\"\n"
        ],
        "resourceType": "\"quota\""
      },
      "cluster": "AT-120N\n",
      "createTime": 0,
      "creatorId": "672863518\n",
      "id": "1000048\n",
      "name": "subquotaA\n",
      "nickName": "subquotaA\n",
      "parameter": {
        "enablePriority": true,
        "forceReservedMin": true,
        "maxCU": 0,
        "minCU": 0,
        "schedulerType": "",
        "singleJobCULimit": 0,
        "elasticReservedCU": 0
      },
      "parentId": "0",
      "regionId": "cn-beijing",
      "scheduleInfo": {
        "currPlan": "planA",
        "currTime": "0800",
        "nextPlan": "planB",
        "nextTime": "1700",
        "oncePlan": "planC",
        "onceTime": "1500",
        "operatorName": "userA\n",
        "timezone": "UTC+8"
      },
      "status": "ON\n",
      "tag": "abc",
      "tenantId": "478403690625249",
      "type": "FUXI_ONLINE",
      "version": "1"
    }
  ],
  "tag": "abc",
  "tenantId": "478403690625249",
  "type": "FUXI_ONLINE",
  "version": "1",
  "data": {
    "id": "0",
    "name": "quota_a",
    "nickName": "quota_nickname",
    "type": "FUXI_ONLINE",
    "status": "ON",
    "saleTag": {
      "resourceIds": [
        "\"aaaaaaa-bbbb-4fd0-a8eb-50861590f7dd\"\n"
      ],
      "resourceType": "\"quota\"\n"
    },
    "tenantId": "478403690625249",
    "regionId": "cn-beijing",
    "parentId": "null",
    "cluster": "AT-120N",
    "version": "1",
    "billingPolicy": {
      "odpsSpecCode": "OdpsStandard",
      "orderId": "45245678",
      "billingMethod": "subscription"
    },
    "scheduleInfo": {
      "currPlan": "planA",
      "currTime": "0800",
      "nextPlan": "planB",
      "nextTime": "1700",
      "oncePlan": "planC",
      "onceTime": "1500",
      "operatorName": "userA",
      "timezone": "UTC+8"
    },
    "parameter": {
      "test": "test",
      "test2": 1
    },
    "tag": "abc",
    "createTime": 0,
    "creatorId": "672863518",
    "subQuotaInfoList": [
      {
        "id": "1000048",
        "name": "subquotaA",
        "saleTag": {
          "resourceIds": [
            "\"aaaaaaa-bbbb-4fd0-a8eb-50861590f7dd\"\n"
          ],
          "resourceType": "\"quota\"\n"
        },
        "nickName": "subquotaA",
        "type": "FUXI_ONLINE",
        "status": "ON",
        "tenantId": "478403690625249\n",
        "regionId": "cn-beijing",
        "parentId": "0",
        "cluster": "AT-120N\n",
        "version": "1",
        "billingPolicy": {
          "odpsSpecCode": "OdpsStandard",
          "orderId": "45245678",
          "billingMethod": "subscription"
        },
        "scheduleInfo": {
          "currPlan": "planA",
          "currTime": "0800",
          "nextPlan": "planB",
          "nextTime": "1700",
          "oncePlan": "planC",
          "onceTime": "1500",
          "operatorName": "userA",
          "timezone": "UTC+8"
        },
        "parameter": {
          "enablePriority": true,
          "forceReservedMin": true,
          "maxCU": 0,
          "minCU": 0,
          "schedulerType": "",
          "singleJobCULimit": 0,
          "elasticReservedCU": 0
        },
        "tag": "abc",
        "createTime": 0,
        "creatorId": "672863518"
      }
    ]
  }
}

エラーコード

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

変更履歴

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