

• O AWS Systems Manager CloudWatch Dashboard não estará mais disponível a partir de 30 de abril de 2026. Os clientes podem continuar usando o console do Amazon CloudWatch para visualizar, criar e gerenciar os painéis do Amazon CloudWatch exatamente como fazem hoje. Para obter mais informações, consulte a [documentação do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 

# Sobre as aprovações em seus modelos de alteração
<a name="cm-approvals-templates"></a>

**Mudança de disponibilidade do Change Manager**  
O AWS Systems Manager Change Manager não estará mais disponível para novos clientes a partir de 7 de novembro de 2025. Se quiser usar o Change Manager, inscreva-se antes dessa data. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte [mudança de disponibilidade do AWS Systems Manager Change Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/change-manager-availability-change.html). 

Para cada modelo de alteração criado, é possível especificar até cinco *níveis* de aprovação para as solicitações de alteração criadas nele. Para cada um desses níveis, você pode designar até cinco possíveis *aprovadores*. Um aprovador não está limitado a um único usuário. Também é possível especificar um grupo do IAM ou um perfil do IAM como um aprovador individual. Para grupos do IAM e perfis do IAM, um ou mais usuários pertencentes ao grupo ou perfil podem fornecer aprovações para receber o número total de aprovações requeridas para uma solicitação de alteração. Você também pode especificar mais aprovadores do que o requerido pelo seu modelo de alteração.

O Change Manager oferece suporte para duas abordagens principais para aprovações: *aprovações por nível* e *aprovações por linha*. Em algumas situações, também é possível realizar uma combinação dos dois tipos. Recomendamos usar somente aprovações por nível em suas operações do Change Manager.

------
#### [ Per-level approvals ]

*Recomendado*. A partir de 23 de janeiro de 2023, o Change Manager oferecerá suporte para aprovações por nível. Nesse modelo, para cada nível de aprovação em seu modelo de alteração, primeiro é necessário especificar quantas aprovações são requeridas para esse nível. Em seguida, você especifica, no mínimo, esse número de aprovadores para o nível e pode especificar mais aprovadores. No entanto, somente o número de aprovadores por nível que você especificar precisará aprovar a solicitação de alteração. Por exemplo, é possível especificar cinco aprovadores, mas requerer três aprovações.

Para obter amostras de visualização do console e JSON desse tipo de aprovação, consulte [Amostra de configuração de aprovação por nível](approval-type-samples.md#per-level-approvals).

------
#### [ Per-line approvals ]

*Com suporte para compatibilidade com versões anteriores*. A versão original do Change Manager oferecia suporte somente para aprovações por linha. Nesse modelo, cada aprovador especificado para um nível de aprovação é representado como uma linha de aprovação. Cada aprovador precisava aprovar uma solicitação de alteração para que ela fosse aprovada nesse nível. Antes de 23 de janeiro de 2023, este era o único modelo com suporte para aprovações. Os modelos de alteração criados antes dessa data continuam a oferecer suporte às aprovações por linha, mas recomendamos usar as aprovações por nível.

Para obter amostras de visualização do console e JSON desse tipo de aprovação, consulte [Amostra de configuração de aprovação por linha](approval-type-samples.md#per-line-approvals).

------
#### [ Combined per-line and per-level approvals ]

*Não recomendado*. No console, a guia **Builder** não oferece mais suporte para a adição de aprovações por linha. No entanto, em alguns casos, é possível ter aprovações por linha e por nível em um modelo de alteração. Isso pode ocorrer caso você atualize um modelo de alteração criado antes de 23 de janeiro de 2023 ou crie ou atualize um modelo de alteração ao editar seu conteúdo YAML manualmente.

Para obter amostras de visualização do console e JSON desse tipo de aprovação, consulte [Amostra de configuração de aprovação combinada por nível e por linha](approval-type-samples.md#combined-approval-levels).

------

**Importante**  
Embora seja possível criar um modelo de alteração que combine aprovações por linha e por nível, essa configuração não é recomendada ou necessária. Qualquer tipo de aprovação que requeira mais aprovações (aprovações por linha ou por nível) tem precedência. Por exemplo:  
Se um modelo de alteração especificar três aprovações por nível, mas cinco aprovações por linha, serão requeridas cinco aprovações.
Se um modelo de alteração especificar quatro aprovações por nível, mas duas aprovações por linha, serão requeridas quatro aprovações.

É possível criar um nível que inclua aprovações por linha e por nível ao editar o conteúdo YAML ou JSON manualmente. Em seguida, a guia **Builder** exibirá os controles para especificação do número requerido de aprovações para o nível e para as linhas individuais. No entanto, os novos níveis adicionados usando o console ainda oferecem suporte somente às configurações de aprovação por nível.

## Notificações e rejeições das solicitações de alteração
<a name="notifications-and-rejections"></a>

Notificações do Amazon SNS  
Quando uma solicitação de alteração é criada usando seu modelo de alteração, as notificações são enviadas aos assinantes do tópico do Amazon Simple Notiﬁcation Service (Amazon SNS) que foi designado para notificações de aprovação nesse nível. É possível especificar o tópico de notificação no modelo de alteração ou permitir que o usuário que está criando a solicitação de alteração o especifique.  
Após o número mínimo de aprovações requeridas ser recebido em um nível, as notificações serão enviadas aos aprovadores inscritos no tópico do Amazon SNS para o próximo nível, e assim sucessivamente.  
Certifique-se de que os grupos, usuários e perfis do IAM designados em conjunto forneçam aprovadores suficientes para atender ao número requerido de aprovações especificado. Por exemplo, se você designar como aprovador um único grupo do IAM que contém três usuários, não poderá especificar que cinco aprovações sejam requeridas nesse nível, somente três ou menos.

Rejeições de solicitações de alteração  
Não importa quantos níveis de aprovação e aprovadores você especificar, somente uma rejeição a uma solicitação de alteração é requerida para evitar que o fluxo de trabalho do runbook para essa solicitação ocorra.

# Exemplos de tipos de aprovação do Change Manager
<a name="approval-type-samples"></a>

**Mudança de disponibilidade do Change Manager**  
O AWS Systems Manager Change Manager não estará mais disponível para novos clientes a partir de 7 de novembro de 2025. Se quiser usar o Change Manager, inscreva-se antes dessa data. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte [mudança de disponibilidade do AWS Systems Manager Change Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/change-manager-availability-change.html). 

As amostras a seguir demonstram a visualização do console e o conteúdo JSON para os três tipos de tipos de aprovação no Change Manager.

**Topics**
+ [Amostra de configuração de aprovação por nível](#per-level-approvals)
+ [Amostra de configuração de aprovação por linha](#per-line-approvals)
+ [Amostra de configuração de aprovação combinada por nível e por linha](#combined-approval-levels)

## Amostra de configuração de aprovação por nível
<a name="per-level-approvals"></a>

Na configuração do nível de aprovação por nível mostrada na imagem a seguir, são requeridas três aprovações. Essas aprovações poderão ser originadas de qualquer combinação de usuários, grupos e perfis do IAM que são especificados como aprovadores. Os aprovadores especificados incluem dois usuários do IAM (John Stiles e Ana Carolina Silva), um grupo de usuários que contém três membros (`GroupOfThree`) e um perfil de usuário que representa dez usuários (`RoleOfTen`). 

Se todos os três usuários do grupo `GroupOfThree` aprovarem a solicitação de alteração, ela será aprovada para esse nível. Não é necessário receber uma aprovação de cada usuário, grupo ou perfil. O número mínimo de aprovações pode ser originado de qualquer combinação de aprovadores especificados. Recomendamos aprovações por nível para suas operações do Change Manager.

![\[Nível de aprovação apresentando três aprovações requeridas e quatro aprovadores especificados.\]](http://docs.aws.amazon.com/pt_br/systems-manager/latest/userguide/images/Add-approval-2.png)


A amostra a seguir ilustra parte do código YAML para essa configuração. 

**nota**  
Essa versão do código YAML inclui uma entrada adicional, `MinRequiredApprovals` (com uma letra maiúscula inicial `M`). O valor para essa entrada indica quantas aprovações são requeridas entre todos os revisores disponíveis. Observe também que o valor `minRequiredApprovals` (com uma letra minúscula inicial `m`) para cada aprovador na lista `Approvers` é `0` (zero). Isso indica que o aprovador poderá contribuir com as aprovações gerais, mas não é obrigado a fazê-lo.

```
schemaVersion: "0.3"
emergencyChange: false
autoApprovable: false
mainSteps:
  - name: ApproveAction1
    action: aws:approve
    timeoutSeconds: 604800
    inputs:
      Message: Please approve this change request
      MinRequiredApprovals: 3
      EnhancedApprovals:
        Approvers:
          - approver: John Stiles
            type: IamUser
            minRequiredApprovals: 0
          - approver: Ana Carolina Silva
            type: IamUser
            minRequiredApprovals: 0
          - approver: GroupOfThree
            type: IamGroup
            minRequiredApprovals: 0
          - approver: RoleOfTen
            type: IamRole
            minRequiredApprovals: 0
templateInformation: >
  #### What is the purpose of this change?
    //truncated
```

## Amostra de configuração de aprovação por linha
<a name="per-line-approvals"></a>

Na configuração do nível de aprovação mostrada na imagem a seguir, quatro aprovadores estão especificados. Destes, temos dois usuários do IAM (John Stiles e Ana Carolina Silva), um grupo de usuários que contém três membros (`GroupOfThree`) e um perfil de usuário que representa dez usuários (`RoleOfTen`). As aprovações por linha oferecem suporte para a compatibilidade com versões anteriores, mas não são recomendadas.

![\[Nível de aprovação apresentando quatro aprovadores requeridos por linha.\]](http://docs.aws.amazon.com/pt_br/systems-manager/latest/userguide/images/Add-approval-1.png)


Para que a solicitação de alteração seja aprovada nessa configuração de aprovação por linha, ela deve ser aprovada por todas as linhas de aprovadores: John Stiles, Ana Carolina Silva, um membro do grupo `GroupOfThree` e um membro do perfil `RoleOfTen`.

A amostra a seguir ilustra parte do código YAML para essa configuração.

**nota**  
Observe que o valor para cada aprovador `minRequiredApprovals` é `1`. Isso indica que uma aprovação é requerida de cada aprovador.

```
schemaVersion: "0.3"
emergencyChange: false
autoApprovable: false
mainSteps:
  - name: ApproveAction1
    action: aws:approve
    timeoutSeconds: 10000
    inputs:
      Message: Please approve this change request
      EnhancedApprovals:
        Approvers:
          - approver: John Stiles
            type: IamUser
            minRequiredApprovals: 1
          - approver: Ana Carolina Silva
            type: IamUser
            minRequiredApprovals: 1
          - approver: GroupOfThree
            type: IamGroup
            minRequiredApprovals: 1
          - approver: RoleOfTen
            type: IamRole
            minRequiredApprovals: 1
executableRunBooks:
  - name: AWS-HelloWorld
    version: $DEFAULT
templateInformation: >
  #### What is the purpose of this change?
    //truncated
```

## Amostra de configuração de aprovação combinada por nível e por linha
<a name="combined-approval-levels"></a>

Na configuração de aprovação combinada por nível e por linha mostrada na imagem a seguir, três aprovações são especificadas para o nível, mas quatro aprovações são especificadas para as aprovações de itens de linha. O tipo de aprovação que requer mais aprovações tem precedência sobre o outro, portanto, quatro aprovações são requeridas para essa configuração. A aprovação combinada por nível e por linha não é recomendada.

![\[Nível de aprovação apresenta três aprovações requeridas para o nível, mas quatro requeridas no nível de linha.\]](http://docs.aws.amazon.com/pt_br/systems-manager/latest/userguide/images/Add-approval-3.png)


```
schemaVersion: "0.3"
emergencyChange: false
autoApprovable: false
mainSteps:
  - name: ApproveAction1
    action: aws:approve
    timeoutSeconds: 604800
    inputs:
      Message: Please approve this change request
      MinRequiredApprovals: 3
      EnhancedApprovals:
        Approvers:
          - approver: John Stiles
            type: IamUser
            minRequiredApprovals: 1
          - approver: Ana Carolina Silva
            type: IamUser
            minRequiredApprovals: 1
          - approver: GroupOfThree
            type: IamGroup
            minRequiredApprovals: 1
          - approver: RoleOfTen
            type: IamRole
            minRequiredApprovals: 1
templateInformation: >
  #### What is the purpose of this change?
    //truncated
```