alibabacloud-odps-quota-manage

MaxCompute クォータ管理

Alibaba Cloud CLI と SDK を使用して MaxCompute（ODPS）のクォータリソースを管理します。このスキルでは、従量課金クォータの作成、クォータの照会、クォータの一覧表示を扱います。

制限事項と注意事項

機能	CLI のサポート	SDK のサポート	備考
従量課金クォータの作成	✅ はい	✅ はい	完全にサポートされています
サブスクリプションクォータの作成	❌ サポート対象外	❌ サポート対象外	一時的に利用できません
クォータの照会（get-quota）	✅ はい	✅ はい	⚠️ 非推奨 - 代わりに query-quota を使用してください
クォータの照会（query-quota）	✅ はい	✅ はい	get-quota の推奨される代替手段です
クォータの一覧表示	✅ はい	✅ はい	完全にサポートされています（従量課金とサブスクリプションの両方）
クォータの削除	❌ API なし	❌ API なし	API では利用できません - コンソールを使用する必要があります
クォータの変更	❌ 対象外	❌ 対象外	このソリューションでは扱いません

重要:

• このスキルでは、サブスクリプションクォータの作成は一時的にサポートされていません。サブスクリプションクォータを作成するには、Alibaba Cloud コンソールを使用してください。
• クォータの削除操作は CLI または SDK からは利用できません。クォータを削除するには、Alibaba Cloud コンソールを使用する必要があります。
• query-quota を優先してください - get-quota は非推奨ですが、成功が返される場合は使用できます。
• ⚠️ 重要：クォータの存在を確認する際は、必ず list-quotas を使用してください。get-quota は絶対に使用しないでください。
• 🚨 必須：create-quota の実行前に、必ず list-quotas を呼び出してください。この手順は絶対に省略しないでください。

アーキテクチャ

Alibaba Cloud Account → MaxCompute Service → Quota Resources (CU)
                                           ├── Pay-as-you-go Quota (后付费) ← **Creation Supported**
                                           └── Subscription Quota (预付费) ← Query/List only

インストール

事前確認：Aliyun CLI >= 3.3.3 が必要です aliyun version を実行して、バージョンが 3.3.3 以上であることを確認してください。未インストールの場合、またはバージョンが古い場合は、 curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash を実行して更新するか、 インストール手順については references/cli-installation-guide.md を参照してください。

事前確認：Aliyun CLI プラグインのセットアップが必要です [必須] maxcompute プラグインを手動でインストールします：aliyun plugin install maxcompute [必須] プラグインを最新バージョンに更新します：aliyun plugin update maxcompute

# Verify CLI version
aliyun version

# Install maxcompute plugin (confirm when prompted)
aliyun plugin install maxcompute

# Update maxcompute plugin to latest version
aliyun plugin update maxcompute

[必須] CLI の User-Agent — aliyun CLI コマンドを実行するたびに、次の指定を含める必要があります： --user-agent AlibabaCloud-Agent-Skills/alibabacloud-odps-quota-manage

コアワークフローの開始時（CLI を実行する前）： [必須] AI-Mode を有効化する — エージェントスキルの実行には AI-mode が必要です。 CLI を実行する前に、次のコマンドを実行してください：

aliyun configure ai-mode enable
aliyun configure ai-mode set-user-agent --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-odps-quota-manage"

[必須] あらゆる終了時点で AI-Mode を無効化する — どのような理由であっても、最終応答を返す前に、必ず AI-mode を無効化してください。これは、ワークフローの成功、ワークフローの失敗、エラー／例外、ユーザーによるキャンセル、セッション終了、または以降 CLI コマンドを実行しないその他すべての状況を含む、あらゆる終了経路に適用されます。 AI-mode はエージェントスキルの実行時にのみ使用し、スキルの実行終了後も有効なままにしてはなりません。

aliyun configure ai-mode disable

環境変数

このスキルでは、aliyun CLI のデフォルト認証情報チェーンを使用します。認証情報を明示的に設定する必要はありません。

• 初回使用前に aliyun configure を実行して認証情報を設定してください
• コマンドで認証情報の値を明示的に扱ったり渡したりしないでください

