aliyun-bdrc-backup
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseCategory: service
分类:service
Backup and Disaster Recovery Center
备份与容灾中心
Use Alibaba Cloud OpenAPI (RPC) with official SDKs or OpenAPI Explorer to manage resources for Backup and Disaster Recovery Center.
通过阿里云OpenAPI(RPC)搭配官方SDK或OpenAPI Explorer来管理备份与容灾中心的资源。
Workflow
工作流
- Confirm region, resource identifiers, and desired action.
- Discover API list and required parameters (see references).
- Call API with SDK or OpenAPI Explorer.
- Verify results with describe/list APIs.
- 确认地域、资源标识符以及所需执行的操作。
- 查找API列表及所需参数(参考相关文档)。
- 通过SDK或OpenAPI Explorer调用API。
- 使用describe/list类API验证执行结果。
AccessKey priority (must follow)
AccessKey优先级(必须遵守)
- Environment variables: /
ALICLOUD_ACCESS_KEY_ID/ALICLOUD_ACCESS_KEY_SECRETRegion policy:ALICLOUD_REGION_IDis an optional default. If unset, decide the most reasonable region for the task; if unclear, ask the user.ALICLOUD_REGION_ID - Shared config file:
~/.alibabacloud/credentials
- 环境变量:/
ALICLOUD_ACCESS_KEY_ID/ALICLOUD_ACCESS_KEY_SECRET地域规则:ALICLOUD_REGION_ID为可选的默认配置。如果未设置,需为当前任务选择最合理的地域;如果无法确定,请询问用户。ALICLOUD_REGION_ID - 共享配置文件:
~/.alibabacloud/credentials
API discovery
API查找
- Product code:
BDRC - Default API version:
2023-08-08 - Use OpenAPI metadata endpoints to list APIs and get schemas (see references).
- 产品代码:
BDRC - 默认API版本:
2023-08-08 - 使用OpenAPI元数据端点列出API并获取 schema(参考相关文档)。
High-frequency operation patterns
高频操作模式
- Inventory/list: prefer /
List*APIs to get current resources.Describe* - Change/configure: prefer /
Create*/Update*/Modify*APIs for mutations.Set* - Status/troubleshoot: prefer /
Get*/Query*APIs for diagnosis.Describe*Status
- 清单/列表查询:优先使用/
List*类API获取当前资源信息。Describe* - 变更/配置:优先使用/
Create*/Update*/Modify*类API执行变更操作。Set* - 状态查询/故障排查:优先使用/
Get*/Query*类API进行诊断。Describe*Status
Minimal executable quickstart
最简可执行快速入门
Use metadata-first discovery before calling business APIs:
bash
python scripts/list_openapi_meta_apis.pyOptional overrides:
bash
python scripts/list_openapi_meta_apis.py --product-code <ProductCode> --version <Version>The script writes API inventory artifacts under the skill output directory.
调用业务API前优先使用元数据查找能力:
bash
python scripts/list_openapi_meta_apis.py可选覆盖参数:
bash
python scripts/list_openapi_meta_apis.py --product-code <ProductCode> --version <Version>该脚本会将API清单产物写入Skill输出目录下。
Output policy
输出策略
If you need to save responses or generated artifacts, write them under:
output/aliyun-bdrc-backup/如果需要保存响应或生成的产物,请写入以下路径:
output/aliyun-bdrc-backup/Validation
验证
bash
mkdir -p output/aliyun-bdrc-backup
for f in skills/backup/aliyun-bdrc-backup/scripts/*.py; do
python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/aliyun-bdrc-backup/validate.txtPass criteria: command exits 0 and is generated.
output/aliyun-bdrc-backup/validate.txtbash
mkdir -p output/aliyun-bdrc-backup
for f in skills/backup/aliyun-bdrc-backup/scripts/*.py; do
python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/aliyun-bdrc-backup/validate.txt通过标准:命令退出码为0且已生成。
output/aliyun-bdrc-backup/validate.txtOutput And Evidence
输出与凭证
- Save artifacts, command outputs, and API response summaries under .
output/aliyun-bdrc-backup/ - Include key parameters (region/resource id/time range) in evidence files for reproducibility.
- 将产物、命令输出和API响应摘要保存到目录下。
output/aliyun-bdrc-backup/ - 在凭证文件中包含关键参数(地域/资源ID/时间范围)以便复现操作。
Prerequisites
前置条件
- Configure least-privilege Alibaba Cloud credentials before execution.
- Prefer environment variables: ,
ALICLOUD_ACCESS_KEY_ID, optionalALICLOUD_ACCESS_KEY_SECRET.ALICLOUD_REGION_ID - If region is unclear, ask the user before running mutating operations.
- 执行前配置最小权限的阿里云凭证。
- 优先使用环境变量:、
ALICLOUD_ACCESS_KEY_ID,可选配置ALICLOUD_ACCESS_KEY_SECRET。ALICLOUD_REGION_ID - 如果地域不明确,执行变更操作前先询问用户。
References
参考
- Sources:
references/sources.md
- 来源:
references/sources.md