Arbeiten mit gemeinsam genutzten Ressourcen in AWS End User Messaging SMS

AWS End User Messaging SMS ist in AWS Resource Access Manager (AWS RAM) integriert, um die gemeinsame Nutzung von Ressourcen zu ermöglichen. AWS RAM ist ein Dienst, der es Ihnen ermöglicht, einige SMS-Ressourcen für AWS Endbenutzer-Nachrichten mit anderen AWS Organizations zu teilen AWS-Konten oder über Mit können Sie Ressourcen AWS RAM, die Ihnen gehören, gemeinsam nutzen, indem Sie eine gemeinsame Nutzung erstellen. Eine Ressourcenfreigabe legt die freizugebenden Ressourcen und die Konsumenten fest, für die sie freigegeben werden sollen. Zu den Verbrauchern können folgende Angaben zählen:

• AWS-Konten Spezifisch innerhalb oder außerhalb der Organisation in AWS Organizations

• Eine Organisationseinheit innerhalb ihrer Organisation in AWS Organizations

• Ihre gesamte Organisation ist in AWS Organizations

• Andere AWS Dienste wie Amazon Pinpoint oder Amazon SNS

Weitere Informationen zu AWS RAM finden Sie im AWS RAM Benutzerhandbuch.

In diesem Thema wird erklärt, wie Sie Ressourcen, die Ihnen gehören, gemeinsam nutzen und wie Sie Ressourcen verwenden, die mit Ihnen gemeinsam genutzt werden.

Voraussetzungen für die gemeinsame Nutzung von Telefonnummer, Pool, Abmeldeliste oder Absender IDs

• Um eine Telefonnummer, einen Pool, eine Abmeldeliste oder eine Absender-ID teilen zu können, müssen Sie diese in Ihrem Konto haben AWS-Konto. Das bedeutet, dass die Ressource Ihrem Konto zugewiesen oder bereitgestellt werden muss. Sie können eine Telefonnummer, einen Pool, eine Abmeldeliste oder eine Absender-ID, die mit Ihnen geteilt wurde, nicht teilen.

• Um eine Telefonnummer, einen Pool, eine Abmeldeliste oder eine Absender-ID mit Ihrer Organisation oder einer Organisationseinheit zu teilen AWS Organizations, müssen Sie das Teilen mit aktivieren AWS Organizations. Weitere Informationen finden Sie unter Freigabe für AWS Organizations aktivieren im AWS RAM -Benutzerhandbuch.

Teilen einer Telefonnummer, eines Pools, einer Abmeldeliste oder einer Absender-ID

Wenn Sie Ressourcen, die Sie besitzen, mit anderen teilen AWS-Konten, ermöglichen Sie ihnen, Folgendes zu tun:

• Opt-Out-Liste — Verbraucher mit Zugriff auf diese Ressource können den Status einer Telefonnummer überprüfen, eine Telefonnummer entfernen und Telefonnummern zur Abmeldeliste hinzufügen.

• PhoneNumber— Verbraucher mit Zugriff auf diese Ressource können die Telefonnummer verwenden, um Nachrichten zu senden.

• Pool — Verbraucher mit Zugriff auf diese Ressource können den Pool einsehen. Alle im Pool enthaltenen Ressourcen müssen ebenfalls gemeinsam genutzt werden AWS-Konten , damit andere darauf zugreifen können. Sie können eine Mischung aus gemeinsam genutzten und nicht gemeinsam genutzten Ressourcen in einem Pool haben.

• Absender-ID — Verbraucher mit Zugriff auf diese Ressource können die Absender-ID zum Senden von Nachrichten verwenden.

Um eine Telefonnummer, einen Pool, eine Abmeldeliste oder eine Absender-ID gemeinsam zu nutzen, müssen Sie sie zu einer Ressourcenfreigabe hinzufügen. Eine Ressourcenfreigabe ist eine AWS RAM -Ressource, mit der Sie Ihre Ressourcen in mehreren AWS-Konten gemeinsam nutzen können. Eine Ressourcenfreigabe gibt die freizugebenden Ressourcen und die Konsumenten an, für die sie freigegeben werden. Wenn Sie eine Telefonnummer, einen Pool, eine Abmeldeliste oder eine Absender-ID über die SMS-Konsole für AWS Endbenutzernachrichten teilen, fügen Sie sie einer vorhandenen Ressourcenfreigabe hinzu. Um die Telefonnummer, den Pool, die Abmeldeliste oder die Absender-ID zu einer neuen Ressourcenfreigabe hinzuzufügen, müssen Sie zunächst die Ressourcenfreigabe mithilfe der AWS RAM Konsole erstellen.

