通过SDK操作ESA资源

注意事项

• 版本限制：Python 版本要求 Python3。

• 费用：运行示例代码可能对当前账号发起线上资源操作产生费用，请小心操作。

• 依赖关系：

  • 资源记录依赖于资源站点，因此在创建记录之前必须先成功创建站点。

  • 资源站点依赖于资源套餐，因此在创建站点之前需要先成功购买套餐。

• 异步操作：新购套餐、创建站点、创建记录、更新记录和删除记录均为异步操作，需等待其状态更新为指定状态后再进行下一步操作。

工作流程

1. 初始化客户端：要运行此示例，您必须首先配置您的凭证，如管理访问凭据中所述。创建一个客户端实例。

2. 新购套餐：调用PurchaseRatePlan接口购买一个新的资源套餐，并等待其状态变为running。调用时需传入 PlanName 参数指定套餐名称，可通过调用 DescribeRatePlanPrice 接口查询可用的套餐名称。中国站入门版套餐的 PlanName 为 entranceplan。

3. 创建站点：在成功购买套餐后，调用CreateSite接口创建一个新的站点，并等待其状态变为pending。

4. 创建DNS记录：在站点创建成功后，调用CreateRecord接口创建一条 CNAME 类型的 DNS 记录。该接口支持重试机制以处理服务繁忙的情况。调用时注意以下参数要求：

   • RecordName：必须传入完整域名（例如 www.example.com），而非仅主机记录前缀。控制台会自动拼接站点域名后缀，但 SDK 调用须手动传入完整域名。使用 @ 表示站点根域名。

   • Data（必填）：记录内容对象，不传会报 MissingData 错误。其中 Data.Value 为主要字段，A/AAAA 记录填 IP 地址，CNAME 记录填目标域名。

   • BizName（可选）：业务场景标识，有效值为 web、file、image_video、api、ai。传入无效值会报 InvalidParameter.InvalidBiz 错误。

   • SourceType（可选）：源站类型，仅 CNAME 记录适用，有效值为 Domain、OSS、S3、LB、OP。选择 OSS 或 S3 时需同时传入 AuthConf 参数。

5. 更新DNS记录：调用UpdateRecord接口更新已创建的DNS记录，直到更新成功。该接口也支持重试机制以处理服务繁忙的情况。更新时 Data 参数同样为必填，不传会报 MissingData 错误。

6. 删除DNS记录：调用DeleteRecord接口删除之前创建的DNS记录，直到删除成功，完成整个生命周期管理。该接口同样支持重试机制以处理服务繁忙的情况。