Jupyrest
Jupyrest — это служба, которая может запускать записные книжки с предварительно определенными входными и выходными контрактами.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Премия | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | LivesiteAutomation |
| URL | https://github.com/microsoft/jupyrest |
| Адрес электронной почты | cosmosdbla@microsoft.com |
| Метаданные соединителя | |
|---|---|
| Publisher | Microsoft |
| Website | https://github.com/microsoft/jupyrest |
| Политика конфиденциальности | https://github.com/microsoft/jupyrest/blob/main/SECURITY.md |
| Категории | Данные |
Jupyrest — это служба, которая может запускать записные книжки с предварительно определенными входными и выходными контрактами.
Предпосылки
Для использования соединителя потребуется следующее:
- Экземпляр Juprest (установка приложения в подписке клиента)
- Приложение идентификатора Microsoft Entra
- Это клиентское приложение Microsoft Entra ID клиента Juprest для отправки запроса в службу Juprest, которая также предоставляется при создании экземпляра Juprest, приведенного выше.
Получение учетных данных
Клиентское приложение Microsoft Entra ID, созданное в предварительных требованиях, имеет доступ к экземпляру Jupyrest и будет использоваться для создания подключения соединителя Jupyrest.
Начало работы с соединителем
Вам потребуется ввести экземпляр Jupyrest, идентификатор клиента Microsoft Entra ID и секрет клиента, чтобы начать работу с соединителем.
- Для экземпляра Jupyrest используйте URL-адрес приложения-функции, например https://cdbkeplerprod.azurewebsites.net
- Для идентификатора и секрета клиента и идентификатора Microsoft Entra id используйте идентификатор Microsoft Entra, упомянутый в предварительных требованиях.
- Для ResourceUrl используйте URL-адрес приложения-функции. Например, https://cdbkeplerprod.azurewebsites.net
Известные проблемы и ограничения
"Отправка записной книжки в Synapse" не поддерживает отправку существующего выполнения записной книжки с учетом excutionId.
Распространенные ошибки и средства устранения неполадок
Обратитесь к нам в kepleruser@service.microsoft.com случае ошибок и вопросов.
Часто задаваемые вопросы
Обратитесь к нам в kepleruser@service.microsoft.com случае ошибок и вопросов.
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| Проверка подлинности субъекта-службы | Используйте собственное приложение идентификатора Microsoft Entra для проверки подлинности субъекта-службы. | Все регионы | Недоступен для совместного использования |
| По умолчанию [не рекомендуется] | Этот параметр предназначен только для старых подключений без явного типа проверки подлинности и предоставляется только для обратной совместимости. | Все регионы | Недоступен для совместного использования |
Аутентификация служебного принципала
Идентификатор проверки подлинности: oauthServicePrincipal
Применимо: все регионы
Используйте собственное приложение идентификатора Microsoft Entra для проверки подлинности субъекта-службы.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Идентификатор клиента | струна | True | |
| Секрет клиента | securestring | True | |
| Tenant | струна | True | |
| ResourceUri | струна | Ресурс, который вы запрашиваете авторизацию для использования. | True |
| Экземпляр Jupyrest | струна | True |
По умолчанию [не рекомендуется]
Применимо: все регионы
Этот параметр предназначен только для старых подключений без явного типа проверки подлинности и предоставляется только для обратной совместимости.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Запуск записной книжки |
Запустите записную книжку. |
| Отправка записной книжки в Synapse |
Отправляет записную книжку в Synapse с использованием существующего идентификатора выполнения или набора параметров. |
| Получение выполнения записной книжки |
Получение выполнения записной книжки. |
Запуск записной книжки
Запустите записную книжку.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
режим отчета
|
report | boolean |
Если значение true, верните версию отчета о результатах выполнения (без ячеек команд записной книжки). |
|
|
parameters
|
parameters | True | dynamic |
Входные параметры записной книжки. |
Возвращаемое значение
- NotebookResponse
- NotebookResponse
Отправка записной книжки в Synapse
Отправляет записную книжку в Synapse с использованием существующего идентификатора выполнения или набора параметров.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
parameters
|
parameters | dynamic |
Входные параметры записной книжки. |
Возвращаемое значение
- SynapseResponse
- SynapseResponse
Получение выполнения записной книжки
Получение выполнения записной книжки.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
идентификатор выполнения
|
executionId | True | string |
Идентификатор выполнения |
|
output
|
output | True | boolean |
Если значение true, возвращает сохраненные выходные данные записной книжки |
|
HTML
|
html | True | boolean |
Если значение true, возвращает html-код в ответе. |
|
режим отчета
|
report | boolean |
Если значение true, верните версию отчета о результатах выполнения (без ячеек команд записной книжки). |
Возвращаемое значение
- NotebookResponse
- NotebookResponse
Определения
NotebookResponse
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
id
|
id | string |
Идентификатор выполнения записной книжки |
|
статус
|
status | string |
Состояние выполнения записной книжки |
|
notebook
|
notebook | string |
Имя записной книжки |
|
parameters
|
parameters | object |
Входные параметры записной книжки |
|
output
|
output | array of |
Выходные данные выполнения записной книжки |
|
HTML
|
html | string |
Результаты записной книжки html |
|
время начала
|
start_time | string |
Время начала выполнения записной книжки |
|
время окончания
|
end_time | string |
Время окончания выполнения записной книжки |
|
исключение
|
exception | string |
Исключение выполнения записной книжки |
SynapseResponse
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
|
url | string |
URL-адрес Synapse созданной записной книжки. |