Mengotomatiskan pustaka variabel dengan menggunakan API

Anda dapat menggunakan REST API Microsoft Fabric untuk sepenuhnya mengotomatiskan manajemen pustaka variabel dalam manajemen siklus hidup aplikasi (ALM).

Jika Anda menggunakan API sebagai bagian dari manajemen siklus hidup Anda, izin untuk referensi item diperiksa selama pembaruan Git dan penyebaran alur.

Prasyarat

Untuk menggunakan API, Anda memerlukan:

• Prasyarat yang sama seperti untuk item pustaka variabel.
• Token Microsoft Entra untuk layanan Fabric. Gunakan token di header otorisasi panggilan API. Untuk informasi tentang cara mendapatkan token, lihat Panduan Memulai Fabric API.

API pustaka variabel

Anda dapat menggunakan REST API pustaka variabel untuk melakukan fungsi berikut:

• Membuat pustaka variabel: Membuat pustaka variabel di ruang kerja yang ditentukan.
• Mendapatkan pustaka variabel: Mengambil properti pustaka variabel. Anda juga dapat mengambil nilai aktif yang ditetapkan dengan menggunakan VariableLibraryProperties parameter .
• Memperbarui pustaka variabel: Memperbarui properti pustaka variabel. Anda juga dapat memperbarui nilai aktif yang ditetapkan dengan menggunakan VariableLibraryProperties parameter .
• Menghapus pustaka variabel: Hapus pustaka variabel yang ditentukan.
• Mencantumkan pustaka variabel: Mencantumkan pustaka variabel di ruang kerja yang ditentukan.
• Mendapatkan definisi pustaka variabel: Mengambil definisi publik pustaka variabel.
• Memperbarui definisi pustaka variabel: Mengambil alih definisi pustaka variabel.

REST API pustaka variabel mendukung perwakilan layanan.

Contoh

Untuk beberapa contoh cara menggunakan API, lihat dokumentasi REST untuk setiap API.

Untuk perincian struktur definisi pustaka variabel, lihat Definisi pustaka variabel.

Pertimbangan dan keterbatasan

Batasan ukuran

• Mungkin ada hingga 1.000 variabel dan hingga 1.000 set nilai, selama Anda memenuhi kedua persyaratan ini:

  • Jumlah total sel dalam set nilai alternatif kurang dari 10.000.
  • Ukuran item tidak melebihi 1 MB.

  Persyaratan ini divalidasi saat Anda menyimpan perubahan.

• Bidang catatan dapat memiliki hingga 2.048 karakter.

• Bidang deskripsi himpunan nilai dapat memiliki hingga 2.048 karakter.

Batasan untuk set nilai alternatif

• Set nilai alternatif dalam pustaka variabel muncul dalam urutan Anda menambahkannya. Saat ini, Anda tidak dapat menyusun ulang di UI. Untuk mengubah urutan, edit file JSON secara langsung.
• Nama setiap set nilai harus unik dalam pustaka variabel.
• Nama variabel harus unik dalam pustaka variabel. Anda dapat memiliki dua variabel dengan nama yang sama di ruang kerja jika berada di item yang berbeda.
• Selalu ada satu (dan hanya satu) nilai aktif yang ditetapkan dalam pustaka variabel sekaligus. Anda tidak dapat menghapus nilai yang ditetapkan saat aktif. Untuk menghapusnya, pertama-tama konfigurasikan nilai lain yang diatur menjadi aktif. Anda dapat memiliki nilai aktif yang berbeda yang ditetapkan untuk setiap tahap alur penyebaran.