

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Alterando o status de um controle de avaliação no AWS Audit Manager
<a name="change-assessment-control-status"></a>

Você pode alterar o status de um controle de avaliação em sua avaliação ativa. A atualização do status de um controle permite que você acompanhe seu progresso e indique quando você o revisou, mantendo sua avaliação organizada up-to-date e. 

## Pré-requisitos
<a name="change-assessment-control-status-prerequisites"></a>

O procedimento a seguir pressupõe que você tenha criado uma avaliação anteriormente e que seu status atual esteja ativo.

Certifique-se de que sua identidade do IAM tenha as permissões apropriadas para gerenciar uma avaliação no AWS Audit Manager. Duas políticas sugeridas que concedem essas permissões são [AWSAuditManagerAdministratorAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSAuditManagerAdministratorAccess.html) e [Permita que o gerenciamento de usuários acesse AWS Audit Manager](security_iam_id-based-policy-examples.md#management-access).

## Procedimento
<a name="change-assessment-control-status-procedure"></a>

Você pode atualizar o status do controle da avaliação usando o console do Audit Manager, a API do Audit Manager ou o AWS Command Line Interface (AWS CLI).

**nota**  
Alterar um status de controle para *Analisado* é definitivo. Depois de definir o status de um controle como *Analisado*, você não poderá mais alterar o status desse controle nem reverter para um status anterior. 

------
#### [ Audit Manager console ]

**Para alterar o status do controle de uma avaliação no console do Audit Manager**

1. Abra o console do AWS Audit Manager em [https://console.aws.amazon.com/auditmanager/casa](https://console.aws.amazon.com/auditmanager/home).

1. No painel de navegação, escolha **Avaliações**.

1. Escolha o nome da avaliação para abri-la.

1. Da guia Avaliação, escolha a guia **Controles**, role para baixo até a tabela **Conjuntos de controles** e selecione o nome de um controle para abri-lo.

1. Selecione **Atualizar status do controle** no canto superior direito da página e escolha um status:    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/audit-manager/latest/userguide/change-assessment-control-status.html)

1. Escolha **Atualizar status do controle** para confirmar sua escolha.

------
#### [ AWS CLI ]

**Para alterar o status de um controle de avaliação no AWS CLI**

1. Execute o comando [list-assessments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/auditmanager/list-assessments.html).

   ```
    aws auditmanager list-assessments
   ```

   A resposta retorna uma lista de avaliações. Encontre a avaliação que contém o controle que você deseja atualizar e anote o ID da avaliação.

1. Execute o comando [get-assessment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/auditmanager/get-assessment.html) e especifique o ID da avaliação na etapa 1.

   No exemplo a seguir, *placeholder text* substitua o por suas próprias informações.

   ```
    aws auditmanager get-assessment --assessment-id 1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4e5f6g
   ```

   Na resposta, encontre o controle que você deseja atualizar e anote os IDs do controle e do conjunto de controles.

1. Execute o [update-assessment-control](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/auditmanager/update-assessment-control.html)comando e especifique os seguintes parâmetros: 
   + `--assessment-id`: a avaliação à qual o controle pertence.
   + `--control-set-id`: o conjunto de controles ao qual o controle pertence.
   + `--control-id`: o controle que você deseja atualizar.
   + `--control-status`: defina esse valor como `UNDER_REVIEW`, `REVIEWED` ou `INACTIVE`.

   No exemplo a seguir, *placeholder text* substitua o por suas próprias informações.

   ```
   aws auditmanager update-assessment-control --assessment-id 1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4e5f6g --control-set-id "My control set" --control-id 2b3c4d5e-2b3c-2b3c-2b3c-2b3c4d5f6g7h --control-status REVIEWED
   ```

------
#### [ Audit Manager API ]

**Para alterar o status do controle de uma avaliação usando a API**

1. Use a operação [ListAssessments](https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_ListAssessments.html). 

   Na resposta, encontre a avaliação que contém o controle que você deseja atualizar e anote o ID da avaliação.

1. Use a [GetAssessment](https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_GetAssessment.html)operação e especifique o ID da avaliação da etapa 1.

   Na resposta, encontre o controle que você deseja atualizar e anote os IDs do controle e do conjunto de controles.

1. Use a [UpdateAssessmentControl](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/auditmanager/update-assessment-control.html)operação e especifique os seguintes parâmetros: 
   + `[assessmentId](https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_UpdateAssessmentControl.html#auditmanager-UpdateAssessmentControl-request-assessmentId)`: a avaliação à qual o controle pertence.
   + `[controlSetId](https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_UpdateAssessmentControl.html#auditmanager-UpdateAssessmentControl-request-controlSetId)`: o conjunto de controles ao qual o controle pertence.
   + `[controlId](https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_UpdateAssessmentControl.html#auditmanager-UpdateAssessmentControl-request-controlId)`: o controle que você deseja atualizar.
   + `[controlStatus](https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_UpdateAssessmentControl.html#auditmanager-UpdateAssessmentControl-request-controlStatus)`: defina esse valor como `UNDER_REVIEW`, `REVIEWED` ou `INACTIVE`.

Para obter mais informações sobre essas operações de API, escolha qualquer um dos links no procedimento anterior para ler mais sobre a *Referência da API AWS Audit Manager *. Isso inclui informações sobre como usar essas operações e parâmetros em um dos idiomas específicos AWS SDKs.

------

## Próximas etapas
<a name="change-assessment-control-status-next-steps"></a>

Quando você estiver pronto para alterar o status da avaliação, consulte [Alterando o status de uma avaliação para inativa em AWS Audit Manager](change-assessment-status-to-inactive.md).