Selecione suas preferências de cookies

Usamos cookies essenciais e ferramentas semelhantes que são necessárias para fornecer nosso site e serviços. Usamos cookies de desempenho para coletar estatísticas anônimas, para que possamos entender como os clientes usam nosso site e fazer as devidas melhorias. Cookies essenciais não podem ser desativados, mas você pode clicar em “Personalizar” ou “Recusar” para recusar cookies de desempenho.

Se você concordar, a AWS e terceiros aprovados também usarão cookies para fornecer recursos úteis do site, lembrar suas preferências e exibir conteúdo relevante, incluindo publicidade relevante. Para aceitar ou recusar todos os cookies não essenciais, clique em “Aceitar” ou “Recusar”. Para fazer escolhas mais detalhadas, clique em “Personalizar”.

Listas de endereços

Modo de foco
Listas de endereços - Amazon Simple Email Service

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

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

A Lista de Endereços é um recurso do Gerenciador de E-mail que permite criar e gerenciar listas de endereços de e-mail e domínios que você pode usar em políticas de tráfego e conjuntos de regras para processar e-mails recebidos com base no fato de o destinatário ou remetente de uma mensagem pertencer ou não a uma lista específica. As listas de endereços oferecem um controle mais granular sobre os fluxos de e-mail e ajudam a simplificar o gerenciamento de cenários complexos de roteamento de e-mail.

O que são listas de endereços?

As listas de endereços são contêineres para endereços e domínios de e-mail que você pode usar para filtrar e processar mensagens de e-mail. Eles fornecem uma maneira conveniente de agrupar endereços relacionados e aplicar regras de roteamento e políticas de tráfego coletivamente.

Os principais casos de uso das listas de endereços incluem:

  • Listas de negação para bloquear remetentes ou domínios de spam conhecidos

  • Permita listas para garantir a entrega de remetentes confiáveis

  • Validação de destinatário para rejeitar e-mails para destinatários inexistentes mais cedo

  • Roteamento baseado em funções para aplicar regras diferentes com base nas funções do destinatário

  • Políticas baseadas em grupos para aplicar políticas para grupos específicos de usuários

Como funcionam as listas de endereços

As listas de endereços no SES simplificam o gerenciamento de e-mails, permitindo que você crie e mantenha coleções de endereços e domínios de e-mail. Depois de criadas, essas listas são integradas aos seus fluxos de trabalho de e-mail por meio de políticas e regras de tráfego.

Quando o SES processa um e-mail, ele verifica a Lista de Endereços relevante para determinar se o remetente ou destinatário é membro. Com base nessa associação e em suas políticas e regras configuradas, o SES então toma as medidas apropriadas, como rotear, filtrar ou rejeitar o e-mail. Esse processo permite um controle eficiente e granular sobre seu tráfego de e-mail.

Configurando listas de endereços

Criando e preenchendo uma lista de endereços

Parte da criação de uma Lista de Endereços no console é preenchê-la com um ou mais endereços. Usando o Gerenciador de e-mail APIs, você pode criar listas de endereços vazias e preenchê-las posteriormente. Esta seção mostrará como fazer isso com os procedimentos e AWS CLI exemplos do console.

