Exportar recursos do Azure Policy

Este artigo fornece informações sobre como exportar os recursos existentes do Azure Policy. Exportar seus recursos é útil e recomendado para backup, mas também é uma etapa importante em seu percurso com a governança de nuvem e no tratamento da sua política como código. Os recursos do Azure Policy podem ser exportados por meio da API REST, da CLI do Azure e do Azure PowerShell.

Observação

A experiência do portal para exportar definições para o GitHub foi preterida em abril de 2023.

Exportar com a CLI do Azure

As definições, iniciativas e atribuições do Azure Policy podem ser exportadas como JSON com a CLI do Azure. Cada um desses comandos usa um parâmetro name para especificar o objeto para o qual obter o JSON. A propriedade name geralmente é um GUID e não o displayName do objeto.

• Definição – az policy definition show
• Iniciativa – az policy set-definition show
• Atribuição – az policy assignment show

Segue um exemplo de como obter o JSON para uma definição de política com name de VirtualMachineStorage:

az policy definition show --name 'VirtualMachineStorage'

Exportar com o Azure PowerShell

As definições, iniciativas e atribuições do Azure Policy podem ser exportadas como JSON com o Azure PowerShell. Cada um desses cmdlets usa um parâmetro Name para especificar o objeto para o qual obter o JSON. A propriedade Name geralmente é um GUID (identificador globalmente exclusivo) e não o displayName do objeto.

• Definição – Get-AzPolicyDefinition
• Iniciativa – Get-AzPolicySetDefinition
• Atribuição – Get-AzPolicyAssignment

Segue um exemplo de uso de JSON para uma definição de política com o Nome (conforme mencionado anteriormente, GUID) de d7fff7ea-9d47-4952-b854-b7da261e48f2:

Get-AzPolicyDefinition -Name 'd7fff7ea-9d47-4952-b854-b7da261e48f2' | ConvertTo-Json -Depth 10

Exportar para CSV com Resource Graph no Portal do Azure

O Azure Resource Graph oferece a capacidade de consultar em escala com filtragem, agrupamento e classificação complexos. O Azure Resource Graph dá suporte à tabela de recursos de política, que contém recursos de política como definições, atribuições e isenções. Examine nossas consultas de exemplo. A experiência do portal do explorador do Resource Graph permite downloads de resultados de consulta para CSV usando a opção de barra de ferramentas "Baixar para CSV".

Próximas etapas

• Examine os exemplos em amostras do Azure Policy.
• Revise a estrutura de definição do Azure Policy.
• Revisar Compreendendo os efeitos da política.
• Entenda como criar políticas de forma programática.
• Saiba como corrigir recursos que não estão em conformidade.
• Veja o que é um grupo de gerenciamento com Organizar seus recursos com grupos de gerenciamento do Azure.