/alibabacloud-polardbx-ops

name: alibabacloud-polardbx-ops
description: |
  Manage Alibaba Cloud PolarDB-X instance lifecycle and routine operations via the Aliyun CLI.
  Use when the user asks to create, delete, restart, scale, modify, monitor, or inspect PolarDB-X instances.
  Triggers: "polardb-x", "polardbx", "create polardb-x", "delete polardb-x", "restart polardb-x",
  "scale polardb-x", "upgrade polardb-x", "describe polardb-x", "polardb-x instance",
  "polardb-x parameters", "polardb-x slow log", "polardb-x performance", "polardb-x binlog"

PolarDB-X Instance Management

Manage Alibaba Cloud PolarDB-X instances through the `aliyun polardbx` CLI: instance lifecycle, scaling, parameter management, monitoring, and logs.

This skill uses **intent routing**: identify the user's intent, run pre-flight checks, then load the relevant module reference document fully before generating any CLI command.

---

Architecture

Alibaba Cloud PolarDB-X Instance Management
├── Instance Lifecycle    --> references/instance-lifecycle.md
│   ├── CreateDBInstance
│   ├── DeleteDBInstance
│   ├── RestartDBInstance
│   ├── DescribeDBInstanceAttribute
│   ├── DescribeDBInstances
│   ├── DescribeDBInstanceTopology
│   ├── DescribeTasks
│   ├── ModifyDBInstanceDescription
│   ├── ModifyDBInstanceMaintainTime
│   └── UpgradeDBInstanceKernelVersion
├── Scaling               --> references/scaling.md
│   ├── UpdatePolarDBXInstanceNode
│   ├── ModifyDBInstanceClass
│   └── DescribeScaleOutMigrateTaskList
├── Parameters            --> references/parameters.md
│   ├── DescribeDBInstanceConfig
│   ├── ModifyDBInstanceConfig
│   ├── DescribeParameters
│   ├── ModifyParameter
│   └── DescribeParameterTemplates
├── Instance Specs        --> scripts/spec_lookup.sh (spec code <-> cores/memory)
│   ├── Enterprise CN (CnClass)
│   ├── Enterprise DN (DnClass)
│   ├── Standard DBNodeClass
│   └── Naming Rules
└── Monitoring & Logs     --> references/monitoring-logs.md
    ├── DescribeDBNodePerformance
    ├── DescribeSlowLogRecords
    └── DescribeBinaryLogList

Extended Modules

The following modules cover the full PolarDB-X (2020-02-02) API surface. See each reference file for the complete API spec.

├── Account Management      --> references/account-management.md
├── Database Management     --> references/database-management.md
├── Backup & Restore        --> references/backup-restore.md
├── Security & Access        --> references/security-access.md
├── SQL Audit & Compliance   --> references/sql-audit-compliance.md
├── Operation Tasks & Events --> references/operation-tasks.md
├── HA & Migration           --> references/ha-migration.md
├── Connection & Endpoint    --> references/connection-endpoint.md
├── Tags & Resource Group    --> references/tags-resourcegroup.md
├── Metadata & Query         --> references/metadata-query.md
├── Cold Storage             --> references/cold-storage.md
├── Data Evaluate & Migration--> references/data-evaluate-migration.md
├── SQL Flashback            --> references/sql-flashback.md
├── CDC (Log Engine)         --> references/cdc.md
├── Columnar                 --> references/columnar.md
├── GDN                      --> references/gdn.md
└── Mem0                     --> references/mem0.md

---

Requirement Analysis

Before routing, analyze the user request:

1. Identify intent: create / delete / restart / describe / list / scale / modify parameters / view monitoring / view logs. 2. Extract required parameters: `RegionId`, instance identifier (`DBInstanceName` or `DBInstanceId`), `EngineVersion`, `DBInstanceClass`, node counts, time ranges, etc. 3. If any required parameter is missing, ask the user. Do NOT guess values or APIs. 4. After intent and parameters are clear, load the matched reference document **fully**, then construct the CLI command.

---

Pre-flight Checks

Run these checks at the start of every skill invocation. Only load the referenced document if a check fails. If step 1/2/3/5 fails, read [references/cli-installation-guide.md](references/cli-installation-guide.md); if step 4 fails, read [references/ram-policies.md](references/ram-policies.md).

1. aliyun CLI version

aliyun --version

**Success:** Output contains `Alibaba Cloud Command Line Interface Version` and the version is >= `3.3.3`.

**Failure:** Read [references/cli-installation-guide.md](references/cli-installation-guide.md) section 1.

2. aliyun CLI plugin and configuration

aliyun configure set --auto-plugin-install true
aliyun plugin update
aliyun configure list

**Success:** `aliyun configure list` shows at least one valid profile (AK, STS, or OAuth identity).

**Failure:** Read [references/cli-installation-guide.md](references/cli-installation-guide.md) sections 2 and 3.

3. Caller identity

aliyun sts get-caller-identity

**Success:** Returns JSON with `AccountId`, `UserId`, and `Arn`.

**Failure:** Read [references/cli-installation-guide.md](references/cli-installation-guide.md) section 4.

4. RAM permissions

aliyun polardbx describe-db-instances --biz-region-id <RegionId> --region <RegionId> --user-agent AlibabaCloud-Agent-Skills/alibabacloud-polardbx-ops/{session-id}

**Success:** Returns an instance list or empty list without permission errors.

**Failure:** Read [references/ram-policies.md](references/ram-policies.md).

5. jq availability

jq --version

**Success:** Output contains a version string such as `jq-1.7.1`.

**Failure:** Read [references/cli-installation-guide.md](references/cli-installation-guide.md) section 5.

---

Observability (MUST follow for every aliyun command)

Upon loading this skill, generate a random session ID (32-char lowercase hex string) once for the entire session. Use it as `{session-id}` below.

**Rule: Every `aliyun` CLI command that calls a cloud API MUST include the `--user-agent` flag.** Local utility commands (e.g. `configure`, `plugin`, `version`) do not support this fla