Items - Create Variable Library

Layanan:: VariableLibrary

Versi API:: v1

Membuat pustaka variabel di ruang kerja yang ditentukan.
API ini mendukung operasi jangka panjang (LRO).

Untuk membuat VariableLibrary dengan definisi publik, lihat artikel VariableLibrary .

Hak akses

Pemanggil harus memiliki peran ruang kerja kontributor .

Cakupan yang Didelegasikan yang Diperlukan

VariableLibrary.ReadWrite.All atau Item.ReadWrite.All

Keterbatasan

Untuk membuat VariableLibrary, ruang kerja harus berada pada kapasitas Fabric yang didukung. Untuk informasi selengkapnya, lihat: jenis lisensi Microsoft Fabric.

Identitas yang didukung oleh Microsoft Entra

API ini mendukung identitas Microsoft yang tercantum di bagian ini.

Identitas	Dukungan
Pengguna	Ya
Prinsipal Layanan dan Identitas Terkelola	Ya

Antarmuka

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
workspaceId	path	True	string (uuid)	ID ruangkerja.

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
displayName	True	string	Nama tampilan VariableLibrary. Nama tampilan harus mengikuti aturan penamaan sesuai dengan jenis item.
definition		VariableLibraryPublicDefinition	Definisi publik VariableLibrary.
description		string	Deskripsi VariableLibrary. Panjang maksimum adalah 256 karakter.
folderId		string (uuid)	ID folder. Jika tidak ditentukan atau null, VariabelLibrary dibuat dengan ruang kerja sebagai foldernya.

Respons

Nama	Jenis	Deskripsi
201 Created	VariableLibrary	Berhasil dibuat
202 Accepted		Permintaan diterima, provisi VariableLibrary sedang berlangsung. Header Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Kode kesalahan umum: InvalidItemType - Tipe item tidak valid ItemDisplayNameAlreadyInUse - Nama tampilan item sudah digunakan. CorruptedPayload - Payload yang disediakan rusak.

Nama

Jenis

Deskripsi

201 Created

VariableLibrary

Berhasil dibuat

202 Accepted

Permintaan diterima, provisi VariableLibrary sedang berlangsung.

Header

Location: string
x-ms-operation-id: string
Retry-After: integer

Other Status Codes

ErrorResponse

Kode kesalahan umum:

InvalidItemType - Tipe item tidak valid
ItemDisplayNameAlreadyInUse - Nama tampilan item sudah digunakan.
CorruptedPayload - Payload yang disediakan rusak.

Contoh

Create a VariableLibrary example

Create a VariableLibrary with public definition example

Create a VariableLibrary example

Permintaan sampel

HTTP

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

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

Respon sampel

Kode status:: 201

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

Kode status:: 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

Permintaan sampel

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

Respon sampel

Kode status:: 201

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

Kode status:: 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

Definisi

Nama	Deskripsi
CreateVariableLibraryRequest	Buat payload permintaan VariableLibrary.
ErrorRelatedResource	Objek detail sumber daya terkait kesalahan.
ErrorResponse	Respons kesalahan.
ErrorResponseDetails	Detail respons kesalahan.
ItemTag	Mewakili tag yang diterapkan pada item.
ItemType	Jenis item. Jenis item tambahan dapat ditambahkan dari waktu ke waktu.
PayloadType	Jenis payload bagian definisi. Jenis payload tambahan dapat ditambahkan dari waktu ke waktu.
VariableLibrary	Objek VariableLibrary.
VariableLibraryProperties	Properti VariableLibrary.
VariableLibraryPublicDefinition	Objek definisi publik VariableLibrary. Lihat artikel ini untuk detail selengkapnya tentang cara membuat definisi publik VariableLibrary.
VariableLibraryPublicDefinitionPart	Objek bagian definisi VariabelLibrary.

CreateVariableLibraryRequest

Objek

Buat payload permintaan VariableLibrary.

Nama	Jenis	Deskripsi
definition	VariableLibraryPublicDefinition	Definisi publik VariableLibrary.
description	string	Deskripsi VariableLibrary. Panjang maksimum adalah 256 karakter.
displayName	string	Nama tampilan VariableLibrary. Nama tampilan harus mengikuti aturan penamaan sesuai dengan jenis item.
folderId	string (uuid)	ID folder. Jika tidak ditentukan atau null, VariabelLibrary dibuat dengan ruang kerja sebagai foldernya.

ErrorRelatedResource

Objek

Objek detail sumber daya terkait kesalahan.

Nama	Jenis	Deskripsi
resourceId	string	ID sumber daya yang terlibat dalam kesalahan.
resourceType	string	Jenis sumber daya yang terlibat dalam kesalahan.

ErrorResponse

Objek

Respons kesalahan.

Nama	Jenis	Deskripsi
errorCode	string	Pengidentifikasi tertentu yang menyediakan informasi tentang kondisi kesalahan, memungkinkan komunikasi standar antara layanan kami dan penggunanya.
message	string	Representasi kesalahan yang dapat dibaca manusia.
moreDetails	ErrorResponseDetails[]	Daftar detail kesalahan tambahan.
relatedResource	ErrorRelatedResource	Detail sumber daya terkait kesalahan.
requestId	string	ID permintaan yang terkait dengan kesalahan.

