사전 조건 테넌트 수준 금지 활성화 새 테넌트에 대한 금지 구성 구성 세트로 재정의 테넌트 수준 금지 비활성화 현재 금지 구성 보기 문제 해결 관련 리소스

테넌트 수준 금지 구성

Amazon Simple Email Service(Amazon SES)가 개별 테넌트에 대한 반송 메일 및 수신 거부를 처리하는 방법을 제어하도록 테넌트 수준 금지 설정을 구성합니다. 기본적으로 테넌트는 계정 수준 금지 목록을 사용합니다. 테넌트 수준 금지를 활성화하면 SES는 각 테넌트에 대해 별도의 금지 목록을 유지합니다. 이를 통해 이메일 전송 가능성을 세부적으로 제어할 수 있습니다.

이 주제에서는를 사용하여 테넌트 수준 금지 설정을 활성화, 수정, 비활성화 및 보는 절차를 제공합니다 AWS CLI.

중요

테넌트 수준 금지를 비활성화해도 테넌트의 금지 목록에서 기존 항목은 삭제되지 않습니다. 나중에 테넌트 수준 금지를 다시 활성화하면 해당 항목이 여전히 활성 상태입니다.

사전 조건

테넌트 수준 금지를 구성하기 전에 다음 요구 사항을 충족하는지 확인합니다.

SES 계정에서 다중 테넌시가 활성화됩니다.
계정에 테넌트가 하나 이상 있거나이 절차의 일부로 테넌트를 생성할 계획입니다.
AWS CLI 버전 2는 적절한 권한으로 설치 및 구성됩니다. 자세한 내용은 AWS Command Line Interface 사용 설명서를 참조하십시오.
계정 수준 금지 개념에 익숙합니다. 자세한 내용은 Amazon SES 계정 수준 금지 목록 사용 단원을 참조하십시오.

기존 테넌트에 대한 테넌트 수준 금지 활성화

PutTenantSuppressionAttributes API 작업을 사용하여 기존 테넌트에 대한 테넌트 수준 금지를 활성화합니다. 이 작업은 멱등성이 있으므로 부작용 없이 동일한 파라미터로 여러 번 호출할 수 있습니다.

테넌트 수준 금지를 활성화하려면

명령줄에서 다음 put-tenant-suppression-attributes 명령을 실행하여 반송 메일과 수신 거부 모두에 대해 테넌트 수준 금지를 활성화합니다.

MyTenant를 테넌트 이름으로 바꿉니다.

명령이 출력을 반환하지 않는지 확인합니다. 요청이 성공하면 본문 없이 HTTP 200 응답을 반환합니다.
다음 명령을 실행하여 구성을 확인합니다.
```
aws sesv2 get-tenant --tenant-name MyTenant
```

테넌트는 이제 반송 메일과 수신 거부 모두에 대해 자체 금지 목록을 사용합니다.

단일 이유 유형에 대해 금지를 구성할 수도 있습니다. 다음 예제에서는 반송 메일만 또는 수신 거부만 금지를 활성화하는 방법을 보여줍니다.

다음 명령은 반송 메일만 억제합니다.

다음 명령은 수신 거부만 억제합니다.

참고

--suppression-scope 및를 --suppressed-reasons 함께 제공해야 합니다. 다른 항목 없이 하나를 제공하면가 반환됩니다InvalidParameterValueException.

새 테넌트를 생성할 때 금지 구성

SuppressionAttributes 파라미터와 함께 CreateTenant API 작업을 사용하여 시작부터 테넌트 수준 금지가 활성화된 테넌트를 생성합니다.

테넌트 수준 금지를 사용하여 테넌트를 생성하려면

명령줄에서 다음 create-tenant 명령을 실행합니다.

MyNewTenant를 새 테넌트의 이름으로 바꿉니다.

응답에 테넌트 ID가 포함되어 있는지 확인합니다.
```
{
    "TenantId": "tn-abc123def456"
}
```

테넌트는 반송 메일과 수신 거부 모두에 대해 테넌트 수준 금지가 활성화된 상태로 생성됩니다.

참고

--suppression-attributes를 생략하면 테넌트는 기본적으로 ACCOUNT 범위를 지정하고 계정 수준 금지 목록을 사용합니다.

구성 세트를 사용하여 테넌트 금지 재정의

