Автоматизация библиотек переменных с помощью API

Rest API Microsoft Fabric можно использовать для полной автоматизации управления библиотеками переменных в управлении жизненным циклом приложений (ALM).

Если вы используете API в рамках управления жизненным циклом, разрешения для ссылки на элементы проверяются во время обновления и развертывания конвейера Git.

Предпосылки

Чтобы использовать API, вам потребуется:

• Те же предварительные требования, что и для элемента библиотеки переменной.
• Токен Microsoft Entra для службы Fabric. Используйте маркер в заголовке авторизации вызова API. Сведения о том, как получить токен, см. в разделе Краткое руководство по API Fabric.

API библиотеки переменных

Rest API библиотеки переменных можно использовать для выполнения следующих функций:

• Создайте библиотеку переменных: создайте библиотеку переменных в указанной рабочей области.
• Получение библиотеки переменных: получение свойств библиотеки переменных. Можно также получить активное значение, заданное VariableLibraryProperties с помощью параметра.
• Обновление библиотеки переменных: обновление свойств библиотеки переменных. Можно также обновить активное значение с помощью VariableLibraryProperties параметра.
• Удаление библиотеки переменных: удаление указанной библиотеки переменных.
• Перечисление библиотек переменных: перечисление библиотек переменных в указанной рабочей области.
• Получение определения библиотеки переменных: получение общедоступного определения библиотеки переменных.
• Обновите определение библиотеки переменных: переопределите определение библиотеки переменных.

Интерфейсы REST API библиотеки переменных поддерживают субъекты-службы.

Примеры

Примеры использования API см. в документации REST для каждого API.

Сведения о структуре определения библиотеки переменных см. в определении библиотеки переменных.

Соображения и ограничения

Ограничения для переменных

• До 1000 переменных и до 1000 наборов значений, если вы соответствуете обоим из этих требований:

  • Общее количество ячеек в альтернативных наборах значений меньше 10 000.
  • Размер элемента не превышает 1 МБ.

  Эти требования проверяются при сохранении изменений.

• Поле заметки может содержать до 2048 символов.

• Поле описания набора значений может содержать до 2 048 символов.

Ограничения для альтернативных наборов значений

• Альтернативные наборы значений в библиотеке переменных отображаются в порядке их добавления. В настоящее время вы не можете переупорядочение их в пользовательском интерфейсе. Чтобы изменить порядок, измените JSON-файл напрямую.
• Имя каждого набора значений должно быть уникальным в библиотеке переменных.
• Имена переменных должны быть уникальными в библиотеке переменных. Вы можете иметь две переменные с одинаковым именем в рабочей области, если они в разных элементах.
• Всегда один (и только один) активный параметр, заданный в библиотеке переменных одновременно. Вы не можете удалить набор значений, пока он активен. Чтобы удалить его, сначала настройте другое значение, которое должно быть активным. Для каждого этапа конвейера развертывания можно задать другое активное значение.