Wenn Sie Teil einer Organisation sind AWS Organizations und die gemeinsame Nutzung innerhalb Ihrer Organisation aktiviert ist, erhalten Verbraucher in Ihrer Organisation automatisch Zugriff auf die gemeinsam genutzte Telefonnummer, den Pool, die Abmeldeliste oder die Absender-ID. Andernfalls erhalten Verbraucher eine Einladung zur Teilnahme an Resource Share und erhalten nach Annahme der Einladung Zugriff auf die gemeinsam genutzte Telefonnummer, den Pool, die Abmeldeliste oder die Absender-ID.

Sie können eine Telefonnummer, einen Pool, eine Abmeldeliste oder eine Absender-ID, deren Eigentümer Sie sind, über die SMS-Konsole, AWS RAM die Konsole oder die für AWS Endbenutzernachrichten freigeben AWS CLI.

Anmerkung

Gemeinsam genutzte Ressourcen können nur über die AWS CLI oder die AWS End User Messaging SMS and Voice v2-API verwendet werden. Um eine gemeinsam genutzte Ressource zu verwenden, müssen Sie den vollständigen Amazon-Ressourcennamen (ARN) verwenden.

Um Ressourcen anzuzeigen, die mit Ihrem Konto geteilt wurden, müssen Sie die Konsole AWS CLI oder die AWS RAM Konsole verwenden.

Wir empfehlen, die AWS RAM Konsole zu verwenden, um Ressourcen gemeinsam zu nutzen.

Um eine Telefonnummer, einen Pool, eine Abmeldeliste oder eine Absender-ID, deren Inhaber Sie sind, über die SMS-Konsole für AWS Endbenutzernachrichten zu teilen

1. Öffnen Sie die SMS-Konsole für AWS Endbenutzernachrichten unter https://console.aws.amazon.com/sms-voice/.

2. Wählen Sie im Navigationsbereich unter Konfigurationen den Ressourcentyp und anschließend die Ressource aus.

3. Klicken Sie in der Registerkarte Zugriffsrichtlinie auf Bearbeiten.

4. Sie können die ressourcenbasierte JSON-Richtlinie bearbeiten, um die Freigabeberechtigungen zu ändern.

5. Wählen Sie Änderungen speichern.

Um eine Telefonnummer, einen Pool, eine Abmeldeliste oder eine Absender-ID, die Ihnen gehören, mithilfe der AWS RAM Konsole zu teilen

Siehe Erstellen einer Ressourcenfreigabe im AWS RAM -Benutzerhandbuch.

Um eine Telefonnummer, einen Pool, eine Abmeldeliste oder eine Absender-ID, deren Inhaber Sie sind, mit der AWS CLI

Verwenden Sie den create-resource-share-Befehl.

Die Weitergabe einer geteilten Telefonnummer, eines Pools, einer Abmeldeliste oder einer Absender-ID rückgängig machen

Wenn ein Ressourcenbesitzer die gemeinsame Nutzung einer Telefonnummer, eines Pools, einer Abmeldeliste oder einer Absender-ID mit einem Verbraucher beendet, wird die Ressource nicht mehr in der Konsole des Verbrauchers angezeigt.

Um die gemeinsame Nutzung einer Telefonnummer, eines Pools, einer Abmeldeliste oder einer Absender-ID, deren Eigentümer Sie sind, rückgängig zu machen, müssen Sie sie aus der Ressourcenfreigabe entfernen. Sie können dazu die SMS-Konsole, AWS RAM die Konsole für AWS Endbenutzernachrichten oder die AWS CLI verwenden.

Um die gemeinsame Nutzung einer Telefonnummer, eines Pools, einer Abmeldeliste oder einer Absender-ID, deren Inhaber Sie sind, mithilfe der AWS RAM Konsole rückgängig zu machen

Siehe Aktualisieren einer Ressourcenfreigabe im AWS RAM -Benutzerhandbuch.

Um die gemeinsame Nutzung einer Telefonnummer, eines Pools, einer Abmeldeliste oder einer Absender-ID, deren Inhaber Sie sind, rückgängig zu machen, verwenden Sie die AWS CLI

