Verificar a disponibilidade do domínio

  • Artigo

Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center para o Microsoft Cloud for US Government

Como determinar se um domínio está disponível para uso.

Pré-requisitos

  • Credenciais, conforme descrito em Autenticação do Partner Center. Esse cenário dá suporte à autenticação com credenciais autônomas de Aplicativo e Aplicativo+Usuário.

  • Um domínio (por exemplo contoso.onmicrosoft.com, ).

C#

Para verificar se um domínio está disponível, primeiro chame IAggregatePartner.Domains para obter uma interface para operações de domínio. Em seguida, chame o método ByDomain com o domínio para marcar. Esse método recupera uma interface para as operações disponíveis para um domínio específico. Por fim, chame o método Exists para ver se o domínio já existe.

// IAggregatePartner partnerOperations;
// const string domain = "contoso.onmicrosoft.com";

bool result = partnerOperations.Domains.ByDomain(domain).Exists();

Exemplo: aplicativo de teste de console. Projeto: Classe de exemplos do SDK do Partner Center: CheckDomainAvailability.cs

Solicitação REST

Sintaxe da solicitação

Método URI da solicitação
HEAD {baseURL}/v1/domains/{domain} HTTP/1.1

Parâmetro do URI

Use o parâmetro de consulta a seguir para verificar a disponibilidade do domínio.

Nome Type Obrigatório Descrição
domínio cadeia de caracteres Y Uma string que identifica o domínio para verificar.

Cabeçalhos de solicitação

Para obter mais informações, confira Cabeçalhos REST do Partner Center.

Corpo da solicitação

Nenhum

Exemplo de solicitação

HEAD https://api.partnercenter.microsoft.com/v1/domains/contoso.onmicrosoft.com HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: cf5b00d6-9240-431c-a973-cc06c904e5bf
MS-CorrelationId: ec57501a-a4c3-45ee-ab2b-da4250545fc9
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Connection: Keep-Alive

Resposta REST

Se o domínio existir, ele não estará disponível para uso e uma resposta status código 200 OK será retornada. Se o domínio não for encontrado, ele estará disponível para uso e uma resposta status código 404 Não Encontrado será retornado.

Códigos de êxito e de erro de resposta

Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais. Para obter a lista completa, confira Códigos de erro REST do Partner Center.

Exemplo de resposta para quando o domínio já está em uso

HTTP/1.1 200 OK
Content-Length: 0
MS-CorrelationId: ec57501a-a4c3-45ee-ab2b-da4250545fc9
MS-RequestId: cf5b00d6-9240-431c-a973-cc06c904e5bf
MS-CV: 7UXAHds8J0mNUCSp.0
MS-ServerId: 201022015
Date: Tue, 31 Jan 2017 22:22:35 GMT

Exemplo de resposta para quando o domínio está disponível

HTTP/1.1 404 Not Found
Content-Length: 0
MS-CorrelationId: 54770745-17f0-433c-bd7b-0265e5b38f98
MS-RequestId: 1169a4cd-3be7-4e29-9cb3-0f78ffa2e91e
MS-CV: RRmc+bEw9U2e97CC.0
MS-ServerId: 202010406
Date: Tue, 31 Jan 2017 22:36:01 GMT