Workloads - Create Workload Assignment

Servizio:: Admin

Versione API:: v1

Creare l'assegnazione del carico di lavoro.

Autorizzazioni

Il chiamante deve essere un amministratore Fabric o eseguire l'autenticazione usando un'entità servizio.

Ambiti delegati obbligatori

Tenant.ReadWrite.All

Limitazioni

Massimo 200 richieste all'ora.

Microsoft Entra identità supportate

Questa API supporta i Microsoft identities elencati in questa sezione.

Identità	Support
User	Sì
Principale del servizio e Identità gestite	Sì

Interfaccia

POST https://api.fabric.microsoft.com/v1/admin/workloads/assignments

Corpo della richiesta

Il corpo della richiesta può essere uno dei seguenti:

Nome	Descrizione
CreateWorkloadCapacityAssignmentRequest	Richiesta di creazione di un'assegnazione del carico di lavoro della capacità. Assegna un carico di lavoro a una capacità specifica.
CreateWorkloadTenantAssignmentRequest	Richiesta di creazione di un'assegnazione del carico di lavoro del tenant. Assegna un carico di lavoro all'intero ambito del tenant.
CreateWorkloadWorkspaceAssignmentRequest	Richiesta di creazione di un'assegnazione del carico di lavoro dell'area di lavoro. Assegna un carico di lavoro a un'area di lavoro specifica.

CreateWorkloadCapacityAssignmentRequest

Richiesta di creazione di un'assegnazione del carico di lavoro della capacità. Assegna un carico di lavoro a una capacità specifica.

Nome	Necessario	Tipo	Descrizione
capacityId	True	string (uuid)	Identificatore univoco della capacità a cui assegnare il carico di lavoro.
type	True	string: Capacity	Tipo di assegnazione da creare. Valori possibili: Capacità, Area di lavoro, Tenant.
workloadId	True	string	Identificatore univoco del carico di lavoro da assegnare.

CreateWorkloadTenantAssignmentRequest

Richiesta di creazione di un'assegnazione del carico di lavoro del tenant. Assegna un carico di lavoro all'intero ambito del tenant.

Nome	Necessario	Tipo	Descrizione
type	True	string: Tenant	Tipo di assegnazione da creare. Valori possibili: Capacità, Area di lavoro, Tenant.
workloadId	True	string	Identificatore univoco del carico di lavoro da assegnare.

CreateWorkloadWorkspaceAssignmentRequest

Richiesta di creazione di un'assegnazione del carico di lavoro dell'area di lavoro. Assegna un carico di lavoro a un'area di lavoro specifica.

Nome	Necessario	Tipo	Descrizione
type	True	string: Workspace	Tipo di assegnazione da creare. Valori possibili: Capacità, Area di lavoro, Tenant.
workloadId	True	string	Identificatore univoco del carico di lavoro da assegnare.
workspaceId	True	string (uuid)	Identificatore univoco dell'area di lavoro a cui assegnare il carico di lavoro.

Risposte

Nome Tipo Descrizione

201 Created

Nome	Tipo	Descrizione
201 Created	BaseWorkloadAssignment: WorkloadCapacityAssignment WorkloadWorkspaceAssignment WorkloadTenantAssignment	Creato. Assegnazione del carico di lavoro creata correttamente.
429 Too Many Requests	ErrorResponse	È stato superato il limite di velocità del servizio. Il server restituisce un'intestazione `Retry-After` che indica, in secondi, per quanto tempo il client deve attendere prima di inviare richieste aggiuntive. Intestazioni Retry-After: integer
Other Status Codes	ErrorResponse	Codici di errore comuni: WorkloadNotFound: non è possibile trovare l'ID del carico di lavoro specificato. PrivateLinksUnsupported: l'API non è supportata con collegamenti privati abilitati. Non autorizzato: il chiamante non dispone dell'autorizzazione per chiamare l'API. TooManyRequests: il chiamante ha superato il numero di richieste consentite nell'intervallo di tempo corrente e altre richieste avranno esito negativo. InternalServerError - Errore imprevisto del server. BadRequest: tipo di richiesta non valido, ID di capacità/area di lavoro mancanti nel corpo della richiesta, ID capacità/area di lavoro non valido ricevuto. CapacityNotFound: capacità non trovata nel tenant. WorkspaceNotFound: area di lavoro non trovata nel tenant. WorkspaceHaveNoCapacity: l'area di lavoro non ha capacità assegnata. WorkspaceHaveUnsupportedSKU: l'area di lavoro ha un livello SKU di capacità non supportato.

BaseWorkloadAssignment:

WorkloadCapacityAssignment
WorkloadWorkspaceAssignment
WorkloadTenantAssignment

Creato. Assegnazione del carico di lavoro creata correttamente.

429 Too Many Requests

ErrorResponse

È stato superato il limite di velocità del servizio. Il server restituisce un'intestazione Retry-After che indica, in secondi, per quanto tempo il client deve attendere prima di inviare richieste aggiuntive.

