Implantar e gerenciar programaticamente as licenças de Atualizações de Segurança Estendidas do Azure Arc

Artigo
10/16/2024

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

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

Observação

Você precisará criar uma entidade de serviço para usar a API do Azure para gerenciar ESUs. Consulte Conectar computadores híbridos 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  
        }  
    }  
}

Fazendo a transição do licenciamento por volume

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

Observação

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

Compartilhar via