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

Profils Go et version

Un profil est une combinaison de différents types de ressources avec différentes versions de différents services. L’utilisation d’un profil vous permet de combiner et de faire correspondre différents types de ressources. Les profils peuvent offrir les avantages suivants :

• Stabilité de votre application en verrouillant les versions d’API spécifiques.
• Compatibilité de votre application avec Azure Stack Hub et centres de données Azure régionaux.

Dans le Kit de développement logiciel (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-DD . Par exemple, le profil d’API Azure Stack Hub version 2020-09-01 est destiné aux versions 2102 ou ultérieures d’Azure Stack Hub. Pour importer un service donné à partir d’un profil, importez son module correspondant à partir du profil. Par exemple, pour importer le service de calcul à 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

1. Installez Git. Consultez Bien démarrer : installation de Git.
2. Installez Go. Les profils d’API pour Azure nécessitent Go version 1.9 ou ultérieure. Consultez le langage de programmation Go.

Profils

Pour utiliser un autre profil ou version du Kit de développement logiciel (SDK), remplacez la date dans une instruction import telle que github.com/Azure/azure-sdk-for-go/profiles/<date>/storage/mgmt/storage. Par exemple, pour la version 2008, le profil est 2019-03-01et 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 logiciel (SDK) modifie le nom des packages. Par conséquent, il se peut que le remplacement de la date d’une chaîne par une date différente ne fonctionne pas. Consultez le tableau suivant pour l’association de profils et de versions d’Azure Stack.

Pour plus d’informations sur les profils Azure Stack Hub et API, consultez le résumé des profils d’API.

Consultez les profils du Kit de développement logiciel (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 création d’un abonnement, consultez ce document.

Service Principal

Un principal de service et ses informations d’environnement associées doivent être créées et enregistrées quelque part. Le principal de service avec owner un rôle est recommandé, mais en fonction de l’exemple, un contributor rôle 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 n’importe quel format pris en charge par le langage sdk, par exemple à partir d’un fichier JSON (que nos exemples utilisent). Selon l’exemple en cours d’exécution, toutes ces valeurs ne peuvent pas être utilisées. Consultez l’exemple de référentiel pour obtenir des informations supplémentaires ou des exemples de code mis à jour.

ID du locataire

Pour rechercher l’ID d’annuaire ou de locataire de votre Azure Stack Hub, suivez les instructions de cet article.

Inscrire des fournisseurs de ressources

Inscrivez les fournisseurs de ressources requis en suivant ce document. Ces fournisseurs de ressources sont requis en fonction des exemples que vous souhaitez exécuter. Par exemple, si vous souhaitez exécuter un exemple de machine virtuelle, l’inscription du Microsoft.Compute fournisseur de ressources 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 surveiller des ressources Azure. Azure Resource Manager peut gérer ces tâches en tant que groupe, plutôt que individuellement, dans une seule opération. Vous pouvez obtenir les informations de métadonnées à partir du point de terminaison Resource Manager. Le point de terminaison retourne un fichier JSON avec les informations requises pour exécuter votre code.

• ResourceManagerEndpointUrl dans le Kit de développement Azure Stack (ASDK) est : https://management.local.azurestack.external/.
• 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 connaître les versions d’API disponibles, consultez les spécifications de l’API rest Azure. Par exemple, dans la 2020-09-01 version du profil, vous pouvez modifier la api-version valeur du 2019-10-01 fournisseur de microsoft.resourcesressources.

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

Échantillons

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

Étapes suivantes

En savoir plus sur les profils d’API :

• Gérer les profils de version d’API dans Azure Stack Hub
• Versions de l’API fournisseur de ressources prises en charge par les profils