Udostępnij przez

Workspaces - Assign To Domain

Usługa:
Core
Wersja interfejsu API:
v1

Przypisuje określony obszar roboczy do określonej domeny.

Permissions

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

Wymagany zakres

Przestrzeń robocza.OdczytZapis.Wszystko

Tożsamości obsługiwane przez Microsoft Entra

To API obsługuje tożsamości Microsoft wymienione w tej sekcji.

Tożsamość Support
User Tak
Główne usługi i Tożsamości zarządzane Tak

Interfejs

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
workspaceId
 path True

string (uuid)

Identyfikator przestrzeni roboczej.

Treść żądania

Nazwa Wymagane Typ Opis
domainId True

string (uuid)

Identyfikator domeny, do której powinien zostać przypisany obszar roboczy.

Odpowiedzi

Nazwa Typ Opis
200 OK

Żądanie zostało ukończone pomyślnie.
Other Status Codes

ErrorResponse

Typowe kody błędów:

  • DomainNotFound — nie znaleziono podanej domeny

  • WorkspaceNotFound — nie znaleziono podanego obszaru roboczego

  • InsufficientPermissionsToDomain — obiekt wywołujący nie ma wystarczających uprawnień do domeny, aby wykonać operację

  • InsufficientWorkspaceRole — obiekt wywołujący nie ma wystarczających uprawnień do obszaru roboczego, aby wykonać operację

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

Przykłady

Assign a workspace to a domain example

Przykładowe żądanie

POST https://api.fabric.microsoft.com/v1/workspaces/f97451ca-d6a0-482f-a46a-cc4b2c48ba56/assignToDomain

{
  "domainId": "9d04ca81-bb30-4009-bd1a-a9213a4c8d75"
}

Przykładowa odpowiedź

Kod stanu:
200

Definicje

Nazwa Opis
AssignWorkspaceToDomainRequest

Żądanie przypisania domeny.
ErrorRelatedResource

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

Odpowiedź na błąd.
ErrorResponseDetails

Szczegóły odpowiedzi na błąd.

AssignWorkspaceToDomainRequest

Objekt

Żądanie przypisania domeny.

Nazwa Typ Opis
domainId

string (uuid)

Identyfikator domeny, do której powinien zostać przypisany obszar roboczy.

ErrorRelatedResource

Objekt

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

Nazwa 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.

Nazwa 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.
moreDetails

ErrorResponseDetails[]

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

ErrorRelatedResource

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

string

Identyfikator żądania skojarzonego z błędem.

ErrorResponseDetails

Objekt

Szczegóły odpowiedzi na błąd.

Nazwa 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.
relatedResource

ErrorRelatedResource

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