Alibabacloud Odps Project Manage

MaxCompute Project Management

Manage Alibaba Cloud MaxCompute (ODPS) Projects including creation, querying, and listing operations.

Prerequisites

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 for installation instructions. > > Then [MUST] run aliyun plugin update to ensure that any existing plugins on your local machine are always up-to-date.

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

[MUST] AI-Mode Commands — When using aliyun CLI, declare AI-Mode lifecycle: 1. Enable AI-Mode before commands:

   aliyun configure ai-mode enable
   

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

   aliyun configure ai-mode disable
   

Quick Start

When user asks about MaxCompute projects, follow these steps:

1. Identify intent: create / list / get 2. Get RegionId: Ask user which region (e.g., cn-hangzhou, cn-shanghai) 3. Execute: Run the appropriate command with --region {REGION_ID} and --user-agent AlibabaCloud-Agent-Skills/alibabacloud-odps-project-manage 4. Verify: Confirm the result and report to user

Pre-flight Checklist (Execute BEFORE every command)

You MUST verify ALL of these before running any command:

If ANY check fails, STOP and fix before proceeding.

Task Completion Checklist

CRITICAL: You MUST complete ALL steps in order. Do NOT stop early.

For LIST Projects:

   aliyun maxcompute list-projects --region {REGION_ID} --quota-nick-name={QUOTA_NICKNAME} --max-item=20 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-odps-project-manage
   

FORBIDDEN:

REQUIRED:

For GET Project:

For CREATE Project:

    aliyun maxcompute create-project --region {ACTUAL_REGION} --body '{"name":"ACTUAL_PROJECT_NAME","defaultQuota":"SECONDARY_QUOTA_NICKNAME","productType":"payasyougo","typeSystem":"TYPE_SYSTEM_VALUE"}' --user-agent AlibabaCloud-Agent-Skills/alibabacloud-odps-project-manage
    

    aliyun maxcompute create-project --region cn-hangzhou --body '{"name":"my-project-123","defaultQuota":"os_PayAsYouGoQuota_sub","productType":"payasyougo","typeSystem":"2"}' --user-agent AlibabaCloud-Agent-Skills/alibabacloud-odps-project-manage
    

If User Requests Deletion:

Common Errors & Solutions

| Error | Cause | Solution | |-------|-------|----------| | ProjectNotFound | Project doesn't exist | Check project name spelling and region | | ProjectAlreadyExist | Name taken | Ask user for a different project name | | get project default quota error | No valid quota | Run list-quotas first, ensure quota exists | | InvalidProjectName | Bad naming format | Use only lowercase, numbers, underscores (3-28 chars) | | NoPermission or 403 Access Denied | RAM permission issue | Inform user: "You need odps permissions for list-quotas, create-project and get-project. Please contact your administrator." | | RegionId required | Missing --region | Always add --region {REGION_ID} to commands | | ODPS-0420095: Access Denied | Missing read privilege | Inform user about required permissions and stop |

Forbidden Actions

> CRITICAL: Never do these: > 1. NEVER read/echo AK/SK values (e.g., echo $ALIBABA_CLOUD_ACCESS_KEY_ID) > 2. NEVER use hardcoded values — always ask user for parameters, then use their ACTUAL answer (not placeholder text) > 3. NEVER use aliyun configure set with literal credential values > 4. NEVER run aliyun ram commands > 5. NEVER execute ANY command without --user-agent AlibabaCloud-Agent-Skills/alibabacloud-odps-project-manage > 6. NEVER skip asking for RegionId — this is ALWAYS required > 7. NEVER assume a default region — always ask the user > 8. NEVER use uppercase API action format as CLI commands — ALWAYS use plugin format with lowercase and hyphens (e.g., create-project) > 9. NEVER execute aliyun maxcompute delete-project — project deletion is NOT supported by this skill

Negative Examples