Verwenden Sie den disassociate-resource-share-Befehl.

Identifizierung einer gemeinsam genutzten Telefonnummer, eines Pools, einer Abmeldeliste oder einer Absender-ID

Eigentümer und Verbraucher können IDs mithilfe der die gemeinsam genutzte Telefonnummer, den Pool, die Abmeldeliste oder den Absender identifizieren AWS CLI.

Anmerkung

Telefonnummern, Pools, Abmeldelisten und Absender IDs sind in der SMS-Konsole für AWS Endbenutzer-Messaging im Allgemeinen nicht als gemeinsam genutzte Ressource identifizierbar.

Um eine gemeinsam genutzte Telefonnummer, einen Pool, eine Abmeldeliste oder eine Absender-ID mithilfe der AWS CLI

Verwenden Sie den describe-sender-idsBefehl describe-opt-out-listsdescribe-phone-numbers,, describe-pools oder, wobei der Owner Parameter auf gesetzt ist. SHARED Der Befehl gibt die Telefonnummer, den Pool, die Abmeldeliste oder den Absender zurück, IDs die mit Ihnen geteilt wurden.

Zuständigkeiten und Berechtigungen für die gemeinsam genutzte Telefonnummer, den Pool, die Abmeldeliste oder den Absender IDs

Berechtigungen für Besitzer

Besitzer können Telefonnummer, Pool, Opt-Out-Liste oder Absender aktualisieren, ansehen, teilen, das Teilen beenden und verwenden IDs.

Berechtigungen für Konsumenten

Verbraucher können die Telefonnummer, den Pool, die Abmeldeliste oder den Absender verwenden und einsehen IDs.

Fakturierung und Messung

Dem Besitzer der Ressource wird die Ressource in Rechnung gestellt. Verbrauchern werden keine Ressourcen in Rechnung gestellt, die sie gemeinsam mit ihnen nutzen, sondern die Nutzung der Ressourcen zum Senden von Nachrichten. Mit der gemeinsamen Nutzung einer Ressource sind keine zusätzlichen Kosten verbunden.

Den Verbrauchern wird das Senden einer Nachricht mit send-media-messageoder send-voice-messagein Rechnung gestellt send-text-message, was auf die Ausgabenlimits der Verbraucher angerechnet wird. Weitere Informationen zu Preisen oder Ausgabenlimits finden Sie unter Preise für AWS Endbenutzer-Nachrichten undLegen Sie in AWS End User Messaging SMS ein Ausgabenlimit für SMS, MMS oder Telefonie fest.

Kontingente für Instanzen

Die gemeinsame Nutzung einer Ressource hat keinen Einfluss auf die Limits der Ressource im Konto des Eigentümers oder Verbrauchers. Nur das Konto des Besitzers wird verwendet, um die Limits der Ressource zu berechnen.

Beispielrichtlinien für die gemeinsame Nutzung einer Absender-ID oder Telefonnummer mit Amazon Pinpoint

Wir empfehlen, dass Sie die AWS RAM Konsole verwenden, um Ressourcenfreigaben zu erstellen und zu verwalten.

Das folgende Beispiel ermöglicht Amazon Pinpoint das Senden von SMS- oder Sprachnachrichten mit der angegebenen Telefonnummer.

Um eine Telefonnummer, die Ihnen gehört, über die SMS-Konsole für AWS Endbenutzer-Messaging weiterzugeben

1. Öffnen Sie die SMS-Konsole für AWS Endbenutzernachrichten unter https://console.aws.amazon.com/sms-voice/.

2. Wählen Sie im Navigationsbereich unter Konfigurationen die Option Telefonnummern und dann eine Telefonnummer aus.

3. Klicken Sie in der Registerkarte Zugriffsrichtlinie auf Bearbeiten.

4. Sie können die ressourcenbasierte JSON-Richtlinie bearbeiten, um die Freigabeberechtigungen zu ändern.

   Nehmen Sie in der folgenden JSON-Datei die folgenden Änderungen vor und fügen Sie die JSON-Datei dann in die Ressourcenrichtlinie ein:

   • PartitionErsetzen Sie durch die AWS Partition, in der sich die Telefonnummer befindet.

   • Ersetze es Region durch AWS-Region die Telefonnummer, in der sich die Telefonnummer befindet.

   • AccountErsetzen Sie es durch die Kontonummer, der die Telefonnummer gehört.

   • Phone-idErsetzen Sie es durch die Kennung der Telefonnummer.

   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Effect": "Allow",
               "Principal": {
                   "Service": "pinpoint.amazonaws.com"
               },
               "Action": [
                   "sms-voice:SendTextMessage",
                   "sms-voice:SendVoiceMessage"
               ]
               "Resource":"arn:Partition:sms-voice:Region:Account:phone-number/Phone-id",
               "Condition": {
                   "StringEquals": {
                       "aws:SourceAccount": "Account"
                   }
               }
           }
       ]
   }