Intestazioni

Retry-After: integer

Other Status Codes

ErrorResponse

Codici di errore comuni:

WorkloadNotFound: non è possibile trovare l'ID del carico di lavoro specificato.
PrivateLinksUnsupported: l'API non è supportata con collegamenti privati abilitati.
Non autorizzato: il chiamante non dispone dell'autorizzazione per chiamare l'API.
TooManyRequests: il chiamante ha superato il numero di richieste consentite nell'intervallo di tempo corrente e altre richieste avranno esito negativo.
InternalServerError - Errore imprevisto del server.
BadRequest: tipo di richiesta non valido, ID di capacità/area di lavoro mancanti nel corpo della richiesta, ID capacità/area di lavoro non valido ricevuto.
CapacityNotFound: capacità non trovata nel tenant.
WorkspaceNotFound: area di lavoro non trovata nel tenant.
WorkspaceHaveNoCapacity: l'area di lavoro non ha capacità assegnata.
WorkspaceHaveUnsupportedSKU: l'area di lavoro ha un livello SKU di capacità non supportato.

Esempio

Create capacity assignment example

Create tenant assignment example

Create workspace assignment example

Create capacity assignment example

Esempio di richiesta

HTTP

POST https://api.fabric.microsoft.com/v1/admin/workloads/assignments

{
  "capacityId": "a7b12741-80ce-444a-a493-ecf92fed4ffd",
  "type": "Capacity",
  "workloadId": "Fabric.SampleWorkloadV2"
}

Risposta di esempio

Codice di stato:: 201

{
  "id": "b70c0007-6524-402c-86a2-489752e219a6",
  "type": "Capacity",
  "workloadId": "Fabric.SampleWorkloadV2",
  "capacityId": "a7b12741-80ce-444a-a493-ecf92fed4ffd",
  "capacityName": "F4 Capacity"
}

Create tenant assignment example

Esempio di richiesta

HTTP

POST https://api.fabric.microsoft.com/v1/admin/workloads/assignments

{
  "type": "Tenant",
  "workloadId": "Fabric.SampleWorkloadV2"
}

Risposta di esempio

Codice di stato:: 201

{
  "id": "07f7c957-9942-442d-83d9-d6a0f317c1c5",
  "type": "Tenant",
  "workloadId": "Fabric.SampleWorkloadV2"
}

Create workspace assignment example

Esempio di richiesta

HTTP

POST https://api.fabric.microsoft.com/v1/admin/workloads/assignments

{
  "workspaceId": "a7b12741-80ce-444a-a493-ecf92fed4ffd",
  "type": "Workspace",
  "workloadId": "Fabric.SampleWorkloadV2"
}

Risposta di esempio

Codice di stato:: 201

{
  "id": "0002665b-43c2-47ec-9f03-866e34503c35",
  "type": "Workspace",
  "workloadId": "Fabric.SampleWorkloadV2",
  "workspaceId": "a7b12741-80ce-444a-a493-ecf92fed4ffd",
  "workspaceName": "My workspace"
}

Definizioni

Nome	Descrizione
CreateWorkloadCapacityAssignmentRequest	Richiesta di creazione di un'assegnazione del carico di lavoro della capacità. Assegna un carico di lavoro a una capacità specifica.
CreateWorkloadTenantAssignmentRequest	Richiesta di creazione di un'assegnazione del carico di lavoro del tenant. Assegna un carico di lavoro all'intero ambito del tenant.
CreateWorkloadWorkspaceAssignmentRequest	Richiesta di creazione di un'assegnazione del carico di lavoro dell'area di lavoro. Assegna un carico di lavoro a un'area di lavoro specifica.
ErrorRelatedResource	Oggetto dei dettagli della risorsa relativo all'errore.
ErrorResponse	Risposta di errore.
ErrorResponseDetails	Dettagli della risposta di errore.
WorkloadAssignmentType	Tipo di assegnazione del carico di lavoro. Specifica se un carico di lavoro viene assegnato a una capacità, a un'area di lavoro o a un tenant. È possibile aggiungere altri tipi di assegnazione nel tempo.
WorkloadCapacityAssignment	Assegnazione del carico di lavoro della capacità. Rappresenta un'assegnazione di un carico di lavoro a una capacità specifica.
WorkloadTenantAssignment	Assegnazione del carico di lavoro del tenant. Rappresenta un'assegnazione di un carico di lavoro all'intero ambito del tenant.
WorkloadWorkspaceAssignment	Assegnazione del carico di lavoro dell'area di lavoro. Rappresenta un'assegnazione di un carico di lavoro a un'area di lavoro specifica.

CreateWorkloadCapacityAssignmentRequest

Oggetto

Richiesta di creazione di un'assegnazione del carico di lavoro della capacità. Assegna un carico di lavoro a una capacità specifica.

