Używanie profilów wersji interfejsu API z językiem Go w usłudze Azure Stack Hub

  • Artykuł

Profile języka Go i wersji

Profil to kombinacja różnych typów zasobów z różnymi wersjami różnych usług. Użycie profilu ułatwia mieszanie i dopasowywanie różnych typów zasobów. Profile mogą zapewnić następujące korzyści:

  • Stabilność aplikacji przez zablokowanie określonych wersji interfejsu API.
  • Zgodność aplikacji z usługą Azure Stack Hub i regionalnymi centrami danych platformy Azure.

W zestawie SDK języka Go profile są dostępne w ścieżce profilów. Numery wersji profilu są oznaczone w formacie RRRR-MM-DD . Na przykład profil interfejsu API usługi Azure Stack Hub w wersji 2020-09-01 jest przeznaczony dla usługi Azure Stack Hub w wersji 2102 lub nowszej. Aby zaimportować daną usługę z profilu, zaimportuj odpowiedni moduł z profilu. Aby na przykład zaimportować usługę obliczeniową z profilu 2020-09-01 , użyj następującego kodu:

import "github.com/Azure/azure-sdk-for-go/profiles/2020-09-01/compute/mgmt/compute"

Instalowanie zestawu Azure SDK dla języka Go

  1. Zainstaluj usługę Git. Zobacz Wprowadzenie — instalowanie usługi Git.
  2. Zainstaluj język Go. Profile interfejsów API dla platformy Azure wymagają języka Go w wersji 1.9 lub nowszej. Zobacz Język programowania Go.

Profile

Aby użyć innego profilu lub wersji zestawu SDK, zastąp datę w instrukcji import, na przykład github.com/Azure/azure-sdk-for-go/profiles/<date>/storage/mgmt/storage. Na przykład w wersji 2008 profil to 2019-03-01, a ciąg staje się ciągiem github.com/Azure/azure-sdk-for-go/profiles/2019-03-01/storage/mgmt/storage. 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.

Zobacz Profile zestawu SDK języka Go.

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 przykładowe repozytorium , aby uzyskać przykładowy kod aktualizacji do daty. Katalog główny README.md opisuje ogólne wymagania, a każdy podkatalog zawiera konkretny przykład z własnym README.md sposobem 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: