Todos os produtos
Search
Central de documentação

:CheckDomain

Última atualização: Jun 27, 2026

Chame a API CheckDomain para validar um nome de domínio.

Teste

Chame esta operação diretamente no OpenAPI Explorer para eliminar a necessidade de calcular assinaturas. Após uma chamada bem-sucedida, o OpenAPI Explorer gera automaticamente códigos de exemplo para o SDK.

Parâmetros de solicitação

Nome

Tipo

Obrigatório

Exemplo

Descrição

DomainId

Integer

Sim

153345

O ID do nome de domínio.

Action

String

Não

CheckDomain

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

Parâmetros de resposta

Nome

Tipo

Exemplo

Descrição

DomainStatus

Integer

1

Status do domínio. Indica se o domínio está autenticado.

0: Ativo. O domínio está autenticado.

1: Inativo. O domínio não está autenticado.

RequestId

String

F0B82E83-A1D9-4FE6-97D2-F4B231F80B02

ID da solicitação.

Exemplos

Exemplo de solicitação

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

Exemplos de resposta

Formato XML

<CheckDomainResponse>
      <DomainStatus>1</DomainStatus>
      <RequestId>F0B82E83-A1D9-4FE6-97D2-F4B231F80B02</RequestId>
</CheckDomainResponse>

Formato JSON

{
    "RequestId":"F0B82E83-A1D9-4FE6-97D2-F4B231F80B02",
    "DomainStatus":1
}

Códigos de erro

Código de erro

Descrição

Código de status HTTP

Semântica

InvalidDomainId.Malformed

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

404

O ID do domínio não existe.

CheckDomain.Failed

Falha na verificação do domínio.

400

A validação do domínio falhou.

InvalidDomainName.DuplicateTLD

O domínio de nível superior do nome de domínio especificado já existe.

400

O nome de domínio principal já existe.

Para obter mais informações sobre códigos de erro, consulte o Error Center.