

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á.

# Alterar uma lista de permissões
<a name="allow-lists-change"></a>

Depois de criar uma lista de permissões, você pode alterar a maioria das configurações da lista no Amazon Macie. Por exemplo, você pode alterar o nome e a descrição da lista. Você também pode adicionar e editar tags para a lista. A única configuração que você não pode alterar é o tipo de lista. Por exemplo, se uma lista existente especificar uma expressão regular (*regex*), você não poderá alterar o tipo para texto predefinido.

Se uma lista de permissões especificar um texto predefinido, você também poderá alterar as entradas na lista. Para fazer isso, atualize o arquivo que contém as entradas. Em seguida, faça o upload da nova versão do arquivo no Amazon Simple Storage Service (Amazon S3). Na próxima vez que o Macie se preparar para usar a lista, o Macie recuperará a versão mais recente do arquivo do Amazon S3. Ao fazer o upload do novo arquivo, certifique-se de armazená-lo no mesmo bucket e objeto do S3. Ou, se você alterar o nome do bucket ou objeto, certifique-se de atualizar as configurações da lista no Macie.

**Para alterar as configurações de uma lista de permissões**  
Você pode alterar as configurações de uma lista de permissões usando o console do Amazon Macie ou a API do Amazon Macie.



------
#### [ Console ]

Siga estas etapas para alterar as configurações de uma lista de permissões usando o console do Amazon Macie.

**Para alterar as configurações de uma lista de permissões usando o console**

1. Abra o console do Amazon Macie em. [https://console.aws.amazon.com/macie/](https://console.aws.amazon.com/macie/)

1. No painel de navegação, em **Configurações**, selecione **Listas de permissões**.

1. Na página **Listas de permissões**, escolha o nome da lista de permissões que você deseja alterar. A página da lista de permissões é aberta e exibe as configurações atuais da lista.

1. Para adicionar ou editar tags para a lista de permissões, escolha **Gerenciar tags** na seção **Tags**. Em seguida, altere as tags conforme necessário. Ao concluir, escolha **Salvar**.

1. Para alterar outras configurações da lista de permissões, escolha **Editar** na seção **Configurações da lista**. Em seguida, altere as configurações desejadas:
   + **Nome**: insira um novo nome para a lista. Um nome pode conter até 128 caracteres.
   + **Descrição**: insira uma nova descrição da lista. A descrição pode conter até 512 caracteres.
   + Se a lista de permissões especificar um texto predefinido:
     + **Nome do bucket do S3**: insira o nome do bucket que armazena a lista.

       No Amazon S3, você pode encontrar esse valor no campo **Nome** das propriedades do bucket. Esse valor diferencia maiúsculas de minúsculas. Além disso, não use caracteres curinga ou valores parciais ao inserir o nome.
     + **Nome do objeto do S3**: insira o nome do objeto do S3 que armazena a lista.

       No Amazon S3, você pode encontrar esse valor no campo **Chave** das propriedades do objeto. Se o nome incluir um caminho, certifique-se de incluir o caminho completo ao inserir o nome, por exemplo **allowlists/macie/mylist.txt**. Esse valor diferencia maiúsculas de minúsculas. Além disso, não use caracteres curinga ou valores parciais ao inserir o nome.
   + Se a lista de permissões especificar uma expressão regular (*regex*), insira uma nova regex na caixa **Expressão regular**. A regex pode conter até 512 caracteres.

     Depois de inserir o novo regex, teste-o opcionalmente. Para fazer isso, insira até 1.000 caracteres na caixa **Dados da amostra** e escolha **Teste**. Macie avalia os dados da amostra e relata o número de ocorrências de texto que correspondem ao regex. Você pode repetir essa etapa quantas vezes quiser para refinar e otimizar o regex antes de salvar suas alterações.

1. Ao concluir, escolha **Salvar**.

Macie testa as configurações da lista. Para obter uma lista de texto predefinido, o Macie também verifica se ele pode recuperar a lista do Amazon S3 e analisar o conteúdo da lista. Para um regex, o Macie também verifica se ele pode compilar a expressão. Se ocorrer um erro, o Macie exibirá uma mensagem que descreve o erro. Para obter informações detalhadas que podem ajudar você a resolver o erro, consulte [Requisitos e opções de configuração para listas de permissões](allow-lists-options.md). Depois de resolver qualquer erro, você poderá salvar as alterações.

------
#### [ API ]

Para alterar programaticamente as configurações de uma lista de permissões, use a [UpdateAllowList](https://docs.aws.amazon.com/macie/latest/APIReference/allow-lists-id.html)operação da API Amazon Macie. Ou, se você estiver usando o AWS CLI, execute o [update-allow-list](https://docs.aws.amazon.com/cli/latest/reference/macie2/update-allow-list.html)comando. Em sua solicitação, use os parâmetros compatíveis para especificar um novo valor para cada configuração que você deseja alterar. Observe que os parâmetros `criteria`, `id` e `name` são obrigatórios. Se você não quiser alterar o valor de um parâmetro obrigatório, especifique o valor atual do parâmetro. 

Por exemplo, o comando a seguir altera o nome e a descrição de uma lista de permissões existente. O exemplo está formatado para Microsoft Windows e usa o caractere de continuação de linha circunflexo (^) para melhorar a legibilidade.

```
C:\> aws macie2 update-allow-list ^
--id {{km2d4y22hp6rv05example}} ^
--name {{my_allow_list-email}} ^
--criteria={\"regex\":\"{{[a-z]@example.com}}\"} ^
--description "{{Ignores all email addresses for the example.com domain}}"
```

Em que:
+ {{km2d4y22hp6rv05example}}é o identificador exclusivo da lista.
+ {{my\_allow\_list-email}}é o novo nome da lista.
+ {{[a-z]@example.com}}é o critério da lista, uma expressão regular.
+ {{Ignores all email addresses for the example.com domain}}é a nova descrição da lista.

Quando você envia sua solicitação, o Macie testa as configurações da lista. Se a lista especificar um texto predefinido (`s3WordsList`), isso inclui verificar se o Macie pode recuperar a lista do Amazon S3 e analisar o conteúdo dela. Se a lista especificar um regex (`regex`), isso inclui verificar se o Macie pode compilar a expressão.

Se ocorrer um erro ao testar as configurações, sua solicitação falhará e o Macie retornará uma mensagem descrevendo o erro. Para obter informações detalhadas que podem ajudar você a resolver o erro, consulte [Requisitos e opções de configuração para listas de permissões](allow-lists-options.md). Se a solicitação falhar por outro motivo, o Macie retornará uma resposta HTTP 4*xx* ou 500 que indica por que a operação falhou.

Se a sua solicitação for realizada com êxito, o Macie atualizará as configurações da lista e você receberá um resultado semelhante ao seguinte.

```
{
    "arn": "arn:aws:macie2:us-west-2:123456789012:allow-list/km2d4y22hp6rv05example",
    "id": "km2d4y22hp6rv05example"
}
```

Em que `arn` é o nome do recurso da Amazon (ARN) da lista de permissões que foi atualizada e `id` é o identificador exclusivo da lista.

------