Partage via

Utiliser des profils de version des API avec .NET dans Azure Stack Hub

  • Article

Important

Le SDK .NET a été mis à jour de la piste 1 à la piste 2. Nous vous recommandons vivement de migrer vers le Kit de développement logiciel (SDK) track 2 dès que possible. Pour obtenir des instructions, consultez ce guide de migration .

Le kit de développement logiciel (SDK) .NET pour Azure Stack Hub Resource Manager fournit des outils pour vous aider à créer et gérer votre infrastructure. Le kit de développement logiciel (SDK) comporte des fournisseurs de ressources de calcul, de réseau, de stockage, de services d’application et KeyVault. Le SDK .NET inclut 14 packages NuGet. Si vous utilisez le SDK .NET track 1 déconseillé (non recommandé), ces packages sont versionnés avec des profils d’API, tels que 2020-09-01-hybrid et 2019-03-01-hybrid. Les profils d’API dans le Kit de développement logiciel (SDK) .NET permettent le développement cloud hybride en vous aidant à basculer entre les ressources Azure globales et les ressources Azure Stack Hub. Pour plus d’informations, consultez la section Profils de version .NET et d’API .

Installer le Kit de développement logiciel (SDK) Azure .NET

.NET et les profils de version d’API

Un profil d’API est une combinaison de fournisseurs de ressources et de versions d’API. Utilisez un profil d’API pour obtenir la version la plus récente et la plus stable de chaque type de ressource dans un package de fournisseur de ressources.

Notes

La partie ResourceProvider de la spécification du package NuGet doit être modifiée. En outre, les packages pour le kit SDK .NET piste 1 sont déconseillés, ce qui vous permet de rencontrer des erreurs. Nous vous recommandons de mettre à jour vers le Kit de développement logiciel (SDK) track 2 .NET dès que possible.

Profils

Pour les profils qui contiennent des dates, pour utiliser un autre profil ou une autre version du SDK, remplacez la date dans Microsoft.Azure.Management.Profiles.hybrid_<date>.ResourceManager. Par exemple, pour la version 2008, le profil est 2019_03_01 et la chaîne devient Microsoft.Azure.Management.Profiles.hybrid_2019_03_01.ResourceManager. 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.

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 cet exemple de référentiel pour obtenir l’exemple de code de mise à jour à ce jour (piste 2). Consultez cet exemple de référentiel pour obtenir l’exemple de code de la piste 1. 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 qui décrit comment 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 :