API'leri kullanarak değişken kitaplıklarını otomatikleştirme

Uygulama yaşam döngüsü yönetiminde (ALM) değişken kitaplıklarının yönetimini tam olarak otomatikleştirmek için Microsoft Fabric REST API'lerini kullanabilirsiniz.

API'leri yaşam döngüsü yönetiminizin bir parçası olarak kullanıyorsanız Git güncelleştirme ve işlem hattı dağıtımı sırasında öğe başvurusu izinleri denetleniyor.

Önkoşullar

API'leri kullanmak için şunları yapmanız gerekir:

• Değişken kitaplık öğesiyle aynı önkoşullar.
• Doku hizmeti için bir Microsoft Entra belirteci. API çağrısının yetkilendirme üst bilgisindeki belirteci kullanın. Token nasıl alınacağı hakkında bilgi için Fabric API hızlı başlangıç belgesine bakın.

Değişken kütüphane API'leri

Aşağıdaki işlevleri gerçekleştirmek için değişken kitaplığı REST API'lerini kullanabilirsiniz:

• Değişken kitaplığı oluşturma: Belirtilen çalışma alanında değişken kitaplığı oluşturun.
• Değişken kitaplığı alma: Değişken kitaplığının özelliklerini alma. Parametresini kullanarak VariableLibraryProperties etkin değer kümesini de alabilirsiniz.
• Değişken kitaplığını güncelleştirme: Değişken kitaplığının özelliklerini güncelleştirin. Parametresini kullanarak VariableLibraryProperties etkin değer kümesini de güncelleştirebilirsiniz.
• Değişken kitaplığını silme: Belirtilen değişken kitaplığını silin.
• Değişken kitaplıklarını listeleme: Belirtilen çalışma alanında değişken kitaplıklarını listeleyin.
• Değişken kitaplığının tanımını alma: Değişken kitaplığının genel tanımını alın.
• Değişken kitaplığının tanımını güncelleştirme: Değişken kitaplığının tanımını geçersiz kılın.

Değişken kitaplığı REST API'leri hizmet sorumlularını destekler.

Örnekler

API'lerin nasıl kullanılacağına ilişkin bazı örnekler için her API için REST belgelerine bakın.

Değişken kitaplığının tanım yapısının dökümü için bkz. Değişken kitaplığı tanımı.

Dikkat edilmesi gerekenler ve sınırlamalar

Boyut sınırlamaları

• Bu gereksinimlerin ikisini de karşıladığınız sürece en fazla1.000 değişken ve 1.000'e kadar değer kümesi olabilir:

  • Alternatif değer kümelerindeki toplam hücre sayısı 10.000'den azdır.
  • Öğenin boyutu 1 MB'ı aşmaz.

  Değişiklikleri kaydettiğinizde bu gereksinimler doğrulanır.

• Not alanında en çok 2.048 karakter olabilir.

• Değer kümesi açıklama alanında en çok 2.048 karakter olabilir.

Alternatif değer kümeleri için sınırlamalar

• Değişken kitaplığındaki alternatif değer kümeleri, bunları eklediğiniz sırada görünür. Şu anda kullanıcı arabiriminde bunları yeniden sıralayamazsınız. Sırayı değiştirmek için JSON dosyasını doğrudan düzenleyin.
• Her değer kümesinin adı bir değişken kitaplığı içinde benzersiz olmalıdır.
• Değişken adları bir değişken kitaplığı içinde benzersiz olmalıdır. Çalışma alanında farklı öğelerdeyse aynı ada sahip iki değişkeniniz olabilir.
• Değişken kitaplığında bir kerede her zaman bir (ve yalnızca bir) etkin değer ayarlanır. Etkinken bir değer kümesini silemezsiniz. Silmek için önce başka bir değer kümesini etkin olacak şekilde yapılandırın. Dağıtım işlem hattının her aşaması için farklı bir etkin değer ayarlayabilirsiniz.