Logic Apps-anslutningsprogram med ARM-baserade VI-konton

  • Artikel

Viktigt!

På grund av azure Media Services-tillbakadragandemeddelandet meddelar Azure AI Video Indexer att funktionsjusteringar för Azure AI Video Indexer har justerats. Mer information om vad detta innebär för ditt Azure AI Video Indexer-konto finns i Ändringar som rör tillbakadragning av Azure Media Service (AMS). Se guiden Förbereda för AMS-pensionering: VI-uppdatering och migrering.

REST API för Azure AI Video Indexer (VI) stöder både server-till-server- och klient-till-server-kommunikation. Med API:et kan du integrera video- och ljudinsikter i din programlogik.

Dricks

För den senaste api-versionväljer du den senaste stabila versionen i vår REST-dokumentation.

För att göra integreringen enklare stöder vi Logic Apps - och Power Automate-anslutningsappar som är kompatibla med Azure AI Video Indexer API.

Du kan använda anslutningsapparna för att konfigurera anpassade arbetsflöden för att effektivt indexeras och extrahera insikter från en stor mängd video- och ljudfiler, utan att skriva en enda kodrad. Genom att använda anslutningsapparna för integreringen får du dessutom bättre insyn i arbetsflödets hälsotillstånd och ett enkelt sätt att felsöka det.

Dricks

Om du använder ett klassiskt VI-konto kan du läsa Logic Apps-anslutningsappen med klassiska VI-konton.

Kom igång med Anslutningsappar för Azure AI Video Indexer

För att hjälpa dig att komma igång snabbt med Azure AI Video Indexer-anslutningsappar skapar exemplet i den här artikeln Logic App-flöden. Logic App- och Power Automate-funktionerna och deras redigerare är nästan identiska, vilket innebär att diagrammen och förklaringarna gäller för båda. Exemplet i den här artikeln baseras på ARM VI-kontot. Om du arbetar med ett klassiskt konto kan du läsa Logic Anslutningsverktyg s with classic-based VI accounts (Logik Anslutningsverktyg med klassiska VI-konton).

Scenariot "ladda upp och indexera videon automatiskt" som beskrivs i den här artikeln består av två olika flöden som fungerar tillsammans. Metoden "två flöde" används för att stödja asynkron uppladdning och indexering av större filer effektivt.

  • Det första flödet utlöses när en blob läggs till eller ändras i ett Azure Storage-konto. Den laddar upp den nya filen till Azure AI Video Indexer med en motringnings-URL för att skicka ett meddelande när indexeringsåtgärden är klar.
  • Det andra flödet utlöses baserat på återanrops-URL:en och sparar de extraherade insikterna tillbaka till en JSON-fil i Azure Storage.

De logikappar som du skapar i den här artikeln innehåller ett flöde per app. I det andra avsnittet (Skapa en ny logikapp av typen förbrukning) förklaras hur du ansluter de två. Det andra flödet står ensamt och utlöses av det första (avsnittet med motringnings-URL:en).

Förutsättningar

  • Om du inte har en Azure-prenumeration skapar du ett kostnadsfritt Azure-konto innan du börjar.

  • Skapa ett ARM-baserat Azure AI Video Indexer-konto.

  • skapa ett Azure Storage-konto Anteckna åtkomstnyckeln för ditt Lagringskonto.

    Skapa två containrar: en för att lagra mediefilerna, för det andra för att lagra de insikter som genereras av Azure AI Video Indexer. I den här artikeln är videos containrarna och insights.

Konfigurera filuppladdningsflödet (det första flödet)

I det här avsnittet beskrivs hur du konfigurerar det första flödet ("filuppladdning"). Det första flödet utlöses när en blob läggs till eller ändras i ett Azure Storage-konto. Den laddar upp den nya filen till Azure AI Video Indexer med en motringnings-URL för att skicka ett meddelande när indexeringsåtgärden är klar.

Följande bild visar det första flödet:

