Share via

az policy attestation

  • Referência

Gerencie atestados de política de recursos.

Comandos

Name Description Tipo Estado
az policy attestation create

Crie um atestado de política.

 Principal GA
az policy attestation delete

Exclua um atestado de política existente.

 Principal GA
az policy attestation list

Listar todos os atestados de um recurso.

 Principal GA
az policy attestation show

Obtenha um atestado de política.

 Principal GA
az policy attestation update

Atualize um atestado de política existente.

 Principal GA

az policy attestation create

Editar

Crie um atestado de política.

az policy attestation create --attestation-name
                             --policy-assignment
                             [--assessment-date]
                             [--comments]
                             [--compliance-state {Compliant, NonCompliant, Unknown}]
                             [--definition-reference-id]
                             [--evidence]
                             [--expires-on]
                             [--metadata]
                             [--namespace]
                             [--owner]
                             [--parent]
                             [--resource]
                             [--resource-group]
                             [--resource-type]

Exemplos

Criar um atestado no escopo do grupo de recursos para uma atribuição de política

az policy attestation create -g myRg -n myAttestation --policy-assignment eeb18edc813c42d0ad5a9eab

Criar um atestado no escopo do grupo de recursos para uma atribuição de política usando a ID do recurso de atribuição de política

az policy attestation create -g myRg -n myAttestation \
  --policy-assignment "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/providers/Microsoft.Authorization/policyAssignments/myPa"

Criar um atestado no escopo da assinatura para uma atribuição de conjunto de políticas

az policy attestation create -n myAttestation \
  --policy-assignment eeb18edc813c42d0ad5a9eab \
  --definition-reference-id auditVMPolicyReference

Criar um atestado para um recurso específico usando a ID do recurso

az policy attestation create \
  --resource "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachines/myVm" \
  -n myAttestation --policy-assignment eeb18edc813c42d0ad5a9eab

Criar um atestado no escopo do grupo de recursos usando todas as propriedades

az policy attestation create --attestation-name myAttestation -g myRg -a eeb18edc813c42d0ad5a9eab \
 --compliance-state Compliant --assessment-date 2023-01-01T08:29:18Z \
 --evidence source-uri=https://sampleuri.com description="Sample description for the sample uri" \
 --evidence source-uri=https://sampleuri2.com description="Sample description 2 for the sample uri 2" \
 --expires-on 2024-08-01T05:29:18Z --owner user@myOrg.com --metadata Location=NYC Dept=ACC \
 --definition-reference-id auditVMPolicyReference

Parâmetros Obrigatórios

--attestation-name --name -n

O nome do atestado.

--policy-assignment --policy-assignment-id -a

A ID do recurso da atribuição de política para a qual o atestado está definindo o estado.

Parâmetros Opcionais

--assessment-date

O momento em que as provas foram avaliadas.

--comments

Comentários que descrevem por que este atestado foi criado.

--compliance-state

O estado de conformidade que deve ser definido no recurso.

valores aceites: Compliant, NonCompliant, Unknown
--definition-reference-id

A ID de referência da definição de política de uma definição de conjunto de políticas para a qual o atestado está definindo o estado. Se a atribuição de política atribuir uma definição de conjunto de políticas, o atestado poderá escolher uma definição dentro da definição de conjunto com essa propriedade ou omiti-la e definir o estado para toda a definição de conjunto.

--evidence

As provas que sustentam o estado de conformidade estabelecido neste atestado.

--expires-on

O tempo que o estado de conformidade deve expirar.

--metadata

Metadados adicionais em pares key=value separados por espaço para um atestado. Isso substitui quaisquer metadados existentes para o atestado.

--namespace

Namespace do provedor (Ex: Microsoft.Provider).

--owner

A pessoa responsável por definir o estado do recurso. Esse valor normalmente é uma ID de objeto do Azure Ative Directory.

--parent

O caminho pai (Ex: resourceTypeA/nameA/resourceTypeB/nameB).

--resource --resource-id

ID do recurso ou nome do recurso. Se for dado um nome, forneça o grupo de recursos e outros argumentos relevantes de identificação de recursos.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--resource-type

Tipo de recurso (Ex: resourceTypeC).

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az policy attestation delete

Editar

Exclua um atestado de política existente.

az policy attestation delete --attestation-name
                             [--namespace]
                             [--parent]
                             [--resource]
                             [--resource-group]
                             [--resource-type]

Exemplos

Excluir um atestado no escopo do grupo de recursos

az policy attestation delete -g myRg -n myAttestation

