Utiliser des profils de version d’API avec Go dans Azure Stack Hub

Article
06/19/2024

Go et les profils de version

Un profil est une combinaison de différents types de ressources dans différentes versions provenant de différents services. L’utilisation d’un profil vous aide à combiner différents types de ressource. Les profils peuvent offrir les avantages suivants :

La stabilité de votre app en verrouillant sur des versions d’API spécifiques.
La compatibilité de votre app avec Azure Stack Hub et les centres de données régionaux Azure.

Dans le SDK Go, les profils sont disponibles sous le chemin des profils. Les numéros de version de profil sont étiquetés au format AAAA-MM-JJ. Par exemple, la version du profil d’API Azure Stack Hub 2020-09-01 est pour Azure Stack Hub versions 2102 ou ultérieures. Pour importer un service donné à partir d’un profil, importez son module correspondant à partir du profil. Par exemple, pour importer le service Compute à partir du profil 2020-09-01, utilisez le code suivant :

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

Installer le kit de développement logiciel Microsoft Azure SDK pour Go

Installez Git. Consultez Bien démarrer - Installation de Git.
Installez Go. Les profils d’API pour Azure nécessitent Go version 1.9 ou une version ultérieure. Consultez Langage de programmation Go.

Profils

Pour utiliser un autre profil ou une autre version du SDK, remplacez la date dans une instruction d’importation comme github.com/Azure/azure-sdk-for-go/profiles/<date>/storage/mgmt/storage. Par exemple, pour la version 2008, le profil est 2019-03-01 et la chaîne devient github.com/Azure/azure-sdk-for-go/profiles/2019-03-01/storage/mgmt/storage. Notez que, parfois, l’équipe du kit de développement modifie le nom des packages. Il est donc possible que le remplacement de la date d’une chaîne par une autre date ne fonctionne pas. Consultez le tableau suivant pour l’association des profils et des versions de Azure Stack.

Version d’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

Pour plus d’informations sur Azure Stack Hub et les profils d’API, voir Résumé des profils d’API.

Consultez Profils du SDK Go.

Abonnement

Si vous n’avez pas encore d’abonnement, créez un abonnement et enregistrez l’ID d’abonnement à utiliser ultérieurement. Pour plus d’informations sur la manière de créer un abonnement, consultez ce document.

Principal du service

Le principal de service et ses informations d’environnement associées doivent être créés et enregistrés quelque part. Le principal de service avec rôle owner est recommandé, mais en fonction de l’exemple, un rôle contributor peut suffire. Reportez-vous au fichier README dans l’exemple de référentiel pour connaître les valeurs requises. Vous pouvez lire ces valeurs dans tout format pris en charge par le langage du SDK, par exemple à partir d’un fichier JSON (que nos exemples utilisent). Selon l’exemple en cours d’exécution, toutes ces valeurs peuvent ne pas être utilisées. Consultez l’exemple de référentiel pour obtenir des exemples de code à jour ou des informations supplémentaires.

ID client

Pour rechercher le répertoire ou l’ID de locataire de votre environnement Azure Stack Hub, suivez les instructions fournies dans cet article.

Inscrire des fournisseurs de ressources

Inscrivez les fournisseurs de ressources requis en suivant ce document. Ces fournisseurs de ressources seront nécessaires en fonction des exemples que vous souhaitez exécuter. Par exemple, si vous souhaitez exécuter un exemple de machine virtuelle, l’inscription du fournisseur de ressources Microsoft.Compute est requise.

Point de terminaison Azure Stack Resource Manager

Azure Resource Manager (ARM) est un framework de gestion qui permet aux administrateurs de déployer, gérer et superviser les ressources Azure. Azure Resource Manager peut gérer ces tâches en groupe, plutôt qu’individuellement, dans une seule opération. Vous pouvez obtenir les informations de métadonnées du point de terminaison du Gestionnaire des ressources. Le point de terminaison retourne un fichier JSON avec les informations requises pour exécuter votre code.

Le ResourceManagerEndpointUrl dans le kit de développement Azure Stack (ASDK) est : https://management.local.azurestack.external/.
Le ResourceManagerEndpointUrl dans les systèmes intégrés est : https://management.region.<fqdn>/, où <fqdn> est votre nom de domaine complet.
Pour récupérer les métadonnées requises : <ResourceManagerUrl>/metadata/endpoints?api-version=1.0. Pour obtenir les versions d’API disponibles, consultez les spécifications de l’API REST Azure. Par exemple, dans la version de profil 2020-09-01, vous pouvez modifier le api-version en 2019-10-01 pour le fournisseur de ressources microsoft.resources.

Exemple de code 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"]
      }
}

Exemples

Consultez l’exemple de référentiel pour obtenir un exemple de code de mise à jour. La racine README.md décrit les exigences générales, et chaque sous-répertoire contient un exemple spécifique avec son propre README.md sur la façon d’exécuter cet exemple.

Découvrez ici l’exemple applicable à la version Azure Stack 2008 ou au profil 2019-03-01 et versions antérieures.

Étapes suivantes

Découvrez-en plus sur les profils d’API :

Partager via