Verificare la disponibilità di un dominio

Articolo
06/19/2023

Si applica a: Centro per i partner | Centro per i partner gestito da 21Vianet | Centro per i partner per Microsoft Cloud for US Government

Come determinare se un dominio è disponibile per l'uso.

Prerequisiti

Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione con le credenziali app autonome e app+utente.
Un dominio (ad esempio contoso.onmicrosoft.com).

C#

Per verificare se è disponibile un dominio, chiamare prima IAggregatePartner.Domains per ottenere un'interfaccia per le operazioni di dominio. Chiamare quindi il metodo ByDomain con il dominio da controllare. Questo metodo recupera un'interfaccia per le operazioni disponibili per un dominio specifico. Infine, chiamare il metodo Exists per verificare se il dominio esiste già.

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

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

Esempio: app di test della console. Progetto: Classe di esempi sdk del Centro per i partner: CheckDomainAvailability.cs

Richiesta REST

Sintassi della richiesta

Metodo	URI richiesta
HEAD	{baseURL}/v1/domains/{domain} HTTP/1.1

Parametro URI

Usare il parametro di query seguente per verificare la disponibilità del dominio.

Nome	Tipo	Obbligatoria	Descrizione
Dominio	string	S	Stringa che identifica il dominio da verificare.

Intestazioni della richiesta

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Testo della richiesta

Nessuno

Esempio di richiesta

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

Risposta REST

Se il dominio esiste, non è disponibile per l'uso e viene restituito un codice di stato della risposta 200 OK. Se il dominio non viene trovato, è disponibile per l'uso e viene restituito un codice di stato della risposta 404 Not Found.

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che ne indica l'esito e con informazioni di debug aggiuntive. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per l'elenco completo, vedi Codici di errore REST del Centro per i partner.

Esempio di risposta per quando il dominio è già in 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

Esempio di risposta per quando il dominio è disponibile

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

Condividi tramite