本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 在 AWS 最終使用者傳訊簡訊中使用共用資源
AWS 最終使用者簡訊 SMS 與 AWS Resource Access Manager (AWS RAM) 整合以啟用資源共用。 AWS RAM 是一種服務，可讓您與其他 AWS 帳戶 或透過 共用一些 AWS 最終使用者簡訊簡訊資源 AWS Organizations。您可以透過建立資源共享 AWS RAM，與 共用您擁有*的資源*。資源共享指定要共用的資源，以及共用它們的消費者。消費者可包括：
+ 中的特定組織 AWS 帳戶 內部或外部 AWS Organizations
+ 中的組織單位 AWS Organizations
+ 其在 中的整個組織 AWS Organizations
+ 其他 AWS 服務，例如 Amazon Pinpoint 或 Amazon SNS
如需 的詳細資訊 AWS RAM，請參閱*[AWS RAM 《 使用者指南》](https://docs.aws.amazon.com/ram/latest/userguide/)*。
本主題說明如何共用您擁有的參數，以及如何使用與您共用的參數。
**重要**
與其他 共用起始身分 AWS 帳戶 並不會授予這些帳戶傳送訊息到中國的許可。無論原始身分是透過 擁有或共用，每個 AWS 帳戶 都必須個別列入允許清單，才能傳送至中國 AWS RAM。如果取用帳戶嘗試使用共用的原始身分傳送至中國，而沒有自己的中國允許清單，則請求會失敗並出現`DESTINATION_COUNTRY_BLOCKED`驗證錯誤。
若要請求 帳戶的中國允許清單，請使用 開立案例 AWS 支援。如需詳細資訊，請參閱[透過 請求支援 SMS、MS 和語音訊息 支援](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，您必須在 中擁有該 ID AWS 帳戶。這表示必須在您的帳戶中配置或佈建資源。您無法共用與您共用的電話號碼、集區、選擇退出清單或寄件者 ID。
+ 若要與您的組織或 中的組織單位共用電話號碼、集區、選擇退出清單或寄件者 ID AWS Organizations，您必須啟用與 共用 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 帳戶之間共用資源的一種 AWS RAM 資源。資源共享指定要共用的資源，以及共用它們的消費者。當您使用 AWS 最終使用者傳訊簡訊主控台共用電話號碼、集區、選擇退出清單或寄件者 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 和語音 v2 API](https://docs.aws.amazon.com/pinpoint/latest/apireference_smsvoicev2/Welcome.html) 使用。若要使用共用資源，您必須使用完整的 Amazon Resource Name (ARN)。
若要檢視與您的帳戶共用的資源，您必須使用 AWS CLI 或 [AWS RAM 主控台](https://console.aws.amazon.com/ram)。
我們建議您使用 [AWS RAM 主控台](https://console.aws.amazon.com/ram)來共用資源。
**使用 AWS 最終使用者簡訊簡訊主控台共享您擁有的電話號碼、集區、選擇退出清單或寄件者 ID**
1. 在 https：//[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/) 開啟 AWS 最終使用者傳訊簡訊主控台。
1. 在導覽窗格中的**組態**下，選擇資源類型，然後選擇資源。
1. 在**資源政策**標籤上，選擇**編輯**。
1. 您可以編輯 JSON 資源型政策來變更共用許可。
1. 選擇**儲存變更**。
**使用 AWS RAM 主控台共用您擁有的電話號碼、集區、選擇退出清單或寄件者 ID**
請參閱《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 最終使用者傳訊簡訊主控台、 AWS RAM 主控台或 來執行此操作 AWS CLI。
**使用 AWS RAM 主控台取消共用您擁有的共用電話號碼、集區、選擇退出清單或寄件者 ID**
請參閱《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。
**注意**
電話號碼、集區、選擇不接收清單和寄件者 IDs 通常無法識別為 AWS 最終使用者簡訊 SMS 主控台中的共用資源。
**使用 識別共用電話號碼、集區、選擇退出清單或寄件者 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)、[describe-pools](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-pools.html) 或 [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-text-message](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-text-message.html)、[send-media-message](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-media-message.html) 或 [send-voice-message](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-voice-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 傳送具有指定電話號碼的 SMS 或語音訊息。
**使用 AWS 最終使用者簡訊 SMS 主控台共用您擁有的電話號碼**
1. 在 https：//[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/) 開啟 AWS 最終使用者傳訊簡訊主控台。
1. 在導覽窗格中的**組態**下，選擇**電話號碼**，然後選擇電話號碼。
1. 在**資源政策**標籤上，選擇**編輯**。
1. 您可以編輯 JSON 資源型政策來變更共用許可。
在下列 JSON 中，進行下列變更，然後將 JSON 貼到**資源政策**：
+ 將{{分割區}}取代為電話號碼所在的 AWS 分割區。
+ AWS 區域 使用電話號碼取代 {{區域}}。
+ 將{{帳戶}}取代為擁有電話號碼的帳號。
+ 將 {{Phone-id}} 取代為電話號碼的識別符。
1. 選擇**儲存變更**。
下列範例允許 Amazon Pinpoint 傳送具有指定寄件者 ID 的 SMS 訊息。
**使用 AWS 最終使用者簡訊 SMS 主控台共享您擁有的寄件者 ID**
1. 在 https：//[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/) 開啟 AWS 最終使用者傳訊簡訊主控台。
1. 在導覽窗格中的**組態**下，選擇**寄件者 IDs**，然後選擇寄件者 ID。
1. 在**資源政策**標籤上，選擇**編輯**。
1. 您可以編輯 JSON 資源型政策來變更共用許可。
在下列 JSON 中，進行下列變更，然後將 JSON 貼到**資源政策**：
+ 將{{分割區}}取代為寄件者 ID 所在的 AWS 分割區。
+ AWS 區域 使用寄件者 ID 取代 {{區域}}。
+ 將{{帳戶}}取代為擁有寄件者 ID 的帳號。
+ 將 {{Senderid}} 取代為寄件者 ID 的識別符。
+ 將 {{Countrycode}} 取代為寄件者 ID 國家/地區的兩個字母 ISO-3166 alpha-2 代碼。
1. 選擇**儲存變更**。
## 與 Amazon Pinpoint 和 Amazon SNS 共用寄件者 ID 的範例政策
我們建議您使用 [AWS RAM 主控台](https://console.aws.amazon.com/ram)來建立和管理資源共用。
下列範例允許 Amazon Pinpoint 和 Amazon SNS 傳送具有指定寄件者 ID 的 SMS 訊息。
**使用 AWS 最終使用者簡訊 SMS 主控台共享您擁有的寄件者 ID**
1. 在 https：//[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/) 開啟 AWS 最終使用者傳訊簡訊主控台。
1. 在導覽窗格中的**組態**下，選擇**寄件者 IDs**，然後選擇寄件者 ID。
1. 在**資源政策**標籤上，選擇**編輯**。
1. 您可以編輯 JSON 資源型政策來變更共用許可。
在下列 JSON 中，進行下列變更，然後將 JSON 貼到**資源政策**：
+ 將{{分割區}}取代為電話號碼所在的 AWS 分割區。
+ AWS 區域 使用電話號碼取代 {{區域}}。
+ 將 {{OwnersAccountID}} 取代為擁有寄件者 ID 的 AWS 帳號。
+ 將 {{SenderID}} 取代為寄件者 ID 的識別符。
+ 將 {{ISO}} 取代為寄件者 ID 國家/地區的兩個字母 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 傳送具有指定電話號碼的 SMS 訊息。
**使用 AWS 最終使用者簡訊 SMS 主控台共用您擁有的電話號碼**
1. 在 https：//[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/) 開啟 AWS 最終使用者傳訊簡訊主控台。
1. 在導覽窗格中的**組態**下，選擇**電話號碼**，然後選擇電話號碼。
1. 在**資源政策**標籤上，選擇**編輯**。
1. 您可以編輯 JSON 資源型政策來變更共用許可。
在下列 JSON 中，進行下列變更，然後將 JSON 貼到**資源政策**：
+ 將{{分割區}}取代為電話號碼所在的 AWS 分割區。
+ 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. 選擇**儲存變更**。