Items - Update Logical Id

Hizmet:: Core

API Sürümü:: v1

Belirtilen öğenin mantıksal kimliğini güncelleştirir.
Karşılık gelen öğe örnekleri aynı mantıksal kimliği paylaşır. Mantıksal kimlik çakışmalarını çözmek için bu işlemi kullanın. Mantıksal kimliği değiştirmeden önce, geçerli değerine dayanan tüm otomasyonları gözden geçirin ve gerektiğinde güncelleştirin. Aksi takdirde, bu otomasyonlar öğeyi bulamayabilir veya yinelenen görünen ad nedeniyle başarısız olabilir. Daha fazla bilgi için bkz. Microsoft Fabric mantıksal kimlik çakışmalarını çözme.

Permissions

Çağıranın öğe için okuma ve yazma izinleri olmalıdır.

Gerekli Devredilen Kapsamlar

Öğe API'leri için aşağıdaki kapsam türlerinden birini kullanın:

Genel kapsam: Item.ReadWrite.All.
Belirli kapsam: itemType. ReadWrite.All (örneğin, Notebook.ReadWrite.All).

Kapsamlar hakkında daha fazla bilgi için bkz. Kapsamlar.

Limitations

Mantıksal kimlik boş bir GUID (00000000-0000-0000-0000-000000000000) olamaz.
Mantıksal kimlik çalışma alanı içinde benzersiz olmalıdır.
Çalışma alanında ci/CD işlemi etkinken işlem desteklenmez.

Microsoft Entra destekli kimlikler

Bu API, bu bölümde listelenen Microsoft kimliklerini destekler.

Identity	Support
User	Evet
Hizmet sorumlusu ve yönetilen kimlikler	Evet

Arayüz

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

URI Parametreleri

Veri Akışı Adı	İçinde	Gerekli	Tür	Description
itemId	path	True	string (uuid)	Öğe kimliği.
workspaceId	path	True	string (uuid)	Çalışma alanı kimliği.

İstek Gövdesi

Veri Akışı Adı	Gerekli	Tür	Description
logicalId	True	string (uuid)	Öğe için güncelleştirilecek mantıksal kimlik.

Yanıtlar

Veri Akışı Adı Tür Description

200 OK

Veri Akışı Adı	Tür	Description
200 OK	LogicalIdResponse	İstek başarıyla tamamlandı.
429 Too Many Requests	ErrorResponse	Hizmet fiyatı sınırı aşıldı. Sunucu, istemcinin ek istek göndermeden önce ne kadar beklemesi gerektiğini saniye cinsinden belirten bir `Retry-After` üst bilgi döndürür. Üst Bilgiler Retry-After: integer
Other Status Codes	ErrorResponse	Sık karşılaşılan hata kodları: ItemNotFound - İstenen öğe bulunamadı. ActiveCiCdOperationInProgress - Çalışma alanında bir CI/CD işlemi etkindir.

LogicalIdResponse

İstek başarıyla tamamlandı.

429 Too Many Requests

ErrorResponse

Hizmet fiyatı sınırı aşıldı. Sunucu, istemcinin ek istek göndermeden önce ne kadar beklemesi gerektiğini saniye cinsinden belirten bir Retry-After üst bilgi döndürür.

Üst Bilgiler

Retry-After: integer

Other Status Codes

ErrorResponse

Sık karşılaşılan hata kodları:

ItemNotFound - İstenen öğe bulunamadı.
ActiveCiCdOperationInProgress - Çalışma alanında bir CI/CD işlemi etkindir.

Örnekler

Update logical ID example

Örnek isteği

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

Örnek yanıt

Durum kodu:: 200

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

Tanımlar

Veri Akışı Adı	Description
ErrorParameter	Bir hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametre.
ErrorRelatedResource	Hata ile ilişkili kaynak ayrıntıları nesnesi.
ErrorResponse	Hata yanıtı.
ErrorResponseDetails	Hata yanıtı ayrıntıları.
LogicalIdResponse	Mantıksal kimlik yanıtı.
UpdateLogicalIdRequest	Mantıksal kimlik isteği yükünü güncelleştirin.

ErrorParameter

Nesne

Bir hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametre.

Veri Akışı Adı	Tür	Description
message	string	Parametrenin anlamının insan tarafından okunabilen açıklaması.
name	string	Parametre tanımlayıcısı.
value	string	Parametre değeridir.

ErrorRelatedResource

Nesne

Hata ile ilişkili kaynak ayrıntıları nesnesi.

Veri Akışı Adı	Tür	Description
resourceId	string	Hataya dahil olan kaynak kimliği.
resourceType	string	Hataya dahil olan kaynağın türü.

ErrorResponse

Nesne

Hata yanıtı.

Veri Akışı Adı	Tür	Description
errorCode	string	Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
isRetriable	boolean	True olduğunda istek yeniden denenebilir. Varsa gecikmeyi `Retry-After` belirlemek için yanıt üst bilgisini kullanın.
message	string	Hatanın insan tarafından okunabilir bir temsilidir.
moreDetails	ErrorResponseDetails[]	Ek hata ayrıntılarının listesi.
parameters	ErrorParameter[]	Hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametreler.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.
requestId	string (uuid)	Hatayla ilişkili isteğin kimliği.

ErrorResponseDetails

Nesne

Hata yanıtı ayrıntıları.

Veri Akışı Adı	Tür	Description
errorCode	string	Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message	string	Hatanın insan tarafından okunabilir bir temsilidir.
parameters	ErrorParameter[]	Hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametreler.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.

LogicalIdResponse

Nesne

Mantıksal kimlik yanıtı.

Veri Akışı Adı	Tür	Description
logicalId	string (uuid)	Öğenin mantıksal kimliği.

UpdateLogicalIdRequest

Nesne

Mantıksal kimlik isteği yükünü güncelleştirin.

Veri Akışı Adı	Tür	Description
logicalId	string (uuid)	Öğe için güncelleştirilecek mantıksal kimlik.