Items - Update Logical Id

Palvelu:

Core

Ohjelmointirajapinnan versio:

v1

Päivittää määritetyn kohteen loogisen tunnuksen.
Vastaavilla kohdeesiintymillä on sama looginen tunnus. Tämän toiminnon avulla voit ratkaista loogisia tunnusristiriitoja. Tarkista ennen loogisen tunnuksen muuttamista kaikki automaatiot, jotka ovat riippuvaisia sen nykyisestä arvosta, ja päivitä ne tarvittaessa. Muussa tapauksessa nämä automaatiot eivät välttämättä löydä kohdetta tai epäonnistuvat näyttönimen kaksoiskappaleen vuoksi. Lisätietoja on artikkelissa Loogisten tunnusten ristiriitojen ratkaiseminen Microsoft Fabric.

Käyttöoikeudet

Soittajalla on oltava kohteen luku- ja kirjoitusoikeudet .

Vaaditut delegoidut vaikutusalueet

Käytä kohteen ohjelmointirajapinnoille jotain seuraavista vaikutusaluetyypeistä:

• Yleinen vaikutusalue: Item.ReadWrite.All.
• Tietty vaikutusalue: itemType. ReadWrite.All (esimerkiksi Notebook.ReadWrite.All).

Katso lisätietoja vaikutusalueista kohdasta Alueet.

Rajoitukset

• Looginen tunnus ei voi olla tyhjä GUID-tunnus (00000000-0000-0000-0000-000000000000).
• Loogisen tunnuksen on oltava yksilöllinen työtilassa.
• Toimintoa ei tueta, kun CI/CD-toiminto on aktiivinen työtilassa.

tuettujen käyttäjätietojen Microsoft Entra

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

Käyttäjätiedot	Tuki
Käyttäjä	Yes
palvelun päänimen ja Hallittujen käyttäjätietojen	Yes

Käyttöliittymä

PATCH https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/logicalId

URI-parametrit

Nimi	Kohteessa	Pakollinen	Tyyppi	Kuvaus
itemId	path	True	string (uuid)	Kohdetunnus.
workspaceId	path	True	string (uuid)	Työtilan tunnus.

Pyynnön leipäteksti

Nimi	Pakollinen	Tyyppi	Kuvaus
logicalId	True	string (uuid)	Kohteen looginen tunnus, joka päivitetään.

Vastaukset

Nimi	Tyyppi	Kuvaus
200 OK	LogicalIdResponse	Pyynnön valmistuttua.
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: ItemNotFound – Pyydettyä kohdetta ei löytynyt. ActiveCiCdOperationInProgress – CI/CD-toiminto on aktiivinen työtilassa.

Esimerkit

Update logical ID example

Mallipyyntö

HTTP

PATCH https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/5b218778-e7a5-4d73-8187-f10824047715/logicalId

{
  "logicalId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
}

Mallivastaus

Tilakoodi:

200

{
  "logicalId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
}

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.
LogicalIdResponse	Loogisen tunnuksen vastaus.
UpdateLogicalIdRequest	Päivitä loogisen tunnuksen pyynnön tiedot.

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.

LogicalIdResponse

Kohde

Loogisen tunnuksen vastaus.

Nimi	Tyyppi	Kuvaus
logicalId	string (uuid)	Kohteen looginen tunnus.

UpdateLogicalIdRequest

Kohde

Päivitä loogisen tunnuksen pyynnön tiedot.

Nimi	Tyyppi	Kuvaus
logicalId	string (uuid)	Kohteen looginen tunnus, joka päivitetään.