Dela via

Items - Update Mirrored Database Definition

Tjänst:
MirroredDatabase
API-version:
v1

Åsidosätter definitionen för den angivna speglade databasen.
Det här API:et stöder tidskrävande åtgärder (LRO).

Behörigheter

Anroparen måste ha läs- och skrivbehörighet för den speglade databasen.

Obligatoriska delegerade omfång

MirroredDatabase.ReadWrite.All eller Item.ReadWrite.All

Identiteter som stöds av Microsoft Entra

Det här API:et stöder Microsoft identiteter som anges i det här avsnittet.

Identitet Stöd
Användare Ja
Tjänsthuvudnamn och hanterade identiteter Ja

Gränssnitt

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

URI-parametrar

Name I Obligatorisk Typ Description
mirroredDatabaseId
 path True

string (uuid)

Det speglade databas-ID:t.
workspaceId
 path True

string (uuid)

Arbetsyte-ID.

Begärandetext

Name Obligatorisk Typ Description
definition True

MirroredDatabaseDefinition

Speglat offentligt definitionsobjekt för databasen.

Svar

Name Typ Description
200 OK

Begäran har slutförts.
202 Accepted

Begäran har godkänts. Uppdateringsdefinitionen pågår.

Sidhuvuden

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Vanliga felkoder:

  • OperationNotSupportedForItem – Åtgärden stöds inte för det begärda objektet.

  • CorruptedPayload – den angivna nyttolasten är skadad.

Exempel

Update a mirrored database definition example

Exempelbegäran

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"
      }
    ]
  }
}

Exempelsvar

Statuskod:
200
Statuskod:
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

Definitioner

Name Description
ErrorRelatedResource

Det felrelaterade resursinformationsobjektet.
ErrorResponse

Felsvaret.
ErrorResponseDetails

Information om felsvar.
MirroredDatabaseDefinition

Speglat offentligt definitionsobjekt för databasen.
MirroredDatabaseDefinitionPart

Speglat databasdefinitionsdelsobjekt.
PayloadType

Typ av definitionsdelens nyttolast. Ytterligare nyttolasttyper kan läggas till över tid.
UpdateMirroredDatabaseDefinitionRequest

Uppdatera nyttolasten för den speglade databasens offentliga definitionsbegäran.

ErrorRelatedResource

Objekt

Det felrelaterade resursinformationsobjektet.

Name Typ Description
resourceId

string

Det resurs-ID som ingår i felet.
resourceType

string

Typen av resurs som är inblandad i felet.

ErrorResponse

Objekt

Felsvaret.

Name Typ Description
errorCode

string

En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
message

string

En mänsklig läsbar representation av felet.
moreDetails

ErrorResponseDetails[]

Lista över ytterligare felinformation.
relatedResource

ErrorRelatedResource

Felrelaterad resursinformation.
requestId

string

ID för den begäran som är associerad med felet.

ErrorResponseDetails

Objekt

Information om felsvar.

Name Typ Description
errorCode

string

En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
message

string

En mänsklig läsbar representation av felet.
relatedResource

ErrorRelatedResource

Felrelaterad resursinformation.

MirroredDatabaseDefinition

Objekt

Speglat offentligt definitionsobjekt för databasen.

Name Typ Description
parts

MirroredDatabaseDefinitionPart[]

En lista över definitionsdelar.

MirroredDatabaseDefinitionPart

Objekt

Speglat databasdefinitionsdelsobjekt.

Name Typ Description
path

string

Den speglade databasdelssökvägen.
payload

string

Den speglade databasdelens nyttolast.
payloadType

PayloadType

Nyttolasttypen.

PayloadType

Uppräkning

Typ av definitionsdelens nyttolast. Ytterligare nyttolasttyper kan läggas till över tid.

Värde Description
InlineBase64

Infogad bas 64.

UpdateMirroredDatabaseDefinitionRequest

Objekt

Uppdatera nyttolasten för den speglade databasens offentliga definitionsbegäran.

Name Typ Description
definition

MirroredDatabaseDefinition

Speglat offentligt definitionsobjekt för databasen.