Domains - Create Domain
Nota
Esta API está en versión preliminar.
Crea un nuevo dominio.
Permisos
El autor de la llamada debe ser administrador de Fabric.
Ámbitos delegados necesarios
Tenant.ReadWrite.All.
Limitaciones
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.
Identidad | Apoyo |
---|---|
Usuario | Sí |
de entidad de servicio y identidades administradas | Sí |
Interfaz
POST https://api.fabric.microsoft.com/v1/admin/domains
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 |
Dominio creado correctamente. |
|
Other Status Codes |
Códigos de error comunes:
|
Ejemplos
Create a domain example
Solicitud de ejemplo
POST https://api.fabric.microsoft.com/v1/admin/domains
{
"displayName": "Finance",
"description": "This domain is used for identifying financial data and reports.",
"parentDomainId": "5f6552c3-816c-43e7-8289-842f8b35f9df"
}
Respuesta de muestra
{
"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",
"contributorsScope": "AllTenant"
}
Definiciones
Nombre | Description |
---|---|
Contributors |
Ámbito de colaborador. Se pueden agregar ámbitos de colaborador adicionales a lo largo del tiempo. |
Create |
Carga de solicitud para crear un dominio o subdominio. |
Domain |
Representa un dominio o subdominio. |
Error |
Objeto de detalles del recurso relacionado con el error. |
Error |
Respuesta de error. |
Error |
Detalles de la respuesta de error. |
ContributorsScopeType
Ámbito de colaborador. Se pueden agregar ámbitos de colaborador adicionales a lo largo del tiempo.
Valor | Description |
---|---|
AdminsOnly |
Solo administradores de inquilinos y dominios. |
AllTenant |
Todos los usuarios del inquilino. |
SpecificUsersAndGroups |
Usuarios y grupos específicos. |
CreateDomainRequest
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
Representa un dominio o subdominio.
Nombre | Tipo | Description |
---|---|---|
contributorsScope |
Ámbito de colaboradores de 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 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
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 |
Lista de detalles de error adicionales. |
|
relatedResource |
Detalles del recurso relacionado con el error. |
|
requestId |
string |
Identificador de la solicitud asociada al error. |
ErrorResponseDetails
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 |
Detalles del recurso relacionado con el error. |