5. Wählen Sie Änderungen speichern.

Das folgende Beispiel ermöglicht Amazon Pinpoint das Senden von SMS-Nachrichten mit der angegebenen Absender-ID.

Um eine Absender-ID, die Ihnen gehört, über die SMS-Konsole für AWS Endbenutzer-Messaging weiterzugeben

1. Öffnen Sie die SMS-Konsole für AWS Endbenutzernachrichten unter https://console.aws.amazon.com/sms-voice/.

2. Wählen Sie im Navigationsbereich unter Konfigurationen die Option Sender IDs und dann eine Absender-ID aus.

3. Klicken Sie in der Registerkarte Zugriffsrichtlinie auf Bearbeiten.

4. Sie können die ressourcenbasierte JSON-Richtlinie bearbeiten, um die Freigabeberechtigungen zu ändern.

   Nehmen Sie in der folgenden JSON-Datei die folgenden Änderungen vor und fügen Sie die JSON-Datei dann in die Ressourcenrichtlinie ein:

   • PartitionErsetzen Sie durch die AWS Partition, in der sich die Absender-ID befindet.

   • RegionErsetzen Sie durch die Absender-ID, in AWS-Region der sich die Absender-ID befindet.

   • AccountErsetzen Sie es durch die Kontonummer, der die Absender-ID gehört.

   • SenderidErsetzen Sie es durch die ID der Absender-ID.

   • CountrycodeErsetzen Sie ihn durch den zweibuchstabigen ISO-3166-Alpha-2-Code für das Land der Absender-ID.

   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Effect": "Allow",
               "Principal": {
                   "Service": "pinpoint.amazonaws.com"
               },
               "Action": [
                   "sms-voice:SendTextMessage"
               ]
               "Resource":"arn:Partition:sms-voice:Region:Account:sender-id/Senderid/Countrycode",
               "Condition": {
                   "StringEquals": {
                       "aws:SourceAccount": "Account"
                   }
               }
           }
       ]
   }

5. Wählen Sie Änderungen speichern.

Beispielrichtlinie für die gemeinsame Nutzung einer Absender-ID mit Amazon Pinpoint und Amazon SNS

Wir empfehlen, dass Sie die AWS RAM Konsole verwenden, um Ressourcenfreigaben zu erstellen und zu verwalten.

Im folgenden Beispiel können Amazon Pinpoint und Amazon SNS SMS-Nachrichten mit der angegebenen Absender-ID senden.

Um eine Absender-ID, die Ihnen gehört, über die SMS-Konsole für AWS Endbenutzernachrichten weiterzugeben

1. Öffnen Sie die SMS-Konsole für AWS Endbenutzernachrichten unter https://console.aws.amazon.com/sms-voice/.

2. Wählen Sie im Navigationsbereich unter Konfigurationen die Option Sender IDs und dann eine Absender-ID aus.

3. Klicken Sie in der Registerkarte Zugriffsrichtlinie auf Bearbeiten.

