Workspaces - Assign To Capacity

Usługa:
Core
Wersja interfejsu API:
v1

Przypisuje określony obszar roboczy do określonej pojemności.

Uprawnienia

  • Obiekt wywołujący musi mieć uprawnienia współautora lub być administratorem pojemności.
  • Obiekt wywołujący musi mieć rolę administratora obszaru roboczego.

Wymagany zakres

Capacity.ReadWrite.All i Workspace.ReadWrite.All

Ograniczenia

  • Elementy sieci szkieletowej (inne niż PowerBI) nie obsługują migracji między regionami. Aby uzyskać więcej informacji, zobacz przenoszenia danych wokół.
  • Obszary robocze z elementami sieci szkieletowej (spoza usługi PowerBI) można przypisywać tylko do pojemności sieci szkieletowej, wersji próbnej sieci szkieletowej lub usługi Power BI Premium. Aby uzyskać więcej informacji, zobacz typy licencji usługi Microsoft Fabric.

Tożsamości obsługiwane przez firmę Microsoft

Ten interfejs API obsługuje tożsamości firmy Microsoft wymienione w tej sekcji.

Tożsamość Wsparcie
Użytkownik Tak
jednostki usługi i tożsamości zarządzanych Tak

Interfejs

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

Parametry identyfikatora URI

Nazwisko W Wymagane Typ Opis
workspaceId
 path True

string (uuid)

Identyfikator obszaru roboczego.

Treść żądania

Nazwisko Wymagane Typ Opis
capacityId True

string (uuid)

Identyfikator pojemności, do której powinien zostać przypisany obszar roboczy.

Odpowiedzi

Nazwisko Typ Opis
202 Accepted

Żądanie zaakceptowane, przypisanie jest w toku.
429 Too Many Requests

ErrorResponse

Przekroczono limit szybkości usługi. Serwer zwraca nagłówek wskazujący Retry-After w sekundach, jak długo klient musi czekać przed wysłaniem dodatkowych żądań.

Nagłówki

Retry-After: integer
Other Status Codes

ErrorResponse

Typowe kody błędów:

  • UnknownError — wystąpił błąd.

Przykłady

Assign a workspace to capacity example

Przykładowe żądanie

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

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

Przykładowa odpowiedź

Kod stanu:
202

Definicje

Nazwisko Opis
AssignWorkspaceToCapacityRequest

Żądanie przypisania pojemności.
ErrorParameter

Parametr ustrukturyzowany zapewniający dodatkowy kontekst czytelny dla maszyny o błędzie.
ErrorRelatedResource

Obiekt szczegółów zasobu powiązanego z błędem.
ErrorResponse

Odpowiedź na błąd.
ErrorResponseDetails

Szczegóły odpowiedzi na błąd.

AssignWorkspaceToCapacityRequest

Objekt

Żądanie przypisania pojemności.

Nazwisko Typ Opis
capacityId

string (uuid)

Identyfikator pojemności, do której powinien zostać przypisany obszar roboczy.

ErrorParameter

Objekt

Parametr ustrukturyzowany zapewniający dodatkowy kontekst czytelny dla maszyny o błędzie.

Nazwisko Typ Opis
message

string

Czytelny dla człowieka opis znaczenia parametru.
name

string

Identyfikator parametru.
value

string

Wartość parametru.

ErrorRelatedResource

Objekt

Obiekt szczegółów zasobu powiązanego z błędem.

Nazwisko Typ Opis
resourceId

string

Identyfikator zasobu, który jest zaangażowany w błąd.
resourceType

string

Typ zasobu, który jest zaangażowany w błąd.

ErrorResponse

Objekt

Odpowiedź na błąd.

Nazwisko Typ Opis
errorCode

string

Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.
isRetriable

boolean

Jeśli to prawda, żądanie można ponowić. Użyj nagłówka Retry-After odpowiedzi, aby określić opóźnienie, jeśli jest dostępne.
message

string

Czytelna reprezentacja błędu przez człowieka.
moreDetails

ErrorResponseDetails[]

Lista dodatkowych szczegółów błędu.
parameters

ErrorParameter[]

Parametry ustrukturyzowane zapewniające dodatkowy kontekst czytelny dla maszyny o błędzie.
relatedResource

ErrorRelatedResource

Szczegóły zasobu powiązanego z błędem.
requestId

string (uuid)

Identyfikator żądania skojarzonego z błędem.

ErrorResponseDetails

Objekt

Szczegóły odpowiedzi na błąd.

Nazwisko Typ Opis
errorCode

string

Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.
message

string

Czytelna reprezentacja błędu przez człowieka.
parameters

ErrorParameter[]

Parametry ustrukturyzowane zapewniające dodatkowy kontekst czytelny dla maszyny o błędzie.
relatedResource

ErrorRelatedResource

Szczegóły zasobu powiązanego z błędem.