$npx -y skills add cinience/alicloud-skills --skill aliyun-bdrc-backupUse when managing Alibaba Cloud Backup and Disaster Recovery Center (BDRC) via OpenAPI/SDK, including the user needs backup/disaster-recovery resource operations, including inventory, policy/configuration changes, status checks, and troubleshooting BDRC workflows.
| 1 | Category: service |
| 2 | |
| 3 | # Backup and Disaster Recovery Center |
| 4 | |
| 5 | Use Alibaba Cloud OpenAPI (RPC) with official SDKs or OpenAPI Explorer to manage resources for Backup and Disaster Recovery Center. |
| 6 | |
| 7 | ## Workflow |
| 8 | |
| 9 | 1) Confirm region, resource identifiers, and desired action. |
| 10 | 2) Discover API list and required parameters (see references). |
| 11 | 3) Call API with SDK or OpenAPI Explorer. |
| 12 | 4) Verify results with describe/list APIs. |
| 13 | |
| 14 | ## AccessKey priority (must follow) |
| 15 | |
| 16 | 1) Environment variables: `ALIBABACLOUD_ACCESS_KEY_ID` / `ALIBABACLOUD_ACCESS_KEY_SECRET` / `ALIBABACLOUD_REGION_ID` |
| 17 | Region policy: `ALIBABACLOUD_REGION_ID` is an optional default. If unset, decide the most reasonable region for the task; if unclear, ask the user. |
| 18 | 2) Shared config file: `~/.alibabacloud/credentials` |
| 19 | |
| 20 | ## API discovery |
| 21 | |
| 22 | - Product code: `BDRC` |
| 23 | - Default API version: `2023-08-08` |
| 24 | - Use OpenAPI metadata endpoints to list APIs and get schemas (see references). |
| 25 | |
| 26 | ## High-frequency operation patterns |
| 27 | |
| 28 | 1) Inventory/list: prefer `List*` / `Describe*` APIs to get current resources. |
| 29 | 2) Change/configure: prefer `Create*` / `Update*` / `Modify*` / `Set*` APIs for mutations. |
| 30 | 3) Status/troubleshoot: prefer `Get*` / `Query*` / `Describe*Status` APIs for diagnosis. |
| 31 | |
| 32 | ## Minimal executable quickstart |
| 33 | |
| 34 | Use metadata-first discovery before calling business APIs: |
| 35 | |
| 36 | ```bash |
| 37 | python scripts/list_openapi_meta_apis.py |
| 38 | ``` |
| 39 | |
| 40 | Optional overrides: |
| 41 | |
| 42 | ```bash |
| 43 | python scripts/list_openapi_meta_apis.py --product-code <ProductCode> --version <Version> |
| 44 | ``` |
| 45 | |
| 46 | The script writes API inventory artifacts under the skill output directory. |
| 47 | |
| 48 | ## Output policy |
| 49 | |
| 50 | If you need to save responses or generated artifacts, write them under: |
| 51 | `output/aliyun-bdrc-backup/` |
| 52 | |
| 53 | ## Validation |
| 54 | |
| 55 | ```bash |
| 56 | mkdir -p output/aliyun-bdrc-backup |
| 57 | for f in skills/backup/aliyun-bdrc-backup/scripts/*.py; do |
| 58 | python3 -m py_compile "$f" |
| 59 | done |
| 60 | echo "py_compile_ok" > output/aliyun-bdrc-backup/validate.txt |
| 61 | ``` |
| 62 | |
| 63 | Pass criteria: command exits 0 and `output/aliyun-bdrc-backup/validate.txt` is generated. |
| 64 | |
| 65 | ## Output And Evidence |
| 66 | |
| 67 | - Save artifacts, command outputs, and API response summaries under `output/aliyun-bdrc-backup/`. |
| 68 | - Include key parameters (region/resource id/time range) in evidence files for reproducibility. |
| 69 | |
| 70 | ## Prerequisites |
| 71 | |
| 72 | - Configure least-privilege Alibaba Cloud credentials before execution. |
| 73 | - Prefer environment variables: `ALIBABACLOUD_ACCESS_KEY_ID`, `ALIBABACLOUD_ACCESS_KEY_SECRET`, optional `ALIBABACLOUD_REGION_ID`. |
| 74 | - If region is unclear, ask the user before running mutating operations. |
| 75 | |
| 76 | ## References |
| 77 | |
| 78 | - Sources: `references/sources.md` |