Compartir a través de

Workspaces - Create Workspace

Servicio:
Core
Versión de la API:
v1

Crea una nueva área de trabajo.

Permisos

Á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

Workspace

Se ha creado correctamente.

Encabezados

Location: string
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

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"
}

Definiciones

Nombre Description
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.
WorkspaceType

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

CreateWorkspaceRequest

Object

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

Object

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

Object

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

Identificador de la solicitud asociada al error.

ErrorResponseDetails

Object

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

Object

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.
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.
type

WorkspaceType

Tipo de área de trabajo.

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.