Freigeben über

Domains - Get Domain

Dienst:
Admin
API-Version:
v1

Gibt die angegebenen Domäneninformationen zurück.

Note

Diese API ist eine Version einer Vorschauversion, die am 31. März 2026 veraltet ist. Beim Aufrufen dieser API müssen Aufrufer den Abfrageparameter preview auf den Wert festlegen. false

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}?preview={preview}

URI-Parameter

Name In Erforderlich Typ Beschreibung
domainId
 path True

string (uuid)

Die Domänen-ID.
preview
 query True

boolean

Dieser Parameter gibt an, welche Version der API verwendet werden soll. Legen Sie diese Einstellung fest, false um die Version zu verwenden.

Antworten

Name Typ Beschreibung
200 OK

Domain

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

Get a domain example

Beispielanforderung

GET https://api.fabric.microsoft.com/v1/admin/domains/f2f6a374-789e-4d1d-9cc7-6e0b934fc529?preview=false

Beispiel für eine Antwort

Statuscode:
200 
{
  "id": "f2f6a374-789e-4d1d-9cc7-6e0b934fc529",
  "displayName": "Finance",
  "description": "This domain is used for identifying financial data and reports.",
  "parentDomainId": null,
  "defaultLabelId": "b2b6fdcc-f8d9-44d9-ae14-2d1fccc0a38f"
}

Definitionen

Name Beschreibung
Domain
ErrorRelatedResource

Das Fehlerbezogene Ressourcendetails-Objekt.
ErrorResponse

Die Fehlerantwort.
ErrorResponseDetails

Die Fehlerantwortdetails.

Domain

Objekt
Name Typ Beschreibung
defaultLabelId

string (uuid)

Die Standardmäßige Vertraulichkeitsbezeichnung der Domäne.
description

string

Die Beschreibung der Domäne.
displayName

string

Der Name der Domäne.
id

string (uuid)

Die Domänenobjekt-ID.
parentDomainId

string (uuid)

Die id des übergeordneten Domänenobjekts.

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.