Freigeben über

Workspaces - Assign To Domain

Dienst:
Core
API-Version:
v1

Weist den angegebenen Arbeitsbereich der angegebenen Domäne zu.

Erlaubnisse

  • Der Aufrufer muss über Mitwirkendeberechtigungen verfügen oder ein Domänenadministrator sein.
  • Der Anrufer muss über die Administratorrolle des Arbeitsbereichs verfügen.

Erforderlicher Bereich

Arbeitsbereich.ReadWrite.All

Von Microsoft Entra unterstützte Identitäten

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

Identität Support
Benutzer Yes
Service Principal und Verwaltete Identitäten Yes

Schnittstelle

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
workspaceId
 path True

string (uuid)

Die Arbeitsbereichs-ID.

Anforderungstext

Name Erforderlich Typ Beschreibung
domainId True

string (uuid)

Die ID der Domäne, der der Arbeitsbereich zugewiesen werden soll.

Antworten

Name Typ Beschreibung
200 OK

Die Anforderung wurde erfolgreich abgeschlossen.
Other Status Codes

ErrorResponse

Häufige Fehlercodes:

  • DomainNotFound – Die bereitgestellte Domäne wurde nicht gefunden.

  • WorkspaceNotFound – Der bereitgestellte Arbeitsbereich wurde nicht gefunden.

  • InsufficientPermissionsToDomain – Der Aufrufer verfügt nicht über ausreichende Berechtigungen für die Domäne, um den Vorgang auszuführen.

  • InsufficientWorkspaceRole – Der Aufrufer verfügt nicht über ausreichende Berechtigungen für den Arbeitsbereich, um den Vorgang auszuführen.

  • UnknownError – Ein Fehler ist aufgetreten.

Beispiele

Assign a workspace to a domain example

Beispielanforderung

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

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

Beispiel für eine Antwort

Statuscode:
200

Definitionen

Name Beschreibung
AssignWorkspaceToDomainRequest

Eine Domänenzuweisungsanforderung.
ErrorRelatedResource

Das Fehlerbezogene Ressourcendetails-Objekt.
ErrorResponse

Die Fehlerantwort.
ErrorResponseDetails

Die Fehlerantwortdetails.

AssignWorkspaceToDomainRequest

Objekt

Eine Domänenzuweisungsanforderung.

Name Typ Beschreibung
domainId

string (uuid)

Die ID der Domäne, der der Arbeitsbereich zugewiesen werden soll.

ErrorRelatedResource

Objekt

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

Objekt

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

Objekt

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.