| ❌ WRONG | ✅ CORRECT | |----------|------------| | Using uppercase API action names as CLI commands | aliyun maxcompute create-project (plugin format, lowercase with hyphens) | | '{"name":"{PROJECT_NAME}"}' (placeholder) | '{"name":"actual-name"}' (actual value) | | --region cn-hangzhou (hardcoded) | Ask user first, then use their answer | | Missing --user-agent | Must include --user-agent AlibabaCloud-Agent-Skills/alibabacloud-odps-project-manage | | echo $ALIBABA_CLOUD_ACCESS_KEY_ID | Never read/display credentials | | aliyun ram ... commands | RAM commands are outside scope | | aliyun maxcompute delete-project | Project deletion is NOT supported | | Verify different project on failure | Report failure, don't substitute |

Architecture

MaxCompute Service
    └── Project (Workspace)
          ├── defaultQuota (Compute Resource - MUST exist before project creation)
          ├── productType (payasyougo/subscription)
          └── typeSystem ("1", "2", or "hive"; default: "2")

Dependencies

> Prerequisite: Quota must exist before creating a project. > > Every MaxCompute project requires a compute quota (defaultQuota). The quota must already exist in your account — if it does not, the create-project call will fail with get project default quota error. > > Use the alibabacloud-odps-quota-manage skill to create or query quotas: > - Pay-as-you-go: aliyun maxcompute create-quota --charge-type payasyougo --commodity-code odps --region --user-agent AlibabaCloud-Agent-Skills/alibabacloud-odps-project-manage > - Subscription: See alibabacloud-odps-quota-manage skill for full parameters (partNickName, CU, ord_time, etc.) > - List existing quotas: aliyun maxcompute list-quotas --billing-type ALL --region --user-agent AlibabaCloud-Agent-Skills/alibabacloud-odps-project-manage > > After creating or confirming a quota exists, use its nickName as the defaultQuota parameter when creating a project.

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 for installation instructions.

Pre-check: Aliyun CLI plugin update required > [MUST] run aliyun configure set --auto-plugin-install true to enable automatic plugin installation. > [MUST] run aliyun plugin update to ensure that any existing plugins are always up-to-date.

# Install/Update Alibaba Cloud CLI
curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash
Verify version (must be >= 3.3.3)
aliyun version
Enable auto plugin installation
aliyun configure set --auto-plugin-install true
Update plugins
aliyun plugin update

Environment Variables

No additional environment variables required beyond standard Alibaba Cloud credentials.

Authentication

CRITICAL: You MUST check credentials before ANY operation.

Allowed Credential Check (ONLY this command):

aliyun configure list

What to look for:

If NO valid profile:

FORBIDDEN - NEVER do these:

RAM Policy

> [MUST] RAM Permission Pre-check: Before executing the workflow, verify that the current user has the required permissions. > > Required permissions are listed in references/ram-policies.md. > > Note: You do NOT need to verify RAM permissions via CLI commands. The permissions listed in ram-policies.md are for user reference only. Proceed with the workflow assuming the user has configured appropriate permissions.

Parameters

Always ask user for these values — never assume defaults:

| Parameter | Required | Description | |-----------|----------|-------------| | RegionId | Yes | Region ID (cn-hangzhou, cn-shanghai, etc.) | | projectName | Yes | Project name | | quotaNickName | For create | Quota alias (get from list-quotas) |

Example Conversation

LIST: User asks → Agent requests RegionId → Agent executes list-projects → Agent presents results

CREATE: User asks → Agent requests RegionId → Agent requests projectName → Agent calls list-quotas → Agent creates project → Agent verifies → Agent confirms success

Commands

List Projects

# Ask user for quota nickname first, then:
aliyun maxcompute list-projects --region {REGION_ID} --quota-nick-name={QUOTA_NICKNAME} --max-item=20 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-odps-project-manage

Get Project

aliyun maxcompute get-project --region {REGION_ID} --project-name {PROJECT_NAME} --user-agent AlibabaCloud-Agent-Skills/alibabacloud-odps-project-manage

Create Project

1. List quotas first:

aliyun maxcompute list-quotas --billing-type ALL --region {REGION_ID} --user-agent AlibabaCloud-Agent-Skills/alibabacloud-odps-project-manage

2. Create with quota nickName from response:

aliyun maxcompute create-project --region {REGION_ID} --body '{"name":"{PROJECT_NAME}","defaultQuota":"{QUOTA_NICKNAME}","productType":"payasyougo"}' --user-agent AlibabaCloud-Agent-Skills/alibabacloud-odps-project-manage

