Udostępnij za pośrednictwem

Używanie profilów wersji interfejsu API z platformą .NET w usłudze Azure Stack Hub

  • Artykuł

Ważne

Zestaw .NET SDK został zaktualizowany ze ścieżki 1 do śledzenia 2. Zdecydowanie zalecamy przeprowadzenie migracji do zestawu SDK 2 tak szybko, jak to możliwe. Aby uzyskać instrukcje, zapoznaj się z tym przewodnikiem migracji .

Zestaw SDK platformy .NET dla usługi Azure Stack Hub Resource Manager udostępnia narzędzia ułatwiające tworzenie infrastruktury i zarządzanie nią. Dostawcy zasobów w zestawie SDK obejmują usługi Compute, Networking, Storage, App Services i Key Vault. Zestaw SDK platformy .NET zawiera 14 pakietów NuGet. Jeśli używasz przestarzałego zestawu SDK platformy .NET (niezalecane), te pakiety są w wersji z profilami interfejsu API, takimi jak 2020-09-01-hybrid i 2019-03-01-hybrid. Profile interfejsów API w zestawie SDK platformy .NET umożliwiają opracowywanie chmury hybrydowej, pomagając przełączać się między globalnymi zasobami platformy Azure i zasobami usługi Azure Stack Hub. Aby uzyskać więcej informacji, zobacz sekcję Profile wersji platformy .NET i interfejsu API .

Instalowanie zestawu AZURE .NET SDK

Profile wersji platformy .NET i interfejsu API

Profil interfejsu API to kombinacja dostawców zasobów i wersji interfejsu API. Użyj profilu interfejsu API, aby uzyskać najnowszą, najbardziej stabilną wersję każdego typu zasobu w pakiecie dostawcy zasobów.

Uwaga

Część ResourceProvider specyfikacji pakietu NuGet musi zostać zmieniona. Ponadto pakiety do śledzenia 1 zestawu SDK platformy .NET są przestarzałe, więc mogą wystąpić błędy. Zalecamy jak najszybsze zaktualizowanie zestawu SDK do śledzenia 2 platformy .NET.

Profile

W przypadku profilów zawierających daty użyj innego profilu lub wersji zestawu SDK, zastąp datę w pliku Microsoft.Azure.Management.Profiles.hybrid_<date>.ResourceManager. Na przykład w wersji 2008 profil to 2019_03_01, a ciąg staje się ciągiem Microsoft.Azure.Management.Profiles.hybrid_2019_03_01.ResourceManager. Należy pamiętać, że czasami zespół zestawu SDK zmienia nazwę pakietów, więc po prostu zastąpienie daty ciągu inną datą może nie działać. Zapoznaj się z poniższą tabelą, aby zapoznać się z skojarzeniem profilów i wersji usługi Azure Stack.

Wersja usługi Azure Stack Profil
2311 2020_09_01
2301 2020_09_01
2206 2020_09_01
2108 2020_09_01
2102 2020_09_01
2008 2019_03_01

Aby uzyskać więcej informacji na temat profilów usługi Azure Stack Hub i interfejsu API, zobacz Podsumowanie profilów interfejsu API.

Subskrypcja

Jeśli nie masz jeszcze subskrypcji, utwórz subskrypcję i zapisz identyfikator subskrypcji do późniejszego użycia. Aby uzyskać informacje na temat tworzenia subskrypcji, zobacz ten dokument.

Jednostka usługi

Jednostka usługi i skojarzone z nią informacje o środowisku powinny zostać utworzone i zapisane gdzieś. Zalecana jest jednostka usługi z rolą owner , ale w zależności od próbki contributor rola może wystarczyć. Zapoznaj się z plikiem README w przykładowym repozytorium , aby uzyskać wymagane wartości. Te wartości można odczytać w dowolnym formacie obsługiwanym przez język zestawu SDK, na przykład z pliku JSON (którego używają nasze przykłady). W zależności od przebiegu próbki nie można użyć wszystkich tych wartości. Zobacz przykładowe repozytorium , aby uzyskać zaktualizowany przykładowy kod lub więcej informacji.

Identyfikator dzierżawy

Aby znaleźć katalog lub identyfikator dzierżawy usługi Azure Stack Hub, postępuj zgodnie z instrukcjami w tym artykule.

Rejestrowanie dostawców zasobów

Zarejestruj wymaganych dostawców zasobów, postępując zgodnie z tym dokumentem. Ci dostawcy zasobów będą zobowiązani w zależności od przykładów, które chcesz uruchomić. Jeśli na przykład chcesz uruchomić przykładową maszynę wirtualną, Microsoft.Compute wymagana jest rejestracja dostawcy zasobów.

Punkt końcowy usługi Azure Stack Resource Manager

Azure Resource Manager (ARM) to struktura zarządzania, która umożliwia administratorom wdrażanie i monitorowanie zasobów platformy Azure oraz zarządzanie nimi. Usługa Azure Resource Manager może obsługiwać te zadania jako grupę, a nie pojedynczo w ramach jednej operacji. Informacje o metadanych można uzyskać z punktu końcowego Resource Manager. Punkt końcowy zwraca plik JSON z informacjami wymaganymi do uruchomienia kodu.

  • Element ResourceManagerEndpointUrl w zestawie Azure Stack Development Kit (ASDK) to: https://management.local.azurestack.external/.
  • Element ResourceManagerEndpointUrl w zintegrowanych systemach to: https://management.region.<fqdn>/, gdzie <fqdn> jest w pełni kwalifikowaną nazwą domeny.
  • Aby pobrać wymagane metadane: <ResourceManagerUrl>/metadata/endpoints?api-version=1.0. Aby uzyskać informacje o dostępnych wersjach interfejsu API, zobacz Specyfikacje interfejsu API REST platformy Azure. Na przykład w 2020-09-01 wersji profilu można zmienić wartość na api-version2019-10-01 dla dostawcy microsoft.resourceszasobów .

Przykładowy kod JSON:

{
   "galleryEndpoint": "https://portal.local.azurestack.external:30015/",
   "graphEndpoint": "https://graph.windows.net/",
   "portal Endpoint": "https://portal.local.azurestack.external/",
   "authentication": 
      {
         "loginEndpoint": "https://login.windows.net/",
         "audiences": ["https://management.yourtenant.onmicrosoft.com/3cc5febd-e4b7-4a85-a2ed-1d730e2f5928"]
      }
}

Przykłady

Zobacz to przykładowe repozytorium, aby uzyskać przykładowy kod aktualizacji (śledzenie 2). Zobacz to przykładowe repozytorium, aby śledzić 1 przykładowy kod. Katalog główny README.md opisuje ogólne wymagania, a każdy podkatalog zawiera konkretny przykład z własnym README.md opisem sposobu uruchamiania tego przykładu.

Zobacz tutaj, aby zapoznać się z przykładową wersją lub profilem 2019-03-01 usługi Azure Stack 2008 i poniżej.

Następne kroki

Dowiedz się więcej o profilach interfejsu API: