本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 在 “ AWS 最终用户消息 SMS” 中使用共享资源
AWS 最终用户消息 SMS 与 AWS Resource Access Manager (AWS RAM) 集成以实现资源共享。 AWS RAM 是一项服务，使您能够与其他人 AWS 账户 或通过共享某些 AWS 最终用户消息 SMS 资源 AWS Organizations。使用 AWS RAM，您可以通过创建资源共享来*共享您拥有的资源*。资源共享指定要共享的资源以及与之共享资源的使用者。使用者可包括：
+ 具体在其组织 AWS 账户 内部或外部 AWS Organizations
+ 其组织内部的组织单位 AWS Organizations
+ 它的整个组织都在 AWS Organizations
+ 其他 AWS 服务，例如亚马逊 Pinpoint 或亚马逊 SNS
有关的更多信息 AWS RAM，请参阅《*[AWS RAM 用户指南》](https://docs.aws.amazon.com/ram/latest/userguide/)*。
本主题说明如何共享您拥有的资源以及如何使用共享给您的资源。
**重要**
与其他人共享原始身份并 AWS 账户 不能授予这些账户向中国发送消息的权限。无论发件人身份是通过所有还是共享，都 AWS 账户 必须单独列入允许名单才能寄往中国。 AWS RAM如果消费者账户在没有自己的中国许可名单的情况下尝试使用共享来源身份向中国汇款，则该请求将因验证`DESTINATION_COUNTRY_BLOCKED`错误而失败。
要申请将账户列入中国许可名单，请向开立案例 AWS 支持。有关更多信息，请参阅 [通过支持请求短信、彩信和语音消息发送支持](awssupport.md)。
**Topics**
+ [共享电话号码、电话池、退出列表或发件人的先决条件 IDs](#sharing-prereqs)
+ [共享电话号码、池、选择退出列表或发件人 ID](#sharing-share)
+ [取消共享电话号码、池、选择退出列表或发件人 ID](#sharing-unshare)
+ [识别共享的电话号码、池、选择退出列表或发件人 ID](#sharing-identify)
+ [共享电话号码、电话池、退出列表或发件人的责任和权限 IDs](#sharing-perms)
+ [计费和计量](#sharing-billing)
+ [实例限额](#sharing-quotas)
+ [与 Amazon Pinpoint 共享发件人 ID 或电话号码的策略示例](#sharing-policy-example)
+ [与 Amazon Pinpoint 和 Amazon SNS 共享发件人 ID 的策略示例](#sharing-policy-example-sender-id)
+ [与 Amazon Pinpoint 和 Amazon SNS 共享电话号码的策略示例](#sharing-policy-example-phone-number)
## 共享电话号码、电话池、退出列表或发件人的先决条件 IDs
+ 要共享电话号码、池、选择退出列表或发件人 ID，您必须在自己的 AWS 账户账户中拥有该资源的所有权。这意味着资源必须分配或预调配到您的账户。您无法共享他人与您共享的电话号码、池、选择退出列表或发件人 ID。
+ 要与您的组织或 AWS Organizations中的组织单元共享电话号码、池、选择退出列表或发件人 ID，您必须启用与 AWS Organizations的共享功能。有关更多信息，请参阅《AWS RAM 用户指南》**中的[在 AWS Organizations中启用资源共享](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-sharing.html#getting-started-sharing-orgs)。
## 共享电话号码、池、选择退出列表或发件人 ID
当您与其他人共享您拥有的资源时 AWS 账户，您可以让他们执行以下操作：
+ **选择退出列表** – 有权访问此资源的使用者可以查看电话号码的状态、删除电话号码以及将电话号码添加到选择退出列表中。
+ **PhoneNumber**— 有权访问此资源的消费者可以使用电话号码发送消息。
+ **池** – 有权访问此资源的使用者可以查看该池。必须同时共享该池中包含的任何资源，其他 AWS 账户 账户才能访问它们。您可以在一个池中混合包含共享与非共享的资源。
+ **发件人 ID** – 有权访问此资源的使用者可以使用该发件人 ID 发送消息。
要共享电话号码、池、选择退出列表或发件人 ID，您必须将其添加到资源共享中。资源共享是一项 AWS RAM 资源，可让您跨 AWS 账户共享资源。资源共享指定要共享的资源以及与之共享资源的使用者。当您使用 AWS 最终用户消息 SMS 控制台共享电话号码、电话池、选择退出列表或发件人 ID 时，可以将其添加到现有资源共享中。要将电话号码、池、选择退出列表或发件人 ID 添加到新的资源共享，必须首先使用 [AWS RAM 控制台](https://console.aws.amazon.com/ram)创建该资源共享。
如果您是组织中的一员， AWS Organizations 并且启用了组织内部共享，则系统会自动授予您组织中的消费者访问共享电话号码、电话池、选择退出列表或发件人 ID 的访问权限。否则，使用者会收到加入资源共享的邀请，并在接受邀请后获得对所共享电话号码、池、选择退出列表或发件人 ID 的访问权限。
您可以使用 AWS 最终用户消息 SMS 控制台、控制台或，共享您拥有的电话号码、电话池、 AWS RAM 选择退出列表或发件人 ID。 AWS CLI
**注意**
共享资源只能通过 AWS CLI 或[AWS 最终用户消息 SMS 和 Voice v2 API](https://docs.aws.amazon.com/pinpoint/latest/apireference_smsvoicev2/Welcome.html) 使用。要使用共享资源，必须使用完整的 Amazon 资源名称（ARN）。
要查看与您的账户共享的资源，您必须使用 AWS CLI 或[AWS RAM 控制台](https://console.aws.amazon.com/ram)。
我们建议使用 [AWS RAM 控制台](https://console.aws.amazon.com/ram)共享资源。
**使用 AWS 最终用户消息 SMS 控制台共享您拥有的电话号码、电话池、退出列表或发件人 ID**
1. 打开 AWS 最终用户消息 SMS 控制台，网址为[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。
1. 在导航窗格的**配置**下，选择资源类型，然后选择资源。
1. 在**资源策略**选项卡上，选择**编辑**。
1. 您可以编辑 JSON 格式的基于资源的策略来更改共享权限。
1. 选择**保存更改**。
**使用控制台共享您拥有的电话号码、电话池、退出列表或发件人 ID AWS RAM**
请参阅《AWS RAM 用户指南》**中的[创建资源共享](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing.html#working-with-sharing-create)。
**要共享您拥有的电话号码、电话池、退出列表或发件人 ID，请使用 AWS CLI**
使用 [create-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/create-resource-share.html) 命令。
## 取消共享电话号码、池、选择退出列表或发件人 ID
当资源所有者停止与使用者共享电话号码、池、选择退出列表或发件人 ID 时，该资源将不再显示在使用者的控制台中。
要取消共享您拥有的已共享电话号码、池、选择退出列表或发件人 ID，您必须从资源共享中将其删除。您可以使用 AWS 最终用户消息 SMS 控制 AWS RAM 台、控制台或 AWS CLI。
**使用控制台取消共享您拥有的共享电话号码、电话池、退出列表或发件人 ID AWS RAM**
请参阅《AWS RAM 用户指南》**中的[更新资源共享](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing.html#working-with-sharing-update)。
**要取消共享您拥有的共享电话号码、电话池、退出列表或发件人 ID，请使用 AWS CLI**
使用 [disassociate-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/disassociate-resource-share.html) 命令。
## 识别共享的电话号码、池、选择退出列表或发件人 ID
所有者和消费者可以使用识别共享的电话号码、电话池、选择退出列表或发件人 IDs 。 AWS CLI
**注意**
在 AWS 最终用户消息 SMS 控制台中，电话号码、电话池、选择退出列表和发件人 IDs 通常无法识别为共享资源。
**要识别共享的电话号码、电话池、退出列表或发件人 ID，请使用 AWS CLI**
使用[describe-opt-out-lists](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-opt-out-lists.html)、[describe-phone-numbers](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-phone-numbers.html)、desc [ribe-poo](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-pools.html) ls 或[describe-sender-ids](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-sender-ids.html)命令并将`Owner`参数设置为。`SHARED`该命令返回与您共享的电话号码、电话池、退出列表或发 IDs 件人。
## 共享电话号码、电话池、退出列表或发件人的责任和权限 IDs
### 拥有者的权限
所有者可以更新、查看、共享、停止共享，以及使用电话号码、电话池、退出列表或发件人。 IDs
### 使用者的权限
消费者可以使用和查看电话号码、电话池、退出列表或发件人。 IDs
## 计费和计量
资源所有者需支付资源费用。使用者无需为共享给他们的资源付费，但使用资源发送消息会产生费用。共享资源不会产生额外的费用。
使用[send-media-message](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-media-message.html)或向消费者发送消息需要付费 [send-text-message[send-voice-message](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-voice-message.html)](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-text-message.html)，这计入消费者的支出限额。有关定价或支出限额的更多信息，请参阅 [AWS 终端用户消息发送服务定价](https://aws.amazon.com//end-user-messaging/pricing/)和[在 AWS 最终用户消息短信中设置短信、彩信或语音支出限制](spend-limit.md)。
## 实例限额
共享资源不会影响资源所有者或使用者账户中的资源限制。仅使用所有者的账户来计算资源限制。
## 与 Amazon Pinpoint 共享发件人 ID 或电话号码的策略示例
建议您使用 [AWS RAM 控制台](https://console.aws.amazon.com/ram)创建和管理资源共享。
以下示例允许 Amazon Pinpoint 使用指定的电话号码发送短信或语音消息。
**使用 AWS 最终用户消息 SMS 控制台共享您拥有的电话号码**
1. 打开 AWS 最终用户消息 SMS 控制台，网址为[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。
1. 在导航窗格中的**配置**下，选择**电话号码**，然后选择所需的电话号码。
1. 在**资源策略**选项卡上，选择**编辑**。
1. 您可以编辑 JSON 格式的基于资源的策略来更改共享权限。
在下面的 JSON 中，进行以下更改，然后将 JSON 粘贴到**资源策略**中：
+ {{Partition}}替换为电话号码所在的 AWS 分区。
+ {{Region}}替换 AWS 区域 为中的电话号码。
+ 替换{{Account}}为拥有该电话号码的账号。
+ {{Phone-id}}替换为电话号码的标识符。
1. 选择**保存更改**。
以下示例允许 Amazon Pinpoint 使用指定发件人 ID 发送短信。
**使用 AWS 最终用户消息 SMS 控制台共享您拥有的发件人 ID**
1. 打开 AWS 最终用户消息 SMS 控制台，网址为[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。
1. 在导航窗格的 “**配置**” 下，选择 “**发件人**”， IDs然后选择发件人 ID。
1. 在**资源策略**选项卡上，选择**编辑**。
1. 您可以编辑 JSON 格式的基于资源的策略来更改共享权限。
在下面的 JSON 中，进行以下更改，然后将 JSON 粘贴到**资源策略**中：
+ {{Partition}}替换为发件人 ID 所在的 AWS 分区。
+ {{Region}}替换为 AWS 区域 中的发件人 ID。
+ 替换为{{Account}}拥有发件人 ID 的账号。
+ {{Senderid}}替换为发件人 ID 的标识符。
+ {{Countrycode}}替换为发件人身份证所在国家/地区的双字母 ISO-3166 alpha-2 代码。
1. 选择**保存更改**。
## 与 Amazon Pinpoint 和 Amazon SNS 共享发件人 ID 的策略示例
建议您使用 [AWS RAM 控制台](https://console.aws.amazon.com/ram)创建和管理资源共享。
以下示例允许 Amazon Pinpoint 和 Amazon SNS 使用指定发件人 ID 发送短信。
**使用 AWS 最终用户消息 SMS 控制台共享您拥有的发件人 ID**
1. 打开 AWS 最终用户消息 SMS 控制台，网址为[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。
1. 在导航窗格的 “**配置**” 下，选择 “**发件人**”， IDs然后选择发件人 ID。
1. 在**资源策略**选项卡上，选择**编辑**。
1. 您可以编辑 JSON 格式的基于资源的策略来更改共享权限。
在下面的 JSON 中，进行以下更改，然后将 JSON 粘贴到**资源策略**中：
+ {{Partition}}替换为电话号码所在的 AWS 分区。
+ {{Region}}替换 AWS 区域 为中的电话号码。
+ 替换为{{OwnersAccountID}}拥有发件人 ID 的 AWS 账号。
+ {{SenderID}}替换为发件人 ID 的标识符。
+ {{ISO}}替换为发件人身份证所在国家/地区的双字母 ISO-3166 alpha-2 代码。
+ {{ConsumersAccountID}}替换为要访问的 AWS 账号。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "pinpoint.amazonaws.com"
},
"Action": [
"sms-voice:SendTextMessage",
"sms-voice:SendVoiceMessage"
],
"Resource": "arn:aws:sms-voice:{{us-east-1}}:{{111122223333}}:sender-id/{{SenderID}}/{{ISO}}",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "{{111122223333}}"
}
}
},
{
"Effect": "Allow",
"Principal": {
"Service": "sns.amazonaws.com"
},
"Action": "sms-voice:SendTextMessage",
"Resource": "arn:aws:sms-voice:{{us-east-1}}:{{111122223333}}:sender-id/{{SenderID}}/{{ISO}}",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "{{111122223333}}"
}
}
},
{
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::{{111122223333}}:root"
},
"Action": "sms-voice:SendTextMessage",
"Resource": "arn:aws:sms-voice:{{us-east-1}}:{{111122223333}}:sender-id/{{SenderID}}/{{ISO}}"
}
]
}
```
------
1. 选择**保存更改**。
## 与 Amazon Pinpoint 和 Amazon SNS 共享电话号码的策略示例
建议您使用 [AWS RAM 控制台](https://console.aws.amazon.com/ram)创建和管理资源共享。
以下示例允许 Amazon Pinpoint 和 Amazon SNS 使用指定的电话号码发送短信。
**使用 AWS 最终用户消息 SMS 控制台共享您拥有的电话号码**
1. 打开 AWS 最终用户消息 SMS 控制台，网址为[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)。
1. 在导航窗格中的**配置**下，选择**电话号码**，然后选择所需的电话号码。
1. 在**资源策略**选项卡上，选择**编辑**。
1. 您可以编辑 JSON 格式的基于资源的策略来更改共享权限。
在下面的 JSON 中，进行以下更改，然后将 JSON 粘贴到**资源策略**中：
+ {{Partition}}替换为电话号码所在的 AWS 分区。
+ {{Region}}替换 AWS 区域 为中的电话号码。
+ 替换{{OwnersAccountID}}为拥有该电话号码的 AWS 账号。
+ {{PhoneNumberID}}替换为电话号码的标识符。
+ {{ConsumersAccountID}}替换为要访问的 AWS 账号。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "pinpoint.amazonaws.com"
},
"Action": [
"sms-voice:SendTextMessage",
"sms-voice:SendVoiceMessage"
],
"Resource": "arn:aws:sms-voice:{{us-east-1}}:{{111122223333}}:phone-number/{{PhoneNumberID}}",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "{{111122223333}}"
}
}
},
{
"Effect": "Allow",
"Principal": {
"Service": "sns.amazonaws.com"
},
"Action": "sms-voice:SendTextMessage",
"Resource": "arn:aws:sms-voice:{{us-east-1}}:{{111122223333}}:phone-number/{{PhoneNumberID}}",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "{{111122223333}}"
}
}
},
{
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::{{111122223333}}:root"
},
"Action": "sms-voice:SendTextMessage",
"Resource": "arn:aws:sms-voice:{{us-east-1}}:{{111122223333}}:phone-number/{{PhoneNumberID}}"
}
]
}
```
------
1. 选择**保存更改**。