Items - Update Logical Id

Service:

Core

API-versie:

v1

Hiermee wordt de logische id voor het opgegeven item bijgewerkt.
Overeenkomende itemexemplaren delen dezelfde logische id. Gebruik deze bewerking om conflicten met logische id's op te lossen. Voordat u de logische id wijzigt, controleert u alle automatiseringen die afhankelijk zijn van de huidige waarde en werkt u deze indien nodig bij. Anders kunnen deze automatiseringen het item niet vinden of mislukken vanwege een dubbele weergavenaam. Zie Logische id-conflicten in Microsoft Fabric oplossen voor meer informatie.

Permissions

De aanroeper moet lees- en schrijfmachtigingen voor het item hebben.

Vereiste gedelegeerde bevoegdheden

Gebruik een van de volgende bereiktypen voor item-API's:

• Algemeen bereik: Item.ReadWrite.All.
• Specifiek bereik: itemType. ReadWrite.All (bijvoorbeeld Notebook.ReadWrite.All).

Zie Bereiken voor meer informatie over bereiken.

Limitations

• De logische id kan geen lege GUID (00000000-0000-0000-0000-000000000000) zijn.
• De logische id moet uniek zijn binnen de werkruimte.
• De bewerking wordt niet ondersteund terwijl een CI/CD-bewerking actief is in de werkruimte.

Door Microsoft Entra ondersteunde identiteiten

Deze API ondersteunt de Microsoft-identiteiten die in deze sectie worden vermeld.

Identity	Support
User	Ja
serviceprincipal en beheerde identiteiten	Ja

Interface

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

URI-parameters

Naam	In	Vereist	Type	Description
itemId	path	True	string (uuid)	De item-id.
workspaceId	path	True	string (uuid)	De werkruimte-ID.

Aanvraagbody

Naam	Vereist	Type	Description
logicalId	True	string (uuid)	De logische id die moet worden bijgewerkt voor het item.

Antwoorden

Naam	Type	Description
200 OK	LogicalIdResponse	De aanvraag is voltooid.
429 Too Many Requests	ErrorResponse	De servicesnelheidslimiet is overschreden. De server retourneert een Retry-After header die in seconden aangeeft hoe lang de client moet wachten voordat extra aanvragen worden verzonden. Kopteksten Retry-After: integer
Other Status Codes	ErrorResponse	Veelvoorkomende foutcodes: ItemNotFound : het aangevraagde item is niet gevonden. ActiveCiCdOperationInProgress: er is een CI/CD-bewerking actief in de werkruimte.

Voorbeelden

Update logical ID example

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:

200

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

Definities

Naam	Description
ErrorParameter	Een gestructureerde parameter die extra machineleesbare context biedt over een fout.
ErrorRelatedResource	Het foutgerelateerde resourcedetailsobject.
ErrorResponse	De foutreactie.
ErrorResponseDetails	De details van het foutbericht.
LogicalIdResponse	Logische id-antwoord.
UpdateLogicalIdRequest	Werk de nettolading van de logische id-aanvraag bij.

ErrorParameter

Object

Een gestructureerde parameter die extra machineleesbare context biedt over een fout.

Naam	Type	Description
message	string	Een door mensen leesbare beschrijving van de betekenis van de parameter.
name	string	De parameter-id.
value	string	De waarde van de parameter.

ErrorRelatedResource

Object

Het foutgerelateerde resourcedetailsobject.

Naam	Type	Description
resourceId	string	De resource-ID die betrokken is bij het probleem.
resourceType	string	Het type resource dat betrokken is bij de fout.

ErrorResponse

Object

De foutreactie.

Naam	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
isRetriable	boolean	Wanneer waar, kan de aanvraag opnieuw worden geprobeerd. Gebruik de Retry-After antwoordheader om de vertraging te bepalen, indien beschikbaar.
message	string	Een leesbare weergave van de fout.
moreDetails	ErrorResponseDetails[]	Lijst met aanvullende foutdetails.
parameters	ErrorParameter[]	Gestructureerde parameters die extra machineleesbare context bieden over de fout.
relatedResource	ErrorRelatedResource	Details van de foutgerelateerde resource.
requestId	string (uuid)	Id van de aanvraag die is gekoppeld aan de fout.

ErrorResponseDetails

Object

De details van het foutbericht.

Naam	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message	string	Een leesbare weergave van de fout.
parameters	ErrorParameter[]	Gestructureerde parameters die extra machineleesbare context bieden over de fout.
relatedResource	ErrorRelatedResource	Details van de foutgerelateerde resource.

LogicalIdResponse

Object

Logische id-antwoord.

Naam	Type	Description
logicalId	string (uuid)	De logische id van het item.

UpdateLogicalIdRequest

Object

Werk de nettolading van de logische id-aanvraag bij.

Naam	Type	Description
logicalId	string (uuid)	De logische id die moet worden bijgewerkt voor het item.