Items - Get Mirrored Database Definition

Palvelu:: MirroredDatabase

Ohjelmointirajapinnan versio:: v1

Palauttaa määritetyn peilatun tietokannan julkisen määrityksen.
Tämä ohjelmointirajapinta tukee pitkäkestoisia toimintoja.

Oikeudet

Soittajalla on oltava peilatun tietokannan luku- ja kirjoitusoikeudet .

Vaaditut delegoidut vaikutusalueet

MirroredDatabase.ReadWrite.All tai Item.ReadWrite.All

Rajoitukset

Soittajalla on oltava riittävät käyttöoikeudet tunnisteen poistamiseen salatulla luottamuksellisuustunnisteellä suojatun peilatun tietokantakohteen määrityksen noutamiseksi, kuten Microsoft Purview on määritetty.

Microsoft Entran tukemat käyttäjätiedot

Tämä ohjelmointirajapinta tukee tässä osiossa lueteltuja Microsoft -käyttäjätietoja.

Identiteetti	Tuki
Käyttäjä	Kyllä
palvelun päänimen ja Hallittujen käyttäjätietojen	Kyllä

Käyttöliittymä

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

Valinnaisilla parametreilla:

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

URI-parametrit

Nimi	Kohteessa	Pakollinen	Tyyppi	Kuvaus
mirroredDatabaseId	path	True	string (uuid)	Peilattu tietokantatunnus.
workspaceId	path	True	string (uuid)	Työtilan tunnus.
format	query		string	Peilatun tietokannan julkisen määrityksen muoto.

Vastaukset

Nimi	Tyyppi	Kuvaus
200 OK	MirroredDatabaseDefinitionResponse	Pyynnön valmistuttua.
202 Accepted		Pyyntö hyväksytty. Määrityksen noutaminen on kesken. Otsikot Location: string x-ms-operation-id: string Retry-After: integer
429 Too Many Requests	ErrorResponse	Palveluhinnan raja ylitettiin. Palvelin palauttaa otsikon, joka `Retry-After` ilmaisee sekunteina, kuinka kauan asiakkaan on odotettava, ennen kuin lisäpyynnöt lähetetään. Otsikot Retry-After: integer
Other Status Codes	ErrorResponse	Yleiset virhekoodit: OperationNotSupportedForItem – Toimintoa ei tueta pyydetylle kohteelle.

Esimerkit

Get a mirrored database definition example

Mallipyyntö

HTTP

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

Mallivastaus

Tilakoodi:: 200

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

Tilakoodi:: 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

Määritelmät

Nimi	Kuvaus
ErrorParameter	Jäsennetty parametri, joka antaa koneluettavaa lisäkontekstia virheestä.
ErrorRelatedResource	Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse	Virhevastaus.
ErrorResponseDetails	Virheen vastauksen tiedot.
MirroredDatabaseDefinition	Peilattu tietokannan julkinen määritysobjekti. Katso tästä artikkelista lisätietoja Peilattu tietokanta -määrityksen rakenteesta.
MirroredDatabaseDefinitionPart	Peilattu tietokannan määritysosaobjekti.
MirroredDatabaseDefinitionResponse	Peilattu tietokannan julkinen määritysvastaus.
PayloadType	Määritelmäosan hyötykuorman tyyppi. Lisää hyötykuormitustyyppejä voidaan lisätä ajan kuluessa.

ErrorParameter

Kohde

Jäsennetty parametri, joka antaa koneluettavaa lisäkontekstia virheestä.

Nimi	Tyyppi	Kuvaus
message	string	Ihmisen luettavissa oleva kuvaus parametrin merkityksestä.
name	string	Parametritunniste.
value	string	Parametriarvo.

ErrorRelatedResource

Kohde

Virheeseen liittyvä resurssitieto-objekti.

Nimi	Tyyppi	Kuvaus
resourceId	string	Virheestä liittyvä resurssitunnus.
resourceType	string	Virheestä liittyvän resurssin tyyppi.

ErrorResponse

Kohde

Virhevastaus.

Nimi	Tyyppi	Kuvaus
errorCode	string	Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
isRetriable	boolean	Kun arvo on tosi, pyyntöä voidaan yrittää uudelleen. Määritä viive vastausotsikon `Retry-After` avulla, jos se on käytettävissä.
message	string	Ihmisen luettavissa oleva esitys virheestä.
moreDetails	ErrorResponseDetails[]	Luettelo virheiden lisätiedoista.
parameters	ErrorParameter[]	Jäsennettyjä parametreja, jotka antavat koneluettavaa lisäkontekstia virheestä.
relatedResource	ErrorRelatedResource	Virheisiin liittyvät resurssitiedot.
requestId	string (uuid)	Virheeseen liittyvän pyynnön tunnus.

ErrorResponseDetails

Kohde

Virheen vastauksen tiedot.

Nimi	Tyyppi	Kuvaus
errorCode	string	Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
message	string	Ihmisen luettavissa oleva esitys virheestä.
parameters	ErrorParameter[]	Jäsennettyjä parametreja, jotka antavat koneluettavaa lisäkontekstia virheestä.
relatedResource	ErrorRelatedResource	Virheisiin liittyvät resurssitiedot.

MirroredDatabaseDefinition

Kohde

Peilattu tietokannan julkinen määritysobjekti. Katso tästä artikkelista lisätietoja Peilattu tietokanta -määrityksen rakenteesta.

Nimi	Tyyppi	Kuvaus
format	string	Peilatun tietokannan määrityksen muoto.
parts	MirroredDatabaseDefinitionPart[]	Luettelo määritysosista.

MirroredDatabaseDefinitionPart

Kohde

Peilattu tietokannan määritysosaobjekti.

Nimi	Tyyppi	Kuvaus
path	string	Peilattu tietokantaosan polku.
payload	string	Peilattu tietokantaosakuormitus.
payloadType	PayloadType	Hyötykuorman tyyppi.

MirroredDatabaseDefinitionResponse

Kohde

Peilattu tietokannan julkinen määritysvastaus.

Nimi	Tyyppi	Kuvaus
definition	MirroredDatabaseDefinition	Peilattu tietokannan julkinen määritysobjekti. Katso tästä artikkelista lisätietoja Peilattu tietokanta -määrityksen rakenteesta.

PayloadType

Luettelointi

Määritelmäosan hyötykuorman tyyppi. Lisää hyötykuormitustyyppejä voidaan lisätä ajan kuluessa.

Arvo	Kuvaus
InlineBase64	Inline Base 64.