Verbinding maken naar een SFTP-bestandsserver vanuit werkstromen in Azure Logic Apps
Van toepassing op: Azure Logic Apps (Verbruik + Standard)
Deze handleiding laat zien hoe u toegang krijgt tot uw SSH File Transfer Protocol (SFTP) -server vanuit een werkstroom in Azure Logic Apps. SFTP is een netwerkprotocol dat bestandstoegang, bestandsoverdracht en bestandsbeheer biedt via een betrouwbare gegevensstroom en het SSH-protocol (Secure Shell) gebruikt.
In werkstromen voor logische apps voor verbruik kunt u de beheerde SFTP-SSH-connectorgebruiken, terwijl u in standaardwerkstromen voor logische apps de ingebouwde SFTP-connector of de beheerde SFTP-SSH-connector kunt gebruiken. U kunt deze connectorbewerkingen gebruiken om geautomatiseerde werkstromen te maken die worden uitgevoerd wanneer ze worden geactiveerd door gebeurtenissen op uw SFTP-server of in andere systemen en acties uitvoeren om bestanden op uw SFTP-server te beheren. Zowel de beheerde als de ingebouwde connectors maken gebruik van het SSH-protocol.
Notitie
De beheerde SFTP-connector is afgeschaft, zodat de bewerkingen van deze connector niet meer worden weergegeven in de werkstroomontwerper.
Uw werkstroom kan bijvoorbeeld beginnen met een SFTP-trigger die gebeurtenissen op uw SFTP-server bewaakt en erop reageert. De trigger maakt de uitvoer beschikbaar voor volgende acties in uw werkstroom. Uw werkstroom kan SFTP-acties uitvoeren die bestanden ophalen, maken en beheren via uw SFTP-serveraccount. De volgende lijst bevat meer voorbeeldtaken:
- Controleren wanneer bestanden worden toegevoegd of gewijzigd.
- Bestanden ophalen, maken, kopiëren, hernoemen, bijwerken, vermelden en verwijderen.
- Mappen maken.
- Bestandsinhoud en metagegevens ophalen.
- Archieven extraheren naar mappen.
In de volgende stappen wordt Azure Portal gebruikt, maar met de juiste Azure Logic Apps-extensie kunt u ook de volgende hulpprogramma's gebruiken om werkstromen voor logische apps te maken en te bewerken:
Werkstromen voor logische apps voor verbruik: Visual Studio of Visual Studio Code
Standaardwerkstromen voor logische apps: Visual Studio Code
Verbinding maken of technische naslaginformatie
De SFTP-connector heeft verschillende versies, op basis van het type logische app en de hostomgeving.
| Type logische app (plan) | Omgeving | Verbinding maken orversie |
|---|---|---|
| Verbruik | Azure Logic Apps met meerdere tenants | Beheerde connector, die wordt weergegeven in de ontwerpfunctie onder het label Standard . Raadpleeg de volgende documentatie voor meer informatie: - Naslaginformatie voor beheerde SFTP-SSH-connector - Beheerde connectors in Azure Logic Apps |
| Verbruik | Integratieserviceomgeving (ISE) | Beheerde connector, die wordt weergegeven in de ontwerpfunctie onder het label Standard en de ISE-versie, die wordt weergegeven in de ontwerpfunctie met het ISE-label en andere berichtlimieten heeft dan de beheerde connector. Raadpleeg de volgende documentatie voor meer informatie: - Naslaginformatie voor beheerde SFTP-SSH-connector - ISE-berichtlimieten - Beheerde connectors in Azure Logic Apps |
| Standaard | Azure Logic Apps en App Service Environment v3 met één tenant (alleen Windows-abonnementen) | Beheerde connector, die wordt weergegeven in de connectorgalerie onder Runtime>Shared en de ingebouwde connector, die wordt weergegeven in de connectorgalerie onder Runtime>In-App en is gebaseerd op serviceproviders. De ingebouwde connector kan rechtstreeks verbinding maken met een SFTP-server en toegang krijgen tot virtuele Azure-netwerken met behulp van een verbindingsreeks zonder een on-premises gegevensgateway. Raadpleeg de volgende documentatie voor meer informatie: - Naslaginformatie voor beheerde SFTP-SSH-connector - Naslaginformatie over de ingebouwde SFTP-connector - Beheerde connectors in Azure Logic Apps - Ingebouwde connectors in Azure Logic Apps |
Algemene beperkingen
Voordat u de beheerde SFTP-SSH-connector gebruikt, bekijkt u de bekende problemen en beperkingen in de naslaginformatie over de beheerde SFTP-SSH-connector.
Voordat u de ingebouwde SFTP-connector gebruikt, bekijkt u de bekende problemen en beperkingen in de referentie voor de ingebouwde SFTP-connector.
Bekende problemen
Triggers die een matrix retourneren, hebben standaard een instelling Splitsen op die al is ingeschakeld. Als deze instelling is ingeschakeld, wordt met de trigger de matrix automatisch gedebatteerd door intern een afzonderlijk werkstroomexemplaren te maken om elk matrixitem te verwerken. Alle werkstroomexemplaren worden parallel uitgevoerd, zodat de matrixitems tegelijkertijd worden verwerkt.
Wanneer de instelling Splitsen op is ingeschakeld, retourneert de beheerde connector echter de uitvoer voor alle matrixitems als lijsten. Alle volgende acties die naar deze uitvoer verwijzen, moeten deze uitvoer eerst als lijsten verwerken. Als u elk matrixitem afzonderlijk wilt afhandelen, kunt u extra acties toevoegen. Als u bijvoorbeeld deze matrixitems wilt herhalen, kunt u een voor elke lus gebruiken. Voor triggers die alleen metagegevens of eigenschappen retourneren, gebruikt u een actie die eerst de metagegevens van het matrixitem ophaalt en gebruikt u vervolgens een actie om de inhoud van de items op te halen.
U moet deze benadering alleen toepassen voor triggers van beheerde connectors, niet voor ingebouwde connectortriggers die uitvoer retourneren voor één matrixitem tegelijk wanneer de instelling Splitsen op is ingeschakeld.
Stel dat u een beheerde connectortrigger hebt met de naam Wanneer een bestand wordt toegevoegd of gewijzigd (alleen eigenschappen) die de metagegevens of eigenschappen voor de nieuwe of bijgewerkte bestanden als matrices retourneert. Als u de metagegevens voor elk bestand afzonderlijk wilt ophalen, kunt u een For-lus gebruiken die door de matrix wordt herhaald. Gebruik in deze lus de volgende beheerde connectoracties in de opgegeven volgorde:
Haal bestandsmetagegevens op om de metagegevens van elk bestand op te halen.
Haal de actie bestandsinhoud op om de inhoud van elk bestand op te halen.
Chunking
Voor meer informatie over hoe de beheerde SFTP-SSH-connector grote bestanden kan verwerken die de standaardgroottelimieten overschrijden, raadpleegt u naslaginformatie over beheerde SFTP-SSH-connector - Segmentering.
Vereisten
Een Azure-account en -abonnement. Als u nog geen abonnement op Azure hebt, registreer u dan nu voor een gratis Azure-account.
Verbinding maken ion- en verificatiegegevens voor toegang tot uw SFTP-server, zoals het serveradres, accountreferenties, toegang tot een persoonlijke SSH-sleutel en het wachtwoord voor de persoonlijke SSH-sleutel. Zie de naslaginformatie over beheerde SFTP-SSH-connector - Verificatie en machtigingen voor meer informatie.
Belangrijk
Wanneer u uw verbinding maakt en uw persoonlijke SSH-sleutel invoert in de eigenschap voor de persoonlijke SSH-sleutel , moet u de stappen volgen voor het opgeven van de volledige en juiste waarde voor deze eigenschap. Anders zorgt een niet-geldige sleutel ervoor dat de verbinding mislukt.
De werkstroom van de logische app waar u toegang wilt krijgen tot uw SFTP-account. Als u wilt beginnen met een SFTP-SSH-trigger, moet u beginnen met een lege werkstroom. Als u een SFTP-SSH-actie wilt gebruiken, start u uw werkstroom met een andere trigger, zoals de trigger Terugkeerpatroon .
Een SFTP-trigger toevoegen
Open uw logische app Verbruik in Azure Portal met een lege werkstroom in de ontwerpfunctie.
Volg deze algemene stappen in de ontwerpfunctie om de gewenste SFTP-SSH-trigger toe te voegen.
Geef de benodigde verbindingsgegevens op als u hierom wordt gevraagd. Selecteer Maken als u klaar bent.
Nadat het informatievak voor de trigger wordt weergegeven, geeft u de benodigde details op voor de geselecteerde trigger. Zie de naslaginformatie over triggers voor SFTP-SSH-beheerde connectors voor meer informatie.
Sla uw werkstroom op wanneer u klaar bent. Selecteer in de werkbalk van de ontwerper Opslaan.
Wanneer u uw werkstroom opslaat, publiceert deze stap automatisch uw updates naar uw geïmplementeerde logische app, die live is in Azure. Met slechts een trigger controleert uw werkstroom alleen de FTP-server op basis van uw opgegeven planning. U moet een actie toevoegen die reageert op de trigger en iets doet met de uitvoer van de trigger.
De trigger met de naam Wanneer een bestand wordt toegevoegd of gewijzigd , start bijvoorbeeld een werkstroom wanneer een bestand wordt toegevoegd of gewijzigd op een SFTP-server. Als volgende actie kunt u een voorwaarde toevoegen waarmee wordt gecontroleerd of de bestandsinhoud voldoet aan de opgegeven criteria. Als de inhoud aan de voorwaarde voldoet, gebruikt u de actie Bestandsinhoud ophalen om de bestandsinhoud op te halen en gebruikt u vervolgens een andere actie om die bestandsinhoud in een andere map op de SFTP-server te plaatsen.
Een SFTP-actie toevoegen
Voordat u een SFTP-actie kunt gebruiken, moet uw werkstroom al beginnen met een trigger. Dit kan elk type zijn dat u kiest. U kunt bijvoorbeeld de ingebouwde trigger terugkeerpatroon gebruiken om uw werkstroom volgens een specifiek schema te starten.
Open uw logische app Verbruik in Azure Portal met werkstroom in de ontwerpfunctie.
Volg deze algemene stappen in de ontwerpfunctie om de gewenste SFTP-SSH-actie toe te voegen.
Geef de benodigde verbindingsgegevens op als u hierom wordt gevraagd. Selecteer Maken als u klaar bent.
Nadat het informatievak voor de actie wordt weergegeven, geeft u de benodigde gegevens op voor de geselecteerde actie. Zie de naslaginformatie over acties voor beheerde SFTP-SSH-connectors voor meer informatie.
Sla uw werkstroom op wanneer u klaar bent. Selecteer in de werkbalk van de ontwerper Opslaan.
De actie Bestandsinhoud ophalen met behulp van het pad haalt bijvoorbeeld de inhoud op van een bestand op een SFTP-server door het bestandspad op te geven. U kunt de trigger uit het vorige voorbeeld gebruiken en een voorwaarde waaraan de bestandsinhoud moet voldoen. Als de voorwaarde waar is, kan een volgende actie de inhoud ophalen.
Problemen oplossen
Zie de volgende documentatie voor meer informatie:
- Naslaginformatie voor beheerde SFTP-SSH-connector - Problemen oplossen
- Naslaginformatie over ingebouwde SFTP-connectors - Probleemoplossing