Items - Get Item

Hizmet:

Core

API Sürümü:

v1

Belirtilen öğenin özelliklerini döndürür.
Bu API bir dizi öğe türü için desteklenir, Öğe yönetimine genel bakışdesteklenen öğe türlerini bulun.

Türe özgü ek özellikleri almak için, belirli öğe türünün GET API başvuru sayfasına bakın.

İzinler

Çağıranın öğe için okuma izinlerine sahip olması gerekir.

Gerekli Temsilci Kapsamları

Öğe API'leri için şu kapsam türlerini kullanın:

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

kapsamlar hakkında daha fazla bilgi için bkz. kapsamlar makalesi.

Microsoft Entra tarafından desteklenen kimlikler

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

Kimlik	Destek
Kullanıcı	Evet
Hizmet sorumlusu ve yönetilen kimlikler	Evet

Arayüz

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

URI Parametreleri

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

Yanıtlar

Name	Tür	Description
200 OK	Item	İ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	Yaygın hata kodları: ItemNotFound - İstenen öğe bulunamadı.

Örnekler

Get an item example

Örnek isteği

HTTP

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

Örnek yanıt

Durum kodu:

200

{
  "displayName": "Item 1",
  "description": "Item 1 description",
  "type": "Lakehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}

Tanımlar

Name	Description
ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse	Hata yanıtı.
ErrorResponseDetails	Hata yanıtı ayrıntıları.
Item	Öğe nesnesi.
ItemTag	Bir öğeye uygulanan etiketi temsil eder.
ItemType	Öğenin türü. Zaman içinde ek öğe türleri eklenebilir.

ErrorRelatedResource

Nesne

Hatayla ilgili kaynak ayrıntıları nesnesi.

Name	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ı.

Name	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 okunabilir bir gösterimi.
moreDetails	ErrorResponseDetails[]	Ek hata ayrıntılarının listesi.
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ı.

Name	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 okunabilir bir gösterimi.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.

Item

Nesne

Öğe nesnesi.

Name	Tür	Description
description	string	Öğe açıklaması.
displayName	string	Öğenin görünen adı.
folderId	string (uuid)	Klasör kimliği.
id	string (uuid)	Öğe kimliği.
tags	ItemTag[]	Uygulanan etiketlerin listesi.
type	ItemType	Öğe türü.
workspaceId	string (uuid)	Çalışma alanı kimliği.

ItemTag

Nesne

Bir öğeye uygulanan etiketi temsil eder.

Name	Tür	Description
displayName	string	Etiketin adı.
id	string (uuid)	Etiket kimliği.

ItemType

Numaralandırma

Öğenin türü. Zaman içinde ek öğe türleri eklenebilir.

Değer	Description
Dashboard	PowerBI panosu.
Report	PowerBI raporu.
SemanticModel	PowerBI anlam modeli.
PaginatedReport	PowerBI sayfalandırılmış raporu.
Datamart	PowerBI datamart.
Lakehouse	Göl evi.
Eventhouse	Bir olay evi.
Environment	Bir ortam.
KQLDatabase	KQL veritabanı.
KQLQueryset	KQL sorgu kümesi.
KQLDashboard	KQL panosu.
DataPipeline	Veri işlem hattı.
Notebook	Bir not defteri.
SparkJobDefinition	Spark iş tanımı.
MLExperiment	Makine öğrenmesi denemesi.
MLModel	Makine öğrenmesi modeli.
Warehouse	Bir depo.
Eventstream	Bir olay akışı.
SQLEndpoint	Bir SQL uç noktası.
MirroredWarehouse	Aynalı bir depo.
MirroredDatabase	Yansıtılmış veritabanı.
Reflex	Bir refleks.
GraphQLApi	GraphQL öğesi için bir API.
MountedDataFactory	Bir MountedDataFactory.
SQLDatabase	A SQLDatabase.
CopyJob	Kopyalama işi.
VariableLibrary	Bir VariableLibrary.
Dataflow	Veri akışı.
ApacheAirflowJob	An ApacheAirflowJob.
WarehouseSnapshot	Ambar anlık görüntüsü.
DigitalTwinBuilder	A DigitalTwinBuilder.
DigitalTwinBuilderFlow	Dijital İkiz Oluşturucu Akışı.
MirroredAzureDatabricksCatalog	Yansıtılmış azure databricks kataloğu.
Map	Bir harita.
AnomalyDetector	Anomali Algılayıcısı.
UserDataFunction	Kullanıcı Verileri İşlevi.
GraphModel	A GraphModel.
GraphQuerySet	A Graph QuerySet.
SnowflakeDatabase	Snowflake hesabından oluşturulan Iceberg tablolarını depolamak için bir Snowflake Veritabanı.
OperationsAgent	A OperationsAgent.
CosmosDBDatabase	Cosmos DB Veritabanı.
Ontology	Bir Ontoloji.
EventSchemaSet	Bir EventSchemaSet.