Jupyrest (wersja zapoznawcza)
Jupyrest to usługa, która może uruchamiać notesy ze wstępnie zdefiniowanymi kontraktami wejściowymi i wyjściowymi.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt | |
|---|---|
| Name | LivesiteAutomation |
| adres URL | https://github.com/microsoft/jupyrest |
| cosmosdbla@microsoft.com |
| Metadane łącznika | |
|---|---|
| Publisher | Microsoft |
| Witryna internetowa | https://github.com/microsoft/jupyrest |
| Zasady ochrony prywatności | https://github.com/microsoft/jupyrest/blob/main/SECURITY.md |
| Kategorie | Dane |
Jupyrest to usługa, która może uruchamiać notesy ze wstępnie zdefiniowanymi kontraktami wejściowymi i wyjściowymi.
Wymagania wstępne
Aby użyć łącznika, potrzebne będą następujące elementy:
- Wystąpienie programu Juprest (instalowanie aplikacji w ramach subskrypcji klienta)
- Aplikacja Microsoft Entra ID
- Jest to twoja aplikacja Microsoft Entra ID klienta Juprest do przesyłania żądania do usługi Juprest, która jest również udostępniana podczas tworzenia wystąpienia Juprest zgodnie z powyższym dokumentem.
Jak uzyskać poświadczenia
Aplikacja kliencka Microsoft Entra ID utworzona w wymaganiach wstępnych ma dostęp do wystąpienia jupyrest i zostanie użyta do utworzenia połączenia łącznika Jupyrest.
Wprowadzenie do łącznika
Aby rozpocząć korzystanie z łącznika, musisz wprowadzić wystąpienie programu Jupyrest, identyfikator klienta Microsoft Entra ID i klucz tajny klienta.
- W przypadku wystąpienia jupyrest użyj adresu URL aplikacji funkcji, takiego jak https://cdbkeplerprod.azurewebsites.net
- W przypadku identyfikatora klienta i wpisu tajnego entra firmy Microsoft użyj identyfikatora entra firmy Microsoft wymienionego w wymaganiach wstępnych.
- W polu ResourceUrl użyj adresu URL aplikacji funkcji. Na przykład: https://cdbkeplerprod.azurewebsites.net
Znane problemy i ograniczenia
"Przekazywanie notesu do usługi Synapse" nie obsługuje przekazywania istniejącego wykonania notesu, biorąc pod uwagę identyfikator excutionId.
Typowe błędy i środki zaradcze
Skontaktuj się z nami za pośrednictwem adresu w kepleruser@service.microsoft.com przypadku błędów i pytań.
Często zadawane pytania
Skontaktuj się z nami za pośrednictwem adresu w kepleruser@service.microsoft.com przypadku błędów i pytań.
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Uwierzytelnianie jednostki usługi | Użyj własnej aplikacji usługi Azure Active Directory do uwierzytelniania jednostki usługi. | Wszystkie regiony | Nie można udostępniać |
| Domyślne [PRZESTARZAŁE] | Ta opcja dotyczy tylko starszych połączeń bez jawnego typu uwierzytelniania i jest dostępna tylko w celu zapewnienia zgodności z poprzednimi wersjami. | Wszystkie regiony | Nie można udostępniać |
Uwierzytelnianie głównego elementu usługi
Identyfikator uwierzytelniania: oauthServicePrincipal
Dotyczy: wszystkie regiony
Użyj własnej aplikacji usługi Azure Active Directory do uwierzytelniania jednostki usługi.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| ID klienta | ciąg | Prawda | |
| Tajemnica klienta | securestring | Prawda | |
| Tenant | ciąg | Prawda | |
| ResourceUri | ciąg | Zasób, którego żądasz autoryzacji do użycia. | Prawda |
| Wystąpienie jupyrest | ciąg | Prawda |
Domyślne [PRZESTARZAŁE]
Dotyczy: wszystkie regiony
Ta opcja dotyczy tylko starszych połączeń bez jawnego typu uwierzytelniania i jest dostępna tylko w celu zapewnienia zgodności z poprzednimi wersjami.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Pobieranie wykonywania notesu |
Pobieranie wykonania notesu. |
| Przekazywanie notesu do usługi Synapse |
Przekazuje notes do usługi Synapse przy użyciu istniejącego identyfikatora wykonania lub zestawu parametrów. |
| Uruchamianie notesu |
Uruchamianie notesu. |
Pobieranie wykonywania notesu
Pobieranie wykonania notesu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
executionId
|
executionId | True | string |
Identyfikator wykonania |
|
We/Wy
|
output | True | boolean |
Jeśli wartość true, zwróć zapisane dane wyjściowe notesu |
|
html
|
html | True | boolean |
Jeśli wartość true, zwróć wynik html w odpowiedzi |
|
tryb raportu
|
report | boolean |
Jeśli wartość true, zwróć wersję raportu wyników wykonywania (bez komórek poleceń notesu). |
Zwraca
- NotesResponse
- NotebookResponse
Przekazywanie notesu do usługi Synapse
Przekazuje notes do usługi Synapse przy użyciu istniejącego identyfikatora wykonania lub zestawu parametrów.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
parameters
|
parameters | dynamic |
Parametry wejściowe notesu. |
Zwraca
- SynapseResponse
- SynapseResponse
Uruchamianie notesu
Uruchamianie notesu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
tryb raportu
|
report | boolean |
Jeśli wartość true, zwróć wersję raportu wyników wykonywania (bez komórek poleceń notesu). |
|
|
parameters
|
parameters | True | dynamic |
Parametry wejściowe notesu. |
Zwraca
- NotesResponse
- NotebookResponse
Definicje
NotesResponse
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
id
|
id | string |
identyfikator wykonywania notesu |
|
stan
|
status | string |
stan wykonywania notesu |
|
notes
|
notebook | string |
nazwa notesu |
|
parameters
|
parameters | object |
parametry wejściowe notesu |
|
We/Wy
|
output | array of |
wyniki wyjściowe wykonywania notesu |
|
html
|
html | string |
wyniki html notesu |
|
czas_rozpoczęcia
|
start_time | string |
godzina rozpoczęcia wykonywania notesu |
|
czas zakończenia
|
end_time | string |
godzina zakończenia wykonywania notesu |
|
wyjątek
|
exception | string |
wyjątek wykonywania notesu |
SynapseResponse
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
|
url | string |
Adres URL utworzonego notesu w usłudze Synapse. |