云解析怎么 获取主域名名称
描述
通过输入的参数，获取主域名名称。关于主域名和子域名级别见
域名级别。 如输入的为
www.abc.com，则输出abc.com。
请求参数
| 名称 | 类型 | 是否必须 | 描述 |
| Action | String | 是 | 操作接口名，系统规定参数，取值：GetMainDomainName |
| InputString | String | 是 | 字符串，最长不超过128个字符 |
返回参数
公共返回参数，详见 公共返回参数
| 名称 | 类型 | 描述 |
| RequestId | String | 唯一请求识别码 |
| DomainName | String | 域名名称 |
| RR | String | 主机记录信息 |
| DomainLevel | Long | 输入域名的级别 |
错误码
对于所有接口的通用性错误，请参考 错误代码表。
| 错误代码 | 描述 | HTTP 状态码 | 语义 |
| InvalidDomainName.Format | The format of domain is error. | 400 | 无效的域名格式 |
| QuotaExceeded.StringLength | You Can’t finish this operation because the input string length has been out of MAX count. | 400 | 字符长度超过限制 |
示例
请求示例
http://alidns.aliyuncs.com/?Action=GetMainDomainName&InputString=www.example.com&<公共请求参数>
返回示例
XML格式
<GetMainDomainNameResponse><RequestId>536E9CAD-DB30-4647-AC87-AA5CC38C5382</RequestId><DomainName>example.com</DomainName><RR>www</RR><DomainLevel>2</DomainLevel></GetMainDomainNameResponse>
JSON示例
{"RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382","DomainName": "example.com","RR": "www","DomainLevel": 2}
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
您提到的场景是关于使用阿里云DNS服务中的API来获取主域名名称。具体来说，您可以通过调用GetMainDomainName这个Action来实现这一需求。下面是对您描述内容的一个整理和补充说明：
API请求说明
-
Action: 必须参数，指定要执行的操作接口名。在这个场景中，应设置为
GetMainDomainName。 -
InputString: 必须参数，需要是一个字符串，最大长度不超过128个字符，用于输入您想要查询其主域名的完整域名（包括子域名）。例如，如果您输入
www.abc.com，API将返回abc.com作为主域名名称。
请求示例
http://alidns.aliyuncs.com/?Action=GetMainDomainName&InputString=www.abc.com
返回参数说明
-
RequestId: 每次API请求的唯一识别码，由系统自动生成并返回。
-
DomainName: 经过处理后得到的主域名名称。在上述示例中，如果输入为
www.abc.com，此字段将返回abc.com。 -
RR: 主机记录信息，在此操作中可能不适用或返回空值，因为主要关注点在于获取主域名。
-
DomainLevel: 输入域名的级别，即子域名的数量加1。例如，对于
www.abc.com，此值为3（.com为第一级，abc为第二级，www为第三级）。
错误码示例
-
InvalidDomainName.Format: 当输入的域名格式错误时触发，HTTP状态码为400。
-
QuotaExceeded.StringLength: 如果输入字符串长度超过允许的最大值，会返回此错误，同样HTTP状态码为400。
注意事项
- 在实际应用中，调用此API通常需要配合阿里云的AccessKey ID和Access Key Secret进行签名认证，确保请求的安全性。
- 请确保遵循阿里云API调用的最佳实践，包括但不限于错误处理、重试机制等，以保证服务的稳定性和可靠性。
通过上述API调用，您可以方便地从任何包含子域名的完整域名中提取出主域名部分。