タイムアウト設定：

• ALIBABA_CLOUD_CONNECT_TIMEOUT：接続タイムアウト（デフォルト：10s）
• ALIBABA_CLOUD_READ_TIMEOUT：読み取りタイムアウト（デフォルト：10s）
• これらのデフォルト値でクォータ操作には十分です。明示的な設定は不要です

パラメーターの確認

重要：パラメーターの確認 — コマンドまたは API 呼び出しを実行する前に、 ユーザーが変更可能なすべてのパラメーター（例：RegionId、クォータのニックネーム、課金タイプなど）をユーザーに確認する必要があります。明示的な承認なしに、値を推測したりデフォルト値を使用したりしないでください。

入力の検証

パラメーター	検証ルール
RegionId	有効な Alibaba Cloud のリージョン ID（例：cn-hangzhou、cn-shanghai）である必要があります
nickname	最大 64 文字です。英数字、ハイフン（-）、アンダースコア（_）を使用できます。漢字を含む場合は URL エンコードしてください
chargeType	payasyougo である必要があります（サブスクリプションはサポートされていません）
commodityCode	odps、odpsplus、odps_intl、odpsplus_intl のいずれかである必要があります
billingType	payasyougo、subscription、ALL のいずれかである必要があります

セキュリティに関する注意： すべてのユーザー入力は aliyun CLI に渡され、パラメーターのサニタイズは aliyun CLI が処理します。未加工のユーザー入力を文字列連結してコマンドを作成しないでください。

パラメーター名	必須／任意	説明	デフォルト値
RegionId	必須	Alibaba Cloud のリージョン（例：cn-hangzhou、cn-shanghai）	-
chargeType	必須	課金タイプ：payasyougo のみ（サブスクリプションはサポートされていません）	-
commodityCode	必須	商品コード（下の表を参照）	-
billingType	任意	一覧表示のフィルター：subscription、payasyougo、ALL	ALL
maxItem	任意	一覧表示における 1 ページあたりの最大項目数	100

商品コード（従量課金用）

サイト	商品コード
中国（国内站）	odps
国際（国际站）	odps_intl

認証

セキュリティ：認証情報を決して公開しないでください

• AK／SK の値を出力しないでください
• チャットでユーザーに AK／SK の入力を求めないでください
• aliyun configure set にハードコードされた値を指定しないでください

認証情報を確認する：

aliyun configure list

認証情報がない場合は、まず aliyun configure を実行するようユーザーに依頼してから続行してください。

基本的なワークフロー

🚨 ステップ 0 - 実行前に必ずパラメーターをユーザーに確認してください：

CLI コマンドを実行する前に、必須パラメーターをすべてユーザーに確認する必要があります。

• LIST の場合： region と billing-type（payasyougo／subscription／ALL）を確認します
• QUERY の場合： region と nickname を確認します
• CREATE の場合： region、charge-type、commodity-code を確認します

値を推測したり、デフォルト値を使用したりしないでください。ユーザーに明示的に確認し、確認が取れるまで先に進まないでください。

🚨 すべての操作に適用される重要なルール：

操作	最初のコマンド	次の処理
CREATE クォータ	list-quotas	空の場合 → 作成、存在する場合 → 停止
QUERY クォータ	query-quota	結果を表示
LIST クォータ	list-quotas	一覧を表示

⚠️ 最初に list-quotas を実行せずに CREATE するとエラーになります

---

禁止コマンド - 絶対に使用しないでください：

• ❌ aliyun quotas コマンド - 誤ったサービス（Quota Center）です。代わりに MaxCompute を使用してください
• ❌ クォータ操作での BssOpenApi コマンド - 代わりに MaxCompute を使用してください
• ❌ get-quota - 非推奨です。代わりに query-quota を使用してください

必ず使用するコマンド（プラグインモード、ケバブケース）：

• ✅ aliyun maxcompute list-quotas - クォータの一覧表示／確認用
• ✅ aliyun maxcompute query-quota - クォータの詳細照会用
• ✅ aliyun maxcompute create-quota - クォータの作成用

⚠️ 重要： aliyun quotas コマンド（Quota Center サービス）ではなく、aliyun maxcompute コマンド（MaxCompute サービス）を使用してください。

