Items - Update Logical Id

Tjeneste:: Core

API-versjon:: v1

Oppdaterer den logiske IDen for det angitte elementet.
Tilsvarende elementforekomster deler samme logiske ID. Bruk denne operasjonen til å løse logiske ID-konflikter. Før du endrer den logiske ID-en, kan du se gjennom eventuelle automatiseringer som er avhengige av gjeldende verdi og oppdatere dem etter behov. Ellers kan det hende at disse automatiseringene ikke finner elementet eller mislykkes på grunn av et duplisert visningsnavn. Hvis du vil ha mer informasjon, kan du se Løse logiske ID-konflikter i Microsoft Fabric.

Tillatelser

Innringeren må ha lese- og skrivetillatelser for elementet.

Nødvendige delegerte omfang

Bruk én av følgende omfangstyper for element-API-er:

Generelt omfang: Item.ReadWrite.All.
Bestemt omfang: itemType. ReadWrite.All (for eksempel Notebook.ReadWrite.All).

Hvis du vil ha mer informasjon om omfang, kan du se Omfang.

Limitations

Den logiske IDen kan ikke være en tom GUID (00000000-0000-0000-0000-000000000000).
Den logiske IDen må være unik i arbeidsområdet.
Operasjonen støttes ikke mens en CI/CD-operasjon er aktiv i arbeidsområdet.

Microsoft Entra støttede identiteter

Denne API-en støtter Microsoft -identiteter oppført i denne delen.

Identitet	Kundestøtte
Bruker	Ja
tjenestekontohaver og administrerte identiteter	Ja

Grensesnitt

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

URI-parametere

Name	I	Obligatorisk	Type	Beskrivelse
itemId	path	True	string (uuid)	Element-ID-en.
workspaceId	path	True	string (uuid)	Arbeidsområde-ID-en.

Brødtekst for forespørsel

Name	Obligatorisk	Type	Beskrivelse
logicalId	True	string (uuid)	Den logiske IDen som skal oppdateres for elementet.

Svar

Name Type Beskrivelse

200 OK

Name	Type	Beskrivelse
200 OK	LogicalIdResponse	Forespørselen er fullført.
429 Too Many Requests	ErrorResponse	Grensen for tjenestesats ble overskredet. Serveren returnerer en `Retry-After` topptekst som angir, i sekunder, hvor lenge klienten må vente før du sender flere forespørsler. Overskrifter Retry-After: integer
Other Status Codes	ErrorResponse	Vanlige feilkoder: ItemNotFound – Finner ikke det forespurte elementet. ActiveCiCdOperationInProgress – en CI/CD-operasjon er aktiv i arbeidsområdet.

LogicalIdResponse

Forespørselen er fullført.

429 Too Many Requests

ErrorResponse

Grensen for tjenestesats ble overskredet. Serveren returnerer en Retry-After topptekst som angir, i sekunder, hvor lenge klienten må vente før du sender flere forespørsler.

Overskrifter

Retry-After: integer

Other Status Codes

ErrorResponse

Vanlige feilkoder:

ItemNotFound – Finner ikke det forespurte elementet.
ActiveCiCdOperationInProgress – en CI/CD-operasjon er aktiv i arbeidsområdet.

Eksempler

Update logical ID example

Eksempelforespørsel

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

Eksempelsvar

Statuskode:: 200

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

Definisjoner

Name	Beskrivelse
ErrorParameter	En strukturert parameter som gir ekstra maskinlesbar kontekst om en feil.
ErrorRelatedResource	Objektet for feilrelaterte ressursdetaljer.
ErrorResponse	Feilsvaret.
ErrorResponseDetails	Feilsvardetaljene.
LogicalIdResponse	Logisk ID-svar.
UpdateLogicalIdRequest	Oppdater nyttelast for logisk ID-forespørsel.

ErrorParameter

Objekt

En strukturert parameter som gir ekstra maskinlesbar kontekst om en feil.

Name	Type	Beskrivelse
message	string	En lesbar beskrivelse av parameterens betydning.
name	string	Parameteridentifikatoren.
value	string	Parameterverdien.

ErrorRelatedResource

Objekt

Objektet for feilrelaterte ressursdetaljer.

Name	Type	Beskrivelse
resourceId	string	Ressurs-ID-en som er involvert i feilen.
resourceType	string	Typen ressurs som er involvert i feilen.

ErrorResponse

Objekt

Feilsvaret.

Name	Type	Beskrivelse
errorCode	string	En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
isRetriable	boolean	Når sann, kan forespørselen prøves på nytt. `Retry-After` Bruk svarhodet til å fastslå forsinkelsen, hvis tilgjengelig.
message	string	En menneskelig lesbar representasjon av feilen.
moreDetails	ErrorResponseDetails[]	Liste over flere feildetaljer.
parameters	ErrorParameter[]	Strukturerte parametere som gir ekstra maskinlesbar kontekst om feilen.
relatedResource	ErrorRelatedResource	Feilrelaterte ressursdetaljer.
requestId	string (uuid)	ID for forespørselen som er knyttet til feilen.

ErrorResponseDetails

Objekt

Feilsvardetaljene.

Name	Type	Beskrivelse
errorCode	string	En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
message	string	En menneskelig lesbar representasjon av feilen.
parameters	ErrorParameter[]	Strukturerte parametere som gir ekstra maskinlesbar kontekst om feilen.
relatedResource	ErrorRelatedResource	Feilrelaterte ressursdetaljer.

LogicalIdResponse

Objekt

Logisk ID-svar.

Name	Type	Beskrivelse
logicalId	string (uuid)	Den logiske ID-en for elementet.

UpdateLogicalIdRequest

Objekt

Oppdater nyttelast for logisk ID-forespørsel.

Name	Type	Beskrivelse
logicalId	string (uuid)	Den logiske IDen som skal oppdateres for elementet.