Verificar a disponibilidade do domínioVerify domain availability

Aplica-se aApplies To

  • Partner CenterPartner Center
  • Partner Center operado pela 21VianetPartner Center operated by 21Vianet
  • Partner Center do Microsoft Cloud GermanyPartner Center for Microsoft Cloud Germany
  • Partner Center do Microsoft Cloud for US GovernmentPartner Center for Microsoft Cloud for US Government

Como determinar se um domínio está disponível para uso.How to determine if a domain is available for use.

Pré-requisitosPrerequisites

  • Credenciais, conforme descrito em Autenticação do Partner Center.Credentials as described in Partner Center authentication. Esse cenário dá suporte à autenticação com aplicativos autônomos e aplicativos + credenciais de usuário.This scenario supports authentication with both standalone App and App+User credentials.

  • Um domínio (por exemplo contoso.onmicrosoft.com ).A domain (for example contoso.onmicrosoft.com).

C#C#

Para verificar se um domínio está disponível, primeiro chame IAggregatePartner. Domains para obter uma interface para operações de domínio.To verify if a domain is available, first call IAggregatePartner.Domains to obtain an interface to domain operations. Em seguida, chame o método ByDomain com o domínio a ser verificado.Then call the ByDomain method with the domain to check. Esse método recupera uma interface para as operações disponíveis para um domínio específico.This method retrieves an interface to the operations available for a specific domain. Por fim, chame o método Exists para ver se o domínio já existe.Finally, call the Exists method to see if the domain already exists.

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

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

Exemplo: aplicativo de teste do console.Sample: Console test app. Projeto: classede exemplos do SDK do Partner Center: CheckDomainAvailability.csProject: Partner Center SDK Samples Class: CheckDomainAvailability.cs

Solicitação RESTREST request

Sintaxe da solicitaçãoRequest syntax

MétodoMethod URI da solicitaçãoRequest URI
PRINCIPALHEAD {baseURL}/v1/Domains/{Domain} http/1.1{baseURL}/v1/domains/{domain} HTTP/1.1

Parâmetro do URIURI parameter

Use o parâmetro de consulta a seguir para verificar a disponibilidade do domínio.Use the following query parameter to verify domain availability.

NomeName TipoType ObrigatórioRequired DescriçãoDescription
controladordomain cadeia de caracteresstring SY Uma string que identifica o domínio para verificar.A string that identifies the domain to check.

Cabeçalhos de solicitaçãoRequest headers

Para obter mais informações, confira Cabeçalhos REST do Partner Center.For more information, see Partner Center REST headers.

Corpo da solicitaçãoRequest body

NenhumNone

Exemplo de solicitaçãoRequest example

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 RESTREST response

Se o domínio existir, ele não estará disponível para uso e um código de status de resposta 200 OK será retornado.If the domain exists, it isn't available for use and a response status code 200 OK is returned. Se o domínio não for encontrado, ele estará disponível para uso e um código de status de resposta 404 não encontrado será retornado.If the domain isn't found, it's available for use and a response status code 404 Not Found is returned.

Códigos de êxito e de erro de respostaResponse success and error codes

Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais.Use a network trace tool to read this code, error type, and additional parameters. Para obter a lista completa, confira Códigos de erro REST do Partner Center.For the full list, see Partner Center REST error codes.

Exemplo de resposta para quando o domínio já estiver em usoResponse example for when the domain is already in use

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 estiver disponívelResponse example for when the domain is available

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