开发者社区 问答 正文

如何查询域名详情?



描述


用于查询您绑定的自定义域名详情信息,包含系统自动分配的二级域名、自定义域名和SSL证书信息。

  • 此功能面向API提供者


请求参数


名称类型是否必须描述
ActionString接口名称,系统规定参数,取值:DescribeDomain
GroupIdStringAPI分组 ID,系统生成,全局唯一
DomainNameString自定义域名


返回参数


名称类型描述
RequestIdString请求唯一标识
GroupIDStringAPI分组 ID,系统生成,全局唯一
DomainNameString自定义域名
SubDomainString系统为分组分配的二级域名
CertificateIdStringSSL证书ID,系统自动生成唯一编号
CertificateNameStringSSL证书名称
CertificateBodyString证书内容
CertificatePrivateKeyString证书私钥
DomainBindingStatusString自定义域名绑定状态,取值:
  • BINDING:正常
  • BOUND:未生效
DomainCNAMEStatusString域名解析情况,取值:
  • RESOLVED:已解析
  • UNRESOLVED:未解析
DomainLegalStatusString域名合法状态,取值:
  • NORMAL:正常
  • ABNORMAL:异常,该状态会影响API调用,需尽快解决
DomainRemarkString域名相关备注,如描述域名异常状态原因


示例



请求示例





展开
收起
轩墨 2017-10-26 13:50:56 1970 分享 版权
阿里云 AI 助理回答

为了查询您绑定的自定义域名详情信息,此功能全面涵盖了系统自动分配的二级域名、自定义域名以及SSL证书的具体情况,特别适用于API提供者进行管理和监控。以下是调用该功能所需的请求参数及预期返回的详细信息:

请求参数

  • Action: DescribeDomain - 固定值,表示查询自定义域名详情的操作。
  • GroupId: (必填) 字符串类型,代表API分组的唯一ID,由系统生成。
  • DomainName: (必填) 字符串类型,指您自定义的域名。

返回参数

成功调用后,您将收到包含以下关键信息的响应:

  • RequestId: 唯一标识本次请求的字符串,用于追踪和日志记录。
  • GroupId: API分组的全局唯一ID。
  • DomainName: 您查询的自定义域名。
  • SubDomain: 系统为您的分组自动分配的二级域名。
  • CertificateId: SSL证书的唯一ID,由系统生成。
  • CertificateName: SSL证书的名称。
  • CertificateBody: 证书的实际内容。
  • CertificatePrivateKey: 证书的私钥部分(敏感信息,请妥善保管)。
  • DomainBindingStatus: 自定义域名的绑定状态,可为:
    • BINDING: 正常
    • BOUND: 未生效
  • DomainCNAMEStatus: 域名解析状态,包括:
    • RESOLVED: 已解析
    • UNRESOLVED: 未解析
  • DomainLegalStatus: 域名的合法性状态,包括:
    • NORMAL: 正常
    • ABNORMAL: 异常(需关注并解决以确保API正常调用)
  • DomainRemark: 关于域名的备注信息,可能说明异常原因或其他备注。

请注意,如果DomainLegalStatus显示为ABNORMAL,这表明存在影响API调用的潜在问题,需要立即采取措施进行修正。

以上信息基于提供的知识库资料汇总而成,旨在帮助您高效地理解和使用查询自定义域名详情的功能。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答