Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Configurazione della soppressione a livello di tenant
Configura le impostazioni di soppressione a livello di tenant per controllare in che modo Amazon Simple Email Service (Amazon SES) Simple Email Service (Amazon SES) gestisce i respingimenti e i reclami per i singoli tenant. Per impostazione predefinita, i tenant utilizzano l'elenco di soppressione a livello di account. Quando si abilita la soppressione a livello di tenant, SES mantiene un elenco di soppressioni separato per ogni tenant. Ciò consente un controllo granulare sulla recapitabilità delle e-mail.
Questo argomento fornisce le procedure per abilitare, modificare, disabilitare e visualizzare le impostazioni di soppressione a livello di tenant utilizzando. AWS CLI
**Importante**
La disabilitazione della soppressione a livello di tenant non elimina le voci esistenti dall'elenco di soppressione del tenant. Se in un secondo momento si riattiva la soppressione a livello di tenant, tali voci sono ancora attive.
## Prerequisiti
Prima di configurare la soppressione a livello di tenant, assicuratevi di soddisfare i seguenti requisiti:
+ Multi-tenancy è abilitato nel tuo account SES.
+ Nel tuo account è presente almeno un inquilino o prevedi di crearne uno come parte di questa procedura.
+ AWS CLI la versione 2 è installata e configurata con le autorizzazioni appropriate. Per ulteriori informazioni, consulta la [Guida per l'utente AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/).
+ Conoscete i concetti di soppressione a livello di account. Per ulteriori informazioni, consulta [Utilizzo dell'elenco di eliminazione a livello di account di Amazon SES](sending-email-suppression-list.md).
## Attivazione della soppressione a livello di tenant per un tenant esistente
Utilizza l'operazione `PutTenantSuppressionAttributes` API per abilitare la soppressione a livello di tenant per un tenant esistente. Questa operazione è idempotente, quindi è possibile richiamarla più volte con gli stessi parametri senza effetti collaterali.
**Per abilitare la soppressione a livello di tenant**
1. Nella riga di comando, esegui il `put-tenant-suppression-attributes` comando seguente per abilitare la soppressione a livello di tenant sia per i rimbalzi che per i reclami:
------
#### [ Linux, macOS, or Unix ]
```
aws sesv2 put-tenant-suppression-attributes \
--tenant-name {{MyTenant}} \
--suppression-scope TENANT \
--suppressed-reasons BOUNCE COMPLAINT
```
------
#### [ Windows ]
```
aws sesv2 put-tenant-suppression-attributes `
--tenant-name {{MyTenant}} `
--suppression-scope TENANT `
--suppressed-reasons BOUNCE COMPLAINT
```
------
Sostituiscilo {{MyTenant}} con il nome del tuo inquilino.
1. Verifica che il comando non restituisca alcun output. Una richiesta riuscita restituisce una risposta HTTP 200 senza corpo.
1. Conferma la configurazione eseguendo il comando seguente:
```
aws sesv2 get-tenant --tenant-name {{MyTenant}}
```
Il tenant ora utilizza la propria lista di soppressione sia per i rimbalzi che per i reclami.
È inoltre possibile configurare la soppressione per un singolo tipo di motivo. Gli esempi seguenti mostrano come abilitare la soppressione solo per i rimbalzi o solo per i reclami.
Il comando seguente sopprime solo i rimbalzi:
------
#### [ Linux, macOS, or Unix ]
```
aws sesv2 put-tenant-suppression-attributes \
--tenant-name {{MyTenant}} \
--suppression-scope TENANT \
--suppressed-reasons BOUNCE
```
------
#### [ Windows ]
```
aws sesv2 put-tenant-suppression-attributes `
--tenant-name {{MyTenant}} `
--suppression-scope TENANT `
--suppressed-reasons BOUNCE
```
------
Il comando seguente elimina solo i reclami:
------
#### [ Linux, macOS, or Unix ]
```
aws sesv2 put-tenant-suppression-attributes \
--tenant-name {{MyTenant}} \
--suppression-scope TENANT \
--suppressed-reasons COMPLAINT
```
------
#### [ Windows ]
```
aws sesv2 put-tenant-suppression-attributes `
--tenant-name {{MyTenant}} `
--suppression-scope TENANT `
--suppressed-reasons COMPLAINT
```
------
**Nota**
È necessario fornire `--suppression-scope` e insieme. `--suppressed-reasons` Fornire uno senza l'altro restituisce un`InvalidParameterValueException`.
## Configurazione della soppressione durante la creazione di un nuovo tenant
Utilizza l'operazione `CreateTenant` API con il `SuppressionAttributes` parametro per creare un tenant con la soppressione a livello di tenant abilitata fin dall'inizio.
**Per creare un tenant con soppressione a livello di tenant**
1. Nella riga di comando, esegui il comando seguente: `create-tenant`
------
#### [ Linux, macOS, or Unix ]
```
aws sesv2 create-tenant \
--tenant-name {{MyNewTenant}} \
--suppression-attributes '{"SuppressionScope":"TENANT","SuppressedReasons":["BOUNCE","COMPLAINT"]}'
```
------
#### [ Windows ]
```
aws sesv2 create-tenant `
--tenant-name {{MyNewTenant}} `
--suppression-attributes '{"SuppressionScope":"TENANT","SuppressedReasons":["BOUNCE","COMPLAINT"]}'
```
------
Sostituiscilo {{MyNewTenant}} con il nome del nuovo inquilino.
1. Verifica che la risposta contenga l'ID del tenant:
```
{
"TenantId": "tn-abc123def456"
}
```
Il tenant viene creato con la soppressione a livello di tenant abilitata sia per i rimbalzi che per i reclami.
**Nota**
Se si omette, per impostazione predefinita il tenant utilizza l'`--suppression-attributes`ambito e utilizza l'elenco di soppressione a livello di account. `ACCOUNT`
## Sovrascrivere la soppressione dei tenant con un set di configurazione
È possibile sovrascrivere le impostazioni di soppressione di un tenant aggiungendole `SuppressionScope` a un set di configurazione. `SuppressionOptions` Quando si invia e-mail utilizzando questo set di configurazione, le impostazioni di soppressione del set di configurazione hanno la precedenza sulle impostazioni del tenant. È possibile sovrascrivere solo l'ambito, solo i motivi o entrambi in modo indipendente.
**Per creare un set di configurazione con l'override dell'ambito del tenant**
1. Nella riga di comando, esegui il comando seguente: `create-configuration-set`
------
#### [ Linux, macOS, or Unix ]
```
aws sesv2 create-configuration-set \
--configuration-set-name {{my-config-set}} \
--suppression-options '{"SuppressionScope":"TENANT","SuppressedReasons":["BOUNCE"]}'
```
------
#### [ Windows ]
```
aws sesv2 create-configuration-set `
--configuration-set-name {{my-config-set}} `
--suppression-options '{"SuppressionScope":"TENANT","SuppressedReasons":["BOUNCE"]}'
```
------
Sostituiscilo {{my-config-set}} con il nome del set di configurazione.
1. Verificate che il comando non restituisca alcun output. Una richiesta riuscita restituisce una risposta HTTP 200.
**Per aggiornare un set di configurazione esistente con opzioni di soppressione**
1. Nella riga di comando, esegui il `put-configuration-set-suppression-options` comando seguente:
------
#### [ Linux, macOS, or Unix ]
```
aws sesv2 put-configuration-set-suppression-options \
--configuration-set-name {{my-config-set}} \
--suppression-scope TENANT \
--suppressed-reasons BOUNCE
```
------
#### [ Windows ]
```
aws sesv2 put-configuration-set-suppression-options `
--configuration-set-name {{my-config-set}} `
--suppression-scope TENANT `
--suppressed-reasons BOUNCE
```
------
Sostituisci {{my-config-set}} con il nome del set di configurazione.
1. Verificate che il comando non restituisca alcun output. Una richiesta riuscita restituisce una risposta HTTP 200.
## Disattivazione della soppressione a livello di tenant
Per riportare un tenant alla soppressione a livello di account, è possibile impostare l'ambito su o cancellare tutte le impostazioni di soppressione. `ACCOUNT`
**Per impostare il tenant sulla soppressione a livello di account**
1. Nella riga di comando, esegui il comando seguente per impostare in modo esplicito l'ambito su: `ACCOUNT`
------
#### [ Linux, macOS, or Unix ]
```
aws sesv2 put-tenant-suppression-attributes \
--tenant-name {{MyTenant}} \
--suppression-scope ACCOUNT \
--suppressed-reasons BOUNCE COMPLAINT
```
------
#### [ Windows ]
```
aws sesv2 put-tenant-suppression-attributes `
--tenant-name {{MyTenant}} `
--suppression-scope ACCOUNT `
--suppressed-reasons BOUNCE COMPLAINT
```
------
{{MyTenant}}Sostituiscilo con il nome del tuo inquilino.
1. Verifica che il comando non restituisca alcun output.
**Per cancellare tutte le impostazioni di soppressione**
1. Nella riga di comando, esegui il comando seguente senza specificare l'ambito o i motivi:
```
aws sesv2 put-tenant-suppression-attributes --tenant-name {{MyTenant}}
```
{{MyTenant}}Sostituiscilo con il nome del tuo inquilino.
1. Verifica che il comando non restituisca alcun output.
**Nota**
Quando si omettono entrambi `--suppression-scope` e`--suppressed-reasons`, SES cancella le impostazioni di soppressione del tenant. Il tenant torna al comportamento di soppressione a livello di account.
**Importante**
La disabilitazione della soppressione a livello di tenant non elimina le voci esistenti dall'elenco di soppressione del tenant. Se in un secondo momento si riattiva la soppressione a livello di tenant, tali voci sono ancora attive.
## Visualizzazione della configurazione di soppressione corrente
Utilizza l'operazione `GetTenant` API per controllare le attuali impostazioni di soppressione di un tenant.
**Per visualizzare la configurazione di soppressione di un tenant**
1. Nella riga di comando, esegui il comando seguente: `get-tenant`
```
aws sesv2 get-tenant --tenant-name {{MyTenant}}
```
{{MyTenant}}Sostituiscilo con il nome del tuo inquilino.
1. Rivedi la risposta. L'esempio seguente mostra un tenant con la soppressione a livello di tenant abilitata:
```
{
"Tenant": {
"TenantName": "MyTenant",
"TenantId": "tn-abc123def456",
"TenantArn": "arn:aws:ses:us-east-1:123456789012:tenant/MyTenant/tn-abc123def456",
"SendingStatus": "ENABLED",
"CreatedTimestamp": 1705312800,
"UpdateTimestamp": 1705762800,
"SuppressionAttributes": {
"SuppressionScope": "TENANT",
"SuppressedReasons": ["BOUNCE", "COMPLAINT"]
}
}
}
```
La tabella seguente descrive i campi chiave dell'oggetto. `SuppressionAttributes`
| Campo | Description |
| --- | --- |
| SuppressionScope | L'ambito di soppressione per il tenant. Un valore di TENANT indica che il tenant utilizza il proprio elenco di soppressione. Un valore di ACCOUNT indica che il tenant utilizza l'elenco di soppressione a livello di account. |
| SuppressedReasons | I motivi di soppressione attivi per il tenant. I valori possibili sono BOUNCECOMPLAINT, o entrambi. |
Se `SuppressionAttributes` è assente o nullo nella risposta, il tenant utilizza la soppressione a livello di account.
## Risoluzione dei problemi
Di seguito sono riportati gli errori più comuni che si possono verificare durante la configurazione della soppressione a livello di tenant.
`InvalidParameterValueException: SuppressedReasons cannot be null when SuppressionScope is provided`
+ **Causa**: hai specificato senza. `--suppression-scope` `--suppressed-reasons`
+ **Correzione**: fornite entrambi i parametri insieme o ometteteli entrambi per cancellare le impostazioni.
`InvalidParameterValueException: SuppressionScope is required when SuppressedReasons are provided`
+ **Causa**: hai specificato `--suppressed-reasons` senza`--suppression-scope`.
+ **Correzione**: fornisce entrambi i parametri insieme.
`NotFoundException`
+ **Causa**: il nome del tenant specificato non esiste.
+ **Correzione** — Verifica il nome del tenant eseguendo il seguente comando:
```
aws sesv2 list-tenants
```
## Risorse correlate
+ [Utilizzo di elenchi di soppressione a livello di tenant in Amazon SES](sending-email-suppression-list-tenant-level.md)
+ [Gestione delle voci dell'elenco di soppressione dei tenant](sending-email-suppression-list-tenant-level-manage.md)
+ [Utilizzo dell'elenco di eliminazione a livello di account di Amazon SES](sending-email-suppression-list.md)
+ [Tenant](tenants.md)