Jupirest (preview)
Jupirest is een service waarmee notebooks kunnen worden uitgevoerd met vooraf gedefinieerde invoer- en uitvoercontracten.
Deze connector is beschikbaar in de volgende producten en regio's:
| Dienst | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Logic-apps | Standaard | Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure Government-regio's - Azure China-regio's - Us Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Contactpersoon | |
|---|---|
| Naam | LivesiteAutomation |
| URL | https://github.com/microsoft/jupyrest |
| E-mailen | cosmosdbla@microsoft.com |
| Connector-metagegevens | |
|---|---|
| Uitgever | Microsoft |
| Webpagina | https://github.com/microsoft/jupyrest |
| Privacybeleid | https://github.com/microsoft/jupyrest/blob/main/SECURITY.md |
| Categorieën | Gegevens |
Jupirest is een service waarmee notebooks kunnen worden uitgevoerd met vooraf gedefinieerde invoer- en uitvoercontracten.
Vereiste voorwaarden
U hebt het volgende nodig om de connector te gebruiken:
- Een Juprest-exemplaar (de app installeren op klantabonnement)
- Een Microsoft Entra ID-toepassing
- Dit is uw Juprest-client Microsoft Entra ID-app voor het indienen van een aanvraag bij de Juprest-service, die ook wordt verstrekt wanneer u uw Juprest-exemplaar maakt volgens het bovenstaande document.
Referenties ophalen
Uw Microsoft Entra ID-client-app die in de vereisten is gemaakt, heeft de toegang tot uw Jupirest-exemplaar en wordt gebruikt om een verbinding van de Jupirest-connector te maken.
Aan de slag met uw connector
U moet uw Jupirest-exemplaar, de Client-id van Microsoft Entra ID en het clientgeheim invoeren om de connector te kunnen gaan gebruiken.
- Voor het Jupirest-exemplaar gebruikt u de URL van uw functie-app, zoals https://cdbkeplerprod.azurewebsites.net
- Gebruik voor de Client-id en het geheim van Microsoft Entra ID de Microsoft Entra-id die wordt vermeld in de vereisten.
- Gebruik voor ResourceUrl de URL van uw functie-app. bijvoorbeeld https://cdbkeplerprod.azurewebsites.net
Bekende problemen en beperkingen
Het uploaden van een notebook naar Synapse biedt geen ondersteuning voor het uploaden van een bestaande notebookuitvoering op basis van een excutionId.
Veelvoorkomende fouten en oplossingen
Neem contact met ons op in kepleruser@service.microsoft.com geval van fouten en vragen.
Veelgestelde vragen
Neem contact met ons op in kepleruser@service.microsoft.com geval van fouten en vragen.
Een verbinding maken
De connector ondersteunt de volgende verificatietypen:
| service principal-authenticatie | Gebruik uw eigen Azure Active Directory-app voor service-principal-verificatie. | Alle regio's | Niet deelbaar |
| Standaard [AFGESCHAFT] | Deze optie is alleen bedoeld voor oudere verbindingen zonder expliciet verificatietype en is alleen beschikbaar voor compatibiliteit met eerdere versies. | Alle regio's | Niet deelbaar |
Authenticatie van service-principal
Verificatie-id: oauthServicePrincipal
Van toepassing: Alle regio's
Gebruik uw eigen Azure Active Directory-app voor service-principal-verificatie.
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
| Naam | Typologie | Description | Verplicht |
|---|---|---|---|
| Klant-ID | touw | Klopt | |
| Clientgeheim | beveiligde string | Klopt | |
| Tenant | touw | Klopt | |
| ResourceUri | touw | De resource die u aanvraagt om autorisatie te gebruiken. | Klopt |
| Jupirest exemplaar | touw | Klopt |
Standaard [AFGESCHAFT]
Van toepassing: Alle regio's
Deze optie is alleen bedoeld voor oudere verbindingen zonder expliciet verificatietype en is alleen beschikbaar voor compatibiliteit met eerdere versies.
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
Beperkingslimieten
| Name | Aanroepen | Verlengingsperiode |
|---|---|---|
| API-aanroepen per verbinding | 100 | 60 seconden |
Acties
| Een notebook uitvoeren |
Voer een notebook uit. |
| Een notebook uploaden naar Synapse |
Uploadt een notebook naar Synapse op basis van een bestaande uitvoerings-id of een set parameters. |
| Een notebookuitvoering ophalen |
Een notebookuitvoering ophalen. |
Een notebook uitvoeren
Voer een notebook uit.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
rapportmodus
|
report | boolean |
Indien waar, retourneert u de rapportversie van uitvoeringsresultaten (zonder notebookopdrachtcellen). |
|
|
parameters
|
parameters | True | dynamic |
Invoerparameters voor notebooks. |
Retouren
- NotebookResponse
- NotebookResponse
Een notebook uploaden naar Synapse
Uploadt een notebook naar Synapse op basis van een bestaande uitvoerings-id of een set parameters.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
parameters
|
parameters | dynamic |
Invoerparameters voor notebooks. |
Retouren
- SynapseResponse
- SynapseResponse
Een notebookuitvoering ophalen
Een notebookuitvoering ophalen.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
uitvoeringsId
|
executionId | True | string |
Uitvoerings-id |
|
output
|
output | True | boolean |
Indien waar, retourneert u de opgeslagen uitvoer van het notitieblok |
|
html
|
html | True | boolean |
Als waar, retourneert u html-resultaat in het antwoord |
|
rapportmodus
|
report | boolean |
Indien waar, retourneert u de rapportversie van uitvoeringsresultaten (zonder notebookopdrachtcellen). |
Retouren
- NotebookResponse
- NotebookResponse
Definities
NotebookResponse
| Name | Pad | Type | Description |
|---|---|---|---|
|
identiteitskaart
|
id | string |
uitvoerings-id van notebook |
|
status
|
status | string |
uitvoeringsstatus van notebook |
|
notebook
|
notebook | string |
naam van notitieblok |
|
parameters
|
parameters | object |
notebookinvoerparameters |
|
output
|
output | array of |
uitvoerresultaten notebook |
|
html
|
html | string |
HTML-resultaten notebook |
|
starttijd
|
start_time | string |
Begintijd van notebookuitvoering |
|
eindtijd
|
end_time | string |
eindtijd van notebookuitvoering |
|
uitzondering
|
exception | string |
uitzondering voor notebookuitvoering |
SynapseResponse
| Name | Pad | Type | Description |
|---|---|---|---|
|
|
url | string |
Synapse-URL van het gemaakte notebook. |