Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Средство конвейеров развертывания Microsoft Fabric позволяет командам создавать эффективный процесс выпуска, который можно использовать повторно, для контента Fabric.
Используйте интерфейсы REST API Fabric для конвейеров развертывания, чтобы интегрировать Fabric в процесс автоматизации вашей организации. Ниже приведены несколько примеров того, что можно сделать с помощью API:
Интеграция Fabric в знакомые средства DevOps, такие как Azure DevOps или GitHub Actions.
Планирование развертываний конвейеров выполняется автоматически в определенное время.
Разверните несколько конвейеров одновременно.
Каскад в зависимости от развертываний конвейеров. Если у вас есть контент, связанный с конвейерами, можно убедиться, что одни конвейеры развертываются перед другими.
Предварительные условия
Чтобы работать с API конвейера развертывания, вам потребуется следующее:
- Те же предварительные требования необходимы для использования конвейеров развертывания.
- Токен Microsoft Entra для службы Fabric. Используйте этот маркер в заголовке авторизации вызова API. Сведения о том, как получить токен, см. в кратком руководстве по API Fabric.
Интерфейсы REST API можно использовать без PowerShell, но скрипты в этой статье используют PowerShell. Чтобы запустить скрипты, необходимо установить следующие программы:
Функции API конвейеров развертывания
REST API Fabric для потоков развертывания позволяют вам выполнять следующие функции:
Получение конвейера развертывания: Возвращает сведения об указанном конвейере развертывания.
Список конвейеров развертывания: возвращает список конвейеров развертывания, к которым у пользователя есть доступ.
Вывод этапов конвейера развертывания: Возвращает этапы указанного развертывания, включая его идентификатор, отображаемое имя, описание и информацию о том, является ли этап общедоступным.
Список элементов этапа развертывания. Возвращает поддерживаемые элементы из рабочей области, назначенной указанному этапу указанного конвейера развертывания.
Развертывание содержимого этапа: Развёртывание элементов из указанного этапа в указанном конвейере развертывания.
Используйте этот API для развертывания всех элементов или выбора определенных элементов для развертывания. Если определенные элементы не выбраны, все элементы развертываются.
Чтобы найти соответствующий идентификатор этапа для развертывания, используйте API списка этапов развертывания.
Этот API интегрирован с API длительных операций для мониторинга состояния развертывания.
- Получите состояние операции, чтобы узнать, завершена ли она, используя API Get Long Running - Get Operation State.
- Через 24 часа после завершения развертывания сведения о расширенном развертывании доступны в APIполучения результатов операции .
Создание конвейера развертывания: создание конвейера развертывания.
Удалить конвейер развертывания: Удаление конвейера развертывания.
Обновление конвейера развертывания: обновить конвейер развертывания.
Получение этапа конвейера развертывания. Получение сведений о стадии конвейера развертывания.
Обновление этапа конвейера развертывания: Обновите этап конвейера развертывания.
Добавьте назначение роли конвейера развертывания: добавьте назначение роли в конвейер развертывания.
Удаление назначения роли конвейера развертывания: Удалите назначение роли из конвейера развертывания.
Список назначений ролей конвейера развертывания: перечислить все назначения ролей для конвейера развертывания.
Назначьте рабочую область этапу конвейера развертывания: назначьте рабочую область определенному этапу конвейера развертывания.
Отмена назначения рабочей области из этапа конвейера развертывания: Снять назначение рабочей области из определенного этапа конвейера развертывания.
Получение операции конвейера развертывания. Получение сведений о операции конвейера развертывания.
Перечислить операции конвейера развертывания: перечислить все операции конвейера развертывания.
Для выполнения связанных операций можно также использовать другие вызовы REST API Fabric .
Примеры для PowerShell
Чтобы понять, как выполнять несколько процессов автоматизации, можно использовать следующие скрипты PowerShell. Чтобы просмотреть или скопировать текст в примере PowerShell, используйте ссылки в этом разделе.
Вы также можете скачать всю Fabric-Samples
папку GitHub.
-
Введите следующую информацию:
- Имя конвейера
- Название исходного этапа
- Название целевого этапа
- Заметки о развертывании (необязательно)
- Тип субъекта. Выберите UserPrincipal или ServicePrincipal. Если субъект-служба, также предоставьте следующее:
- Идентификатор приложения (клиента) субъекта-службы
- Идентификатор каталога (клиента) субъекта-службы
- Значение секрета субъекта-службы
-
Введите следующую информацию:
- Имя конвейера
- Название исходного этапа
- Название целевого этапа
- Элементы для развертывания (отображаемое имя элементов и тип элемента)
- Заметки о развертывании (необязательно)
- Тип субъекта. Выберите UserPrincipal или ServicePrincipal. Если это service principal, также предоставьте:
- Идентификатор приложения (клиента) субъекта-службы
- Идентификатор каталога (клиента) субъекта-службы
- Значение секрета служебного принципала
Назначьте новому конвейеру развертывания и разверните
Введите следующую информацию:
- Идентификатор рабочей области разработки
- Новое имя рабочей рабочей области
- Имя конвейера
- Заметки о развертывании (необязательно)
- Тип субъекта. Выберите UserPrincipal или ServicePrincipal. Если основной сервис, также предоставьте следующее:
- Идентификатор приложения (клиента) субъекта-службы
- Идентификатор каталога (клиента) субъекта-службы
- Значение секрета идентификатора службы
Рекомендации и ограничения
При использовании API конвейеров развертывания рассмотрите следующие ограничения:
Все ограничения, которые применяются к конвейеру развертывания, применяются при использовании API. Дополнительные сведения см. в рекомендациях по конвейерам развертывания.
Потоки данных в настоящее время не поддерживаются. Клиенты, использующие потоки данных, могут использовать API Power BI.
В Fabric доступны не все варианты развертывания, доступные в API Power BI. Следующие API недоступны в API контента этапа развертывания Fabric:
- allowPurgeData
- allowTakeOver
- разрешить пропускать плитки с отсутствующими предварительными условиями
Чтобы использовать один из этих API, используйте API Power BI для развертывания. Однако эти API работают только для элементов Power BI.