Workspaces - Assign To Capacity
Atribui o workspace especificado à capacidade especificada.
Permissões
- O chamador deve ter permissões de colaborador ou ser um administrador de capacidade.
- O chamador deve ter função de administrador workspace.
Escopo necessário
Capacity.ReadWrite.All e Workspace.ReadWrite.All
Limitações
- Os itens de malha (não PowerBI) não dão suporte à migração entre regiões. Para obter mais informações, confira como mover dados.
- Workspaces com itens do Fabric (não PowerBI) só podem ser atribuídos à capacidade Fabric, Fabric ou Power BI Premium. Para obter mais informações, consulte tipos de licença do Microsoft Fabric.
Identidades com suporte do Microsoft Entra
Esta API dá suporte às identidades do Microsoft listadas nesta seção.
| Identidade | Apoio |
|---|---|
| Utilizador | Yes |
| Entidade de serviço e identidades gerenciadas | Yes |
Interfase
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/assignToCapacity
Parâmetros de URI
| Nome | Em | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
workspace
|
path | True |
string (uuid) |
O identificador do espaço de trabalho. |
Corpo da solicitação
| Nome | Obrigatório | Tipo | Description |
|---|---|---|---|
| capacityId | True |
string (uuid) |
A ID da capacidade à qual o workspace deve ser atribuído. |
Respostas
| Nome | Tipo | Description |
|---|---|---|
| 202 Accepted |
Solicitação aceita, a atribuição está em andamento. |
|
| Other Status Codes |
Códigos de erro comuns:
|
Exemplos
Assign a workspace to capacity example
Solicitação de exemplo
POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff512/assignToCapacity
{
"capacityId": "0f084df7-c13d-451b-af5f-ed0c466403b2"
}
Resposta de exemplo
Definições
| Nome | Description |
|---|---|
|
Assign |
Uma solicitação de atribuição de capacidade. |
|
Error |
O objeto de detalhes do recurso relacionado ao erro. |
|
Error |
A resposta de erro. |
|
Error |
Os detalhes da resposta de erro. |
AssignWorkspaceToCapacityRequest
Uma solicitação de atribuição de capacidade.
| Nome | Tipo | Description |
|---|---|---|
| capacityId |
string (uuid) |
A ID da capacidade à qual o workspace deve ser atribuído. |
ErrorRelatedResource
O objeto de detalhes do recurso relacionado ao erro.
| Nome | Tipo | Description |
|---|---|---|
| resourceId |
string |
A ID do recurso envolvida no erro. |
| resourceType |
string |
O tipo do recurso envolvido no erro. |
ErrorResponse
A resposta de erro.
| Nome | Tipo | Description |
|---|---|---|
| errorCode |
string |
Um identificador específico que fornece informações sobre uma condição de erro, permitindo a comunicação padronizada entre nosso serviço e seus usuários. |
| message |
string |
Uma representação legível humana do erro. |
| moreDetails |
Lista de detalhes de erro adicionais. |
|
| relatedResource |
Os detalhes do recurso relacionado ao erro. |
|
| requestId |
string |
ID da solicitação associada ao erro. |
ErrorResponseDetails
Os detalhes da resposta de erro.
| Nome | Tipo | Description |
|---|---|---|
| errorCode |
string |
Um identificador específico que fornece informações sobre uma condição de erro, permitindo a comunicação padronizada entre nosso serviço e seus usuários. |
| message |
string |
Uma representação legível humana do erro. |
| relatedResource |
Os detalhes do recurso relacionado ao erro. |