View a markdown version of this page

Arbeiten mit gemeinsam genutzten Ressourcen in AWS Nachrichtenübermittlung für Endbenutzer (SMS) - AWS SMS-Nachrichten für Endbenutzer
Voraussetzungen für die Weitergabe von Telefonnummer, Pool, Opt-Out-Liste oder Absender-IDsTeilen einer Telefonnummer, eines Pools, einer Opt-Out-Liste oder einer Absender-IDAufheben der Freigabe einer gemeinsamen Telefonnummer, eines Pools, einer Abmeldeliste oder einer Absender-IDIdentifizieren einer gemeinsam genutzten Telefonnummer, eines Pools, einer Abmeldeliste oder einer Absender-IDZuständigkeiten und Berechtigungen für gemeinsam genutzte Telefonnummern, Pools, Opt-Out-Listen oder Absender-IDsFakturierung und MessungKontingente für InstanzenBeispielrichtlinien für die Weitergabe einer Absender-ID oder Telefonnummer an Amazon PinpointBeispielrichtlinie für die gemeinsame Nutzung einer Absender-ID mit Amazon Pinpoint und Amazon SNSBeispielrichtlinie für die gemeinsame Nutzung einer Telefonnummer mit Amazon Pinpoint und Amazon SNS

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Arbeiten mit gemeinsam genutzten Ressourcen in AWS Nachrichtenübermittlung für Endbenutzer (SMS)

AWS End User Messaging SMS lässt sich in AWS Resource Access Manager (AWS RAM) integrieren, um die gemeinsame Nutzung von Ressourcen zu ermöglichen. AWS RAM ist ein Dienst, mit dem Sie einige SMS-Ressourcen für AWS End User Messaging mit anderen AWS-Konten oder über teilen können AWS Organizations. Mit teilen Sie Ressourcen AWS RAM, die Sie besitzen, indem Sie eine Ressourcenfreigabe 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

  • Es ist die gesamte Organisation in AWS Organizations

  • Andere AWS Dienste wie Amazon Pinpoint oder Amazon SNS

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

In diesem Thema wird erklärt, wie Sie Ressourcen teilen, deren Eigentümer Sie sind, und wie Sie Ressourcen verwenden, die mit Ihnen gemeinsam genutzt werden.

Wichtig

Gemeinsam genutzte Ressourcen (Telefonnummern, Absender-IDs, Pools und Opt-Out-Listen), auf die über zugegriffen wird, AWS RAM können nur mit der AWS End User Messaging SMS API verwendet werden (z. B. die SendTextMessage Aktion). Sie werden nicht unterstützt mit:

  • Amazon SNS (PublishAPI für SMS)

  • Amazon Pinpoint (API) SendMessages

  • Die AWS SMS-Konsole für Endbenutzer-Messaging

Um von einer gemeinsam genutzten Ressource aus zu senden, verwenden Sie AWS CLI oder an mit dem vollständigen Amazon-Ressourcennamen (ARN) der Ressource im SendTextMessage API-Aufruf.

Wichtig

Durch das Teilen der Ausgangsidentitäten mit anderen Benutzern AWS-Konten wird diesen Konten nicht die Erlaubnis erteilt, Nachrichten nach China zu senden. Jedes Konto AWS-Konto muss für den Versand nach China einzeln in die Zulassungsliste aufgenommen werden, unabhängig davon, ob die Identität des Absenders im Besitz der Person ist oder über sie geteilt wird. AWS RAM Wenn ein Nutzerkonto versucht, mit einer gemeinsamen Absenderidentität nach China zu senden, ohne dass eine eigene chinesische Zulassungsliste vorhanden ist, schlägt die Anfrage fehl und es wird ein Bestätigungsfehler angezeigt. DESTINATION_COUNTRY_BLOCKED

Um die Aufnahme eines Kontos in die chinesische Zulassungsliste zu beantragen, eröffnen Sie einen Fall bei. AWS Support Weitere Informationen finden Sie unter Unterstützung für SMS, MMS und Sprachnachrichten anfordern über Support.

