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

Este artigo fornece instruções para provisionar e gerenciar programaticamente Windows Server operações de ciclo de vida de Atualizações de Segurança Estendidas por meio das APIs do ARM do ESU Azure Arc. As instruções se aplicam a Windows Server 2012/2012 R2 e Windows Server 2016. Use o seletor na parte superior do artigo para escolher a versão do sistema operacional que você está licenciando.

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. Defina a target propriedade para o sistema operacional que você está licenciando:

  • Windows Server 2012
  • Windows Server 2012 R2
  • Windows Server 2016

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

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 2016",  
            "Edition": "Datacenter",  
            "Type": "pCore",  
            "Processors": 12  
        }  
    }  
}

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]

Transição do licenciamento por volume

Não há suporte para a transição do licenciamento por volume para Windows Server 2016 ESUs habilitadas pelo Azure Arc.

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

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

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 2016",  
            "Edition": "Datacenter",  
            "Type": "pCore",  
            "Processors": 12  
        }  
    }  
}

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
  • Last updated on