az policy attestation

  • Referência

Gerenciar atestados de política de recursos.

Comandos

Nome Description Tipo Status
az policy attestation create

Crie um atestado de política.

 Núcleo GA
az policy attestation delete

Exclua um atestado de política existente.

 Núcleo GA
az policy attestation list

Listar todos os atestados de um recurso.

 Núcleo GA
az policy attestation show

Obtenha um atestado de política.

 Núcleo GA
az policy attestation update

Atualizar um atestado de política existente.

 Núcleo 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 diretiva

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 Exigidos

--attestation-name --name -n

O nome do atestado.

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

A ID do recurso da atribuição de diretiva 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 descrevendo por que esse atestado foi criado.

--compliance-state

O estado de conformidade que deve ser definido no recurso.

Valores aceitos: 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 evidências que sustentam o estado de conformidade estabelecidas 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 todos os 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 Active Directory do Azure.

--parent

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

--resource --resource-id

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

--resource-group -g

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 Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. 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 Exigidos

--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 um nome for fornecido, forneça o grupo de recursos e outros argumentos de id de recurso relevantes.

--resource-group -g

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 Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. 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

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

--top

Número máximo de registros a serem retornados.

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. 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 Exigidos

--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 um nome for fornecido, forneça o grupo de recursos e outros argumentos de id de recurso relevantes.

--resource-group -g

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 Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az policy attestation update

Editar

Atualizar 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 Exigidos

--attestation-name --name -n

O nome do atestado.

Parâmetros Opcionais

--assessment-date

O momento em que as provas foram avaliadas.

--comments

Comentários descrevendo por que esse atestado foi criado.

--compliance-state

O estado de conformidade que deve ser definido no recurso.

Valores aceitos: 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 evidências que sustentam o estado de conformidade estabelecidas 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 todos os 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 Active Directory do Azure.

--parent

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

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

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

--resource --resource-id

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

--resource-group -g

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 Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.