---
Title: Manage instance
URL Source: https://company-skill.com/p/rds/rds-manage-instance
Language: en
Description: You want to create, configure, modify, restart, or delete an ApsaraDB RDS instance — including managing accounts, permissions, backups, and engine-specific settings like pg_hba.conf. Typical User…
---

# Manage instance

Part of **ApsaraDB RDS**. Route queries via `POST https://company-skill.com/api/route`.

## What You Want to Do

You want to create, configure, modify, restart, or delete an ApsaraDB RDS instance — including managing accounts, permissions, backups, and engine-specific settings like `pg_hba.conf`.

**Typical User Questions**:
- How do I create and configure an RDS instance?
- How to upgrade my RDS instance specs?
- Can I manage RDS instances via API?

## Decision Tree

Pick the best path for your situation:

- **If** you need to integrate database operations into CI/CD pipelines or scripts using programmatic calls → Use API (go to *rds/rds-instance*)
- **If** you are performing a one-time task (e.g., creating a single account) and prefer visual confirmation → Use (go to *rds/rds-instance*)
- **If** you require precise control over parameters like `PriorityId` (range 0–10000) in `ModifyPGHbaConfig` → Use API (go to *rds/rds-instance*)
- **Otherwise (default)** → — safest for beginners and occasional tasks with immediate visual feedback

## Path Comparison

| Path | Best For | Complexity | Code Required | Automation | Key Fact | Detail Skill |
|------|----------|------------|---------------|------------|----------|-------------|
| API | CI/CD | medium | Yes | Yes | Requires `Authorization: Bearer` with AccessKey ID/Secret | `rds/api/rds-instance` |
| Console / Dashboard | low | No | No | Uses Console SSO for authentication | `rds/guide/rds-instance` |

## Path Details

### Path 1: API

**Best For**: CI/CD

**Brief Description**: ApsaraDB RDS API RESTful Key operations include `DescribeDBInstances`, `CreateAccount`, `GrantAccountPrivilege`, `RevokeAccountPrivilege`, `CreateBackup`, `ModifyBackupPolicy`, and `ModifyPGHbaConfig`. Authentication uses `Authorization: Bearer $ACCESS_TOKEN` derived from AccessKey ID and Secret.

**Key technical facts**:
- Auth method: Header: Authorization: Bearer $ACCESS_TOKEN

- pg_hba.conf PriorityId 0-10000

- SDK aliyun-sdk>=4.0.0

### Path 2: Console / Dashboard
**Brief Description**: ApsaraDB RDS Navigate via paths like `Console > RDS > Instances > Manage Instance`, `RDS > Instances > Manage Permissions`, `RDS > Instances > Backup & Restore`, and `RDS > Instances > Modify pg_hba.conf`. Authentication uses Console SSO.

**Key technical facts**:
- Auth method: Console SSO

- 'RDS > Instances > Backup & Restore'

- API pg_hba.conf 

## FAQ

Q: Which path should I start with?
A: Start with if you're performing a one-time task or are new to RDS. Switch to API only when you need automation, bulk operations, or fine-grained control over parameters like those in `ModifyPGHbaConfig`.

Q: What if I need to manage 50 RDS instances but used ?
A: You’ll face severe inefficiency — each action must be repeated manually per instance, with no way to script or parallelize. The console lacks batch capabilities, making large-scale management impractical.

Q: What if I’m unfamiliar with programming but chose API?
A: You’ll struggle with authentication (`Authorization: Bearer` using AccessKey), error codes (400/403/500), and SDK setup (`aliyun-sdk>=4.0.0`). Without retry logic or parameter validation, calls may fail silently or violate constraints like password policies.

Q: Can I modify `pg_hba.conf` fully via the console?
A: Only basic edits are supported in `RDS > Instances > Modify pg_hba.conf`. For full control (e.g., setting `PriorityId` in 0–10000 range), you must use the `ModifyPGHbaConfig` API.

Q: Does the API support querying existing accounts or instances?
A: Yes — use `DescribeDBInstances` to list instances and related metadata. This is essential for dynamic scripting but unavailable in the console as a programmatic query.

Q: Is there a rate limit I should worry about with the API?
A: Yes — for example, `RevokeAccountPrivilege` is limited to 100 QPS per account. Exceeding limits causes 429 errors, requiring backoff logic not needed in console use.

## Related queries

manage RDS instance, manage database instance, configure RDS, create RDS instance, modify RDS specs, upgrade RDS instance, restart RDS, delete RDS instance, automate RDS management, RDS API management, RDS console management, how to manage RDS, can I manage RDS via API, control RDS via console, RDS

---
Part of [ApsaraDB RDS](https://company-skill.com/p/rds.md) · https://company-skill.com/llms.txt