Verificar a disponibilidade do domínio
Aplica-se a: Centro de Parceiros | Centro de Parceiros operado pela 21Vianet | Centro de Parceiros para Microsoft Cloud for US Government
Como determinar se um domínio está disponível para utilização.
Pré-requisitos
Credenciais conforme descrito na autenticação do Centro de Parceiros. Este cenário suporta a autenticação com credenciais autónomas da Aplicação e da Aplicação+Utilizador.
Um domínio (por exemplo
contoso.onmicrosoft.com
).
C#
Para verificar se um domínio está disponível, chame primeiro IAggregatePartner.Domains para obter uma interface para operações de domínio. Em seguida, chame o método ByDomain com o domínio para verificar. Este método obtém uma interface para as operações disponíveis para um domínio específico. Por fim, chame o método Existe para ver se o domínio já existe.
// IAggregatePartner partnerOperations;
// const string domain = "contoso.onmicrosoft.com";
bool result = partnerOperations.Domains.ByDomain(domain).Exists();
Exemplo: aplicação de teste da consola. Project: Classe de Exemplos do SDK do Centro de Parceiros: CheckDomainAvailability.cs
Pedido REST
Sintaxe do pedido
Método | URI do pedido |
---|---|
CABEÇALHO | {baseURL}/v1/domains/{domain} HTTP/1.1 |
Parâmetro URI
Utilize o seguinte parâmetro de consulta para verificar a disponibilidade do domínio.
Nome | Tipo | Necessário | Descrição |
---|---|---|---|
domínio | string | Y | Uma cadeia que identifica o domínio a verificar. |
Cabeçalhos do pedido
Para obter mais informações, veja Cabeçalhos REST do Centro de Parceiros.
Corpo do pedido
Nenhuma
Exemplo de pedido
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: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Connection: Keep-Alive
Resposta do REST
Se o domínio existir, não está disponível para utilização e é devolvido um código de estado de resposta 200 OK. Se o domínio não for encontrado, está disponível para utilização e é devolvido um código de estado de resposta 404 Não Encontrado.
Códigos de erro e êxito da resposta
Cada resposta inclui um código de estado HTTP que indica êxito ou falha e informações adicionais de depuração. Utilize uma ferramenta de rastreio de rede para ler este código, tipo de erro e parâmetros adicionais. Para obter a lista completa, veja Códigos de erro REST do Centro de Parceiros.
Exemplo de resposta para quando o domínio já está a ser utilizado
HTTP/1.1 200 OK
Content-Length: 0
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: 1169a4cd-3be7-4e29-9cb3-0f78ffa2e91e
MS-CV: RRmc+bEw9U2e97CC.0
MS-ServerId: 202010406
Date: Tue, 31 Jan 2017 22:36:01 GMT