4. Sie können die ressourcenbasierte JSON-Richtlinie bearbeiten, um die Freigabeberechtigungen zu ändern.

   Nehmen Sie in der folgenden JSON-Datei die folgenden Änderungen vor und fügen Sie die JSON-Datei dann in die Ressourcenrichtlinie ein:

   • PartitionErsetzen Sie durch die AWS Partition, in der sich die Telefonnummer befindet.

   • Ersetze es Region durch AWS-Region die Telefonnummer, in der sich die Telefonnummer befindet.

   • OwnersAccountIDErsetzen Sie es durch die AWS Kontonummer, der die Absender-ID gehört.

   • SenderIDErsetzen Sie es durch die ID der Absender-ID.

   • ISOErsetzen Sie ihn durch den zweibuchstabigen ISO-3166-Alpha-2-Code für das Land der Absender-ID.

   • Ersetzen Sie es ConsumersAccountID durch die AWS Kontonummer, auf die Sie Zugriff gewähren möchten.

   
   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Principal": {
           "Service": "pinpoint.amazonaws.com"
         },
         "Action": [
           "sms-voice:SendTextMessage",
           "sms-voice:SendVoiceMessage"
         ],
         "Resource": "arn:Partition:sms-voice:Region:OwnersAccountID:sender-id/SenderID/ISO",
         "Condition": {
           "StringEquals": {
             "aws:SourceAccount": "OwnersAccountID"
           }
         }
       },
       {
         "Effect": "Allow",
         "Principal": {
           "Service": "sns.amazonaws.com"
         },
         "Action": "sms-voice:SendTextMessage",
         "Resource": "arn:Partition:sms-voice:Region:OwnersAccountID:sender-id/SenderID/ISO",
         "Condition": {
           "StringEquals": {
             "aws:SourceAccount": "OwnersAccountID"
           }
         }
       },
       {
         "Effect": "Allow",
         "Principal": {
           "AWS": "arn:aws:iam::ConsumersAccountID:root"
         },
         "Action": "sms-voice:SendTextMessage",
         "Resource": "arn:Partition:sms-voice:Region:OwnersAccountID:sender-id/SenderID/ISO"
       }
     ]
   }
           

5. Wählen Sie Änderungen speichern.

Beispielrichtlinie für die gemeinsame Nutzung einer Telefonnummer mit Amazon Pinpoint und Amazon SNS

Wir empfehlen, dass Sie die AWS RAM Konsole verwenden, um Ressourcenfreigaben zu erstellen und zu verwalten.

Im folgenden Beispiel können Amazon Pinpoint und Amazon SNS SMS-Nachrichten mit der angegebenen Telefonnummer senden.

Um eine Telefonnummer, die Ihnen gehört, über die SMS-Konsole für AWS Endbenutzernachrichten weiterzugeben

1. Öffnen Sie die SMS-Konsole für AWS Endbenutzernachrichten unter https://console.aws.amazon.com/sms-voice/.

2. Wählen Sie im Navigationsbereich unter Konfigurationen die Option Telefonnummern und dann eine Telefonnummer aus.

3. Klicken Sie in der Registerkarte Zugriffsrichtlinie auf Bearbeiten.

4. Sie können die ressourcenbasierte JSON-Richtlinie bearbeiten, um die Freigabeberechtigungen zu ändern.

   Nehmen Sie in der folgenden JSON-Datei die folgenden Änderungen vor und fügen Sie die JSON-Datei dann in die Ressourcenrichtlinie ein:

   • PartitionErsetzen Sie durch die AWS Partition, in der sich die Telefonnummer befindet.

   • Ersetze es Region durch AWS-Region die Telefonnummer, in der sich die Telefonnummer befindet.

   • OwnersAccountIDErsetzen Sie es durch die AWS Kontonummer, der die Telefonnummer gehört.

   • PhoneNumberIDErsetzen Sie es durch die Kennung der Telefonnummer.

   • ConsumersAccountIDErsetzen Sie es durch die AWS Kontonummer, auf die Sie zugreifen möchten.

   
   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Principal": {
           "Service": "pinpoint.amazonaws.com"
         },
         "Action": [
           "sms-voice:SendTextMessage",
           "sms-voice:SendVoiceMessage"
         ],
         "Resource": "arn:Partition:sms-voice:Region:OwnersAccountID:phone-number/PhoneNumberID",
         "Condition": {
           "StringEquals": {
             "aws:SourceAccount": "OwnersAccountID"
           }
         }
       },
       {
         "Effect": "Allow",
         "Principal": {
           "Service": "sns.amazonaws.com"
         },
         "Action": "sms-voice:SendTextMessage",
         "Resource": "arn:Partition:sms-voice:Region:OwnersAccountID:phone-number/PhoneNumberID",
         "Condition": {
           "StringEquals": {
             "aws:SourceAccount": "OwnersAccountID"
           }
         }
       },
       {
         "Effect": "Allow",
         "Principal": {
           "AWS": "arn:aws:iam::ConsumersAccountID:root"
         },
         "Action": "sms-voice:SendTextMessage",
         "Resource": "arn:Partition:sms-voice:Region:OwnersAccountID:phone-number/PhoneNumberID"
       }
     ]
   }
           

5. Wählen Sie Änderungen speichern.