Hantera PROFILER för API-version i Azure Stack Hub

API-profiler anger Azure-resursprovidern och API-versionen för Azure REST-slutpunkter. Du kan skapa anpassade klienter på olika språk med hjälp av API-profiler. Varje klient använder en API-profil för att kontakta rätt resursprovider och API-version för Azure Stack Hub.

Du kan skapa en app som fungerar med Azure-resursproviders utan att behöva veta exakt vilken version av varje resursproviders API som är kompatibel med Azure Stack Hub. Det är bara att justera appen till en profil så återgår SDK:n till rätt API-version.

Det här avsnittet hjälper dig att:

  • Förstå API-profiler för Azure Stack Hub.
  • Lär dig hur du kan använda API-profiler för att utveckla dina lösningar.
  • Se var du hittar kodspecifik vägledning.

Sammanfattning av API-profiler

  • API-profiler används för att representera en uppsättning Azure-resursproviders och deras API-versioner.
  • API-profiler har skapats för att du ska kunna skapa mallar i flera Azure-moln. Profiler ger ett kompatibelt och stabilt gränssnitt.
  • Profiler släpps fyra gånger per år.
  • Tre namngivningskonventioner för profiler används:
    • senaste
      Innehåller de senaste API-versionerna som släppts i globala Azure.
    • yyyy-mm-dd-hybrid
      Den här versionen lanseras varannan år och fokuserar på konsekvens och stabilitet i flera moln. Den här profilen har Azure Stack Hub kompatibilitet.
    • yyyy-mm-dd-profile
      Balanserar optimal stabilitet och de senaste funktionerna.

Azure API-profiler och Azure Stack Hub kompatibilitet

De senaste Azure API-profilerna är inte kompatibla med Azure Stack Hub. Använd följande namngivningskonventioner för att identifiera vilka profiler som ska användas för Azure Stack Hub lösningar:

senaste
Den här profilen har de senaste API-versionerna som finns i globala Azure, som inte fungerar i Azure Stack Hub. senaste har det största antalet större ändringar. Profilen ger stabilitet och kompatibilitet med andra moln. Om du försöker använda de senaste API-versionerna är den senaste profilen som du bör använda.

Yyyy-mm-dd-hybrid
Den här profilen släpps i mars och september varje år. Den har optimal stabilitet och kompatibilitet med olika moln och är utformad för att rikta in sig på globala Azure- och Azure Stack Hub. De Azure API-versioner som anges i den här profilen kommer att vara desamma som de som anges i Azure Stack Hub. Använd den här profilen för att utveckla kod för hybridmolnlösningar.

yyyy-mm-dd-profile
Den här profilen släpps för globala Azure i juni och december. Det fungerar inte med Azure Stack Hub och det kommer vanligtvis att finnas många större ändringar. Även om den balanserar optimal stabilitet och de senaste funktionerna är skillnaden mellan senaste och den här profilen att den senaste alltid består av de senaste API-versionerna, oavsett när API:et släpps. Om till exempel en ny API-version skapas för Beräknings-API:et i morgon visas den API-versionen i den senaste, men inte i profilen yyyy-mm-dd-profile , eftersom den här profilen redan finns. yyyy-mm-dd-profile omfattar de senaste versionerna som släppts före juni eller före december.

Azure Resource Manager API-profiler

Azure Stack Hub använder inte den senaste versionen av API-versionerna som finns i globala Azure. När du skapar en lösning måste du hitta API-versionen för varje Azure-resursprovider som är kompatibel med Azure Stack Hub.

I stället för att undersöka varje resursprovider och den specifika version Azure Stack Hub kan du använda en API-profil. Profilen anger en uppsättning resursproviders och API-versioner. SDK: n, eller ett verktyg som skapats med SDK, återgår till det mål api-version som anges i profilen. Med API-profiler kan du ange en profilversion som gäller för en hel mall. Vid körning väljer Azure Resource Manager väljer rätt version av resursen.

API-profiler fungerar med verktyg som använder Azure Resource Manager, till exempel PowerShell, Azure CLI, kod som tillhandahålls i SDK och Microsoft Visual Studio. Verktyg och SDK:er kan använda profiler för att läsa vilken version av modulerna och biblioteken som ska ingå när du skapar en app.

Om du till exempel använder PowerShell för att skapa ett lagringskonto med hjälp av resursprovidern Microsoft.Storage, som stöder API-version 2016-03-30 och en virtuell dator med hjälp av resursprovidern Microsoft.Compute med API-version 2015-12-01, måste du leta upp vilken PowerShell-modul som stöder 2016-03-30 för Storage och vilken modul som stöder 2015-02-01 för Compute och sedan installera dem. I stället kan du använda en profil. Använd cmdleten Install-Profile <profilename>så läser PowerShell in rätt version av modulerna.

På samma sätt kan du ange profilen när du använder Python SDK för att skapa en Python-baserad app. SDK läser in rätt moduler för de resursproviders som du har angett i skriptet.

Som utvecklare innebär det att du kan fokusera på att skriva din lösning. I stället för att undersöka vilka API-versioner, resursprovider och moln som fungerar tillsammans kan du använda en profil och veta att din kod fungerar i alla moln som stöder profilen.

Kodexempel för API-profil

Du hittar kodexempel som hjälper dig att integrera din lösning med det språk du föredrar Azure Stack Hub med hjälp av profiler. För närvarande kan du hitta vägledning och exempel för följande språk:

  • .NET
    Använd .NET API-profilen för att hämta den senaste, mest stabila versionen av varje resurstyp i ett resursproviderpaket. Mer information finns i Använda API-versionsprofiler med .NET i Azure Stack Hub.
  • PowerShell
    Använd modulen Az.Bootstrapper som är tillgänglig via PowerShell-galleriet för att hämta de PowerShell-cmdlets som krävs för att arbeta med API-versionsprofiler. Mer information finns i Använda API-versionsprofiler för PowerShell. Använd modulen AzureRM.Bootstrapper som är tillgänglig via PowerShell-galleriet för att hämta de PowerShell-cmdlets som krävs för att arbeta med API-versionsprofiler. Mer information finns i Använda API-versionsprofiler för PowerShell.
  • Azure CLI
    Uppdatera din miljökonfiguration så att den använder den Azure Stack Hub API-versionsprofilen. Mer information finns i Använda API-versionsprofiler för Azure CLI.
  • Kör
    I Go SDK är en profil en kombination av olika resurstyper med olika versioner från olika tjänster. Profiler är tillgängliga under profilerna/sökvägen med deras version i formatet YYYY-MM-DD . Mer information finns i Använda API-versionsprofiler för Go.
  • Ruby
    Ruby SDK för Azure Stack Hub Resource Manager innehåller verktyg som hjälper dig att skapa och hantera din infrastruktur. Resursproviders i SDK:n omfattar beräkning, virtuella nätverk och lagring med språket Ruby. Mer information finns i Använda API-versionsprofiler med Ruby.
  • Python
    Python SDK stöder API-versionsprofiler för olika molnplattformar, till exempel Azure Stack Hub och globala Azure. Använd API-profiler för att skapa lösningar för ett hybridmoln. Mer information finns i Använda API-versionsprofiler med Python.
  • Node.js
    I Node.js SDK för Azure Stack Hub Resource Manager verktyg som hjälper dig att skapa och hantera din infrastruktur. Mer information finns i Använda API-versionsprofiler med Node.js.

Nästa steg