구성 세트의에를 추가하여 테넌트의 금지 설정을 재정의SuppressionScope할 수 있습니다SuppressionOptions. 이 구성 세트를 사용하여 이메일을 보내면 구성 세트의 금지 설정이 테넌트의 설정보다 우선합니다. 범위만, 이유만 또는 둘 다 독립적으로 재정의할 수 있습니다.

테넌트 범위 재정의로 구성 세트를 생성하려면

명령줄에서 다음 create-configuration-set 명령을 실행합니다.

my-config-set를 구성 세트의 이름으로 바꿉니다.

명령이 출력을 반환하지 않는지 확인합니다. 요청이 성공하면 HTTP 200 응답이 반환됩니다.

억제 옵션으로 기존 구성 세트를 업데이트하려면

명령줄에서 다음 put-configuration-set-suppression-options 명령을 실행합니다.

my-config-set를 구성 세트의 이름으로 바꿉니다.

명령이 출력을 반환하지 않는지 확인합니다. 요청이 성공하면 HTTP 200 응답이 반환됩니다.

테넌트 수준 금지 비활성화

테넌트를 계정 수준 금지로 되돌리려면 범위를 로 설정ACCOUNT하거나 모든 금지 설정을 지울 수 있습니다.

테넌트를 계정 수준 금지로 설정하려면

명령줄에서 ACCOUNT다음 명령을 실행하여 범위를 로 명시적으로 설정합니다.

MyTenant를 테넌트 이름으로 바꿉니다.

명령이 출력을 반환하지 않는지 확인합니다.

모든 금지 설정을 지우려면

명령줄에서 범위 또는 이유를 지정하지 않고 다음 명령을 실행합니다.
```
aws sesv2 put-tenant-suppression-attributes --tenant-name MyTenant
```
MyTenant를 테넌트 이름으로 바꿉니다.
명령이 출력을 반환하지 않는지 확인합니다.

참고

--suppression-scope 및를 모두 생략하면 --suppressed-reasonsSES가 테넌트의 금지 설정을 지웁니다. 테넌트는 계정 수준 금지 동작으로 돌아갑니다.

중요

현재 금지 구성 보기

GetTenant API 작업을 사용하여 테넌트의 현재 금지 설정을 확인합니다.

테넌트의 억제 구성을 보려면

명령줄에서 다음 get-tenant 명령을 실행합니다.
```
aws sesv2 get-tenant --tenant-name MyTenant
```
MyTenant를 테넌트 이름으로 바꿉니다.

응답을 검토합니다. 다음 예제에서는 테넌트 수준 금지가 활성화된 테넌트를 보여줍니다.


{
    "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"]
        }
    }
}

다음 표에서는 SuppressionAttributes 객체의 키 필드를 설명합니다.

필드	설명
`SuppressionScope`	테넌트의 금지 범위입니다. 값이 이면 테넌트가 자체 금지 목록을 사용한다`TENANT`는 의미입니다. 값이 `ACCOUNT`이면 테넌트가 계정 수준 금지 목록을 사용한다는 의미입니다.
`SuppressedReasons`	테넌트에 대해 활성 상태인 금지 이유입니다. 가능한 값은 `BOUNCE`, `COMPLAINT`또는 둘 다입니다.

SuppressionAttributes가 응답에 없거나 null인 경우 테넌트는 계정 수준 금지를 사용합니다.

문제 해결

다음은 테넌트 수준 금지를 구성할 때 발생할 수 있는 일반적인 오류입니다.

InvalidParameterValueException: SuppressedReasons cannot be null when SuppressionScope is provided

원인 - --suppression-scope 없이를 지정했습니다--suppressed-reasons.
수정 - 두 파라미터를 함께 제공하거나 두 파라미터를 모두 생략하여 설정을 지웁니다.

InvalidParameterValueException: SuppressionScope is required when SuppressedReasons are provided

원인 - --suppressed-reasons 없이를 지정했습니다--suppression-scope.
수정 - 두 파라미터를 함께 제공합니다.

NotFoundException

원인 - 지정한 테넌트 이름이 존재하지 않습니다.
수정 - 다음 명령을 실행하여 테넌트 이름을 확인합니다.
```
aws sesv2 list-tenants
```

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

테넌트 수준 금지 목록

테넌트 금지 항목 관리