Voraussetzungen für die Weitergabe von Telefonnummer, Pool, Opt-Out-Liste oder Absender-IDs

  • Um eine Telefonnummer, einen Pool, eine Opt-Out-Liste oder eine Absender-ID gemeinsam nutzen 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 Opt-Out-Liste oder eine Absender-ID, die mit Ihnen geteilt wurden, nicht teilen.

  • Um eine Telefonnummer, einen Pool, eine Opt-Out-Liste oder eine Absender-ID mit Ihrer Organisation oder einer Organisationseinheit in 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 Opt-Out-Liste oder einer Absender-ID

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

  • 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 Opt-Out-Liste oder eine Absender-ID gemeinsam zu nutzen, müssen Sie sie zu einer gemeinsam genutzten Ressource 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 Opt-Out-Liste oder eine Absender-ID mithilfe der SMS-Konsole für AWS Endbenutzer-Nachrichten teilen, fügen Sie diese zu einer vorhandenen Ressourcenfreigabe hinzu. Um die Telefonnummer, den Pool, die Opt-Out-Liste oder die Absender-ID zu einer neuen Ressourcenfreigabe hinzuzufügen, müssen Sie die Ressourcenfreigabe zunächst 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, der gemeinsamen Nutzung der Ressource beizutreten, und erhalten nach Annahme der Einladung Zugriff auf die gemeinsame Telefonnummer, den Pool, die Abmeldeliste oder die Absender-ID.

Sie können eine Telefonnummer, einen Pool, eine Opt-Out-Liste oder eine Absender-ID, die Sie besitzen, mit der AWS End User Messaging SMS-Konsole, AWS RAM Konsole oder dem teilen AWS CLI.

Anmerkung

Gemeinsam genutzte Ressourcen können nur über die AWS CLI oder AWS End User Messaging SMS and Voice v2-API verwendet werden. Sie müssen den vollständigen Amazon-Ressourcennamen (ARN) der gemeinsam genutzten Ressource verwenden. Das Senden über Amazon SNS, Amazon Pinpoint oder die AWS End User Messaging SMS-Konsole wird für gemeinsam genutzte Ressourcen nicht unterstützt.

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

Wir empfehlen, die AWS RAM Konsole zum Teilen von Ressourcen zu verwenden.

Um eine Telefonnummer, einen Pool, eine Opt-Out-Liste oder eine Absender-ID, die Ihnen gehören, zu teilen, verwenden Sie das AWS SMS-Konsole für Endbenutzer-Messaging

  1. Öffnen Sie die AWS End User Messaging SMS-Konsole unter https://console.aws.amazon.com/sms-voice/.

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

  3. Klicken Sie in der Registerkarte Zugriffsrichtlinie auf Bearbeiten.

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

  5. Wählen Sie Änderungen speichern aus.

Um eine Telefonnummer, einen Pool, eine Opt-Out-Liste oder eine Absender-ID, deren Eigentümer Sie sind, mit der AWS RAM Konsole

Siehe Erstellen einer Ressourcenfreigabe im AWS RAM -Benutzerhandbuch.

Um eine Telefonnummer, einen Pool, eine Opt-Out-Liste oder eine Absender-ID, die Ihnen gehören, mit anderen zu teilen, verwenden Sie AWS CLI

Verwenden Sie den Befehl create-resource-share.

Aufheben der Freigabe einer gemeinsamen Telefonnummer, eines Pools, einer Abmeldeliste oder einer Absender-ID

Wenn ein Ressourcenbesitzer aufhört, eine Telefonnummer, einen Pool, eine Opt-Out-Liste oder eine Absender-ID mit einem Verbraucher zu teilen, wird die Ressource nicht mehr in der Konsole des Verbrauchers angezeigt.

Um die gemeinsame Nutzung einer Telefonnummer, eines Pools, einer Opt-Out-Liste oder einer Absender-ID, deren Eigentümer Sie sind, aufzuheben, müssen Sie diese aus der gemeinsamen Nutzung der Ressource entfernen. Sie können dies über die AWS End User Messaging-SMS-Konsole, die AWS RAM Konsole oder die AWS CLI tun.

Um die gemeinsame Nutzung einer Telefonnummer, eines Pools, einer Abmeldeliste oder einer Absender-ID, deren Eigentümer Sie sind, aufzuheben, verwenden Sie die AWS RAM Konsole

Siehe Aktualisieren einer Ressourcenfreigabe im AWS RAM -Benutzerhandbuch.

Um die Freigabe einer geteilten Telefonnummer, eines Pools, einer Abmeldeliste oder einer Absender-ID, deren Eigentümer Sie sind, aufzuheben, verwenden Sie die AWS CLI

Verwenden Sie den Befehl disassociate-resource-share.

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

Eigentümer und Verbraucher können die gemeinsame Telefonnummer, den Pool, die Opt-Out-Liste oder die Absender-IDs mithilfe von identifizieren AWS CLI.

Anmerkung

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

Um eine gemeinsam genutzte Telefonnummer, einen Pool, eine Abmeldeliste oder eine Absender-ID zu identifizieren, verwenden Sie die AWS CLI

Verwenden Sie die Befehle describe-opt out-lists, describe-phone-numbers, describe-pools oder describe-sender-ids, wobei der Parameter auf gesetzt ist. https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-sender-ids.html Owner SHARED Der Befehl gibt die Telefonnummer, den Pool, die Opt-Out-Liste oder die Absender-IDs zurück, die mit Ihnen geteilt wurden.

