Freigeben über

Items - Get Mirrored Database Definition

Dienst:
MirroredDatabase
API-Version:
v1

Gibt die angegebene öffentliche Definition der gespiegelten Datenbank zurück.
Diese API unterstützt LRO-.

Erlaubnisse

Der Aufrufer muss Lese- und Schreibberechtigungen für die gespiegelte Datenbank besitzen.

Erforderliche delegierte Bereiche

MirroredDatabase.ReadWrite.All oder Item.ReadWrite.All

Von Microsoft Entra unterstützte Identitäten

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

Identität Unterstützung
Benutzer Ja
Service Principal und Verwaltete Identitäten Ja

Schnittstelle

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/mirroredDatabases/{mirroredDatabaseId}/getDefinition

URI-Parameter

Name In Erforderlich Typ Beschreibung
mirroredDatabaseId
 path True

string (uuid)

Die gespiegelte Datenbank-ID.
workspaceId
 path True

string (uuid)

Die Arbeitsbereichs-ID.

Antworten

Name Typ Beschreibung
200 OK

MirroredDatabaseDefinitionResponse

Die Anforderung wurde erfolgreich abgeschlossen.
202 Accepted

Anforderung angenommen. Das Abrufen der Definition wird ausgeführt.

Header

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
429 Too Many Requests

ErrorResponse

Der Dienstratengrenzwert wurde überschritten. Der Server gibt einen Retry-After Header zurück, der in Sekunden angibt, wie lange der Client warten muss, bevor zusätzliche Anforderungen gesendet werden.

Header

Retry-After: integer
Other Status Codes

ErrorResponse

Häufige Fehlercodes:

  • OperationNotSupportedForItem – Vorgang für angefordertes Element nicht unterstützt.

Beispiele

Get a mirrored database definition example

Beispielanforderung

POST https://api.fabric.microsoft.com/v1/workspaces/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/mirroredDatabases/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2/getDefinition

Beispiel für eine Antwort

Statuscode:
200 
{
  "definition": {
    "parts": [
      {
        "path": "mirroring.json",
        "payload": "eyAicHJvcGVydGllcy..WJsZSIgfSB9IH0gXSB9IH0",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}
Statuscode:
202 
Location: https://api.fabric.microsoft.com/v1/operations/0000aaaa-11bb-cccc-dd22-eeeeee333333
x-ms-operation-id: 0000aaaa-11bb-cccc-dd22-eeeeee333333
Retry-After: 30

Definitionen

Name Beschreibung
ErrorRelatedResource

Das Fehlerbezogene Ressourcendetails-Objekt.
ErrorResponse

Die Fehlerantwort.
ErrorResponseDetails

Die Fehlerantwortdetails.
MirroredDatabaseDefinition

Öffentliches Definitionsobjekt der gespiegelten Datenbank.
MirroredDatabaseDefinitionPart

Spiegelung des Datenbankdefinitionsteilobjekts.
MirroredDatabaseDefinitionResponse

Antwort auf die öffentliche Definition der gespiegelten Datenbank.
PayloadType

Der Typ der Definitionsteilnutzlast. Zusätzliche Nutzlasttypen können im Laufe der Zeit hinzugefügt 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 (uuid)

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.

MirroredDatabaseDefinition

Objekt

Öffentliches Definitionsobjekt der gespiegelten Datenbank.

Name Typ Beschreibung
parts

MirroredDatabaseDefinitionPart[]

Eine Liste der Definitionsteile.

MirroredDatabaseDefinitionPart

Objekt

Spiegelung des Datenbankdefinitionsteilobjekts.

Name Typ Beschreibung
path

string

Der Gespiegelte Datenbankteilpfad.
payload

string

Die Nutzlast des gespiegelten Datenbankteils.
payloadType

PayloadType

Der Nutzlasttyp.

MirroredDatabaseDefinitionResponse

Objekt

Antwort auf die öffentliche Definition der gespiegelten Datenbank.

Name Typ Beschreibung
definition

MirroredDatabaseDefinition

Öffentliches Definitionsobjekt der gespiegelten Datenbank.

PayloadType

Enumeration

Der Typ der Definitionsteilnutzlast. Zusätzliche Nutzlasttypen können im Laufe der Zeit hinzugefügt werden.

Wert Beschreibung
InlineBase64

Inlinebasis 64.