Partage via


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

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 les commandes suivantes :

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  
        }  
    }  
}

Pour lier une licence, exécutez les commandes suivantes :

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

Pour dissocier une licence, exécutez les commandes suivantes :

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 les commandes suivantes :

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 les commandes suivantes :

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