Parâmetros Obrigatórios

--attestation-name --name -n

O nome do atestado.

Parâmetros Opcionais

--namespace

Namespace do provedor (Ex: Microsoft.Provider).

--parent

O caminho pai (Ex: resourceTypeA/nameA/resourceTypeB/nameB).

--resource --resource-id

ID do recurso ou nome do recurso. Se for dado um nome, forneça o grupo de recursos e outros argumentos relevantes de identificação de recursos.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--resource-type

Tipo de recurso (Ex: resourceTypeC).

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az policy attestation list

Editar

Listar todos os atestados de um recurso.

az policy attestation list [--filter]
                           [--resource]
                           [--resource-group]
                           [--top]

Exemplos

Listar todos os atestados de política no escopo da assinatura

az policy attestation list

Listar os dois principais atestados de política no escopo do grupo de recursos

az policy attestation list -g myRg --top 2

Listar todos os atestados que têm a ID de atribuição de política de myPolicyAssignment

az policy attestation list --filter "PolicyAssignmentId eq '/subscriptions/35ee058e-5fa0-414c-8145-3ebb8d09b6e2/providers/microsoft.authorization/policyassignments/b101830944f246d8a14088c5'"

Parâmetros Opcionais

--filter

Expressão de filtro OData.

--resource --resource-id

ID do recurso.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--top

Número máximo de registos a devolver.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az policy attestation show

Editar

Obtenha um atestado de política.

az policy attestation show --attestation-name
                           [--namespace]
                           [--parent]
                           [--resource]
                           [--resource-group]
                           [--resource-type]

Exemplos

Mostre um atestado na assinatura.

az policy attestation show --attestation-name myAttestation

Parâmetros Obrigatórios

--attestation-name --name -n

O nome do atestado.

Parâmetros Opcionais

--namespace

Namespace do provedor (Ex: Microsoft.Provider).

--parent

O caminho pai (Ex: resourceTypeA/nameA/resourceTypeB/nameB).

--resource --resource-id

ID do recurso ou nome do recurso. Se for dado um nome, forneça o grupo de recursos e outros argumentos relevantes de identificação de recursos.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--resource-type

Tipo de recurso (Ex: resourceTypeC).

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az policy attestation update

Editar

Atualize um atestado de política existente.

az policy attestation update --attestation-name
                             [--assessment-date]
                             [--comments]
                             [--compliance-state {Compliant, NonCompliant, Unknown}]
                             [--definition-reference-id]
                             [--evidence]
                             [--expires-on]
                             [--metadata]
                             [--namespace]
                             [--owner]
                             [--parent]
                             [--policy-assignment]
                             [--resource]
                             [--resource-group]
                             [--resource-type]

Exemplos

Atualizar um atestado no escopo do recurso

az policy attestation update --attestation-name myAttestation \
  --resource "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachines/myVm" \
  --comments "Adding comments for this attestation"

Parâmetros Obrigatórios

--attestation-name --name -n

O nome do atestado.

Parâmetros Opcionais

--assessment-date

O momento em que as provas foram avaliadas.

--comments

Comentários que descrevem por que este atestado foi criado.

--compliance-state

O estado de conformidade que deve ser definido no recurso.

valores aceites: Compliant, NonCompliant, Unknown
--definition-reference-id

A ID de referência da definição de política de uma definição de conjunto de políticas para a qual o atestado está definindo o estado. Se a atribuição de política atribuir uma definição de conjunto de políticas, o atestado poderá escolher uma definição dentro da definição de conjunto com essa propriedade ou omiti-la e definir o estado para toda a definição de conjunto.

--evidence

As provas que sustentam o estado de conformidade estabelecido neste atestado.

--expires-on

O tempo que o estado de conformidade deve expirar.

--metadata

Metadados adicionais em pares key=value separados por espaço para um atestado. Isso substitui quaisquer metadados existentes para o atestado.

--namespace

Namespace do provedor (Ex: Microsoft.Provider).

--owner

A pessoa responsável por definir o estado do recurso. Esse valor normalmente é uma ID de objeto do Azure Ative Directory.

--parent

O caminho pai (Ex: resourceTypeA/nameA/resourceTypeB/nameB).

--policy-assignment --policy-assignment-id -a

A ID do recurso da atribuição de política para a qual o atestado está definindo o estado.

--resource --resource-id

ID do recurso ou nome do recurso. Se for dado um nome, forneça o grupo de recursos e outros argumentos relevantes de identificação de recursos.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--resource-type

Tipo de recurso (Ex: resourceTypeC).

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.