本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# AWS 最终用户消息 SMS 中的电话池
电话池，也被称为池，是电话号码或发件人的集合 IDs ，这些号码或发件人的设置与可用于发送消息的设置相同。通过电话池发送消息时，它会选择适当的发起身份来发送消息。如果电话池中的某个发起身份出现故障，电话池将自动切换至同一电话池内的其他可用发送身份。
**注意**
电话池可以与 AWS Notify 配置相关联，以便使用您自己的专用电话号码和托管身份进行模板化消息。有关更多信息，请参阅 [在 “通知” 中使用专用号码](notify-dedicated-numbers.md)。
创建池时，您可以配置指定的发起身份。此身份包括关键字、消息类型、选择退出列表、双向配置和自行管理的选择退出配置。例如，通过使用池，您可以将已选择退出的目标电话号码列表与特定国家/地区的电话号码相关联。这使您可以防止向已选择不接收来自您的消息的用户发送消息。
添加到池中的每个电话号码的配置必须与您在创建池时指定的第一个电话号码的配置相匹配。例如，如果您创建的池中包含一个启用了双向消息的电话号码，则添加到该池中的其他号码也必须启用双向消息。
您还可以将 AWS RCS 代理作为发起身份添加到池中，以及您的电话号码和发件人。 IDs当 AWS RCS 代理位于池中时，该池会启用自动 RCS-to-SMS回退 — 如果 RCS 交付失败，该服务会使用同一池中的另一个发起身份自动通过 SMS 重试消息。有关使用池配置 RCS 回退的更多信息，请参阅。[使用电话池的 RCS 到 SMS 回退](rcs-sms-fallback.md)
**Topics**
+ [创建电话池](phone-pool-create.md)
+ [添加电话号码或发件人 ID](phone-pool-add-number.md)
+ [查看所有电话池](phone-pool-list.md)
+ [删除电话池](phone-pool-delete.md)
+ [更改池的选择退出列表](phone-pool-manage-opt-out-list.md)
+ [更新共享路由表](phone-pool-shared-routes.md)
+ [使用电话池删除保护](phone-pool-deletion-protection.md)
+ [管理电话池的标签](phone-pool-tags.md)
+ [列出共享电话池](phone-pool-shared.md)
+ [在池中管理 AWS RCS 代理](phone-pool-rcs-agents.md)
# 在 AWS 终端用户消息发送 SMS 服务中创建电话池
创建新的电话池时，该池将继承首个添加的电话号码或发件人 ID 的所有设置。例如，如果您创建的池中首个添加的电话号码启用了双向消息功能，则后续添加到该池的其他电话号码也必须启用双向消息功能。
------
#### [ Create a phone pool (Console) ]
要使用 AWS 终端用户消息发送 SMS 服务控制台创建电话池，请执行以下步骤：
**创建池（控制台）**
1. 打开 AWS 终端用户消息发送 SMS 服务控制台，网址为 [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。
1. 在导航窗格中的**配置**下，选择**电话池**。
1. 在**电话池**页面上，选择**创建电话池**。
1. 在**池设置**部分下，对于**池名称**，请输入池的名称。
1. 请选择以下选项之一：
+ **电话号码** – 在**可供关联的电话号码**部分，选择要与该池关联的电话号码。
+ **模拟器号码**（可选）– 如果没有任何电话号码且需申请模拟器号码，请选择**电话号码**，然后在**可供关联的电话号码**部分中，执行以下操作：
+ 选择**申请模拟器号码**。
+ 在**申请模拟器号码**中，从下拉列表中选择您的国家/地区。
+ 选择**申请号码**。
+ 在**可供关联的电话号码**中，选择新的模拟器电话号码。
+ **发件人 ID** – 在**可供关联的发件人 ID** 部分，选择要与该池关联的发件人 ID。
1. （可选）展开**标签**并选择**添加新标签**。
1. 输入新的空键/值对。
1. （可选）选择**添加标签**以添加其他标签。
1. 选择**创建电话池**。
------
#### [ Create a phone pool (AWS CLI) ]
您可以使用 [create-pool](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-pool.html) 命令来创建新的池。
当您使用 `RequestPhoneNumber` API 购买电话号码时，您也可以将电话号码添加到池中。有关更多信息，请参阅 [在 “ AWS 最终用户消息 SMS” 中请求电话号码](phone-numbers-request.md)。
**使用 AWS CLI 创建池**
+ 在命令行输入以下命令：
```
$ aws pinpoint-sms-voice-v2 create-pool \
> --origination-identity originationIdentity \
> --iso-country-code XX \
> --message-type TRANSACTIONAL
```
在前面的命令中，进行以下更改：
+ 将 *originationIdentity* 替换为您要添加到池中的电话号码或发件人 ID 的唯一 ID 或 Amazon 资源名称 (ARN)。
**提示**
您可以使用 [describe-phone-numbers](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-phone-numbers.html) 操作找到电话号码的 ID 和 ARN。您可以使用 [describe-sender-ids](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-sender-ids.html) 操作找到发件人 ID 的 ID 和 ARN。
+ 将 *XX* 替换为 *originationIdentity* 所在国家/地区的 ISO-3166 alpha-2 标识符。
+ 如果您打算使用池发送营销或促销信息，请将 *TRANSACTIONAL* 替换为 `PROMOTIONAL`。否则，请使用 `TRANSACTIONAL`。
------
# 向电话池添加电话号码或发件人 ID
按照以下说明向电话池添加电话号码或发件人 ID。添加到池中的每个电话号码或发件人 ID 的配置必须与电话池的配置相匹配。例如，如果您创建的池中首个添加的电话号码启用了双向消息功能，则后续添加到该池的其他电话号码也必须启用双向消息功能。
------
#### [ Add a phone number or sender ID to a pool (Console) ]
要使用 AWS 终端用户消息发送 SMS 服务控制台向电话池添加电话号码或发件人 ID，请按照以下步骤操作：
**添加电话号码或发件人 ID（控制台）**
1. 打开 AWS 终端用户消息发送 SMS 服务控制台，网址为 [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。
1. 在导航窗格中的**配置**下，选择**电话池**。
1. 在**电话池**页面上，选择要添加发起身份的电话池。
1. 在**关联的池发起人**选项卡上，选择**添加发起人**。
1. 请选择以下选项之一：
+ **电话号码** – 如果选择此选项，请在**可供关联的电话号码**部分下执行以下操作：
+ 选择要添加到电话池的电话号码。
+ **发件人 ID** – 如果选择此选项，请在**可供关联的发件人 ID** 部分下执行以下操作：
+ 选择要添加到电话池的发件人 ID。
1. 选择**将发起人添加到池中**。
------
#### [ Add a phone number or sender ID to a pool (AWS CLI) ]
您可以使用 [associate-origination-identity](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/associate-origination-identity.html) CLI 将电话号码或发件人 ID 添加到现有池中。
添加到池中的每个电话号码或发件人 ID 的配置必须与您在创建池时指定的第一个电话号码或发件人 ID 的配置相匹配。例如，如果您创建的池中包含一个启用了双向消息的电话号码，则添加到该池中的其他号码也必须启用双向消息。
**使用 AWS CLI 将电话号码或发件人 ID 添加到池中**
+ 在命令行输入以下命令：
```
$ aws pinpoint-sms-voice-v2 associate-origination-identity \
> --pool-id poolId \
> --origination-identity originationIdentity \
> --iso-country-code US
```
在前面的命令中，进行以下更改：
+ 将 *poolId* 替换为您要向其中添加发起身份的池的 ID 或 Amazon 资源名称 (ARN)。
+ 将 *originationIdentity* 替换为您要添加到池中的电话号码或发件人 ID 的唯一 ID 或 Amazon 资源名称 (ARN)。
+ 将 *\$112065550142* 替换为要添加到池中的发起身份。此值可以是短代码、电话号码或发件人 ID。
+ 将 *US* 替换为两个字母的 ISO-3166 alpha-2 代码，代表发起身份所在的国家/地区。
------
#### [ List origination identities (AWS CLI) ]
您可以使用 [list-pool-origination-identities](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/list-pool-origination-identities.html) CLI 查看已添加到特定池中的所有发起身份的信息。
**使用 AWS CLI 查看池中的发起 ID 列表**
+ 在命令行输入以下命令：
```
$ aws pinpoint-sms-voice-v2 list-pool-origination-identities \
> --pool-id pool-78ec067f62f94d57bd3bab991example
```
在上述命令中，将 *poolId* 替换为该池的 ID 或 Amazon 资源名称（ARN）。
------
# 查看 AWS 终端用户消息发送 SMS 服务中的所有电话池
您可以使用 [describe-pools](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-pools.html) CLI 查看有关现有池的信息。
此操作可提供 AWS 终端用户消息发送 SMS 服务账户中所有池的完整列表、有关特定池的信息或根据您定义的条件筛选出来的池列表。
**使用 AWS CLI 检索所有池的列表**
+ 在命令行输入以下命令：
```
$ aws pinpoint-sms-voice-v2 describe-pools
```
要查找有关特定池的信息，请使用 `PoolId` 参数。
**使用 AWS CLI 获取有关特定池的信息**
+ 在命令行输入以下命令：
```
$ aws pinpoint-sms-voice-v2 describe-pools \
> --pool-id poolId
```
在上述命令中，将 *poolId* 替换为该池的 ID 或 Amazon 资源名称（ARN）。
要查看经过筛选的池列表，请使用 `Filters` 参数。可以使用下列筛选器值：
+ `status` – 池的当前状态，例如 `ACTIVE`。
+ `message-type` – 使用池发送的消息的类型。可能的值为 `TRANSACTIONAL` 或 `PROMOTIONAL`。
+ `two-way-enabled` – 一个布尔值，表示是否为池中的号码启用了双向短信消息。
+ `self-managed-opt-outs-enabled` – 一个布尔值，表示是否为池中的号码启用了自行管理的短信选择退出。
+ `opt-out-list-name` – 与池关联的选择退出列表的名称。
+ `shared-routes-enabled` – 一个布尔值，表示是否为该池启用了共享路由。
+ `deletion-protection-enabled` – 一个布尔值，表示是否可以使用 `DeletePhoneNumber` 操作删除电话号码。
例如，如果要查看支持双向消息的事务性消息的池列表，请在命令行中输入以下命令：
```
$ aws pinpoint-sms-voice-v2 describe-pools \
> --filters Name=message-type,Values=TRANSACTIONAL \
> --filters Name=two-way-enabled,Values=true
```
# 在 “ AWS 最终用户消息 SMS” 中删除电话池
在删除电话池之前，您需要关闭**删除保护**功能，并移除电话池中的发起方，仅保留一个即可。有关如何禁用删除保护的更多信息，请参阅[在 AWS 终端用户消息发送 SMS 服务中使用电话池删除保护功能](phone-pool-deletion-protection.md)。与池关联的电话号码和发件 IDs 人仍保留在您的 “ AWS 最终用户消息” SMS 帐户中。
------
#### [ Delete a phone pool (Console) ]
在删除电话池之前，您需要关闭删除保护功能并从电话池中移除所有发起方。要使用 AWS 最终用户消息 SMS 控制台删除池，请执行以下步骤：
**删除电话池（控制台）**
1. 打开 AWS 最终用户消息 SMS 控制台，网址为[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。
1. 在导航窗格中的**配置**下，选择**电话池**。
1. 在**电话池**页面上，选择要删除的电话池。
1. 选择**删除**。
1. 输入 **release**，然后选择**确认**以删除该池。
------
#### [ Delete a phone pool (AWS CLI) ]
在删除电话池之前，您需要关闭删除保护功能并从电话池中移除所有发起方。您可以使用 [delete-pool](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-pool.html) API 来删除池。
**要使用删除池 AWS CLI**
+ 要删除池，在命令行处，键入以下命令：
```
$ aws pinpoint-sms-voice-v2 delete-pool \
> --pool-id pool-78ec067f62f94d57bd3bab991example
```
在前面的命令中，*pool-78ec067f62f94d57bd3bab991example*替换为池的唯一 ID 或 Amazon 资源名称 (ARN)。您可以通过执行 [describe-pools](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-pools.html) 操作来获取这两个值。
------
# 在 AWS 终端用户消息发送 SMS 服务中更改池的选择退出列表
*选择退出列表*是不应向其发送消息的目标手机号码列表。当您发送短信时，如果目标身份使用关键字 STOP 回复您的源号码，则除非您启用了自行管理的选择退出选项，否则目标身份会自动添加到选择退出列表中。如果您尝试向选择退出列表中的目标号码发送消息，并且该选择退出列表与用于发送消息的池相关联，则 AWS 终端用户消息发送 SMS 服务不会尝试发送消息。
默认情况下，创建的池会自动分配到*默认*选择退出列表。池可以共享同一选择退出列表。当您更改池的选择退出列表时，之前已选择退出的任何收件人可能不在新列表中，而会开始接收消息。有关在选择退出列表中添加或删除目标电话号码的更多信息，请参阅[将目标电话号码添加到 AWS 最终用户消息 SMS 的选择退出列表中](opt-out-list-add-phone-number.md)。
------
#### [ Change opt-out list (Console) ]
要使用 AWS 终端用户消息发送 SMS 服务控制台更改选择退出列表，请执行以下步骤：
**更改选择退出列表**
1. 打开 AWS 终端用户消息发送 SMS 服务控制台，网址为 [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。
1. 在导航窗格中的**配置**下，选择**电话池**。
1. 在**电话池**页面上，选择相应池。
1. 在**选择退出列表**选项卡上，选择**编辑设置**。
+ **创建新的选择退出列表** – 新建空白选择退出列表并输入易记名称。
+ **选择现有的选择退出列表** – 从下拉列表中选择之前创建的选择退出列表。
1. （可选）要启用自行管理的选择退出，请选择**启用自行管理的选择退出**。
1. 选择**保存更改**。
------
#### [ Change opt-out list (AWS CLI) ]
您可以使用 [update-pool](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-pool.html) 命令来更改池使用的选择退出列表。
在命令行输入以下命令：
```
$ aws pinpoint-sms-voice-v2 update-pool --pool-id poolid --opt-out-list-name OptOutListName
```
在前面的命令中，进行以下更改：
+ 将 *poolid* 替换为该池的 poolID 或 Amazon 资源名称（ARN）。
+ 将 *OptOutListName* 替换为 Amazon 资源名称（ARN）或选择退出列表名称。
------
# 更新 AWS 终端用户消息发送 SMS 服务中的共享路由
在某些国家/地区，AWS 终端用户消息发送 SMS 服务维护着一个共享发起身份池。当您激活共享路由时，AWS 终端用户消息发送 SMS 服务会设法使用其中一个共享身份来传送您的消息。发件身份可以是发件人 ID、长码或短码，且在每个国家/地区可能有所不同。当共享路由使用发件人 ID 作为发送身份时，该发件人 ID 将是通用发件人 ID，例如 `NOTICE`。在某些国家（包括美国），共享身份不可用。
**注意**
共享路由可能会受到更严格的下游过滤，因此在可用时，应优先使用专用路由。
**开启共享路由（AWS 管理控制台）**
1. 打开 AWS 终端用户消息发送 SMS 服务控制台，网址为 [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。
1. 在导航窗格中的**配置**下，选择**电话池**。
1. 在**电话池**页面上，选择要启用共享路由的电话池。
1. 在**共享路由**选项卡上，选择**编辑设置**按钮。
1. 选择**启用共享路由**，然后选择**保存更改**。
# 在 AWS 终端用户消息发送 SMS 服务中使用电话池删除保护功能
启用删除保护后，您将无法删除该池，直至禁用删除保护功能。默认情况下，删除保护处于禁用状态。
**启用删除保护（控制台）**
1. 打开 AWS 终端用户消息发送 SMS 服务控制台，网址为 [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。
1. 在导航窗格中的**配置**下，选择**电话池**。
1. 在**电话池**页面上，选择需要启用删除功能的电话池。
1. 在**删除保护**选项卡上，选择**编辑设置**。
1. 选择**启用删除保护**，然后选择**保存更改**。
# 管理 AWS 终端用户消息发送 SMS 服务中电话池的标签
标签是键值对，您可以选择将其应用于您的 AWS 资源以控制访问权限或使用。通过编辑名称键/值对的值来更改池的名称。
------
#### [ Manage tags (Console) ]
使用 AWS 终端用户消息发送 SMS 服务控制台在电话池中添加或编辑标签。
**管理标签（控制台）**
1. 打开 AWS 终端用户消息发送 SMS 服务控制台，网址为 [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。
1. 在导航窗格中的**配置**下，选择**电话池**。
1. 在**电话池**页面上，选择要添加标签的电话池。
1. 在**标签**选项卡上，选择**管理标签**。
+ **添加标签** – 在**管理标签**中，选择**添加新标签**以创建新的空白键/值对。
+ **删除标签** – 在**管理标签**中，选择键/值对旁边的**移除**。
+ **编辑标签** – 在**管理标签**中，选择**键**或**值**并编辑文本。
1. 选择**保存更改**。
------
#### [ Manage tags (AWS CLI) ]
使用 AWS CLI 添加或编辑标签。
```
$ aws pinpoint-sms-voice-v2 tag-resource \
--resource-arn resource-arn \
--tags tags={key1=value1,key2=value2}
```
在上述示例中，执行以下操作：
+ 将 *resource-arn* 替换为要添加标签的 Amazon 资源名称（ARN）。
+ 将 *key1* 和 *key2* 替换为要添加到资源中的标签的键。
+ 将 *value1* 和 *value2* 替换为要为相应键添加的标签的值。
使用 AWS CLI 删除标签。
```
$ aws pinpoint-sms-voice-v2 untag-resource \
--resource-arn resource-arn \
--tag-keys tags={key1=value1,key2=value2}
```
在上述示例中，执行以下操作：
+ 将 *resource-arn* 替换为要从中移除标签的 Amazon 资源名称（ARN）。
+ 将 *key1* 和 *key2* 替换为要移除的标签的键。
+ 将 *value1* 和 *value2* 替换为要移除的标签的值。
------
# 使用 AWS CLI 列出共享电话池
您可以使用 [describe-pools](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-pools.html) CLI 或 [AWS RAM 控制台](https://console.aws.amazon.com/ram)来查看与您的账户共享的池的相关信息。有关共享资源的更多信息，请参阅[在 “ AWS 最终用户消息 SMS” 中使用共享资源](shared-resources.md)。
**使用 AWS CLI 检索与您共享的池的列表**
+ 在命令行输入以下命令：
```
$ aws pinpoint-sms-voice-v2 describe-pools --owner SHARED
```
在上述命令中，将 *SHARED* 替换为 *SELF* 可列出您账户拥有的池。
# 在池中管理 AWS RCS 代理
您可以将 AWS RCS 代理作为发起身份添加到电话池中，旁边还有您的 SMS 电话号码。当池同时包含 AWS RCS 代理和 SMS 电话号码时， AWS 最终用户消息将首先尝试 RCS 交付，如果无法传送 RCS，则会自动回退到 SMS。有关后备工作原理的详细信息，请参阅[使用电话池的 RCS 到 SMS 回退](rcs-sms-fallback.md)。
**注意**
将 AWS RCS 代理添加到池中时，请使用`ZZ`作为 ISO 国家/地区代码。该`ZZ`代码表明 RCS 代理在池级别上不是特定国家/地区的。特定国家/地区的路线是通过代理商的国家/地区发射注册来处理的。一个地址池可以包含来自多个国家的电话号码以及RCS代理人。
ISO 国家/地区代码是在创建资源池时提供的，但不会保留在池中。如果您致电`DescribePools`，ISO 国家/地区代码不会出现在响应中。
## 使用 AWS RCS 代理创建池
您可以使用 AWS 最终用户消息控制台或 `CreatePool` API 创建包含您的 AWS RCS 代理的新池。
------
#### [ Console ]
**使用控制台创建带有 AWS RCS 代理的池**
1. 打开 AWS 最终用户消息控制台。
1. 在导航窗格中，选择 “**电话池**”。
1. 选择**创建池**。
1. 要获取**来源身份，请选择您的 AWS RCS 代理**。该池从您选择的来源身份继承其配置。
1. 根据需要配置池设置，然后选择**创建池**。
1. 创建池后，将您的 SMS 电话号码添加到池中以启用 SMS 回退。池中的所有发起身份都必须具有匹配的配置。有关更多信息，请参阅 [RCS 的池配置要求](#phone-pool-rcs-config)。
------
#### [ AWS CLI ]
使用 `CreatePool` API 创建以您的 AWS RCS 代理作为初始发起身份的池。创建池时，指定 AWS RCS 代理 ARN 作为发起身份。
以下示例使用 AWS CLI 创建池：
```
aws pinpoint-sms-voice-v2 create-pool \
--origination-identity arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id \
--iso-country-code ZZ \
--message-type TRANSACTIONAL
```
创建池后，使用 `AssociateOriginationIdentity` API 向池中添加 SMS 电话号码以备后用。
------
## 将 AWS RCS 代理添加到现有池中
如果您已经有一个包含短信电话号码的池，则可以将您的 AWS RCS 代理添加到该池中，以启用带有 SMS 回退功能的 RCS 消息传送。您还可以向已包含 AWS RCS 代理的池中添加其他 SMS 电话号码。
**重要**
在向现有池中添加源身份之前，请验证池的配置是否与您要添加的身份相匹配。池中的所有来源身份必须具有相同的元数据。如果存在不匹配项，则操作将失败，并显示为。`ConflictException`有关哪些字段必须匹配以及如何解决不匹配问题的详细信息，请参阅[RCS 的池配置要求](#phone-pool-rcs-config)。
------
#### [ Console ]
在使用控制台将 AWS RCS 代理添加到池之前，请检查池的详细信息页面以查看其当前配置。确认池的消息类型、ISO 国家/地区代码和其他设置与您要添加的 AWS RCS 代理兼容。
**使用控制台将 AWS RCS 代理添加到现有池中**
1. 打开 AWS 最终用户消息控制台。
1. 在导航窗格中，选择 “**电话池**”。
1. 选择您要将 AWS RCS 代理添加到的池。
1. 在详细信息页面上查看池的配置。确认消息类型和其他设置与您要添加的 AWS RCS 代理相匹配。
1. 在 “**来源身份**” 部分，选择**添加来源身份。**
1. 从列表中选择您的 AWS RCS 代理，然后选择**添加**。
------
#### [ AWS CLI ]
在使用 CLI 或 API 将 AWS RCS 代理添加到池之前，请使用 `DescribePools` API 检索池的当前配置。验证池的设置是否与您要添加的 AWS RCS 代理相匹配。
以下示例检索池的详细信息：
```
aws pinpoint-sms-voice-v2 describe-pools \
--pool-ids pool-id
```
确认配置匹配后，使用 `AssociateOriginationIdentity` API 将 AWS RCS 代理添加到池中：
```
aws pinpoint-sms-voice-v2 associate-origination-identity \
--pool-id pool-id \
--origination-identity arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id \
--iso-country-code ZZ
```
------
## RCS 的池配置要求
池中的所有来源身份必须具有相同的元数据。向池中添加发起身份时，“ AWS 最终用户消息” 会将该身份的配置与池的现有配置进行比较。如果存在不匹配项，则操作将失败`ConflictException`，其中包含有关不同特定字段的详细信息。
池配置字段分为两类：在创建池时设置且无法更改的不可变字段，以及创建后可以更新的可变字段。
**不可变与可变池配置字段**
| 字段 | 可变性 | 注意 |
| --- | --- | --- |
| 消息类型 | 不可变的 | 在创建池时设置。所有身份都必须匹配。 |
| ISO 国家/地区代码 | 不可变的 | 在创建池时设置。对于 AWS RCS 代理，值为ZZ。矿池可以包含来自多个国家的电话号码。 |
| 删除保护 | Mutable | 创建后可以切换。必须跨身份保持一致。 |
| 选择退出列表 | Mutable | 可以在创建后进行更改。必须跨身份保持一致。 |
以下配置字段必须与池中的所有原始身份相匹配：
+ **消息类型**-必须为相同的消息类型（例如，交易或促销）配置所有身份。
+ **ISO 国家/地区代码**-在创建资源池时设置。对于 AWS RCS 代理，请使用`ZZ`作为 ISO 国家/地区代码。矿池可以包含来自多个国家的电话号码。
+ **删除保护**-各身份的删除保护设置必须一致。
+ **选择退出列表** — 所有身份都必须与同一个选择退出列表相关联，否则所有身份都不应有选择退出列表。
### 了解 ConflictException 错误
当您尝试向池中添加发起身份但配置不匹配时，`AssociateOriginationIdentity`或 `CreatePool` API 会返回。`ConflictException`异常消息包含有关身份和池中哪些字段不同的详细信息。
例如，如果您尝试将为促销消息配置的电话号码添加到为交易消息配置的池中，则错误消息表明消息类型不匹配。
要解决以下问题`ConflictException`：
1. 查看错误消息以确定哪些字段不同。
1. 更新来源标识或池配置，使字段匹配。
1. 重试`AssociateOriginationIdentity`或`CreatePool`操作。
**注意**
如果您无法解决配置不匹配问题，请考虑为原始身份创建一个单独的池。每个池可以有自己的配置，您可以针对不同的用例使用不同的池。
## 从池中移除 AWS RCS 代理
您可以使用 AWS 最终用户消息控制台或 `DisassociateOriginationIdentity` API 从池中删除 AWS RCS 代理。从池中删除 AWS RCS 代理会禁用通过该池发送的消息的 RCS 传输。删除代理后发送到地址池的消息仅通过 SMS 传送（使用池中剩余的电话号码）。
------
#### [ Console ]
**使用控制台从池中删除 AWS RCS 代理**
1. 打开 AWS 最终用户消息控制台。
1. 在导航窗格中，选择 “**电话池**”。
1. 选择包含要删除的 AWS RCS 代理的池。
1. 在**来源身份**部分，选择 AWS RCS 代理。
1. 选择 “**删除**”，然后确认删除。
------
#### [ AWS CLI ]
使用 `DisassociateOriginationIdentity` API 从池中移除 AWS RCS 代理：
```
aws pinpoint-sms-voice-v2 disassociate-origination-identity \
--pool-id pool-id \
--origination-identity arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id \
--iso-country-code ZZ
```
移除 AWS RCS 代理后，通过池发送的消息仅通过 SMS 传送。要重新启用 RCS 交付，请使用 API 将 AWS RCS 代理重新添加到池中。`AssociateOriginationIdentity`
------