Success Verification Method

See references/verification-method.md for detailed verification steps.

Verification Command:

aliyun maxcompute get-project --region {REGION_ID} --project-name {PROJECT_NAME} --user-agent AlibabaCloud-Agent-Skills/alibabacloud-odps-project-manage

Success Criteria:

If verification fails: 1. Check error message for specific issue 2. Report failure reason to user 3. Suggest corrective action based on error type

Limitations

The following operations cannot be performed via CLI/API and require Console access:

| Operation | Reason | Alternative | |-----------|--------|-------------| | View billing details | Requires Console access | Use Billing Console | | Manage IAM policies visually | Console-only feature | Use RAM CLI for policy management | | Real-time resource monitoring | Requires Console dashboard | Use CloudMonitor APIs |

API and Command Tables

See references/related-apis.md for complete API reference.

| Operation | CLI Command (plugin mode) | API Action Name | |-----------|-------------|------------| | Create Project | aliyun maxcompute create-project | create-project | | Get Project | aliyun maxcompute get-project | get-project | | List Projects | aliyun maxcompute list-projects | list-projects | | List Quotas | aliyun maxcompute list-quotas | list-quotas |

Skill Completion Criteria (REQUIRED for skill_pass)

For skill_pass_rate to be successful, ALL of these MUST be true:

Universal Requirements (ALL operations):

Operation-Specific Requirements:

LIST:

GET:

CREATE:

Final Skill Pass Check:

Before responding to user, verify:
□ I followed the correct workflow for the operation type
□ I asked for ALL required parameters from user
□ I used user's actual values in commands (not placeholders or defaults)
□ I included --user-agent AlibabaCloud-Agent-Skills/alibabacloud-odps-project-manage in EVERY command
□ I did NOT perform any forbidden actions
□ I reported the final result to user
If ALL checks pass → Skill execution is SUCCESSFUL
If ANY check fails → Skill execution is INCOMPLETE

Final Verification (Before Marking Task Complete)

You MUST verify ALL of these before telling user the task is done:

For LIST:

For GET:

For CREATE:

For DELETE:

If ANY check fails, the task is NOT complete.

Best Practices

1. Naming Convention: Use lowercase letters, numbers, and underscores for project names 2. Quota Selection: Choose appropriate quota based on workload requirements 3. Product Type: Use payasyougo for development/testing, subscription for production with predictable workloads 4. Type System: Use 2 (MaxCompute) for new projects unless Hive compatibility is required 5. Resource Cleanup: Always clean up test projects to avoid unnecessary costs

Reference Links

| Document | Description | |----------|-------------| | references/related-apis.md | Complete API reference | | references/ram-policies.md | Required RAM permissions | | references/verification-method.md | Verification steps | | references/cli-installation-guide.md | CLI installation guide | | MaxCompute Product Page | Official product documentation | | create-project API | API reference | | get-project API | API reference | | list-projects API | API reference |

When user asks about MaxCompute projects, follow these steps:

1. Identify intent: create / list / get 2. Get RegionId: Ask user which region (e.g., cn-hangzhou, cn-shanghai) 3. Execute: Run the appropriate command with --region {REGION_ID} and --user-agent AlibabaCloud-Agent-Skills/alibabacloud-odps-project-manage 4. Verify: Confirm the result and report to user

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 for installation instructions. > > Then [MUST] run aliyun plugin update to ensure that any existing plugins on your local machine are always up-to-date.

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

[MUST] AI-Mode Commands — When using aliyun CLI, declare AI-Mode lifecycle: 1. Enable AI-Mode before commands:

   aliyun configure ai-mode enable
   

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

   aliyun configure ai-mode disable
   

1. Naming Convention: Use lowercase letters, numbers, and underscores for project names 2. Quota Selection: Choose appropriate quota based on workload requirements 3. Product Type: Use payasyougo for development/testing, subscription for production with predictable workloads 4. Type System: Use 2 (MaxCompute) for new projects unless Hive compatibility is required 5. Resource Cleanup: Always clean up test projects to avoid unnecessary costs