云解析怎么发起找回域名
描述
根据传入参数发送验证邮件到用户的whois邮箱。点击whois邮箱中的验证链接，会跳转到阿里云解析的管理平台。
请求参数
| 名称 | 类型 | 是否必须 | 描述 |
| Action | String | 是 | 操作接口名，系统规定参数，取值：RetrievalDomainName |
| DomainName | String | 是 | 域名名称 |
返回参数
公共返回参数，详见 公共返回参数
| 名称 | 类型 | 描述 |
| RequestId | String | 唯一请求识别码 |
| DomainName | String | 域名名称 |
| WhoisEmail | String | 接收验证码的whois邮箱 |
错误码
对于所有接口的通用性错误，请参考 错误代码表。
| 错误代码 | 描述 | HTTP 状态码 | 语义 |
| InvalidDomainName.Format | The format of domain is error. | 400 | 域名格式错误 |
| InvalidDomainName.Suffix | The domain suffix isnot been supported. | 400 | 不支持的域名后缀 |
| InvalidDomainName.Unregistered | The domain name is not registered. | 400 | 未注册的域名 |
| InvalidDomainName.Duplicate | The domain name is duplicated in this user’s domain list. | 400 | 本用户下已存在的域名 |
| CHNDomainInfoNotMatch | The information of chinese domain does not match with CNNIC. | 400 | 中文域名与注册局返回信息不匹配(见注释) |
| UnabletoGetWoisInfo | The domain is unable to get information from whois system. | 400 | 获取不到Whois信息 |
| InvalidDomainName.NoExist | The domain is not exist in Alibaba Cloud DNS system. | 400 | 域名在云解析系统中不存在 |
| UnableToGetWhoisEmail | The domain is unable to get whois email. | 400 | Whois邮箱未获取到 |
| Forbidden.DomainType | TThe domain is forbidden to operate because it is a hichina domain. | 400 | 万网域名不允许找回 |
| Forbidden.TooOfen | The operation is too ofen in 90 seconds. | 400 | 90秒内不允许重复找回 |
| Forbidden.ProtectedDomain | The domain is forbidden to operation because this is a protected domain in white list. | 400 | 找回白名单域名不允许找回 |
示例
请求示例
- [backcolor=transparent]http[backcolor=transparent]:[backcolor=transparent]//alidns.aliyuncs.com/?Action=RetrievalDomainName
- [backcolor=transparent]&[backcolor=transparent]DomainName[backcolor=transparent]=[backcolor=transparent]example[backcolor=transparent].[backcolor=transparent]com
- [backcolor=transparent]&<公共请求参数>
返回示例
XML格式
- [backcolor=transparent]<RetrievalDomainNameResponse>
- [backcolor=transparent] [backcolor=transparent]<RequestId>[backcolor=transparent]536E9CAD-DB30-4647-AC87-AA5CC38C5382[backcolor=transparent]</RequestId>
- [backcolor=transparent] [backcolor=transparent]<DomainName>[backcolor=transparent]example.com[backcolor=transparent]</DomainName>
- [backcolor=transparent] [backcolor=transparent]<WhoisEmail>[backcolor=transparent]webmaster@gmail.com[backcolor=transparent]</WhoisEmail>
- [backcolor=transparent]</RetrievalDomainNameResponse>
JSON示例
- [backcolor=transparent]{
- [backcolor=transparent] [backcolor=transparent]"RequestId"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"536E9CAD-DB30-4647-AC87-AA5CC38C5382"[backcolor=transparent],
- [backcolor=transparent] [backcolor=transparent]"DomainName"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"example.com"[backcolor=transparent],
- [backcolor=transparent] [backcolor=transparent]"WhoisEmail"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"webmaster@gmail.com"
- [backcolor=transparent]}
展开
收起
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
阿里云 AI 助理回答
您描述的是一个使用阿里云DNS服务中与找回域名相关的API操作流程。这个过程涉及发送验证邮件到注册域名时填写的WHOIS邮箱，以验证用户对某个域名的所有权，进而进行相关管理操作。下面是对这一流程的详细解析：
请求目的
- 主要功能：通过调用阿里云DNS API中的
RetrievalDomainName接口，实现向域名WHOIS信息中记录的邮箱发送验证邮件。 - 应用场景：当用户需要验证自己对某个域名的所有权，以便在阿里云解析平台上进行域名管理、找回或转移等操作时，会用到此功能。
请求参数说明
- Action: 必须参数，固定值为
RetrievalDomainName，表示执行找回域名的操作。 - DomainName: 必须参数，指需要找回的域名名称。
返回参数说明
- RequestId: 每次请求的唯一标识。
- DomainName: 域名名称，即请求中提交的域名。
- WhoisEmail: 接收验证码的WHOIS邮箱地址。
错误码说明
列举了一些可能遇到的错误情况及其对应的HTTP状态码和简要描述，例如： - InvalidDomainName.Format: 表示输入的域名格式不正确。 - InvalidDomainName.Suffix: 输入的域名后缀不受支持。 - UnabletoGetWhoisInfo: 无法从WHOIS系统获取该域名信息。 - 等等，这些错误码帮助开发者理解请求失败的原因并进行相应的调试。
示例请求
提供的示例请求URL展示了如何构造请求来调用此接口，但请注意，实际请求中还需包含阿里云要求的鉴权信息（如AccessKeyId、Signature等），这些通常通过HTTP头或者查询字符串附加到请求中，确保请求的安全性和有效性。
注意事项
- 在发起请求前，请确保已阅读并理解阿里云API文档中关于签名认证、请求频率限制等相关规定。
- 对于中文域名，需特别注意信息匹配问题，避免因信息不一致导致操作失败。
- 考虑到安全性，频繁的操作尝试可能会触发限制，如
Forbidden.TooOfen错误提示90秒内不允许重复操作。
总之，通过遵循阿里云API指南，您可以有效地利用RetrievalDomainName接口完成域名找回的验证流程，确保域名管理权限的合法性与安全性。
有帮助
无帮助
AI 助理回答生成答案可能存在不准确，仅供参考
相关问答