Todos os produtos
Search

Este produto

    Direct Mail:DescDomain

    Central de documentação

    Direct Mail:DescDomain

    Última atualização: Oct 20, 2026

    Configura um nome de domínio.

    Experimente agora

    Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

    Testar

    Autorização RAM

    A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

    • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

    • API: A API que você pode chamar para executar a ação.

    • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

    • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

      • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

      • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

    • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

    • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

    Ação

    Nível de acesso

    Tipo de recurso

    Chave de condição

    Ação dependente

    dm:DescDomain

    get

    *Todos os recursos.

    *

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    DomainId

    integer

    Sim

    O ID do nome de domínio. Você pode chamar a operação QueryDomainByParam para obter o ID.

    13464
    RequireRealTimeDnsRecords

    boolean

    Não

    Especifica se a resolução de DNS em tempo real é necessária.

    true

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    SpfRecord

    string

    O valor do registro SPF fornecido pelo console do DirectMail.

    include:spf1.dm.aliyun.com
    CnameConfirmStatus

    string

    Indica se o registro de host do registro CNAME foi modificado. Valores válidos:

    • 1: Modificado. Alterar o valor de volta para o valor original também é considerado uma modificação.

    • 0: Não modificado.

    0
    DefaultDomain

    string

    Indica se o nome de domínio é o nome de domínio padrão. [Deprecated] Valores válidos:

    • 0: Não.

    0
    CreateTime

    string

    A hora em que o nome de domínio foi criado. A hora segue o padrão ISO 8601 e é exibida em UTC, com precisão de minutos.

    2025-03-19T12:49Z
    CnameRecord

    string

    A parte personalizada do registro de host CNAME.

    dmtrace
    CnameAuthStatus

    string

    O status de verificação do CNAME. Valores válidos:

    • 0: Bem-sucedido.

    • 1: Falhou.

    1
    IcpStatus

    string

    O status de registro ICP. Valores válidos:

    • 1: Registrado.

    • 0: Não registrado.

    1
    DnsTxt

    string

    O valor do registro de propriedade resolvido a partir do nome de domínio público.

    0c40d5f125af4e42892a
    DomainName

    string

    O nome de domínio.

    test.example.net
    DomainId

    string

    O ID do nome de domínio.

    158910
    DnsSpf

    string

    O valor do registro SPF resolvido a partir do nome de domínio público.

    v=xxxx
    SpfAuthStatus

    string

    O status de verificação do SPF. Valores válidos:

    • 0: Bem-sucedido.

    • 1: Falhou.

    1
    RequestId

    string

    O ID da solicitação.

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

    string

    O valor do registro MX fornecido pelo console do DirectMail.

    mx01.dm.aliyun.com
    MxAuthStatus

    string

    O status de verificação do MX. Valores válidos:

    • 0: Bem-sucedido.

    • 1: Falhou.

    1
    DnsMx

    string

    O valor do registro MX resolvido a partir do nome de domínio público.

    mx01.dm.aliyun.com
    DomainStatus

    string

    O status do nome de domínio, que indica se a verificação foi bem-sucedida. Valores válidos:

    • 0: Disponível. A verificação foi bem-sucedida.

    • 1: Indisponível. A verificação falhou.

    1
    TlDomainName

    string

    O nome de domínio principal.

    example.com
    TracefRecord

    string

    O valor do registro CNAME fornecido pelo console do DirectMail.

    tracedm.aliyuncs.com
    DomainType

    string

    O registro de propriedade fornecido pelo console do DirectMail.

    0c40d5f125af4e42892a
    SpfRecordV2

    string

    O registro SPF. Anteriormente, o conteúdo SPF exibido precisava ser calculado pelo cliente com base no parâmetro spfRecord na resposta. O parâmetro spfRecordV2 foi adicionado para substituir o parâmetro spfRecord, permitindo que o cliente exiba diretamente seu valor.

    v=spf1 include:spf1.dm.aliyun.com -all
    DkimRR

    string

    O registro de host DKIM, que é a chave do registro DKIM que você precisa configurar no DNS.

    aliyun-cn-hangzhou._domainkey.hangzhou26
    DkimPublicKey

    string

    O valor da chave pública DKIM, que é o valor do registro DKIM que você precisa configurar no DNS.

    v=DKIM1; k=rsa; p=MIGfMA0GCSqGSI...
    DkimAuthStatus

    string

    O status de verificação do DKIM, que indica se o registro DKIM configurado no DNS passou na verificação. Valores válidos:

    • 0: Aprovado.

    • 1: Falhou.

    0
    HostRecord

    string

    O registro de host.

    xxx
    DmarcRecord

    string

    O valor do registro DMARC.

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

    string

    O valor do registro DMARC resolvido a partir do nome de domínio público.

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

    integer

    O status de verificação do DMARC, que indica se o registro DMARC configurado no DNS passou na verificação. Valores válidos:

    • 0: Aprovado.

    • 1: Falhou.

    1
    DmarcHostRecord

    string

    O valor do registro de host DMARC.

    _dmarc.xxx
    DkimRsaLength

    integer

    O comprimento da chave RSA usada para o DKIM, como 1024 ou 2048.

    1024
    DomainVersion

    integer

    A versão do nome de domínio. Valores válidos:

    • 0: Versão antiga.

    • 1: Nova versão. Os itens de configuração necessários para passar na verificação variam de acordo com a versão.

    0

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "SpfRecord": "include:spf1.dm.aliyun.com",
  "CnameConfirmStatus": "0",
  "DefaultDomain": "0",
  "CreateTime": "2025-03-19T12:49Z",
  "CnameRecord": "dmtrace",
  "CnameAuthStatus": "1",
  "IcpStatus": "1",
  "DnsTxt": "0c40d5f125af4e42892a",
  "DomainName": "test.example.net",
  "DomainId": "158910",
  "DnsSpf": "v=xxxx",
  "SpfAuthStatus": "1",
  "RequestId": "51B74264-46B4-43C8-A9A0-6B8E8BC04F34",
  "MxRecord": "mx01.dm.aliyun.com",
  "MxAuthStatus": "1",
  "DnsMx": "mx01.dm.aliyun.com",
  "DomainStatus": "1",
  "TlDomainName": "example.com",
  "TracefRecord": "tracedm.aliyuncs.com",
  "DomainType": "0c40d5f125af4e42892a",
  "SpfRecordV2": "v=spf1 include:spf1.dm.aliyun.com -all",
  "DkimRR": "aliyun-cn-hangzhou._domainkey.hangzhou26",
  "DkimPublicKey": "v=DKIM1; k=rsa; p=MIGfMA0GCSqGSI...",
  "DkimAuthStatus": "0",
  "HostRecord": "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",
  "DmarcAuthStatus": 1,
  "DmarcHostRecord": "_dmarc.xxx",
  "DkimRsaLength": 1024,
  "DomainVersion": 0
}

    Códigos de erro

    Consulte Códigos de Erro para uma lista completa.

    Notas de versão

    Consulte Notas de Versão para uma lista completa.