Todos os produtos
Search

Este produto

    :DescDomain

    Central de documentação

    :DescDomain

    Última atualização: Jun 27, 2026

    Use a operação DescDomain para consultar a configuração de um nome de domínio.

    Testar a operação

    Teste esta operação no OpenAPI Explorer. Não é necessário calcular uma assinatura. Após uma chamada bem-sucedida, o OpenAPI Explorer gera automaticamente exemplos de código do SDK.

    Parâmetros de solicitação

    Nome

    Tipo

    Obrigatório

    Exemplo

    Descrição

    DomainId

    Integer

    Sim

    13464

    ID do nome de domínio. Para obter o ID do nome de domínio, chame a operação QueryDomainByParam.

    Action

    String

    Não

    DescDomain

    Parâmetro obrigatório. Defina o valor como DescDomain.

    RequireRealTimeDnsRecords

    boolean

    Não

    true

    Especifica se deve executar a resolução DNS em tempo real.

    Parâmetros de resposta

    Nome

    Tipo

    Exemplo

    Descrição

    SpfRecord

    String

    include the following:spf1.dm.aliyun.com

    Valor do registro SPF fornecido no console do Direct Mail.

    CnameConfirmStatus

    String

    0

    Indica se o registro de host CNAME foi alterado. O valor 1 indica alteração, inclusive reversão ao valor original. O valor 0 indica que não houve alteração.

    DefaultDomain

    String

    0

    Indica se este é o nome de domínio padrão.

    Valor: 0 (Não). Este parâmetro está obsoleto.

    CreateTime

    String

    2019-09-29T12:49Z

    Data e hora de criação.

    CnameRecord

    String

    dmtrace

    Parte personalizada do registro de host CNAME.

    CnameAuthStatus

    String

    1

    Sinalizador de verificação CNAME. O valor 0 indica sucesso; o valor 1 indica falha.

    IcpStatus

    String

    1

    Status do registro ICP. O valor 1 indica que o nome de domínio possui registro ICP. O valor 0 indica ausência de registro ICP.

    DnsTxt

    String

    0c40d5f125af4e42892a

    Valor do registro de propriedade obtido por resolução DNS na internet.

    DomainName

    String

    test.example.net

    Nome de domínio.

    DomainId

    String

    158910

    ID do nome de domínio.

    DnsSpf

    String

    v=xxxx

    Valor do registro SPF obtido por resolução DNS na internet.

    SpfAuthStatus

    String

    1

    Sinalizador de verificação SPF. O valor 0 indica sucesso; o valor 1 indica falha.

    RequestId

    String

    51B74264-46B4-43C8-A9A0-6B8E8BC04F34

    ID da solicitação.

    MxRecord

    String

    mx01.dm.aliyun.com

    Valor do registro MX fornecido no console do Direct Mail.

    MxAuthStatus

    String

    1

    Sinalizador de verificação MX. O valor 0 indica sucesso; o valor 1 indica falha.

    DnsMx

    String

    mx01.dm.aliyun.com

    Valor do registro MX obtido por resolução DNS na internet.

    DomainStatus

    String

    1

    Status do nome de domínio. Indica se o nome de domínio foi verificado. Valores válidos:

    0: Ativo e verificado.

    1: Inativo e com falha na verificação.

    TlDomainName

    String

    example.net

    Nome de domínio principal.

    TracefRecord

    String

    tracedm.aliyuncs.com

    Valor do registro CNAME fornecido no console do Direct Mail.

    DomainType

    String

    0c40d5f125af4e42892a

    Registro de propriedade fornecido no console do Direct Mail.

    SpfRecordV2

    String

    v=spf1 include the following:spf1.dm.aliyun.com -all

    Valor do registro SPF.

    DkimRR

    String

    aliyun-cn-hangzhou._domainkey.xxx

    Registro de host DKIM.

    DkimPublicKey

    String

    v=DKIM1; k=rsa; p=MIGfMA0GCSqGSIb...

    Chave pública DKIM.

    DkimAuthStatus

    String

    1

    Sinalizador de verificação DKIM. O valor 0 indica sucesso; o valor 1 indica falha.

    HostRecord

    String

    xxx

    Registro de host.

    DmarcHostRecord

    String

    _dmarc.xxx

    Registro de host DMARC.

    DmarcRecord

    String

    v=DMARC1;p=none;rua=mailto:dmarc_report@service.aliyun.com

    Registro DMARC.

    DnsDmarc

    String

    v=DMARC1;p=none;rua=mailto:dmarc_report@service.aliyun.com

    Valor do registro DMARC obtido por resolução DNS na internet.

    DmarcAuthStatus

    Integer

    1

    Sinalizador de verificação DMARC. O valor 0 indica sucesso; o valor 1 indica falha.

    Exemplos

    Exemplo de solicitação

    http(s)://dm.aliyuncs.com/?Action=DescDomain
&DomainId=401591
&<Common request parameters>

    Exemplo de resposta

    Formato JSON

    {
  "HostRecord": "dmailtest",
  "CnameAuthStatus": 1,
  "CnameRecord": "dmtrace",
  "IcpStatus": 1,
  "DefaultDomain": 0,
  "DomainType": "df29ab561bb140e98dfb",
  "SpfRecordV2": "v=spf1 include the following:spf1.dm.aliyun.com -all",
  "DkimRR": "aliyun-cn-hangzhou._domainkey.dmailtest",
  "TlDomainName": "sdysy.top",
  "SpfRecord": "include the following:spf1.dm.aliyun.com",
  "SpfAuthStatus": 0,
  "RequestId": "9C7FB8ED-BF86-5BA1-B0EF-BB71937C2036",
  "DomainName": "dmailtest.sdysy.top",
  "DnsMx": "mx01.dm.aliyun.com",
  "CreateTime": "2023-09-11T17:59Z",
  "DnsTxt": "df29ab561bb140e98dfb",
  "CnameConfirmStatus": 0,
  "DnsSpf": "v=spf1 include the following:spf1.dm.aliyun.com -all",
  "MxRecord": "mx01.dm.aliyun.com",
  "DomainId": 401591,
  "MxAuthStatus": 0,
  "TracefRecord": "tracedm.aliyuncs.com",
  "DkimPublicKey": "v=DKIM1; k=rsa; p=xxx",
  "DkimAuthStatus": 0,
  "DmarcAuthStatus": 1,
  "DomainStatus": 3,
  "DmarcHostRecord": "_dmarc.xxx",
  "DmarcRecord": "v=DMARC1;p=none;rua=mailto:dmarc_report@service.aliyun.com",
  "DnsDmarc": "v=DMARC1;p=none;rua=mailto:dmarc_report@service.aliyun.com"
}

    Códigos de erro

    Código de status HTTP

    Código de erro

    Mensagem de erro

    Descrição

    400

    InvalidDomainId.Malformed

    The specified domain ID does not exist.

    O ID de domínio especificado não existe.

    Para obter a lista completa de códigos de erro, consulte o Error Center.