Workspaces - Create Workspace

Servicio:: Core

Versión de la API:: v1

Crea una nueva área de trabajo.

Permisos

El autor de la llamada debe tener permiso para crear áreas de trabajo concedidas por el administrador de Fabric. Para más información, consulte Creación de áreas de trabajo.
El autor de la llamada debe tener permisos de colaborador o ser administrador de la capacidad. Para obtener más información, consulte: permisos de usuario de capacidad.
El administrador de Fabric debe tener permiso concedido a las entidades de servicio. Para obtener más información, consulte: Las entidades de servicio pueden crear áreas de trabajo, conexiones e canalizaciones de implementación.

Ámbitos delegados necesarios

Workspace.ReadWrite.All

Identidades admitidas de Microsoft Entra

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

identidad	Apoyo
Usuario	Sí
Entidad de servicio e Identidades administradas	Sí

Interfaz

POST https://api.fabric.microsoft.com/v1/workspaces

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
displayName	True	string	Nombre para mostrar del área de trabajo. El nombre para mostrar no puede contener más de 256 caracteres. Solo se permiten nombres de área de trabajo sin usar. "Supervisión del administrador" es un nombre de área de trabajo reservada.
capacityId		string (uuid)	Identificador de la capacidad a la que asignar el área de trabajo.
description		string	Descripción del área de trabajo. La descripción no puede contener más de 4000 caracteres.
domainId		string (uuid)	Identificador del dominio al que se va a asignar el área de trabajo.

Respuestas

Nombre Tipo Description

201 Created

Nombre	Tipo	Description
201 Created	Workspace	Se ha creado correctamente. Encabezados Location: string
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: DomainNotFound: no se encontró el dominio proporcionado. InsufficientPermissionsToDomain: el permiso de usuario para el dominio no es suficiente para realizar la operación. UnknownError: se produjo un error.

Workspace

Se ha creado correctamente.

Encabezados

Location: string

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:

DomainNotFound: no se encontró el dominio proporcionado.
InsufficientPermissionsToDomain: el permiso de usuario para el dominio no es suficiente para realizar la operación.
UnknownError: se produjo un error.

Ejemplos

Create a workspace example

Solicitud de ejemplo

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces

{
  "displayName": "New workspace"
}

Respuesta de muestra

status code:: 201

Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb22287ff

{
  "id": "cfafbeb1-8037-4d0c-896e-a46fb22287ff",
  "displayName": "New workspace",
  "description": "",
  "type": "Workspace",
  "capacityRegion": "West US"
}

Definiciones

Nombre	Description
CapacityRegion	Región de la capacidad asociada a esta área de trabajo. Se pueden agregar valores adicionales de región de capacidad a lo largo del tiempo.
CreateWorkspaceRequest	Cree una carga de solicitud de área de trabajo.
ErrorRelatedResource	Objeto de detalles del recurso relacionado con el error.
ErrorResponse	Respuesta de error.
ErrorResponseDetails	Detalles de la respuesta de error.
Workspace	Un objeto de área de trabajo.
WorkspaceAppliedTag	Representa una etiqueta aplicada.
WorkspaceType	Tipo de área de trabajo. Se pueden agregar tipos de área de trabajo adicionales a lo largo del tiempo.

CapacityRegion

Enumeración

Región de la capacidad asociada a esta área de trabajo. Se pueden agregar valores adicionales de región de capacidad a lo largo del tiempo.