Para criar e preencher uma lista de endereços:
  1. Abra o console SES em https://console.aws.amazon.com/ses/.

  2. No painel de navegação, em Mail Manager, escolha Listas de endereços.

  3. Escolha Criar lista de endereços e insira um nome no campo Nome da lista de endereços.

  4. Selecione Entrada manual ou Upload em massa e siga as respectivas etapas:

  5. Para entrada manual — insira um ou mais endereços de e-mail ou domínios no console.

    Se você usar o caractere curinga asterisco (*), os seguintes formatos se aplicam:

    1. Somente um * é permitido no endereço:

      • *Deve ser antes ou depois de @ quando a entrada for um endereço de e-mail.

      • Quando * está na parte local, a parte local pode ter zero ou 3 a 19 caracteres, excluindo o. *

      • Quando * está no domínio, o nível do subdomínio pode ser de 2 a 9, excluindo o. *

    2. Exemplos de formatos curinga válidos:

      • *.domain1.com a *.domain8.domain7... domain1.com

      • * @domain .com

      • 123* @domain .com até 1234567890123456789* @domain .com

      • local@*.domain1.com a local@*.domain8.domain7... domain1.com

  6. Para upload em massa — Selecione Escolher arquivo e escolha um arquivo CSV ou JSON do seu computador contendo os endereços a serem carregados.

    Use o formato mostrado no exemplo para cada tipo de arquivo:

    1. Exemplo de arquivo CSV (observe que o cabeçalho,address, é obrigatório. ):

      address user1@domain.com user2@*.domain.com *@domain.com
    2. Exemplo de arquivo JSON:

      { "items": [ { "address": "user1@domain.com" }, { "address": "user2@*.domain.com" }, { "address": "*@domain.com" } ] }
  7. Depois de terminar de adicionar endereços ou selecionar um arquivo em massa, escolha Criar lista de endereços.

Usando o AWS CLI:

Crie a lista de endereços

aws mailmanager create-address-list --address-list-name "MyDenyList"

Preencha a lista de endereços:

  • Upload único

    aws mailmanager register-member-to-address-list \ --address-list-id al-123456789abc \ --address "user@example.com"
  • Upload em massa

    Para uploads em massa, primeiro você precisa criar um trabalho de importação especificando o formato CSV ou JSON:

    aws mailmanager create-address-list-import-job \ --address-list-id "al-123456789abc" \ --name "MyImportJob" \ --import-data-format ImportDataType=CSV

    Isso retorna uma ID do trabalho e uma URL pré-assinada. Use esse URL pré-assinado para carregar seu arquivo CSV ou JSON em um bucket do S3, conforme mostrado no exemplo a seguir, usando o comando curl:

    curl -X PUT -T "/path/to/file" "pre-signed URL"

    Após o upload, inicie o trabalho de importação usando o ID do trabalho retornado no comando anterior:

    aws mailmanager start-address-list-import-job --job-id "job-123456789"

Gerenciando listas de endereços

Você pode atualizar, visualizar e excluir listas de endereços conforme necessário.

Atualizando uma lista de endereços

Você pode atualizar uma lista de endereços adicionando ou removendo endereços e, opcionalmente, adicionando ou removendo etiquetas.

Para atualizar uma lista de endereços:
  1. Na página Listas de endereços, selecione o nome da Lista de endereços que você deseja editar.

  2. Para adicionar endereços, escolha Adicionar endereço de e-mail e continue com o método de entrada manual ou upload em massa, conforme explicado emCriando e preenchendo uma lista de endereços.

  3. Para remover endereços, marque a caixa de seleção ao lado de cada endereço que você deseja remover, seguida de Remover endereço de e-mail e confirmar a exclusão.

  4. (Opcional) Adicione ou remova tags à sua lista de endereços escolhendo Gerenciar tags.

Usando o AWS CLI:

Adicionar

aws mailmanager register-member-to-address-list \ --address-list-id al-123456789abc \ --address "user@example.com"

Remover

aws mailmanager deregister-member-from-address-list \ --address-list-id al-123456789abc \ --address "user@example.com"

Exibindo detalhes da lista de endereços

Para ver os detalhes da Lista de Endereços:

  • Na página Listas de Endereços, selecione o nome de uma Lista de Endereços para ver seus detalhes.

Usando o AWS CLI:

aws mailmanager list-members-of-address-list --address-list-id al-123456789abc

Excluindo uma lista de endereços

Para excluir uma lista de endereços:

  1. Na página Listas de endereços, selecione o botão de opção ao lado da Lista de endereços que você deseja excluir seguido de Excluir.

  2. Confirme a exclusão da lista digitando confirmar seguido de Excluir.

Usando o AWS CLI:

aws mailmanager delete-address-list --address-list-id al-123456789abc

Usando listas de endereços em políticas de tráfego e conjuntos de regras

