Implantar e gerenciar programaticamente licenças do Azure Arc Extended Security Updates

Artigo
10/04/2024

Este artigo fornece instruções para provisionar e gerenciar programaticamente as operações do ciclo de vida das Atualizações de Segurança Estendidas do Windows Server 2012 e do Windows Server 2012 R2 por meio das APIs ESU ARM do Azure Arc WS2012.

Para cada um dos comandos da API explicados neste artigo, certifique-se de inserir informações precisas de parâmetros para localização, estado, edição, tipo e processadores, dependendo do seu cenário específico.

Nota

Você precisará criar uma entidade de serviço para usar a API do Azure para gerenciar ESUs. Consulte Conectar máquinas híbridas ao Azure em escala e Referência da API REST do Azure para obter mais informações.

Provisionar uma licença

Para provisionar uma licença, execute o seguinte comando:

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

Transição do licenciamento por volume

Programaticamente, você pode usar a CLI do Azure para gerar novas licenças, especificando o Volume License Details parâmetro em seus direitos de Licenciamento por Volume do Ano 1 inserindo os respetivos números de fatura. Você deve especificar explicitamente a ID da fatura (número) em seu provisionamento de licença para o 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]

Vincular uma licença

Para vincular uma licença, execute o seguinte comando:

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

Desvincular uma licença

Para desvincular uma licença, execute o seguinte comando:

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

Modificar uma licença

Para modificar uma licença, execute o seguinte comando:

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

Para PUT, todas as propriedades devem ser fornecidas. Para PATCH, um subconjunto pode ser fornecido.

Excluir uma licença

Para excluir uma licença, execute o seguinte comando:

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

Partilhar via