/alibabacloud-odps-quota-manage

name: alibabacloud-odps-quota-manage
description: |
  MaxCompute Quota Management Skill. Use for managing MaxCompute/ODPS quota resources including pay-as-you-go quota creation, query, and listing operations.
  Triggers: "MaxCompute quota", "ODPS quota", "create quota", "list quotas", "quota management", "CU management".

MaxCompute Quota Management

Manage MaxCompute (ODPS) Quota resources using Alibaba Cloud CLI and SDK. This skill covers **pay-as-you-go quota creation**, quota query, and quota listing operations.

Limitations and Notes

| Feature | CLI Support | SDK Support | Notes | |---------|-------------|-------------|-------| | Create Pay-as-you-go Quota | ✅ Yes | ✅ Yes | Fully supported | | Create Subscription Quota | ❌ Not Supported | ❌ Not Supported | **Temporarily unavailable** | | Query Quota (get-quota) | ✅ Yes | ✅ Yes | ⚠️ **Deprecated** - Use query-quota instead | | Query Quota (query-quota) | ✅ Yes | ✅ Yes | Recommended replacement for get-quota | | List Quotas | ✅ Yes | ✅ Yes | Fully supported (both payasyougo and subscription) | | Delete Quota | ❌ No API | ❌ No API | **Not available via API** - Must use Console | | Modify Quota | ❌ Not in scope | ❌ Not in scope | Not covered in this solution |

> **Important**: > - **Create Subscription Quota** is **temporarily NOT supported** in this skill. For subscription quota creation, please use the [Alibaba Cloud Console](https://maxcompute.console.aliyun.com/). > - **Delete Quota** operation is NOT available through CLI or SDK. You must use the [Alibaba Cloud Console](https://maxcompute.console.aliyun.com/) to delete quotas. > - **query-quota is preferred** - get-quota is deprecated but acceptable if it returns success > - **⚠️ CRITICAL: When checking if quota exists, ALWAYS use list-quotas, NEVER use get-quota** > - **🚨 MANDATORY: Before create-quota, MUST call list-quotas first - NEVER skip this step**

Architecture

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

Installation

> **Pre-check: Aliyun CLI >= 3.3.3 required** > Run `aliyun version` to verify >= 3.3.3. If not installed or version too low, > run `curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash` to update, > or see [references/cli-installation-guide.md](references/cli-installation-guide.md) for installation instructions.

> **Pre-check: Aliyun CLI plugin setup required** > [MUST] Install the maxcompute plugin manually: `aliyun plugin install maxcompute` > [MUST] Update the plugin to latest version: `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

**[MUST] CLI User-Agent** — Every `aliyun` CLI command invocation must include: `--user-agent AlibabaCloud-Agent-Skills/alibabacloud-odps-quota-manage`

At the **start** of the Core Workflow (before any CLI invocation): **[MUST] Enable AI-Mode** — AI-mode is required for Agent Skill execution. Run the following commands before any CLI invocation:

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

**[MUST] Disable AI-Mode at EVERY exit point** — Before delivering the final response for ANY reason, always disable AI-mode first. This applies to ALL exit paths: workflow success, workflow failure, error/exception, user cancellation, session end, or any other scenario where no further CLI commands will be executed. AI-mode is only used for Agent Skill invocation scenarios and MUST NOT remain enabled after the skill stops running.

aliyun configure ai-mode disable

Environment Variables

This skill relies on the aliyun CLI default credential chain. No explicit credential configuration is needed.

• Run `aliyun configure` to set up credentials before first use
• Do NOT explicitly handle or pass credential values in commands

**Timeout Configuration:**

• `ALIBABA_CLOUD_CONNECT_TIMEOUT`: Connection timeout (default: 10s)
• `ALIBABA_CLOUD_READ_TIMEOUT`: Read timeout (default: 10s)
• These defaults are sufficient for quota operations; no explicit configuration required

Parameter Confirmation

> **IMPORTANT: Parameter Confirmation** — Before executing any command or API call, > ALL user-customizable parameters (e.g., RegionId, quota nicknames, billing types, etc.) > MUST be confirmed with the user. Do NOT assume or use default values without explicit user approval.

Input Validation

| Parameter | Validation Rules | |-----------|------------------| | `RegionId` | Must be valid Alibaba Cloud region ID (e.g., cn-hangzhou, cn-shanghai) | | `nickname` | Max 64 characters; alphanumeric, hyphens (-), underscores (_); URL-encode if contains Chinese characters | | `chargeType` | Must be `payasyougo` (subscription not supported) | | `commodityCode` | Must be `odps`, `odpsplus`, `odps_intl`, or `odpsplus_intl` | | `billingType` | Must be `payasyougo`, `subscription`, or `ALL` |

**Security Note:** All user inputs are passed to aliyun CLI which handles parameter sanitization. Do NOT construct commands using string concatenation with raw user input.

| Parameter Name | Required/Optional | Description | Default Value | |----------------|-------------------|--------------------------------------------------------------|---------------| | `RegionId` | Required | Alibaba Cloud region (e.g., cn-hangzhou, cn-shanghai) | - | | `chargeType` | Required | Billing type: `payasyougo` only (subscription not supported) | - | | `commodityCode` | Required | Product code (see table below) | - | | `billingType` | Optional