Déployez et gérez par programmation les licences des mises à jour de sécurité étendues Azure Arc

Article
10/07/2024

Cet article fournit des instructions pour approvisionner et gérer par programmation les opérations de cycle de vie des mises à jour de sécurité étendues Windows Server 2012 et Windows Server 2012 R2 via les API ARM Azure Arc WS2012 ESU.

Pour chacune des commandes d’API expliquées dans cet article, veillez à entrer des informations de paramètre précises pour l’emplacement, l’état, l’édition, le type et les processeurs en fonction de votre scénario particulier.

Remarque

Vous devez créer un principal de service pour utiliser l’API Azure pour gérer les unités d’ESU. Pour plus d’informations, voir Connecter des machines hybrides à Azure à grande échelle et référence Azure API REST.

Approvisionner une licence

Pour approvisionner une licence, exécutez la commande suivante :

PUT  
https://management.azure.com/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP_NAME/providers/Microsoft.HybridCompute/licenses/LICENSE_NAME?api-version=2023-06-20-preview 
{  
    "location": "ENTER-REGION",  
    "properties": {  
        "licenseDetails": {  
            "state": "Activated",  
            "target": "Windows Server 2012",  
            "Edition": "Datacenter",  
            "Type": "pCore",  
            "Processors": 12  
        }  
    }  
}

Transition de licence en volume

Par programmation, vous pouvez utiliser Azure CLI pour générer de nouvelles licences, en spécifiant le paramètre Volume License Details dans vos droits de licence en volume Année 1 en entrant les numéros de facture respectifs. Vous devez spécifier explicitement la Réf. facture (numéro) dans votre approvisionnement de licences pour Azure Arc :

az connectedmachine license create --license-name
                                   --resource-group
                                   [--edition {Datacenter, Standard}]
                                   [--license-type {ESU}]
                                   [--location]
                                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                   [--processors]
                                   [--state {Activated, Deactivated}]
                                   [--tags]
                                   [--target {Windows Server 2012, Windows Server 2012 R2}]
                                   [--tenant-id]
                                   [--type {pCore, vCore}]
                                   [--volume-license-details]

Lier une licence

Pour lier une licence, exécutez la commande suivante :

PUT  
https://management.azure.com/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP_NAME/providers/Microsoft.HybridCompute/machines/MACHINE_NAME/licenseProfiles/default?api-version=2023-06-20-preview 
{
   "location": "SAME_REGION_AS_MACHINE",
   "properties": {
      "esuProfile": {
         "assignedLicense": "RESOURCE_ID_OF_LICENSE"
      }
   }
}

Dissocier une licence

Pour dissocier une licence, exécutez la commande suivante :

PUT 
https://management.azure.com/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP_NAME/providers/Microsoft.HybridCompute/machines/MACHINE_NAME/licenseProfiles/default?api-version=2023-06-20-preview
{
  "location": "SAME_REGION_AS_MACHINE",
  "properties": {
    "esuProfile": {
    }
  }
}

Modifier une licence

Pour modifier une licence, exécutez la commande suivante :

PUT/PATCH 
https://management.azure.com/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP_NAME/providers/Microsoft.HybridCompute/licenses/LICENSE_NAME?api-version=2023-06-20-preview 
{  
    "location": "ENTER-REGION",  
    "properties": {  
        "licenseDetails": {  
            "state": "Activated",  
            "target": "Windows Server 2012",  
            "Edition": "Datacenter",  
            "Type": "pCore",  
            "Processors": 12  
        }  
    }  
}

Remarque

Pour PUT, toutes les propriétés doivent être fournies. Pour PATCH, un sous-ensemble peut être fourni.

Supprimer une licence

Pour supprimer une licence, exécutez la commande suivante :

DELETE  
https://management.azure.com/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP_NAME/providers/Microsoft.HybridCompute/licenses/LICENSE_NAME?api-version=2023-06-20-preview

Partage via