コマンドのルール：

• すべての CLI コマンドでプラグインモード（ケバブケース）を使用します：create-quota、list-quotas、query-quota
• パラメーターにもケバブケースを使用します：--charge-type、--commodity-code、--billing-type

---

クォータの作成（最初に確認してから作成）：

🚨 プリペイド／サブスクリプションのクォータは禁止されています： このスキルがサポートするクォータの作成方法は、従量課金のみです。

• ユーザーがプリペイド／サブスクリプションのクォータを希望する場合は、Alibaba Cloud Consoleを利用するよう案内してください。
• プリペイドのクォータを作成しようとしないでください。

🚨 作成する場合は、必ず最初にLISTQUOTASを実行してください。省略禁止です：

ステップ1 - 必須：最初にlist-quotasを呼び出す

aliyun maxcompute list-quotas --billing-type payasyougo --region <R>

list-quotasの結果を取得するまで、ステップ2に進まないでください。

Quota Center（aliyun quotas）ではなく、MaxComputeサービス（aliyun maxcompute）を使用してください。

list-quotasの結果取得後（ステップ2）：

結果	アクション
一覧にクォータがある	作成しないでください。「クォータはすでに存在します」とユーザーに伝えます → 完了
一覧が空	ステップ3（作成）に進みます

ステップ3 - 一覧が空の場合に限る：

作成前のチェックリスト - すべて満たす必要があります：

• ユーザーが従量課金を希望している（プリペイド／サブスクリプションではない）
• list-quotasを呼び出し、空の一覧が返された
• リージョン内に既存の従量課金クォータがない
• ユーザーが作成を確認した

aliyun maxcompute create-quota --charge-type payasyougo --commodity-code odps --region <R> --client-token <UNIQUE_TOKEN>

国際サイトの場合：

aliyun maxcompute create-quota --charge-type payasyougo --commodity-code odps_intl --region <R> --client-token <UNIQUE_TOKEN>

重要：

• プラグインモード（ケバブケース）を使用します：create-quota
• BssOpenApiではなく、MaxComputeサービスを使用します。
• client-token： 再試行時の冪等性を確保するため、一意のトークン（例：UUID）を生成します。
• commodityCodeの値：
  • 中国サイト：odpsまたはodpsplus
  • 国際サイト：odps_intlまたはodpsplus_intl
  • maxcomputeをcommodityCodeとして使用しないでください。
  • 注：chargeType=payasyougoが設定されている場合、commodityCodeの検証は厳密ではありません。

⚠️ 出力の取り扱い：

• コマンド出力をファイルにパイプしないでください（例：| tee ...や> file.json）。出力先のディレクトリが存在しない場合、API呼び出しが成功していても、コマンドはゼロ以外の終了コードを返します。
• CLIから標準出力に直接出力し、その場で結果を解析してください。
• 出力ファイルを保存する場合（例：existing_quotas.json、actions_log.txt）、ファイルを書き込む前に必ずmkdir -p <directory>を実行し、出力先のディレクトリが存在することを確認してください。

最後に：

• 結果を解析します。
• ユーザーに表示します。
• 完了

⚠️ list-quotasより先にcreate-quotaを呼び出さないでください。エラーの原因になります。

**注：**クォータがすでに存在する場合は作成しないでください。list-quotasで空の一覧が返された場合に限り、作成してください。

クォータの照会（ユーザーがニックネームを指定した場合）：

**優先事項：**ニックネームで特定のクォータの詳細を照会する場合は、主なAPIとしてquery-quotaを使用してください。

チェックリスト：

• ユーザーがクォータのニックネームを指定した
• get-quotaではなくquery-quotaを使用する

次のコマンドを使用します：

aliyun maxcompute query-quota --nickname <N> --region <R>

**重要：**ニックネームに漢字が含まれている場合は、コマンドに渡す前にURLエンコードしてください。

禁止：get-quotaは非推奨です。代わりにquery-quotaを使用してください。

• JSONを解析します。
• nickName、name、id、statusを抽出します。
• すべてのフィールドを表示します → 完了

