Comprobar la disponibilidad del dominio
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
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de