Items - Update Logical Id

Služba:

Core

Verze rozhraní API:

v1

Aktualizuje logické ID pro zadanou položku.
Odpovídající instance položek sdílejí stejné logické ID. Pomocí této operace můžete vyřešit konflikty logických ID. Před změnou logického ID zkontrolujte všechny automatizace, které spoléhají na aktuální hodnotu, a podle potřeby je aktualizujte. Jinak se tyto automatizace nemusí podařit najít položku nebo selhat z důvodu duplicitního zobrazovaného názvu. Další informace najdete v tématu Řešení konfliktů logických ID v Microsoft Fabric.

Povolení

Volající musí mít oprávnění ke čtení a zápisu položky.

Požadované delegované rozsahy

Pro rozhraní API položek použijte jeden z následujících typů oborů:

• Obecný obor: Item.ReadWrite.All.
• Konkrétní obor: itemType. ReadWrite.All (například Notebook.ReadWrite.All).

Další informace o oborech najdete v tématu Obory.

Limitations

• Logické ID nemůže být prázdný identifikátor GUID (00000000-0000-0000-0000-000000000000).
• Logické ID musí být v rámci pracovního prostoru jedinečné.
• Operace není podporována, když je v pracovním prostoru aktivní operace CI/CD.

Podporované identity v Microsoft Entra

Toto rozhraní API podporuje identity Microsoft uvedené v této části.

Identity	Podpora
User	Ano
Hlavní služba a Spravované identity	Ano

Rozhraní

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

Parametry identifikátoru URI

Název	V	Vyžadováno	Typ	Description
itemId	path	True	string (uuid)	ID položky.
workspaceId	path	True	string (uuid)	Identifikátor pracovního prostoru.

Text požadavku

Název	Vyžadováno	Typ	Description
logicalId	True	string (uuid)	Logické ID, které se má aktualizovat pro položku.

Odpovědi

Název	Typ	Description
200 OK	LogicalIdResponse	Žádost byla úspěšně dokončena.
429 Too Many Requests	ErrorResponse	Byl překročen limit přenosové rychlosti služby. Server vrátí hlavičku Retry-After udávající, kolik sekund musí klient čekat před odesláním dalších požadavků. Hlavičky Retry-After: integer
Other Status Codes	ErrorResponse	Běžné kódy chyb: ItemNotFound – Požadovaná položka nebyla nalezena. ActiveCiCdOperationInProgress – Operace CI/CD je v pracovním prostoru aktivní.

Příklady

Update logical ID example

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:

200

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

Definice

Název	Description
ErrorParameter	Strukturovaný parametr poskytující další strojově čitelný kontext chyby.
ErrorRelatedResource	Chyba související s objektem podrobností o prostředku.
ErrorResponse	Odpověď na chybu.
ErrorResponseDetails	Podrobnosti o odpovědi na chybu.
LogicalIdResponse	Odpověď logického ID
UpdateLogicalIdRequest	Aktualizujte datovou část požadavku logického ID.

ErrorParameter

Objekt

Strukturovaný parametr poskytující další strojově čitelný kontext chyby.

Název	Typ	Description
message	string	Popis významu parametru čitelný člověkem.
name	string	Identifikátor parametru.
value	string	Hodnota parametru.

ErrorRelatedResource

Objekt

Chyba související s objektem podrobností o prostředku.

Název	Typ	Description
resourceId	string	ID prostředku, které je součástí chyby.
resourceType	string	Typ prostředku, který se podílí na chybě.

ErrorResponse

Objekt

Odpověď na chybu.

Název	Typ	Description
errorCode	string	Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
isRetriable	boolean	Pokud je hodnota true, je možné požadavek opakovat. Pomocí hlavičky Retry-After odpovědi určete zpoždění, pokud je k dispozici.
message	string	Lidské čitelné vyjádření chyby.
moreDetails	ErrorResponseDetails[]	Seznam dalších podrobností o chybě
parameters	ErrorParameter[]	Strukturované parametry poskytují další strojově čitelný kontext chyby.
relatedResource	ErrorRelatedResource	Podrobnosti o prostředku souvisejícím s chybou
requestId	string (uuid)	ID požadavku přidruženého k chybě.

ErrorResponseDetails

Objekt

Podrobnosti o odpovědi na chybu.

Název	Typ	Description
errorCode	string	Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message	string	Lidské čitelné vyjádření chyby.
parameters	ErrorParameter[]	Strukturované parametry poskytují další strojově čitelný kontext chyby.
relatedResource	ErrorRelatedResource	Podrobnosti o prostředku souvisejícím s chybou

LogicalIdResponse

Objekt

Odpověď logického ID

Název	Typ	Description
logicalId	string (uuid)	Logické ID položky.

UpdateLogicalIdRequest

Objekt

Aktualizujte datovou část požadavku logického ID.

Název	Typ	Description
logicalId	string (uuid)	Logické ID, které se má aktualizovat pro položku.