Items - Get Mirrored Database Definition

Služba:

MirroredDatabase

Verze rozhraní API:

v1

Vrátí zadanou veřejnou definici zrcadlené databáze.
Toto rozhraní API podporuje dlouhotrvajících operací (LRO).

Povolení

Volající musí mít oprávnění ke čtení a zápisu pro zrcadlenou databázi.

Požadované delegovaná rozsahy

MirroredDatabase.ReadWrite.All nebo Item.ReadWrite.All

Podporované identity v Microsoft Entra

Toto rozhraní API podporuje identity Microsoft uvedené v této části.

Identita	Podpora
Uživatel	Ano
Hlavní služba a Spravované identity	Ano

Rozhraní

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
mirroredDatabaseId	path	True	string (uuid)	ID zrcadlené databáze.
workspaceId	path	True	string (uuid)	Identifikátor pracovního prostoru.

Odpovědi

Name	Typ	Description
200 OK	MirroredDatabaseDefinitionResponse	Žádost byla úspěšně dokončena.
202 Accepted		Žádost byla přijata. Probíhá načítání definice. Hlavičky Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Běžné kódy chyb: OperationNotSupportedForItem – Operace není podporována pro požadovanou položku.

Příklady

Get a mirrored database definition example

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:

200

{
  "definition": {
    "parts": [
      {
        "path": "mirroring.json",
        "payload": "eyAicHJvcGVydGllcy..WJsZSIgfSB9IH0gXSB9IH0",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

Stavový kód:

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

Definice

Name	Description
ErrorRelatedResource	Chyba související s objektem podrobností o prostředku.
ErrorResponse	Odpověď na chybu.
ErrorResponseDetails	Podrobnosti o odpovědi na chybu.
MirroredDatabaseDefinition	Zrcadlený objekt veřejné definice databáze.
MirroredDatabaseDefinitionPart	Zrcadlený objekt části definice databáze.
MirroredDatabaseDefinitionResponse	Odpověď na veřejnou definici zrcadlené databáze
PayloadType	Typ datové části definice. V průběhu času je možné přidat další typy datových částí.

ErrorRelatedResource

Objekt

Chyba související s objektem podrobností o prostředku.

Name	Typ	Description
resourceId	string	ID prostředku, které je součástí chyby.
resourceType	string	Typ prostředku, který je součástí chyby.

ErrorResponse

Objekt

Odpověď na chybu.

Name	Typ	Description
errorCode	string	Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message	string	Lidské čitelné vyjádření chyby.
moreDetails	ErrorResponseDetails[]	Seznam dalších podrobností o chybě
relatedResource	ErrorRelatedResource	Podrobnosti o prostředku souvisejícím s chybou
requestId	string	ID požadavku přidruženého k chybě.

ErrorResponseDetails

Objekt

Podrobnosti o odpovědi na chybu.

Name	Typ	Description
errorCode	string	Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message	string	Lidské čitelné vyjádření chyby.
relatedResource	ErrorRelatedResource	Podrobnosti o prostředku souvisejícím s chybou

MirroredDatabaseDefinition

Objekt

Zrcadlený objekt veřejné definice databáze.

Name	Typ	Description
parts	MirroredDatabaseDefinitionPart[]	Seznam částí definice.

MirroredDatabaseDefinitionPart

Objekt

Zrcadlený objekt části definice databáze.

Name	Typ	Description
path	string	Cesta k části zrcadlené databáze.
payload	string	Datová část zrcadlené databáze.
payloadType	PayloadType	Typ datové části.

MirroredDatabaseDefinitionResponse

Objekt

Odpověď na veřejnou definici zrcadlené databáze

Name	Typ	Description
definition	MirroredDatabaseDefinition	Zrcadlený objekt veřejné definice databáze.

PayloadType

Výčet

Typ datové části definice. V průběhu času je možné přidat další typy datových částí.

Hodnota	Description
InlineBase64	Vložená základna 64.