Skärmbild av filuppladdningsflödet.

  1. Skapa logikappen. Vi skapar en logikapp i samma region som Azure Video Indexer-regionen (rekommenderas men krävs inte). Vi anropar logikappen UploadIndexVideosApp.

    1. Välj Förbrukning som plantyp.
    2. Tryck på Granska + Skapa ->Skapa.
    3. När distributionen av logikappen är klar söker du i Azure-portalen och navigerar till den nyligen skapade logikappen.
    4. Under avsnittet Inställningar väljer du fliken Identitet på den vänstra sidans panel.
    5. Under Systemtilldelat ändrar du Status från Av till På (steget är viktigt för senare i den här självstudien).
    6. Tryck på Spara (överst på sidan).
    7. Välj fliken Logikappdesigner i fönstret till vänster.
    8. Välj ett tomt logic app-flöde .
    9. Sök efter "blob" på bladet Välj en åtgärd .
    10. På fliken Alla väljer du Azure Blob Storage-komponenten .
    11. Under Utlösare väljer du utlösaren När en blob läggs till eller ändras (endast egenskaper) (V2).

  2. Ange lagringsanslutningen.

    När du har skapat en V2-utlösare (när en blob läggs till eller ändras) måste anslutningen anges till följande värden:

    Tangent Värde
    Anslutningens namn <Namnge anslutningen>.
    Authentication type Snabbtangent
    Namn på Azure Storage-konto <Lagringskontonamn där mediefiler ska lagras>.
    Åtkomstnyckel för Azure Storage-konto Så här hämtar du åtkomstnyckeln för ditt lagringskonto: i Azure-portalen –> my-storage –> under Säkerhet + nätverk –> Åtkomstnycklar –> kopierar du en av nycklarna.

    Välj Skapa.

    Skärmbild av utlösaren för lagringsanslutning.

    När du har angett anslutningen till lagringen måste du ange den bloblagringscontainer som övervakas för ändringar.

    Tangent Värde
    Lagringskontonamn Lagringskontonamn där mediefiler lagras
    Container /videos

    Välj Spara ->+Nytt steg

    Skärmbild av utlösaren för lagringscontainern.

  3. Skapa SAS-URI efter sökvägsåtgärd.

    1. Välj fliken Åtgärd .
    2. Sök efter och välj Skapa SAS-URI efter sökväg (V2)..
    Tangent Värde
    Lagringskontonamn <Lagringskontots namn där mediefiler lagras>.
    Blobsökväg Under Dynamiskt innehåll väljer du Sökvägslista för filer
    Grupprincipidentifierare Behåll standardvärdet.
    Behörigheter Läs
    Protokoll för delad åtkomst (visas när du har tryckt på Lägg till ny parameter) HttpsOnly

    Välj Spara (överst på sidan).

    Skärmbild av skapa SAS-URI efter sökvägslogik.

    Välj +Nytt steg.

  4. Generera en åtkomsttoken.

    Kommentar

    Mer information om ARM-API:et och exempel på begäran/svar finns i Generera en Åtkomsttoken för Azure AI Video Indexer.

    Tryck på Prova för att hämta rätt värden för ditt konto.

    Sök efter och skapa en HTTP-åtgärd .

    Tangent Värde Kommentar
    Metod POST
    URI generateAccessToken.
    Brödtext { "permissionType": "Contributor", "scope": "Account" } Se REST-dokumentexemplet och se till att ta bort POST-raden.
    Lägg till ny parameter Autentisering

    Skärmbild av HTTP-åtkomsttoken.

    När parametern Autentisering har lagts till fyller du i de obligatoriska parametrarna enligt tabellen nedan:

    Tangent Värde
    Authentication type Hanterade identiteter
    Hanterad identitet Systemtilldelad hanterad identitet
    Målgrupp https://management.core.windows.net

    Välj Spara.

    Dricks

    Innan du går vidare till nästa steg konfigurerar du rätt behörighet mellan logikappen och Azure AI Video Indexer-kontot.

    Kontrollera att du har följt stegen för att aktivera den systemtilldelade hanterade identiteten för dina Logic Apps.

    Skärmbild av hur du aktiverar den systemtilldelade hanterade identiteten.

    1. Konfigurera systemtilldelad hanterad identitet för behörighet på Azure AI Video Indexer-resurs.

      I Azure-portalen går du till din Azure AI Video Indexer-resurs/-konto.

      1. På bladet till vänster väljer du Åtkomstkontroll.
      2. Välj Lägg till ->Lägg till rolltilldelning ->Deltagare ->Nästa ->Användare, grupp eller tjänstens huvudnamn ->+Välj medlemmar.
      3. Under Medlemmar söker du efter det Logic Apps-namn som du skapade (i det här fallet UploadIndexVideosApp).
      4. Tryck på Välj.
      5. Tryck på Granska + tilldela.

  5. I logikappen skapar du en åtgärd för att ladda upp video och index .

    1. Välj Video Indexer(V2).

    2. Från Video Indexer(V2) väljer du Ladda upp video och index.

    3. Ange anslutningen till Video Indexer-kontot.

      Tangent Värde
      Anslutningens namn <Ange ett namn för anslutningen>, i det här fallet aviconnection.
      API key Det här är din personliga API-nyckel, som är tillgänglig under Profil i utvecklarportalen Eftersom den här logikappen är för ARM-konton behöver vi inte den faktiska API-nyckeln och du kan fylla i ett dummy-värde som 12345

      Välj Skapa.

    4. Fyll i åtgärdsparametrarna Ladda upp video och index .

      Dricks

      Om VI-konto-ID:t inte kan hittas och inte finns i listrutan använder du det anpassade värdet.

      Tangent Värde
      Plats Plats för det associerade Azure AI Video Indexer-kontot.
      Konto-ID Konto-ID för det associerade Azure AI Video Indexer-kontot. Du hittar konto-ID :t på sidan Översikt för ditt konto i Azure-portalen. Eller fliken Kontoinställningar till vänster om webbplatsen för Azure AI Video Indexer.
      Åtkomsttoken Använd uttrycket body('HTTP')['accessToken'] för att extrahera åtkomsttoken i rätt format från föregående HTTP-anrop.
      Videonamn Välj Lista över filnamn från det dynamiska innehållet i När en blob läggs till eller ändras .
      Video-URL Välj Webb-URL från det dynamiska innehållet i åtgärden Skapa SAS-URI efter sökväg .
      Brödtext Kan lämnas som standard.

      Skärmbild av uppladdnings- och indexåtgärden.

      Välj Spara.