クォータの一覧表示：

⚠️ クォータの一覧表示には、BssOpenApiではなく、MaxComputeのlist-quotasのみを使用してください。

既存の従量課金クォータを確認する場合（作成前）：

aliyun maxcompute list-quotas --billing-type payasyougo --region <R>

APIレベルでフィルタリングするため、必ず--billing-type payasyougoを含めてください。

すべてのクォータを一覧表示する場合（ユーザーからの依頼）：

aliyun maxcompute list-quotas --billing-type ALL --region <R>

billingTypeパラメーター：

• 有効な値：payasyougo、subscription、ALL

• 設定されていない場合、デフォルトはALLです。

• 既存の従量課金クォータを確認する場合は、payasyougoを使用してください。

• JSONを解析します。

• quotaInfoList配列を抽出します。

• 一覧を表示します → 完了

レスポンスフィールドodpsSpecCodeの列挙値：

odpsSpecCode	説明
OdpsStandard	ODPS従量課金リソース
OdpsSpot	ODPSスポット／オフピークリソース（従量課金）
OdpsDev	開発者リソースタイプ
OdpsPlusStandard	サブスクリプションリソース
OdpsPlusHa	高可用性リソース
OdpsPlusElasticCU	ODPSの予約不要なエラスティックCUサブスクリプションリソース

---

クイックリファレンス

CLI コマンドの完全なリファレンスとレスポンス形式の詳細については、references/related-apis.md を参照してください。

重要なポイント：

• 作成前に list-quotas --billing-type payasyougo を使用します
• 照会には get-quota ではなく query-quota を使用します
• 作成には create-quota（kebab-case のプラグインモード）を使用します
• 必ず --user-agent AlibabaCloud-Agent-Skills/alibabacloud-odps-quota-manage を含めます

---

タスクの完了

出力ファイル — 完了前に必ず作成してください：

1. mkdir -p outputs ran_scripts を実行して、最初にディレクトリが存在することを確認します
2. クォータの照会／一覧表示結果を outputs/existing_quotas.json に保存します
3. 実行したすべての操作のログを ran_scripts/actions_log.txt に保存します

重要： ファイルを書き込む前に、対象ディレクトリに対して必ず mkdir -p を実行してください。ディレクトリがすでに存在すると決めつけないでください。

次の内容で終了します：

• 実行した内容の概要
• 主な結果（ニックネーム、リージョン、ステータス）
• 出力ファイルが書き込まれたことの確認（outputs/existing_quotas.json、ran_scripts/actions_log.txt）
• "✅ Complete"

---

エラー処理

エラーコード	対応方法
QuotaAlreadyExists	クォータが存在します → 照会して詳細を表示します → タスク完了
QuotaNotFound	クォータが存在しません → ユーザーに伝えます
InvalidParameter	パラメーターの形式が正しくありません → ユーザーに確認します
Forbidden	権限がありません → コンソールを案内します
INTERNAL_ERROR	1 回再試行するか、サポートに問い合わせます

---

クリーンアップ

削除 API はありません — クォータを削除するには コンソール を使用する必要があります

API リファレンス

API リファレンス、CLI コマンド、レスポンス形式の詳細については、references/related-apis.md を参照してください。

ベストプラクティス

1. 操作の前に必ずユーザーにリージョンを確認します
2. 作成する場合：クォータが存在するかどうかを最初に一覧表示して確認します（リージョンごとに 1 つまで）
3. クォータが存在する場合：作成を試みるのではなく、ユーザーのために照会します
4. クォータの詳細には get-quota ではなく query-quota を使用します
5. サブスクリプションクォータの場合：ユーザーに Alibaba Cloud コンソールを案内します

参考リンク

参考資料	説明
references/related-apis.md	CLI コマンドと API リファレンスの完全版
references/ram-policies.md	必要な RAM 権限
references/verification-method.md	成功の確認手順
references/acceptance-criteria.md	テストの受け入れ基準
references/cli-installation-guide.md	CLI のインストールガイド

関連ドキュメント

• MaxCompute 製品
• create-quota API
• get-quota API
• list-quotas API
• Java SDK ドキュメント
• 認証情報の管理