Items - Create Variable Library

Hizmet:: VariableLibrary

API Sürümü:: v1

Belirtilen çalışma alanında bir değişken kitaplığı oluşturur.
Bu API, uzun süre çalışan işlemleri (LRO)destekler.

Ortak bir tanım ile VariableLibrary oluşturmak için VariableLibrary makalesine bakın.

İzinler

Çağıranın katkıda bulunan çalışma alanı rolü olmalıdır.

Gerekli Temsilci Kapsamları

VariableLibrary.ReadWrite.All veya Item.ReadWrite.All

Sınırlamalar

VariableLibrary oluşturmak için çalışma alanının desteklenen bir Doku kapasitesinde olması gerekir. Daha fazla bilgi için bkz. Microsoft Fabric lisans türleri.

Microsoft Entra destekli 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

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/VariableLibraries

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	VariableLibrary görünen adı. Görünen ad, öğe türüne göre adlandırma kurallarına uymalıdır.
definition		VariableLibraryPublicDefinition	VariableLibrary genel tanımı.
description		string	VariableLibrary açıklaması. Uzunluk üst sınırı 256 karakterdir.
folderId		string (uuid)	Klasör kimliği. Belirtilmezse veya null ise, VariableLibrary çalışma alanı klasörü olarak oluşturulur.

Yanıtlar

Name	Tür	Description
201 Created	VariableLibrary	Başarıyla oluşturuldu
202 Accepted		İstek kabul edildi, VariableLibrary 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.

Name

Tür

Description

201 Created

VariableLibrary

Başarıyla oluşturuldu

202 Accepted

İstek kabul edildi, VariableLibrary 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 a VariableLibrary example

Create a VariableLibrary with public definition example

Create a VariableLibrary example

Örnek isteği

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/VariableLibraries

{
  "displayName": "VariableLibrary 1",
  "description": "A VariableLibrary description."
}

Örnek yanıt

Durum kodu:: 201

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

Durum kodu:: 202

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

Create a VariableLibrary with public definition example

Örnek isteği

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/VariableLibraries

{
  "displayName": "VariableLibrary 1",
  "description": "A VariableLibrary description.",
  "definition": {
    "format": "VariableLibraryV1",
    "parts": [
      {
        "path": "variables.json",
        "payload": "eyJleGVjdXRhYmxlRm..OWRmNDhhY2ZmZTgifQ==",
        "payloadType": "InlineBase64"
      },
      {
        "path": "valueSets/valueSet1.json",
        "payload": "eyJleGVjdXRhYmxlRm..OWRmNDhhY2ZmZTgifQ==",
        "payloadType": "InlineBase64"
      },
      {
        "path": "settings.json",
        "payload": "eyJleGVjdXRhYmxlRm..OWRmNDhhY2ZmZTgifQ==",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

Örnek yanıt

Durum kodu:: 201

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

Durum kodu:: 202

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
CreateVariableLibraryRequest	VariableLibrary istek yükü oluşturun.
ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse	Hata yanıtı.
ErrorResponseDetails	Hata yanıtı ayrıntıları.
ItemTag	Bir öğeye uygulanan etiketi temsil eder.
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.
VariableLibrary	Bir VariableLibrary nesnesi.
VariableLibraryProperties	VariableLibrary özellikleri.
VariableLibraryPublicDefinition	VariableLibrary genel tanım nesnesi. VariableLibrary genel tanımı oluşturma hakkında daha fazla bilgi için bu makaleye bakın.
VariableLibraryPublicDefinitionPart	VariableLibrary tanımı parça nesnesi.

CreateVariableLibraryRequest

Nesne

VariableLibrary istek yükü oluşturun.

Name	Tür	Description
definition	VariableLibraryPublicDefinition	VariableLibrary genel tanımı.
description	string	VariableLibrary açıklaması. Uzunluk üst sınırı 256 karakterdir.
displayName	string	VariableLibrary görünen adı. Görünen ad, öğe türüne göre adlandırma kurallarına uymalıdır.
folderId	string (uuid)	Klasör kimliği. Belirtilmezse veya null ise, VariableLibrary çalışma alanı klasörü olarak oluşturulur.

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

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.

PayloadType

Numaralandırma

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.

VariableLibrary

Nesne

Bir VariableLibrary 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.
properties	VariableLibraryProperties	VariableLibrary özellikleri.
tags	ItemTag[]	Uygulanan etiketlerin listesi.
type	ItemType	Öğe türü.
workspaceId	string (uuid)	Çalışma alanı kimliği.

VariableLibraryProperties

Nesne

VariableLibrary özellikleri.

Name	Tür	Description
activeValueSetName	string	VariableLibrary geçerli etkin değer kümesi.

VariableLibraryPublicDefinition

Nesne

VariableLibrary genel tanım nesnesi. VariableLibrary genel tanımı oluşturma hakkında daha fazla bilgi için bu makaleye bakın.

Name	Tür	Description
format	string	Öğe tanımının biçimi. Desteklenen biçim: `VariableLibraryV1`.
parts	VariableLibraryPublicDefinitionPart[]	Tanım bölümlerinin listesi.

VariableLibraryPublicDefinitionPart

Nesne

VariableLibrary tanımı parça nesnesi.

Name	Tür	Description
path	string	VariableLibrary genel tanımı bölüm yolu.
payload	string	VariableLibrary genel tanımı parça yükü.
payloadType	PayloadType	Yük türü.

Aracılığıyla paylaş

Items - Create Variable Library

İzinler

Gerekli Temsilci Kapsamları

Sınırlamalar

Microsoft Entra destekli kimlikler

Arayüz

URI Parametreleri

İstek Gövdesi

Yanıtlar

Örnekler

Create a VariableLibrary example

Örnek isteği

Örnek yanıt

Create a VariableLibrary with public definition example

Örnek isteği

Örnek yanıt

Tanımlar

CreateVariableLibraryRequest

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ItemTag

ItemType

PayloadType

VariableLibrary

VariableLibraryProperties

VariableLibraryPublicDefinition

VariableLibraryPublicDefinitionPart