Freigeben über

Domains - List Domain Workspaces

Dienst:
Admin
API-Version:
v1

Gibt eine Liste der Arbeitsbereiche zurück, die der angegebenen Domäne zugewiesen sind.
Diese API unterstützt Paginierung.

Permissions

Der Aufrufer muss ein Fabric-Administrator sein.

Erforderliche delegierte Bereiche

Tenant.Read.All oder Tenant.ReadWrite.All.

Limitations

Maximal 25 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

GET https://api.fabric.microsoft.com/v1/admin/domains/{domainId}/workspaces
Mit optionalen Parametern: 
GET https://api.fabric.microsoft.com/v1/admin/domains/{domainId}/workspaces?continuationToken={continuationToken}

URI-Parameter

Name In Erforderlich Typ Beschreibung
domainId
 path True

string (uuid)

Die Domänen-ID.
continuationToken
 query

string

Ein Token zum Abrufen der nächsten Seite mit Ergebnissen.

Antworten

Name Typ Beschreibung
200 OK

DomainWorkspaces

Die Anforderung wurde erfolgreich abgeschlossen.
Other Status Codes

Häufige Fehlercodes:

  • UnknownError – Ein Fehler ist aufgetreten.

Beispiele

Get all domain workspaces example

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
200 
{
  "value": [
    {
      "id": "e281785b-5608-41ac-a1a1-78b48b95b825",
      "displayName": "Mark8ProjectTeam"
    },
    {
      "id": "24402490-9519-48b9-9d51-b2db4095a56b",
      "displayName": "Team southern region"
    },
    {
      "id": "46f8ccd7-a209-4e12-978f-56ef3c44a68c",
      "displayName": "SalesAndMarketing"
    }
  ],
  "continuationToken": null,
  "continuationUri": null
}

Definitionen

Name Beschreibung
DomainWorkspace

Stellt einen Arbeitsbereich in einer Domäne dar.
DomainWorkspaces

Ein Antwortwrapper für eine Liste aller Arbeitsbereiche, die einer Domäne mit einem fortlaufenden Token zugewiesen sind.

DomainWorkspace

Objekt

Stellt einen Arbeitsbereich in einer Domäne dar.

Name Typ Beschreibung
displayName

string

Der Name des Arbeitsbereichs.
id

string (uuid)

Die Arbeitsbereichs-ID.

DomainWorkspaces

Objekt

Ein Antwortwrapper für eine Liste aller Arbeitsbereiche, die einer Domäne mit einem fortlaufenden Token zugewiesen sind.

Name Typ Beschreibung
continuationToken

string

Das Token für den nächsten Resultsetbatch. Wenn keine weiteren Datensätze vorhanden sind, wird sie aus der Antwort entfernt.
continuationUri

string

Der URI des nächsten Resultsetbatches. Wenn keine weiteren Datensätze vorhanden sind, wird sie aus der Antwort entfernt.
value

DomainWorkspace[]

Die Liste aller Arbeitsbereiche, die der Domäne zugewiesen sind.