ErrorResponseDetails

Objek

Detail respons kesalahan.

Nama	Jenis	Deskripsi
errorCode	string	Pengidentifikasi tertentu yang menyediakan informasi tentang kondisi kesalahan, memungkinkan komunikasi standar antara layanan kami dan penggunanya.
message	string	Representasi kesalahan yang dapat dibaca manusia.
relatedResource	ErrorRelatedResource	Detail sumber daya terkait kesalahan.

ItemTag

Objek

Mewakili tag yang diterapkan pada item.

Nama	Jenis	Deskripsi
displayName	string	Nama dari tag.
id	string (uuid)	ID tag.

ItemType

Enumerasi

Jenis item. Jenis item tambahan dapat ditambahkan dari waktu ke waktu.

Nilai	Deskripsi
Dashboard	Dasbor PowerBI.
Report	Laporan PowerBI.
SemanticModel	Model semantik PowerBI.
PaginatedReport	Laporan paginasi PowerBI.
Datamart	Datamart PowerBI.
Lakehouse	Sebuah lakehouse.
Eventhouse	Sebuah rumah acara.
Environment	Lingkungan.
KQLDatabase	Database KQL.
KQLQueryset	Set kueri KQL.
KQLDashboard	Dasbor KQL.
DataPipeline	Alur data.
Notebook	Buku catatan.
SparkJobDefinition	Definisi pekerjaan spark.
MLExperiment	Eksperimen pembelajaran mesin.
MLModel	Model pembelajaran mesin.
Warehouse	Sebuah gudang.
Eventstream	Eventstream.
SQLEndpoint	Titik akhir SQL.
MirroredWarehouse	Sebuah gudang cermin.
MirroredDatabase	Database cermin.
Reflex	Sebuah Refleks.
GraphQLApi	API untuk item GraphQL.
MountedDataFactory	A MountedDataFactory.
SQLDatabase	Sebuah SQLDatabase.
CopyJob	Pekerjaan Penyalinan.
VariableLibrary	VariabelLibrary.
Dataflow	Aliran Data.
ApacheAirflowJob	An ApacheAirflowJob.
WarehouseSnapshot	Rekam jepret gudang.
DigitalTwinBuilder	Sebuah DigitalTwinBuilder.
DigitalTwinBuilderFlow	Alur Pembangun Kembar Digital.
MirroredAzureDatabricksCatalog	Katalog azure databricks cermin.
Map	Peta.
AnomalyDetector	Detektor Anomali.
UserDataFunction	Fungsi data pengguna.
GraphModel	Sebuah GraphModel.
GraphQuerySet	A Graph QuerySet.
SnowflakeDatabase	Snowflake Database untuk menyimpan tabel Iceberg yang dibuat dari akun Snowflake.
OperationsAgent	A OperationsAgent.
CosmosDBDatabase	Database Cosmos DB.
Ontology	Ontologi.
EventSchemaSet	An EventSchemaSet.

PayloadType

Enumerasi

Jenis payload bagian definisi. Jenis payload tambahan dapat ditambahkan dari waktu ke waktu.

Nilai	Deskripsi
InlineBase64	Dasar Sebaris 64.

VariableLibrary

Objek

Objek VariableLibrary.

Nama	Jenis	Deskripsi
description	string	Deskripsi item.
displayName	string	Nama tampilan item.
folderId	string (uuid)	ID folder.
id	string (uuid)	ID item.
properties	VariableLibraryProperties	Properti VariableLibrary.
tags	ItemTag[]	Daftar tag yang diterapkan.
type	ItemType	Jenis item.
workspaceId	string (uuid)	ID ruangkerja.

VariableLibraryProperties

Objek

Properti VariableLibrary.

Nama	Jenis	Deskripsi
activeValueSetName	string	Kumpulan nilai aktif saat ini VariableLibrary.

VariableLibraryPublicDefinition

Objek

Objek definisi publik VariableLibrary. Lihat artikel ini untuk detail selengkapnya tentang cara membuat definisi publik VariableLibrary.

Nama	Jenis	Deskripsi
format	string	Format definisi item. Format yang didukung: `VariableLibraryV1`.
parts	VariableLibraryPublicDefinitionPart[]	Daftar bagian definisi.

VariableLibraryPublicDefinitionPart

Objek

Objek bagian definisi VariabelLibrary.

Nama	Jenis	Deskripsi
path	string	Jalur bagian definisi publik VariableLibrary.
payload	string	Payload bagian definisi publik VariableLibrary.
payloadType	PayloadType	Jenis payload.

Bagikan melalui

Items - Create Variable Library

Hak akses

Cakupan yang Didelegasikan yang Diperlukan

Keterbatasan

Identitas yang didukung oleh Microsoft Entra

Antarmuka

Parameter URI

Isi Permintaan

Respons

Contoh

Create a VariableLibrary example

Permintaan sampel

Respon sampel

Create a VariableLibrary with public definition example

Permintaan sampel

Respon sampel

Definisi

CreateVariableLibraryRequest

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ItemTag

ItemType

PayloadType

VariableLibrary

VariableLibraryProperties

VariableLibraryPublicDefinition

VariableLibraryPublicDefinitionPart