Slutförandet av uppladdningen och indexeringen från det första flödet skickar en HTTP-begäran med rätt motringnings-URL för att utlösa det andra flödet. Sedan hämtar den de insikter som genereras av Azure AI Video Indexer. I det här exemplet lagras utdata från indexeringsjobbet i Azure Storage. Det är dock upp till dig vad du gör med utdata.

Skapa en ny logikapp av typen förbrukning (det andra flödet)

Skapa det andra flödet, Logic Apps av typen consumption. Det andra flödet utlöses baserat på återanrops-URL:en och sparar de extraherade insikterna tillbaka till en JSON-fil i Azure Storage.

Skärmbild av flödet på hög nivå.

  1. Konfigurera utlösaren

    Sök efter när en HTTP-begäran tas emot.

    Skärmbild av konfigurationen av utlösaren.

    För utlösaren visas ett HTTP POST-URL-fält. URL:en genereras inte förrän du har sparat flödet. Du behöver dock URL:en så småningom.

    Dricks

    Vi kommer tillbaka till den URL som skapades i det här steget.

  2. Generera en åtkomsttoken.

    Följ alla steg från:

    1. Generera en åtkomsttoken som vi gjorde för det första flödet (som visas här).
    2. Välj Spara ->+ Nytt steg.

  3. Hämta Video Indexer-insikter.

    1. Sök efter "Video Indexer".

    2. Från Video Indexer(V2) väljer du åtgärden Hämta videoindex .

      Ange anslutningsnamnet:

      Tangent Värde
      Anslutningens namn <Ett namn på anslutningen>. Exempel: aviconnection
      API key Det här är din personliga API-nyckel som är tillgänglig under Profil på utvecklarportalen. Mer information finns i Prenumerera på API:et.
      1. Välj Skapa.

    3. Fyll i de obligatoriska parametrarna enligt tabellen:

      Tangent Värde
      Plats Platsen för Azure AI Video Indexer-kontot.
      Konto-ID Video Indexer-konto-ID:t kan kopieras från resurs-/kontoöversiktssidan i Azure-portalen.
      Video-ID* För Video-ID lägger du till dynamiskt innehåll av typen Uttryck och lägger till följande uttryck: triggerOutputs()['queries']['id'].
      Åtkomsttoken Från det dynamiska innehållet går du till avsnittet Parsa JSON och väljer den accessToken som är utdata för åtgärden parsa JSON.

      *Det här uttrycket instruerar anslutaren att hämta video-ID:t från utdata från utlösaren. I det här fallet är utdata från utlösaren utdata från Ladda upp video och index i din första utlösare.

      Skärmbild av uppladdningen och indexering av en videoåtgärd.

      Välj Spara ->+ Nytt steg.

  4. Skapa en blob och lagra insikternas JSON.

    1. Sök efter "Azure blob" från gruppen med åtgärder.

    2. Välj Skapa blob(V2).

    3. Ange anslutningen till bloblagringen som lagrar JSON Insights-filerna.

      Tangent Värde
      Anslutningens namn <Ange ett anslutningsnamn>.
      Authentication type Snabbtangent
      Namn på Azure Storage-konto <* Namnet på lagringskontot där insikter lagras*>.
      Åtkomstnyckel för Azure Storage-konto Gå till Azure-portalen –> my-storage –> under Säkerhet + nätverk –> Åtkomstnycklar –> kopiera en av nycklarna.

      Skärmbild av åtgärden skapa blob.

    4. Välj Skapa.

    5. Ange den mapp där insikter ska lagras.

      Tangent Värde
      Lagringskontonamn <Ange namnet på lagringskontot som skulle innehålla JSON-utdata (i den här självstudien är samma som källvideon).>
      Folder path I listrutan väljer du /insights
      Blobnamn I det dynamiska innehållet går du till avsnittet Hämta videoindex och väljer Namn och lägger till _insights.json. Filnamnet för insights blir videonamnet + insights.json
      Blobinnehåll I det dynamiska innehållet går du till avsnittet Hämta videoindex och väljer brödtexten.

      Skärmbild av åtgärden för att lagra blobinnehåll.

    6. Välj Spara flöde.

  5. Uppdatera återanrops-URL:en för att få ett meddelande när ett indexjobb har slutförts.

    När flödet har sparats skapas en HTTP POST-URL i utlösaren.

    1. Kopiera URL:en från utlösaren.

      Skärmbild av utlösaren spara URL.

    2. Gå tillbaka till det första flödet och klistra in URL:en i åtgärden Ladda upp video och index för parametern Motringnings-URL.

Kontrollera att båda flödena sparas.