Zuständigkeiten und Berechtigungen für gemeinsam genutzte Telefonnummern, Pools, Opt-Out-Listen oder Absender-IDs

Berechtigungen für Besitzer

Inhaber können die Telefonnummer, den Pool, die Opt-Out-Liste oder die Absender-IDs aktualisieren, ansehen, teilen, beenden und verwenden.

Berechtigungen für Konsumenten

Verbraucher können Telefonnummer, Pool, Opt-Out-Liste oder Absender-IDs verwenden und einsehen.

Fakturierung und Messung

Dem Eigentümer der Ressource wird die Ressource in Rechnung gestellt. Verbrauchern werden nicht die Ressourcen in Rechnung gestellt, die für sie freigegeben wurden, sondern für die Nutzung von Ressourcen zum Senden von Nachrichten. Mit der gemeinsamen Nutzung einer Ressource fallen keine zusätzlichen Kosten an.

Verbrauchern wird das Senden einer Nachricht mit Textnachricht, Medienmitteilung oder Sprachnachricht in Rechnung gestellt. Dies wird auf die Ausgabenlimits der Verbraucher angerechnet. Weitere Informationen zu Preisen oder Ausgabenlimits finden Sie unter Preise für Endverbraucher-Messaging und. AWS Legen Sie ein Ausgabenlimit für SMS, MMS oder Telefonie fest AWS Nachrichtenübermittlung für Endbenutzer

Kontingente für Instanzen

Die gemeinsame Nutzung einer Ressource hat keinen Einfluss auf die Beschränkungen 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 Weitergabe einer Absender-ID oder Telefonnummer an Amazon Pinpoint

Es wird empfohlen, die AWS RAM -Konsole zu verwenden, um Ressourcenfreigaben zu erstellen und zu verwalten.

Das folgende Beispiel ermöglicht Amazon Pinpoint, SMS- oder Sprachnachrichten mit der angegebenen Telefonnummer zu senden.

Um eine Telefonnummer, die Ihnen gehört, zu teilen, verwenden Sie die AWS SMS-Konsole für Endbenutzer-Messaging

  1. Öffnen Sie die AWS End User Messaging SMS-Konsole 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 auf JSON-Ressourcen basierende 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.

    • RegionErsetzen Sie durch AWS-Region die, 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.

  5. Wählen Sie Änderungen speichern aus.

Das folgende Beispiel ermöglicht Amazon Pinpoint, SMS-Nachrichten mit der angegebenen Absender-ID zu versenden.

Um eine Absender-ID, die Ihnen gehört, zu teilen, verwenden Sie die AWS SMS-Konsole für Endbenutzer-Messaging

  1. Öffnen Sie die AWS End User Messaging SMS-Konsole unter https://console.aws.amazon.com/sms-voice/.

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

  3. Klicken Sie in der Registerkarte Zugriffsrichtlinie auf Bearbeiten.

  4. Sie können die auf JSON-Ressourcen basierende 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 das, in AWS-Region dem sich die Absender-ID befindet.

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

    • SenderidErsetzen Sie es durch den Bezeichner der Absender-ID.

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

  5. Wählen Sie Änderungen speichern aus.

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

Es wird empfohlen, die AWS RAM -Konsole zu 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, zu teilen, verwenden Sie AWS SMS-Konsole für Endbenutzer-Messaging

  1. Öffnen Sie die AWS End User Messaging SMS-Konsole unter https://console.aws.amazon.com/sms-voice/.

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

  3. Klicken Sie in der Registerkarte Zugriffsrichtlinie auf Bearbeiten.

  4. Sie können die auf JSON-Ressourcen basierende 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.

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

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

    • SenderIDErsetzen Sie es durch den Bezeichner 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 Zugriff gewährt werden soll.

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

  5. Wählen Sie Änderungen speichern aus.

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

Es wird empfohlen, die AWS RAM -Konsole zu verwenden, um Ressourcenfreigaben zu erstellen und zu verwalten.

Das folgende Beispiel ermöglicht Amazon Pinpoint und Amazon SNS, SMS-Nachrichten mit der angegebenen Telefonnummer zu senden.

Um eine Telefonnummer, die Ihnen gehört, zu teilen, verwenden Sie die AWS SMS-Konsole für Endbenutzer-Messaging

  1. Öffnen Sie die AWS End User Messaging SMS-Konsole 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 auf JSON-Ressourcen basierende 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.

    • RegionErsetzen Sie durch AWS-Region die, 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 Zugriff gewährt werden soll.

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

  5. Wählen Sie Änderungen speichern aus.