Items - Create Item
Belirtilen çalışma alanında bir öğe oluşturur.
Bu API bir dizi öğe türü için desteklenir, Öğe yönetimine genel bakışdesteklenen öğe türlerini bulun. Öğe tanımı almak için Get item definition API kullanabilirsiniz.
Bu API, uzun süre çalışan işlemleri (LRO)destekler.
İzinler
Çağıranın katkıda bulunan veya daha yüksek çalışma alanı rolü olmalıdır.
Gerekli Temsilci Kapsamları
Öğe API'leri için şu kapsam türlerini 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 kapsamlar makalesine bakın.
Sınırlama
- PowerBI Fabric olmayan bir öğe oluşturmak için çalışma alanının desteklenen bir Yapı kapasitesinde olması gerekir. Daha fazla bilgi için bkz. Microsoft Fabric lisans türleri.
- PowerBI öğesi oluşturmak için kullanıcının uygun lisansa sahip olması gerekir. Daha fazla bilgi için bkz. Microsoft Fabric lisans türleri.
- Öğe oluştururken
creationPayload
veyadefinition
kullanın, ancak ikisini aynı anda kullanmayın.
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 | Çağrıdaki öğe türü desteklendiğinde. Aramanızın desteklenip desteklenmediğini görmek için çağırdığınız öğe türü için ilgili API'yi denetleyin. Örneğin, anlamsal modeller desteklenir. |
Arayüz
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
workspace
|
path | True |
string uuid |
Çalışma alanı kimliği. |
İstek Gövdesi
Name | Gerekli | Tür | Description |
---|---|---|---|
displayName | True |
string |
Öğenin görünen adı. Görünen ad, öğe türüne göre adlandırma kurallarına uymalıdır. |
type | True |
Öğe türü. |
|
creationPayload |
object |
Öğeyi oluşturmak için kullanılan bir özellik kümesi. İlgili türün Öğe Oluştur sayfası, |
|
definition |
Öğe tanımı. İlgili türün Öğe Oluştur sayfası, tanımın desteklenip desteklenmediğini gösterir ve yapısını ayrıntılarıyla açıklar.
|
||
description |
string |
Öğe açıklaması. Uzunluk üst sınırı 256 karakterdir. |
Yanıtlar
Name | Tür | Description |
---|---|---|
201 Created |
Başarıyla oluşturuldu |
|
202 Accepted |
İstek kabul edildi, öğe sağlama devam ediyor Üst Bilgiler
|
|
Other Status Codes |
Yaygın hata kodları:
|
Örnekler
Create an item example
Örnek isteği
POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items
{
"displayName": "Item 1",
"type": "Lakehouse"
}
Örnek yanıt
{
"displayName": "Item 1",
"description": "",
"type": "Lakehouse",
"workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"id": "5b218778-e7a5-4d73-8187-f10824047715"
}
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30
Tanımlar
Name | Description |
---|---|
Create |
Öğe isteği yükü oluşturun. |
Error |
Hatayla ilgili kaynak ayrıntıları nesnesi. |
Error |
Hata yanıtı. |
Error |
Hata yanıtı ayrıntıları. |
Item |
Öğe nesnesi. |
Item |
Öğe tanımı nesnesi. |
Item |
Öğe tanımı parça nesnesi. |
Item |
Öğenin türü. Zaman içinde ek öğe türleri eklenebilir. |
Payload |
Tanım parçası yükünün türü. Zaman içinde ek yük türleri eklenebilir. |
CreateItemRequest
Öğe isteği yükü oluşturun.
Name | Tür | Description |
---|---|---|
creationPayload |
object |
Öğeyi oluşturmak için kullanılan bir özellik kümesi. İlgili türün Öğe Oluştur sayfası, |
definition |
Öğe tanımı. İlgili türün Öğe Oluştur sayfası, tanımın desteklenip desteklenmediğini gösterir ve yapısını ayrıntılarıyla açıklar.
|
|
description |
string |
Öğe açıklaması. Uzunluk üst sınırı 256 karakterdir. |
displayName |
string |
Öğenin görünen adı. Görünen ad, öğe türüne göre adlandırma kurallarına uymalıdır. |
type |
Öğe türü. |
ErrorRelatedResource
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
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 |
Ek hata ayrıntılarının listesi. |
|
relatedResource |
Hatayla ilgili kaynak ayrıntıları. |
|
requestId |
string |
Hatayla ilişkili isteğin kimliği. |
ErrorResponseDetails
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 |
Hatayla ilgili kaynak ayrıntıları. |
Item
Öğe nesnesi.
Name | Tür | Description |
---|---|---|
description |
string |
Öğe açıklaması. |
displayName |
string |
Öğenin görünen adı. |
id |
string uuid |
Öğe kimliği. |
type |
Öğe türü. |
|
workspaceId |
string uuid |
Çalışma alanı kimliği. |
ItemDefinition
Öğe tanımı nesnesi.
Name | Tür | Description |
---|---|---|
format |
string |
Öğe tanımının biçimi. |
parts |
Tanım bölümlerinin listesi. |
ItemDefinitionPart
Öğe tanımı parça nesnesi.
Name | Tür | Description |
---|---|---|
path |
string |
Öğe bölümü yolu. |
payload |
string |
Öğe bölümü yükü. |
payloadType |
Yük türü. |
ItemType
Öğenin türü. Zaman içinde ek öğe türleri eklenebilir.
Değer | Description |
---|---|
Dashboard |
PowerBI panosu. |
DataPipeline |
Veri işlem hattı. |
Datamart |
PowerBI datamart. |
Environment |
Bir ortam. |
Eventhouse |
Bir olay evi. |
Eventstream |
Bir olay akışı. |
GraphQLApi |
GraphQL öğesi için bir API. |
KQLDashboard |
KQL panosu. |
KQLDatabase |
KQL veritabanı. |
KQLQueryset |
KQL sorgu kümesi. |
Lakehouse |
Göl evi. |
MLExperiment |
Makine öğrenmesi denemesi. |
MLModel |
Makine öğrenmesi modeli. |
MirroredDatabase |
Yansıtılmış veritabanı. |
MirroredWarehouse |
Aynalı bir depo. |
MountedDataFactory |
Bir MountedDataFactory. |
Notebook |
Bir not defteri. |
PaginatedReport |
PowerBI sayfalandırılmış raporu. |
Reflex |
Bir refleks. |
Report |
PowerBI raporu. |
SQLDatabase |
A SQLDatabase. |
SQLEndpoint |
Bir SQL uç noktası. |
SemanticModel |
PowerBI anlam modeli. |
SparkJobDefinition |
Spark iş tanımı. |
Warehouse |
Bir depo. |
PayloadType
Tanım parçası yükünün türü. Zaman içinde ek yük türleri eklenebilir.
Değer | Description |
---|---|
InlineBase64 |
Satır içi Temel 64. |