As listas de endereços podem ser usadas em declarações de política de tráfego e condições de regras para processar e-mails com base na associação à lista, dando controle sobre o fluxo de e-mails.

Usando uma lista de endereços em uma declaração de política de tráfego

As listas de endereços podem ser selecionadas quando você cria a condição de uma declaração de política de tráfego para permitir ou negar a entrada de e-mails em seu endpoint de entrada.

O procedimento de console a seguir e seus AWS CLI equivalentes mostram um exemplo de criação de uma declaração de política que permite que mensagens entrem em seu endpoint de entrada se o destinatário estiver na Lista de Endereços especificada.

Para usar uma Lista de Endereços em uma declaração de política de tráfego:
  1. Crie uma nova política de tráfego ou edite uma existente, conforme explicado em Criar políticas de tráfego e declarações de política (console)

  2. No contêiner da declaração de política, escolha Permitir para que a ação seja tomada quando as condições da declaração forem atendidas.

  3. Crie a condição da declaração da seguinte forma:

    • Selecione o endereço do destinatário no campo Protocolo.

    • Selecione Está na lista de endereços no campo Operador.

    • Selecione o nome da sua Lista de endereços no campo Valor.

  4. Embora esse seja apenas um exemplo, você pode adicionar mais condições de política que podem ser baseadas em uma variedade de operadores com qualquer uma das suas listas de endereços.

Usando o AWS CLI:

aws mailmanager create-traffic-policy \ --default-action ALLOW \ --traffic-policy-name "testpolicy" \ --policy-statements '[{ "Action": "ALLOW", "Conditions": [{ "BooleanExpression": { "Evaluate": { "IsInAddressList": { "Attribute": "RECIPIENT", "AddressLists": [ "arn:aws:ses:eu-west-3:123456789012:mailmanager-address-list/al-123456789abc" ] } }, "Operator": "IS_TRUE" } }] }]'

Usando uma lista de endereços em uma regra

As listas de endereços podem ser selecionadas quando você cria a condição de uma regra usada em um dos seus conjuntos de regras para acionar a ação da regra.

O procedimento de console a seguir e seus AWS CLI equivalentes mostram um exemplo de criação de uma regra que invoca a ação de descarte se o destinatário estiver na Lista de Endereços especificada.

Para usar uma Lista de Endereços em uma condição de regra:
  1. Crie uma nova regra ou edite uma existente, conforme explicado em Criar conjuntos de regras e regras (console)

  2. No contêiner Condições da regra, crie a condição da regra da seguinte maneira.

    • Selecione o endereço do destinatário no campo Selecionar propriedade.

    • Selecione Está na lista de endereços no campo Selecionar operador.

    • Selecione o nome da sua Lista de endereços no campo Valor.

  3. No contêiner Ações, escolha Adicionar nova ação e selecione Eliminar ação.

  4. Embora esse seja apenas um exemplo, você pode adicionar mais condições de regras que podem ser baseadas em uma variedade de operadores com qualquer uma de suas listas de endereços para que várias ações sejam tomadas.

Usando o AWS CLI:

aws mailmanager create-rule-set \ --rule-set-name "testruleset2" \ --rules '[{ "Name": "addresslist", "Conditions": [{ "BooleanExpression": { "Evaluate": { "IsInAddressList": { "Attribute": "RECIPIENT", "AddressLists": [ "arn:aws:ses:us-east-1:123456789012:mailmanager-address-list/al-123456789abc" ] } }, "Operator": "IS_TRUE" } }], "Actions": [{ "Drop": {} }] }]'

Melhores práticas e considerações

  • Esteja atento aos tamanhos das listas — listas muito grandes podem afetar o desempenho.

  • As listas de endereços são específicas da conta e só podem ser usadas na mesma AWS conta.

  • Atualmente, não há suporte para listas de endereços aninhadas.

  • Há suporte para um máximo de 100 listas de endereços por região.

  • Há suporte para um máximo de 100.000 endereços por lista de endereços.

PrivacidadeTermos do sitePreferências de cookies
© 2025, Amazon Web Services, Inc. ou suas afiliadas. Todos os direitos reservados.