Valor	Description
Australia East	Región Este de Australia
Australia Southeast	Región sudeste de Australia
Brazil South	Región sur de Brasil
Brazil Southeast	Región sudeste de Brasil
Canada Central	Región central de Canadá
Canada East	Región Este de Canadá
Central India	Región centro de la India
Central US	Región Centro de EE. UU.
Central US EUAP	Región EUAP centro de EE. UU.
East Asia	Región de Asia Oriental
East US	Región Este de EE. UU.
East US 2	Región Este de EE. UU. 2
France Central	Región centro de Francia
France South	Región sur de Francia
Germany Central	Región central de Alemania
Germany Northeast	Región noreste de Alemania
Israel Central	Región central de Israel
Italy North	Región norte de Italia
Japan East	Región Este de Japón
Japan West	Región Oeste de Japón
Korea Central	Región central de Corea
Korea South	Región sur de Corea
Mexico Central	Región Centro de México
North Central US	Región Centro-norte de EE. UU.
North Europe	Región norte de Europa
Norway East	Región Este de Noruega
Norway West	Región Oeste de Noruega
Poland Central	Región central de Polonia
South Africa North	Región norte de Sudáfrica
South Africa West	Región Oeste de Sudáfrica
South Central US	Región Centro-sur de EE. UU.
South India	Región Sur de la India
Southeast Asia	Región sudeste de Asia
Spain Central	Región Central de España
Sweden Central	Región central de Suecia
Switzerland North	Región norte de Suiza
Switzerland West	Región Oeste de Suiza
West Europe	Región Oeste de Europa
West India	Región oeste de la India
West US	Región Oeste de EE. UU.
West US 2	Región Oeste de EE. UU. 2
West US 3	Región Oeste de EE. UU. 3
West Central US	Región Centro-oeste de EE. UU.
UAE Central	Región central de Emiratos Árabes Unidos
UAE North	Región norte de Emiratos Árabes Unidos
Qatar Central	Región central de Qatar
Germany West Central	Región Centro-oeste de Alemania
Germany North	Región norte de Alemania
UK South	Región sur de Reino Unido
UK West	Región Oeste de Reino Unido
China North	Región norte de China
China East	Región Este de China
China East 2	Región Este de China 2
China East 3	Región Este de China 3
China North 2	Región norte de China 2
China North 3	Región norte de China 3

CreateWorkspaceRequest

Objeto

Cree una carga de solicitud de área de trabajo.

Nombre	Tipo	Description
capacityId	string (uuid)	Identificador de la capacidad a la que asignar el área de trabajo.
description	string	Descripción del área de trabajo. La descripción no puede contener más de 4000 caracteres.
displayName	string	Nombre para mostrar del área de trabajo. El nombre para mostrar no puede contener más de 256 caracteres. Solo se permiten nombres de área de trabajo sin usar. "Supervisión del administrador" es un nombre de área de trabajo reservada.
domainId	string (uuid)	Identificador del dominio al que se va a asignar el área de trabajo.

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.
isRetriable	boolean	Cuando es true, se puede reintentar la solicitud. Use el `Retry-After` encabezado de respuesta para determinar el retraso, si está disponible.
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.

Workspace

Objeto

Un objeto de área de trabajo.

Nombre	Tipo	Description
apiEndpoint	string (uri)	Dirección URL HTTP que representa el punto de conexión de API específico del área de trabajo. Este valor de punto de conexión se devuelve cuando el usuario habilita preferWorkspaceSpecificEndpoints. Permite el acceso a la API a través de vínculos privados.
capacityId	string (uuid)	Identificador de la capacidad a la que se asigna el área de trabajo.
capacityRegion	CapacityRegion	Región de la capacidad asociada a esta área de trabajo.
description	string	Descripción del área de trabajo.
displayName	string	Nombre para mostrar del área de trabajo.
domainId	string (uuid)	Identificador del dominio al que se asigna el área de trabajo.
id	string (uuid)	El identificador del área de trabajo.
tags	WorkspaceAppliedTag[]	Lista de etiquetas aplicadas.
type	WorkspaceType	Tipo de área de trabajo.

WorkspaceAppliedTag

Objeto

Representa una etiqueta aplicada.

Nombre	Tipo	Description
displayName	string	Nombre de la etiqueta.
id	string (uuid)	Identificador de etiqueta.

WorkspaceType

Enumeración

Tipo de área de trabajo. Se pueden agregar tipos de área de trabajo adicionales a lo largo del tiempo.

Valor	Description
Personal	Mi carpeta o Mi área de trabajo se usa para administrar elementos de usuario.
Workspace	Área de trabajo que se usa para administrar los elementos de Fabric.
AdminWorkspace	Área de trabajo de supervisión de administración. Contiene informes de administración, como el informe de auditoría y el informe de uso y adopción.