Skip to content

Commit 16d6dbc

Browse files
franklwyfranklwy
authored
Create readme_dns.md
1 parent fd6807e commit 16d6dbc

File tree

1 file changed

+97
-0
lines changed

1 file changed

+97
-0
lines changed

‎readme_dns.md

+97
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,97 @@
1+
# 华为云DNS服务适配Cloud Custodian文档
2+
3+
## 1. 华为云DNS资源类型
4+
5+
华为云DNS服务主要涉及以下资源类型，对应AWS Route53的相关资源：
6+
7+
- `huaweicloud.dns-publiczone`: 公网DNS托管区域。对应AWS的`aws.hostedzone`公共区域。
8+
- `huaweicloud.dns-privatezone`: 内网DNS托管区域。对应AWS的`aws.hostedzone`私有区域。
9+
- `huaweicloud.dns-recordset`: DNS记录集。对应AWS的`aws.rrset`。
10+
11+
## 2. 通用Filters (适用于所有DNS资源)
12+
13+
| Filter | 说明 | 是否可复用 | 开发状态 | 华为云API链接 | 涉及其他服务 |
14+
| :----------------- | :------------------------- | :-------------------- |:-----| :------------------------------------------------------------------------------------------- | :------------------------------------------- |
15+
| value | 基于资源属性值的通用过滤器 | 可复用 | 已复用 | 不适用 | 无 |
16+
| list-item | 列表元素过滤器 | 可复用 | 已复用 | 不适用 | 无 |
17+
| event | 事件过滤器 | 可复用 | 已复用 | 不适用 | LTS (日志流服务) / CTS (云审计服务) |
18+
| reduce | 聚合过滤器 | 可复用 | 已复用 | 不适用 | 无 |
19+
| marked-for-op | 标记操作过滤器 | 可复用 | 已复用 | 不适用 | 无 |
20+
| tag-count | 标签数量过滤器 | 可复用 | 已复用 | 不适用 | 无 |
21+
| tms | 标签过滤器 | 可复用 `tms.py` | 已复用 | [查询指定实例的标签信息](https://support.huaweicloud.com/api-dns/ShowResourceTag.html) | TMS (标签管理服务) |
22+
| finding | 安全发现过滤器 | 需要适配 | 不开发 | 不适用 | AWR (应用风险感知) / Config (配置审计服务) |
23+
| ops-item | 运维项过滤器 | 需要适配 | 不开发 | 不适用 | O&M (运维管理) |
24+
| config-compliance | 配置合规性过滤器 | 需要适配 | 不开发 | 不适用 | Config (配置审计服务) |
25+
26+
## 3. DNS PublicZone特定Filters (`huaweicloud.dns-publiczone`)
27+
28+
| Filter | 说明 | 是否可复用 | 开发状态 | 华为云API链接 | 涉及其他服务 |
29+
| :----- |:-------------------------------| :--------- | :--------- | :-------------------------------------------------------------------------------------- | :----------- |
30+
31+
## 4. DNS PrivateZone特定Filters (`huaweicloud.dns-privatezone`)
32+
33+
| Filter | 说明 | 是否可复用 | 开发状态 | 华为云API链接 | 涉及其他服务 |
34+
|:---------------|:-------------------------------| :--------- | :--------- |:--------------------------------------------------------------------------------------------------------|:------|
35+
| vpc-associated | 关联VPC过滤器 | 需要开发 | 已完成 | [查询内网Zone列表](https://support.huaweicloud.com/api-dns/dns_api_63006.html) | VPC (虚拟私有云) |
36+
37+
## 5. DNS RecordSet特定Filters (`huaweicloud.dns-recordset`)
38+
39+
| Filter | 说明 | 是否可复用 | 开发状态 | 华为云API链接 | 涉及其他服务 |
40+
| :---------- | :-------------------------------------- | :--------- | :--------- | :------------------------------------------------------------------------------------------------ | :----------- |
41+
| record-type | 记录类型过滤器 (A, CNAME, MX等) | 需要开发 | 已完成 | [查询租户Record Set资源列表](https://support.huaweicloud.com/api-dns/dns_api_64003.html) | 无 |
42+
| zone-id | 所属Zone ID过滤器 | 需要开发 | 已完成 | [查询租户Record Set资源列表](https://support.huaweicloud.com/api-dns/dns_api_64003.html) | 无 |
43+
| line-id | 线路ID过滤器 (用于区分智能解析线路) | 需要开发 | 已完成 | [查询租户Record Set资源列表](https://support.huaweicloud.com/api-dns/dns_api_64003.html) | 无 |
44+
45+
## 6. 通用Actions (适用于所有DNS资源)
46+
47+
| Action | 说明 | 是否可复用 | 开发状态 | 华为云API链接 | 涉及其他服务 |
48+
| :--------------- | :------------------ | :-------------------- |:-----| :------------------------------------------------------------------------------------------------ | :------------------------------------------------------------ |
49+
| tag | 添加标签 | 可复用 `tms.py` | 已复用 | [为指定实例添加标签](https://support.huaweicloud.com/api-dns/CreateTag.html) | TMS |
50+
| remove-tag | 删除标签 | 可复用 `tms.py` | 已复用 | [删除资源标签](https://support.huaweicloud.com/api-dns/DeleteTag.html) | TMS |
51+
| rename-tag | 重命名标签键 | 需要适配 (基于删+添) | 需要开发 | [为指定实例批量添加或删除标签](https://support.huaweicloud.com/api-dns/BatchCreateTag.html) | TMS |
52+
| mark-for-op | 标记待操作 | 可复用 | 已复用 | 不适用 | 无 |
53+
| auto-tag-user | 自动标记创建者 | 可复用 `autotag.py` | 已复用 | [为指定实例添加标签](https://support.huaweicloud.com/api-dns/CreateTag.html) | TMS, IAM |
54+
| copy-related-tag | 复制相关标签 | 需要适配 | 不开发 | [为指定实例批量添加或删除标签](https://support.huaweicloud.com/api-dns/BatchCreateTag.html) | TMS |
55+
| notify | 发送通知 | 可复用 | 不开发 | 不适用 | SMN (消息通知服务) / 第三方通知渠道 |
56+
| webhook | 调用Webhook | 可复用 | 不开发 | 不适用 | 无 |
57+
| put-metric | 发布监控指标 | 需要适配 | 不开发 | 不适用 | CES (云监控服务) |
58+
| invoke-lambda | 调用函数 | 需要适配 | 不开发 | 不适用 | FunctionGraph (函数工作流) |
59+
| invoke-sfn | 调用状态机 | 需要适配 | 不开发 | 不适用 | FunctionGraph (函数工作流) / DMS (分布式消息服务) |
60+
| post-finding | 推送安全发现 | 需要适配 | 不开发 | 不适用 | AWR / Config |
61+
| post-item | 推送运维项 | 需要适配 | 不开发 | 不适用 | O&M |
62+
63+
## 7. DNS PublicZone特定Actions (`huaweicloud.dns-publiczone`)
64+
65+
| Action | 说明 | 是否可复用 | 开发状态 | 华为云API链接 | 涉及其他服务 |
66+
| :--------- |:---------| :--------- | :--------- | :------------------------------------------------------------------------------------------- | :----------- |
67+
| delete | 删除公网域名 | 需要开发 | 已完成 | [删除单个公网Zone](https://support.huaweicloud.com/api-dns/dns_api_62005.html) | 无 |
68+
| update | 更新公网域名属性 | 需要开发 | 已完成 | [修改单个公网Zone](https://support.huaweicloud.com/api-dns/UpdatePublicZone.html) | 无 |
69+
| set-status | 设置公网域名状态 | 需要开发 | 已完成 | [设置单个公网Zone状态](https://support.huaweicloud.com/api-dns/UpdatePublicZoneStatus.html), [批量设置Zone状态](https://support.huaweicloud.com/api-dns/BatchSetZonesStatus.html) | 无 |
70+
71+
## 8. DNS PrivateZone特定Actions (`huaweicloud.dns-privatezone`)
72+
73+
| Action | 说明 | 是否可复用 | 开发状态 | 华为云API链接 | 涉及其他服务 |
74+
| :--------------- | :---------------------- | :--------- | :--------- | :-------------------------------------------------------------------------------------------- | :----------- |
75+
| delete | 删除内网区域 | 需要开发 | 已完成 | [删除单个内网Zone](https://support.huaweicloud.com/api-dns/dns_api_63008.html) | 无 |
76+
| update | 更新内网区域属性 | 需要开发 | 已完成 | [修改单个内网Zone](https://support.huaweicloud.com/api-dns/UpdatePrivateZone.html) | 无 |
77+
| associate-vpc | 关联VPC | 需要开发 | 已完成 | [在内网Zone上关联VPC](https://support.huaweicloud.com/api-dns/dns_api_63003.html) | VPC |
78+
| disassociate-vpc | 解关联VPC | 需要开发 | 已完成 | [在内网Zone上解关联VPC](https://support.huaweicloud.com/api-dns/dns_api_63004.html) | VPC |
79+
80+
## 9. DNS RecordSet特定Actions (`huaweicloud.dns-recordset`)
81+
82+
| Action | 说明 | 是否可复用 | 开发状态 | 华为云API链接 | 涉及其他服务 |
83+
| :--------- | :------------------------------- | :--------- | :--------- | :------------------------------------------------------------------------------------------------------------- | :----------- |
84+
| delete | 删除记录集 | 需要开发 | 已完成 | [删除单个Record Set](https://support.huaweicloud.com/api-dns/dns_api_64005.html), [批量删除Record Set](https://support.huaweicloud.com/api-dns/BatchDeleteRecordSets.html) | 无 |
85+
| update | 更新记录集 (如TTL、记录值) | 需要开发 | 已完成 | [修改单个Record Set](https://support.huaweicloud.com/api-dns/UpdateRecordSet.html), [批量修改RecordSet](https://support.huaweicloud.com/api-dns/BatchUpdateRecordSetWithLine.html) | 无 |
86+
| set-status | 设置状态 (启用/禁用) | 需要开发 | 已完成 | [设置Record Set状态](https://support.huaweicloud.com/api-dns/SetRecordSetsStatus.html), [批量设置Record Set状态](https://support.huaweicloud.com/api-dns/BatchSetRecordSetsStatus.html) | 无 |
87+
88+
## 11. 开发建议
89+
90+
1. **资源定义**: 分别创建三个主要资源类: `huaweicloud.dns-publiczone`, `huaweicloud.dns-privatezone`, `huaweicloud.dns-recordset`。由于公网Zone和内网Zone使用完全不同的API，应**分别实现**而非合并。
91+
2. **复用与适配**: 优先复用通用filters和actions（如`value`, `list-item`, `tms`等）。对于标签相关功能，可复用`tms.py`中的实现。对于自动标记功能，可复用`autotag.py`中的实现。需要适配的功能需根据华为云对应服务进行实现。
92+
3. **开发新功能**: 针对不同资源类型的特定操作和过滤条件，开发对应的filters和actions，调用相应的公网/内网Zone、RecordSet或PTR的华为云DNS SDK。
93+
4. **特别考虑**:
94+
* **批量操作**: 华为云DNS提供多种批量API，可提高操作效率，在实现相关Actions时应考虑使用。
95+
* **线路管理**: 华为云支持复杂的线路管理功能，RecordSet相关的filters和actions需要能处理线路ID (`line-id`)。
96+
* **公私网分离**: 严格区分公网Zone和内网Zone的API调用。
97+
5. **其他服务集成**: 明确各filters和actions依赖的华为云服务（VPC, EIP, TMS, CES, SMN, FunctionGraph, IAM, LTS, CTS, Config, AWR, O&M等），确保开发和使用时有正确的配置和权限。

0 commit comments

Comments
 (0)