Nome	Tipo	Descrizione
capacityId	string (uuid)	Identificatore univoco della capacità a cui assegnare il carico di lavoro.
type	string: Capacity	Tipo di assegnazione da creare. Valori possibili: Capacità, Area di lavoro, Tenant.
workloadId	string	Identificatore univoco del carico di lavoro da assegnare.

CreateWorkloadTenantAssignmentRequest

Oggetto

Richiesta di creazione di un'assegnazione del carico di lavoro del tenant. Assegna un carico di lavoro all'intero ambito del tenant.

Nome	Tipo	Descrizione
type	string: Tenant	Tipo di assegnazione da creare. Valori possibili: Capacità, Area di lavoro, Tenant.
workloadId	string	Identificatore univoco del carico di lavoro da assegnare.

CreateWorkloadWorkspaceAssignmentRequest

Oggetto

Richiesta di creazione di un'assegnazione del carico di lavoro dell'area di lavoro. Assegna un carico di lavoro a un'area di lavoro specifica.

Nome	Tipo	Descrizione
type	string: Workspace	Tipo di assegnazione da creare. Valori possibili: Capacità, Area di lavoro, Tenant.
workloadId	string	Identificatore univoco del carico di lavoro da assegnare.
workspaceId	string (uuid)	Identificatore univoco dell'area di lavoro a cui assegnare il carico di lavoro.

ErrorRelatedResource

Oggetto

Oggetto dei dettagli della risorsa relativo all'errore.

Nome	Tipo	Descrizione
resourceId	string	ID risorsa coinvolto nell'errore.
resourceType	string	Tipo della risorsa coinvolta nell'errore.

ErrorResponse

Oggetto

Risposta di errore.

Nome	Tipo	Descrizione
errorCode	string	Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
isRetriable	boolean	Se true, la richiesta può essere ritentata. Usare l'intestazione della `Retry-After` risposta per determinare il ritardo, se disponibile.
message	string	Rappresentazione leggibile dell'errore.
moreDetails	ErrorResponseDetails[]	Elenco di dettagli aggiuntivi sull'errore.
relatedResource	ErrorRelatedResource	Dettagli della risorsa correlati all'errore.
requestId	string (uuid)	ID della richiesta associata all'errore.

ErrorResponseDetails

Oggetto

Dettagli della risposta di errore.

Nome	Tipo	Descrizione
errorCode	string	Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message	string	Rappresentazione leggibile dell'errore.
relatedResource	ErrorRelatedResource	Dettagli della risorsa correlati all'errore.

WorkloadAssignmentType

Enumerazione

Tipo di assegnazione del carico di lavoro. Specifica se un carico di lavoro viene assegnato a una capacità, a un'area di lavoro o a un tenant. È possibile aggiungere altri tipi di assegnazione nel tempo.

Valore	Descrizione
Capacity	Tipo di assegnazione della capacità. Il carico di lavoro viene assegnato a una capacità specifica.
Workspace	Tipo di assegnazione dell'area di lavoro. Il carico di lavoro viene assegnato a un'area di lavoro specifica.
Tenant	Tipo di assegnazione del tenant. Il carico di lavoro viene assegnato all'intero ambito del tenant.

WorkloadCapacityAssignment

Oggetto

Assegnazione del carico di lavoro della capacità. Rappresenta un'assegnazione di un carico di lavoro a una capacità specifica.

Nome	Tipo	Descrizione
capacityId	string (uuid)	Identificatore univoco della capacità a cui è assegnato il carico di lavoro.
capacityName	string	Nome visualizzato della capacità a cui è assegnato il carico di lavoro.
id	string (uuid)	Identificatore univoco dell'assegnazione.
type	string: Capacity	Tipo di assegnazione. Valori possibili: Capacità, Area di lavoro, Tenant.
workloadId	string	Identificatore univoco del carico di lavoro.

WorkloadTenantAssignment

Oggetto

Assegnazione del carico di lavoro del tenant. Rappresenta un'assegnazione di un carico di lavoro all'intero ambito del tenant.

Nome	Tipo	Descrizione
id	string (uuid)	Identificatore univoco dell'assegnazione.
type	string: Tenant	Tipo di assegnazione. Valori possibili: Capacità, Area di lavoro, Tenant.
workloadId	string	Identificatore univoco del carico di lavoro.

WorkloadWorkspaceAssignment

Oggetto

Assegnazione del carico di lavoro dell'area di lavoro. Rappresenta un'assegnazione di un carico di lavoro a un'area di lavoro specifica.

Nome	Tipo	Descrizione
id	string (uuid)	Identificatore univoco dell'assegnazione.
type	string: Workspace	Tipo di assegnazione. Valori possibili: Capacità, Area di lavoro, Tenant.
workloadId	string	Identificatore univoco del carico di lavoro.
workspaceId	string (uuid)	Identificatore univoco dell'area di lavoro a cui è assegnato il carico di lavoro.
workspaceName	string	Nome visualizzato dell'area di lavoro a cui è assegnato il carico di lavoro.