Delen via

Quickstart: Azure Functions verbinden met databases en services met Service Connector

Ga aan de slag met Service Connector om uw Azure Functions te verbinden met databases, opslagaccounts en andere Azure-services. Service Connector vereenvoudigt verificatie en configuratie, zodat u verbinding kunt maken met resources met behulp van beheerde identiteiten of andere verificatiemethoden.

Dit artikel bevat stapsgewijze instructies voor zowel Azure Portal als Azure CLI. Kies de gewenste methode met behulp van de bovenstaande tabbladen.

Vereiste voorwaarden

  • Voor deze quickstart is versie 2.30.0 of hoger van de Azure CLI vereist. Als u wilt upgraden naar de nieuwste versie, voert u uit . Als u Azure Cloud Shell gebruikt, is de nieuwste versie al geïnstalleerd.

Uw omgeving instellen

  1. Als u serviceconnector voor het eerst gebruikt, registreert u de resourceprovider van de serviceconnector door de opdracht az provider register uit te voeren.

    az provider register -n Microsoft.ServiceLinker

    Aanbeveling

    U kunt controleren of de resourceprovider al is geregistreerd door de opdracht az provider show -n "Microsoft.ServiceLinker" --query registrationStateuit te voeren. Als de uitvoer is Registered, is serviceconnector al geregistreerd.

  2. Voer desgewenst de opdracht az functionapp connection list-support-types uit om een lijst met ondersteunde doelservices voor Azure Functions op te halen.

    az functionapp connection list-support-types --output table

Een serviceverbinding maken

Gebruik ServiceConnector om een serviceverbinding te maken tussen uw Azure Functions-app en Azure Blob Storage. In dit voorbeeld ziet u hoe u verbinding maakt met Blob Storage, maar u kunt hetzelfde proces gebruiken voor andere ondersteunde Azure-services.

  1. Selecteer in Azure Portal de zoekbalk resources, services en documenten (G +/) bovenaan, typ functie-app en selecteer Functie-app.

    Schermopname van Azure Portal en functie-app selecteren.

  2. Selecteer de functie-app-resource die u wilt verbinden met een doelresource.

  3. Selecteer serviceconnector in het linkernavigatievenster en selecteer vervolgens Maken.

    Schermopname van Azure Portal, serviceconnector selecteren en nieuwe verbinding maken.

  4. Selecteer of voer op het tabblad Basis de volgende instellingen in:

    Configuratie Voorbeeld Beschrijving
    Servicetype Opslag - Blob Het doelservicetype. Als u geen Blob Storage-account hebt, kunt u een account maken of een ander servicetype gebruiken.
    Abonnement Mijn abonnement Het abonnement voor uw doelservice (de service waarmee u verbinding wilt maken). De standaardwaarde is het abonnement voor deze functie-app-resource.
    Verbindingsnaam my_connection De verbindingsnaam waarmee de verbinding tussen uw functie-app en de doelservice wordt geïdentificeerd. Gebruik de verbindingsnaam die is opgegeven door Service Connector of kies uw eigen verbindingsnaam.
    opslagaccount my_storage_account Het doelopslagaccount waarmee u verbinding wilt maken. Doelservice-exemplaren waaruit u kunt kiezen, variëren afhankelijk van het geselecteerde servicetype.
    Clienttype Dezelfde app-stack op deze functie-app De standaardwaarde is afkomstig van de runtimestack van de functie-app. Selecteer de app-stack die zich in dit exemplaar van deze functie-app bevinden.

  5. Selecteer Volgende: Verificatie om een verificatiemethode te kiezen.

    Selecteer Door het systeem toegewezen beheerde identiteit om verbinding te maken via een identiteit die automatisch wordt gegenereerd in Microsoft Entra-id en is gekoppeld aan de levenscyclus van het service-exemplaar. Dit is de aanbevolen verificatieoptie.

  6. Selecteer Volgende: Netwerken om netwerkinstellingen te configureren. Selecteer Firewallregels configureren om toegang tot de doelservice in te schakelen , zodat uw functie-app toegang heeft tot de doelservice.

  7. Kies Volgende: Controleren + Aanmaken om de opgegeven informatie te controleren. Het uitvoeren van de laatste validatie duurt enkele seconden. Selecteer Vervolgens Maken om de serviceverbinding te maken. Het kan even duren voordat deze bewerking is voltooid.

Voer de opdracht az functionapp connection create uit om een serviceverbinding met Blob Storage te maken met een door het systeem toegewezen beheerde identiteit. U kunt deze opdracht op twee manieren uitvoeren:

  • Genereer stap voor stap de nieuwe verbinding:

    az functionapp connection create storage-blob --system-identity

  • Genereer de nieuwe verbinding tegelijk. Vervang de tijdelijke aanduidingen door uw eigen gegevens: <source-subscription>, <source_resource_group>, <function-app>, <target-subscription>, , en <target_resource_group><account>.

    az functionapp connection create storage-blob \
   --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.Web/sites/<function-app> \
   --target-id /subscriptions/<target-subscription>/resourceGroups/<target_resource_group>/providers/Microsoft.Storage/storageAccounts/<account>/blobServices/default \
   --system-identity

Aanbeveling

Als u geen Blob Storage-account hebt, voert u deze uit az functionapp connection create storage-blob --new --system-identity om er een te maken en deze te verbinden met uw functie-app met behulp van een beheerde identiteit.

Uw serviceverbindingen weergeven en valideren

Nadat u de serviceverbinding hebt gemaakt, kunt u alle verbindingen vanuit uw Azure Functions-app bekijken, valideren en beheren.

  1. Verbindingen met functie-apps worden weergegeven in het servicemenu van de serviceconnector . Selecteer > deze optie om de lijst uit te vouwen en de eigenschappen weer te geven die vereist zijn voor uw toepassing.

  2. Selecteer Valideren om de verbinding te controleren. U ziet de details van de verbindingsvalidatie in het deelvenster aan de rechterkant.

    Schermopname van Azure Portal, waarin de verbinding wordt weergegeven en geverifieerd.

Voer de opdracht az functionapp connection list uit om alle ingerichte verbindingen van uw functie-app weer te geven. Vervang de tijdelijke aanduidingen <function-app-resource-group> en <function-app-name> door uw eigen gegevens. U kunt ook de --output table optie verwijderen om meer informatie over uw verbindingen weer te geven.

az functionapp connection list --resource-group "<function-app-resource-group>" --name "<function-app-name>" --output table

In de uitvoer wordt ook de inrichtingsstatus van uw verbindingen weergegeven.

Verwante inhoud

Nu u uw Azure Functions-app hebt verbonden met Azure Storage, kunt u deze zelfstudies verkennen om geavanceerdere functietoepassingen te bouwen met Service Connector:

  • Last updated on