Domains - Create Domain

Servicio:: Admin

Versión de la API:: v1

Crea un nuevo dominio.

Note

Esta API es una versión de lanzamiento de una versión preliminar debido a que está en desuso el 31 de marzo de 2026. Al llamar a esta API: los autores de llamadas deben establecer el parámetro preview de consulta en el valor. false

Permissions

El autor de la llamada debe ser administrador de Fabric.

Ámbitos delegados necesarios

Tenant.ReadWrite.All.

Limitations

Máximo de 25 solicitudes por minuto por entidad de seguridad.

Identidades admitidas de Microsoft Entra

Esta API admite las identidades de Microsoft enumeradas en esta sección.

Identity	Support
User	Yes
Entidad de servicio e Identidades administradas	Yes

Interface

POST https://api.fabric.microsoft.com/v1/admin/domains?preview={preview}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
preview	query	True	boolean	Este parámetro especifica la versión de la API que se va a usar. Establézcalo en `false` para usar la versión de lanzamiento.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
displayName	True	string	Nombre para mostrar del dominio. El nombre para mostrar no puede contener más de 40 caracteres.
description		string	Descripción del dominio. La descripción no puede contener más de 256 caracteres.
parentDomainId		string (uuid)	Identificador de objeto primario del dominio.

Respuestas

Nombre Tipo Description

201 Created

Nombre	Tipo	Description
201 Created	Domain	Dominio creado correctamente.
429 Too Many Requests	ErrorResponse	Se superó el límite de frecuencia de servicio. El servidor devuelve un `Retry-After` encabezado que indica, en segundos, cuánto tiempo debe esperar el cliente antes de enviar solicitudes adicionales. Encabezados Retry-After: integer
Other Status Codes	ErrorResponse	Códigos de error comunes: EntityNotFound: error al crear un dominio porque no se encontró el identificador de dominio primario. EntityConflict: error al crear dominio porque el nombre para mostrar del dominio ya existe. InvalidInput: identificador de dominio primario no válido.

Domain

Dominio creado correctamente.

429 Too Many Requests

ErrorResponse

Se superó el límite de frecuencia de servicio. El servidor devuelve un Retry-After encabezado que indica, en segundos, cuánto tiempo debe esperar el cliente antes de enviar solicitudes adicionales.

Encabezados

Retry-After: integer

Other Status Codes

ErrorResponse

Códigos de error comunes:

EntityNotFound: error al crear un dominio porque no se encontró el identificador de dominio primario.
EntityConflict: error al crear dominio porque el nombre para mostrar del dominio ya existe.
InvalidInput: identificador de dominio primario no válido.

Ejemplos

Create a domain example

Solicitud de ejemplo

HTTP

POST https://api.fabric.microsoft.com/v1/admin/domains?preview=false

{
  "displayName": "Finance",
  "description": "This domain is used for identifying financial data and reports.",
  "parentDomainId": "5f6552c3-816c-43e7-8289-842f8b35f9df"
}

Respuesta de muestra

status code:: 201

{
  "id": "9eba6944-daff-4441-b9b5-630ce34238fd",
  "displayName": "Finance",
  "description": "This domain is used for identifying financial data and reports.",
  "parentDomainId": "5f6552c3-816c-43e7-8289-842f8b35f9df"
}

Definiciones

Nombre	Description
CreateDomainRequest	Carga de solicitud para crear un dominio o subdominio.
Domain
ErrorRelatedResource	Objeto de detalles del recurso relacionado con el error.
ErrorResponse	Respuesta de error.
ErrorResponseDetails	Detalles de la respuesta de error.

CreateDomainRequest

Objeto

Carga de solicitud para crear un dominio o subdominio.

Nombre	Tipo	Description
description	string	Descripción del dominio. La descripción no puede contener más de 256 caracteres.
displayName	string	Nombre para mostrar del dominio. El nombre para mostrar no puede contener más de 40 caracteres.
parentDomainId	string (uuid)	Identificador de objeto primario del dominio.

Domain

Objeto

Nombre	Tipo	Description
defaultLabelId	string (uuid)	Etiqueta de confidencialidad predeterminada del dominio.
description	string	Descripción del dominio.
displayName	string	Nombre del dominio.
id	string (uuid)	Identificador del objeto de dominio.
parentDomainId	string (uuid)	Identificador de objeto primario del dominio.

ErrorRelatedResource

Objeto

Objeto de detalles del recurso relacionado con el error.

Nombre	Tipo	Description
resourceId	string	Identificador de recurso implicado en el error.
resourceType	string	Tipo del recurso implicado en el error.

ErrorResponse

Objeto

Respuesta de error.

Nombre	Tipo	Description
errorCode	string	Identificador específico que proporciona información sobre una condición de error, lo que permite una comunicación estandarizada entre nuestro servicio y sus usuarios.
message	string	Representación legible del error.
moreDetails	ErrorResponseDetails[]	Lista de detalles de error adicionales.
relatedResource	ErrorRelatedResource	Detalles del recurso relacionado con el error.
requestId	string (uuid)	Identificador de la solicitud asociada al error.

ErrorResponseDetails

Objeto

Detalles de la respuesta de error.

Nombre	Tipo	Description
errorCode	string	Identificador específico que proporciona información sobre una condición de error, lo que permite una comunicación estandarizada entre nuestro servicio y sus usuarios.
message	string	Representación legible del error.
relatedResource	ErrorRelatedResource	Detalles del recurso relacionado con el error.