Items - Update Mirrored Database Definition

Služba:

MirroredDatabase

Verze rozhraní API:

v1

Přepíše definici pro zadanou zrcadlenou databázi.
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}/updateDefinition

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.

Text požadavku

Name	Vyžadováno	Typ	Description
definition	True	MirroredDatabaseDefinition	Zrcadlený objekt veřejné definice databáze.

Odpovědi

Name	Typ	Description
200 OK		Žádost byla úspěšně dokončena.
202 Accepted		Žádost byla přijata. Probíhá definice aktualizace. 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. Poškozená částPayload – zadanou datovou část je poškozena.

Příklady

Update 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/updateDefinition

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

Ukázková odpověď

Stavový kód:

200

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.
PayloadType	Typ datové části definice. V průběhu času je možné přidat další typy datových částí.
UpdateMirroredDatabaseDefinitionRequest	Aktualizujte datovou část žádosti o veřejnou definici zrcadlené databáze.

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.

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.

UpdateMirroredDatabaseDefinitionRequest

Objekt

Aktualizujte datovou část žádosti o veřejnou definici zrcadlené databáze.

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