Partilhar via

Workspaces - Create Workspace

Serviço:
Core
Versão da API:
v1

Cria um novo espaço de trabalho.

Permissões

Escopos delegados necessários

Workspace.ReadWrite.All

Identidades suportadas pelo Entra da Microsoft

Esta API suporta as identidades do Microsoft listadas nesta secção.

Identidade Apoio
Utilizador Sim
Entidade de serviço e identidades geridas Sim

Interfaz

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

Corpo do Pedido

Name Necessário Tipo Description
displayName True

string

O nome de exibição do espaço de trabalho.
O nome para exibição não pode conter mais de 256 caracteres.
Apenas nomes de espaços de trabalho não utilizados são permitidos.
"Monitoramento de administrador" é um nome de espaço de trabalho reservado.
capacityId

string (uuid)

A ID da capacidade para atribuir o espaço de trabalho.
description

string

A descrição do espaço de trabalho.
A descrição não pode conter mais de 4000 caracteres.
domainId

string (uuid)

A ID do domínio ao qual atribuir o espaço de trabalho.

Respostas

Name Tipo Description
201 Created

Workspace

Criado com sucesso.

Cabeçalhos

Location: string
Other Status Codes

ErrorResponse

Códigos de erro comuns:

  • DomainNotFound - O domínio fornecido não foi encontrado

  • InsufficientPermissionsToDomain - A permissão do usuário para o domínio não é suficiente para executar a operação

  • UnknownError - Ocorreu um erro.

Exemplos

Create a workspace example

Pedido de amostra

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

{
  "displayName": "New workspace"
}

Resposta da amostra

Código de estado:
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"
}

Definições

Name Description
CreateWorkspaceRequest

Crie carga útil de solicitação de espaço de trabalho.
ErrorRelatedResource

O objeto de detalhes do recurso relacionado ao erro.
ErrorResponse

A resposta de erro.
ErrorResponseDetails

Os detalhes da resposta de erro.
Workspace

Um objeto de espaço de trabalho.
WorkspaceType

Um tipo de espaço de trabalho. Tipos de espaço de trabalho adicionais podem ser adicionados ao longo do tempo.

CreateWorkspaceRequest

Object

Crie carga útil de solicitação de espaço de trabalho.

Name Tipo Description
capacityId

string (uuid)

A ID da capacidade para atribuir o espaço de trabalho.
description

string

A descrição do espaço de trabalho.
A descrição não pode conter mais de 4000 caracteres.
displayName

string

O nome de exibição do espaço de trabalho.
O nome para exibição não pode conter mais de 256 caracteres.
Apenas nomes de espaços de trabalho não utilizados são permitidos.
"Monitoramento de administrador" é um nome de espaço de trabalho reservado.
domainId

string (uuid)

A ID do domínio ao qual atribuir o espaço de trabalho.

ErrorRelatedResource

Object

O objeto de detalhes do recurso relacionado ao erro.

Name Tipo Description
resourceId

string

A ID do recurso envolvida no erro.
resourceType

string

O tipo de recurso envolvido no erro.

ErrorResponse

Object

A resposta de erro.

Name Tipo Description
errorCode

string

Um identificador específico que fornece informações sobre uma condição de erro, permitindo uma comunicação padronizada entre nosso serviço e seus usuários.
message

string

Uma representação legível por humanos do erro.
moreDetails

ErrorResponseDetails[]

Lista de detalhes de erro adicionais.
relatedResource

ErrorRelatedResource

Os detalhes do recurso relacionados ao erro.
requestId

string

ID da solicitação associada ao erro.

ErrorResponseDetails

Object

Os detalhes da resposta de erro.

Name Tipo Description
errorCode

string

Um identificador específico que fornece informações sobre uma condição de erro, permitindo uma comunicação padronizada entre nosso serviço e seus usuários.
message

string

Uma representação legível por humanos do erro.
relatedResource

ErrorRelatedResource

Os detalhes do recurso relacionados ao erro.

Workspace

Object

Um objeto de espaço de trabalho.

Name Tipo Description
apiEndpoint

string (uri)

URL HTTP que representa o ponto de extremidade da API específico para o espaço de trabalho. Esse valor de ponto de extremidade é retornado quando o usuário habilita preferWorkspaceSpecificEndpoints. Ele permite o acesso à API através de links privados.
capacityId

string (uuid)

A ID da capacidade à qual o espaço de trabalho é atribuído.
description

string

A descrição do espaço de trabalho.
displayName

string

O nome de exibição do espaço de trabalho.
domainId

string (uuid)

A ID do domínio ao qual o espaço de trabalho é atribuído.
id

string (uuid)

O ID do espaço de trabalho.
type

WorkspaceType

O tipo de espaço de trabalho.

WorkspaceType

Enumeração

Um tipo de espaço de trabalho. Tipos de espaço de trabalho adicionais podem ser adicionados ao longo do tempo.

Valor Description
Personal

Minha pasta ou Meu espaço de trabalho usado para gerenciar itens de usuário.
Workspace

Espaço de trabalho usado para gerenciar os itens de malha.
AdminWorkspace

Espaço de trabalho de monitoramento de administrador. Contém relatórios administrativos, como o relatório de auditoria e o relatório de uso e adoção.