Aracılığıyla paylaş


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 veya definitionkullanı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
workspaceId
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

ItemType

Öğe türü.

creationPayload

object

Öğeyi oluşturmak için kullanılan bir özellik kümesi. İlgili türün Öğe Oluştur sayfası, creationPayload desteklenip desteklenmediğini gösterir ve öğenin özelliklerini listeler. creationPayload veya definitionkullanın. İkisini de aynı anda kullanamazsınız.

definition

ItemDefinition

Öğ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. definition veya creationPayloadkullanın. İkisini de aynı anda kullanamazsınız.

description

string

Öğe açıklaması. Uzunluk üst sınırı 256 karakterdir.

Yanıtlar

Name Tür Description
201 Created

Item

Başarıyla oluşturuldu

202 Accepted

İstek kabul edildi, öğe sağlama devam ediyor

Üst Bilgiler

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Yaygın hata kodları:

  • InvalidItemType - Öğe türü geçersiz.

  • ItemDisplayNameAlreadyInUse - Öğe görünen adı zaten kullanılıyor.

  • BozukPayload - Sağlanan yük bozuk

Ö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
CreateItemRequest

Öğe isteği yükü oluşturun.

ErrorRelatedResource

Hatayla ilgili kaynak ayrıntıları nesnesi.

ErrorResponse

Hata yanıtı.

ErrorResponseDetails

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

Item

Öğe nesnesi.

ItemDefinition

Öğe tanımı nesnesi.

ItemDefinitionPart

Öğe tanımı parça nesnesi.

ItemType

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

PayloadType

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ı, creationPayload desteklenip desteklenmediğini gösterir ve öğenin özelliklerini listeler. creationPayload veya definitionkullanın. İkisini de aynı anda kullanamazsınız.

definition

ItemDefinition

Öğ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. definition veya creationPayloadkullanın. İkisini de aynı anda kullanamazsınız.

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

ItemType

Öğ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

ErrorResponseDetails[]

Ek hata ayrıntılarının listesi.

relatedResource

ErrorRelatedResource

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

ErrorRelatedResource

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

ItemType

Öğ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

ItemDefinitionPart[]

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

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.