Freigeben über

Domains - Assign Domain Workspaces By Ids

Dienst:
Admin
API-Version:
v1

Weisen Sie der angegebenen Domäne Arbeitsbereiche anhand der Arbeitsbereichs-ID zu.
Bereits vorhandene Domänenzuweisungen werden außer Kraft gesetzt, es sei denn, die Massenzuweisung wird durch Domänenverwaltungsmandanteneinstellungen blockiert.

Permissions

Der Aufrufer muss ein Fabric-Administrator sein.

Erforderliche delegierte Bereiche

Tenant.ReadWrite.All.

Limitations

Maximal 10 Anforderungen pro Minute pro Prinzipal.

Von Microsoft Entra unterstützte Identitäten

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

Identity Support
User Yes
Service Principal und Verwaltete Identitäten Yes

Interface

POST https://api.fabric.microsoft.com/v1/admin/domains/{domainId}/assignWorkspaces

URI-Parameter

Name In Erforderlich Typ Beschreibung
domainId
 path True

string (uuid)

Die Domänen-ID.

Anforderungstext

Name Typ Beschreibung
workspacesIds

string[] (uuid)

Die Arbeitsbereichs-IDs, die dieser Domäne zugewiesen werden.

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.

  • UnknownError – Ein Fehler ist aufgetreten.

Beispiele

Assign domain workspaces example

Beispielanforderung

POST https://api.fabric.microsoft.com/v1/admin/domains/97dd1d38-a4c6-41ed-bc4f-1e383f8ddd0f/assignWorkspaces

{
  "workspacesIds": [
    "e8de1852-7382-480a-8404-d5b1f5e1ab65",
    "5348d3a9-c096-4074-9083-09e3ca69c8e5",
    "ac561643-c5c5-4cf1-868e-8755a90e6fa3"
  ]
}

Beispiel für eine Antwort

Statuscode:
200

Definitionen

Name Beschreibung
AssignDomainWorkspacesByIdsRequest

Die Anforderungsnutzlast zum Zuweisen von Arbeitsbereichen zu einer Domäne nach Arbeitsbereichs-ID.
ErrorRelatedResource

Das Fehlerbezogene Ressourcendetails-Objekt.
ErrorResponse

Die Fehlerantwort.
ErrorResponseDetails

Die Fehlerantwortdetails.

AssignDomainWorkspacesByIdsRequest

Objekt

Die Anforderungsnutzlast zum Zuweisen von Arbeitsbereichen zu einer Domäne nach Arbeitsbereichs-ID.

Name Typ Beschreibung
workspacesIds

string[] (uuid)

Die Arbeitsbereichs-IDs, die dieser Domäne zugewiesen werden.

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.