Freigeben über


Workspaces - Assign To Capacity

Weist den angegebenen Arbeitsbereich der angegebenen Kapazität zu.

Erlaubnisse

  • Der Aufrufer muss Mitwirkenden Berechtigungen besitzen oder ein Kapazitätsadministrator sein.
  • Der Anrufer muss über Administratorrolle Arbeitsbereichs verfügen.

Erforderlicher Bereich

Capacity.ReadWrite.All und Workspace.ReadWrite.All

Begrenzungen

  • Fabric-Elemente (nicht PowerBI) unterstützen keine Migration über die Region hinweg. Weitere Informationen finden Sie unter Verschieben von Daten um.
  • Arbeitsbereiche mit Fabric-Elementen (nicht PowerBI) können nur Fabric-, Fabric-Testversions- oder Power BI Premium-Kapazität zugewiesen werden. Weitere Informationen finden Sie unter Microsoft Fabric-Lizenztypen.

Von Microsoft Entra unterstützte Identitäten

Diese API unterstützt die in diesem Abschnitt aufgeführten Microsoft Identitäten.

Identität Unterstützen
Benutzer Ja
Dienstprinzipal und verwaltete Identitäten Ja

Schnittstelle

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/assignToCapacity

URI-Parameter

Name In Erforderlich Typ Beschreibung
workspaceId
path True

string (uuid)

Die Arbeitsbereichs-ID.

Anforderungstext

Name Erforderlich Typ Beschreibung
capacityId True

string (uuid)

Die ID der Kapazität, der der Arbeitsbereich zugewiesen werden soll.

Antworten

Name Typ Beschreibung
202 Accepted

Anforderung angenommen, Zuordnung wird ausgeführt.

Other Status Codes

ErrorResponse

Häufige Fehlercodes:

  • UnknownError – Ein Fehler ist aufgetreten.

Beispiele

Assign a workspace to capacity example

Beispielanforderung

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff512/assignToCapacity

{
  "capacityId": "0f084df7-c13d-451b-af5f-ed0c466403b2"
}

Beispiel für eine Antwort

Definitionen

Name Beschreibung
AssignWorkspaceToCapacityRequest

Eine Kapazitätszuweisungsanforderung.

ErrorRelatedResource

Das Fehlerbezogene Ressourcendetails-Objekt.

ErrorResponse

Die Fehlerantwort.

ErrorResponseDetails

Die Fehlerantwortdetails.

AssignWorkspaceToCapacityRequest

Eine Kapazitätszuweisungsanforderung.

Name Typ Beschreibung
capacityId

string (uuid)

Die ID der Kapazität, der der Arbeitsbereich zugewiesen werden soll.

ErrorRelatedResource

Das Fehlerbezogene Ressourcendetails-Objekt.

Name Typ Beschreibung
resourceId

string

Die Ressourcen-ID, die an dem Fehler beteiligt ist.

resourceType

string

Der Typ der Ressource, die an dem Fehler beteiligt ist.

ErrorResponse

Die Fehlerantwort.

Name Typ Beschreibung
errorCode

string

Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht.

message

string

Eine lesbare Darstellung des Fehlers.

moreDetails

ErrorResponseDetails[]

Liste der zusätzlichen Fehlerdetails.

relatedResource

ErrorRelatedResource

Die fehlerbezogenen Ressourcendetails.

requestId

string

ID der Anforderung, die dem Fehler zugeordnet ist.

ErrorResponseDetails

Die Fehlerantwortdetails.

Name Typ Beschreibung
errorCode

string

Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht.

message

string

Eine lesbare Darstellung des Fehlers.

relatedResource

ErrorRelatedResource

Die fehlerbezogenen Ressourcendetails.