Domains - Assign Domain Workspaces By Ids

Dienst:

Admin

API-Version:

v1

Anmerkung

Diese API befindet sich in der Vorschau.

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.

Erlaubnisse

Der Aufrufer muss ein Fabric-Administrator sein.

Erforderliche delegierte Bereiche

Tenant.ReadWrite.All.

Begrenzungen

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.

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

Schnittstelle

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

Antworten

Name	Typ	Beschreibung
200 OK		Die Anforderung wurde erfolgreich abgeschlossen.
Other Status Codes	ErrorResponse	Häufige Fehlercodes: UnknownError – Ein Fehler ist aufgetreten.

Beispiele

Assign domain workspaces example

Beispielanforderung

HTTP

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

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.