Distribuire e gestire a livello di codice le licenze degli Aggiornamenti della sicurezza estesa di Azure Arc

Articolo
10/07/2024

Questo articolo fornisce istruzioni per il provisioning e la gestione a livello di codice delle operazioni del ciclo di vita degli aggiornamenti della sicurezza estesa di Windows Server 2012 e Windows Server 2012 R2 tramite le API ARM di Azure Arc WS2012.

Per ognuno dei comandi API illustrati in questo articolo, assicurarsi di immettere informazioni accurate sui parametri per la posizione, lo stato, l'edizione, il tipo e i processori a seconda dello scenario specifico.

Nota

È necessario creare un'entità servizio per usare l'API di Azure per gestire le ESU. Per altre informazioni, vedere Connettere macchine ibride ad Azure su larga scala e informazioni di riferimento sull'API REST di Azure.

Effettuare il provisioning di una licenza

Per effettuare il provisioning di una licenza, eseguire il comando seguente:

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

Transizione da contratti multilicenza

A livello di codice, è possibile usare l'interfaccia della riga di comando di Azure per generare nuove licenze, specificando il parametro Volume License Details nei diritti per contratti multilicenza dell'anno 1 immettendo i rispettivi numeri di fattura. È necessario specificare in modo esplicito l'ID fattura (numero) nel provisioning delle licenze per 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]

Collegare una licenza

Per collegare una licenza, eseguire il comando seguenti:

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

Scollegare una licenza

Per scollegare una licenza, eseguire il comando seguente:

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

Modificare una licenza

Per modificare una licenza, eseguire il comando seguente:

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

Nota

Per PUT, è necessario specificare tutte le proprietà. Per PATCH è possibile specificare un subset.

Eliminare una licenza

Per eliminare una licenza, eseguire il comando seguente:

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

Condividi tramite