Comprobar la disponibilidad del dominio

Artículo
03/23/2023

Se aplica a: Centro de partners | Centro de partners operado por 21Vianet | Centro de partners para Microsoft Cloud for US Government

Cómo determinar si un dominio está disponible para su uso.

Requisitos previos

Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario admite la autenticación con las credenciales de aplicación independiente y app+usuario.
Un dominio (por ejemplo contoso.onmicrosoft.com, ).

C#

Para comprobar si un dominio está disponible, primero llame a IAggregatePartner.Domains para obtener una interfaz para las operaciones de dominio. A continuación, llame al método ByDomain con el dominio para comprobarlo. Este método recupera una interfaz a las operaciones disponibles para un dominio específico. Por último, llame al método Exists para ver si el dominio ya existe.

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

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

Ejemplo: Aplicación de prueba de consola. Project: Clase de ejemplos del SDK del Centro de partners: CheckDomainAvailability.cs

Solicitud REST

Sintaxis de la solicitud

Método	URI de solicitud
HEAD	{baseURL}/v1/domains/{domain} HTTP/1.1

Parámetro de URI

Use el siguiente parámetro de consulta para comprobar la disponibilidad del dominio.

Nombre	Tipo	Obligatorio	Descripción
dominio	string	Y	Cadena que identifica el dominio que se va a comprobar.

Encabezados de solicitud

Para obtener más información, consulta Encabezados REST del Centro de partners.

Cuerpo de la solicitud

None

Ejemplo de solicitud

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

Respuesta REST

Si el dominio existe, no está disponible para su uso y se devuelve un código de estado de respuesta 200 Ok. Si no se encuentra el dominio, está disponible para su uso y se devuelve un código de estado de respuesta 404 No encontrado.

Códigos de error y de respuesta correctos

Cada respuesta incluye un código de estado HTTP que indica si la operación se ha realizado correctamente o con errores y proporciona información de depuración adicional. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales. Para obtener la lista completa, consulta Códigos de error de REST del Centro de partners.

Ejemplo de respuesta para cuando el dominio ya está en 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

Ejemplo de respuesta para cuando el dominio está disponible

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