View a markdown version of this page

Lavorare con risorse condivise in AWS Messaggistica SMS per l'utente finale - AWS Messaggistica SMS per l'utente finale
Prerequisiti per la condivisione del numero di telefono, del pool, della lista di esclusione o degli ID mittenteCondivisione di un numero di telefono, un pool, un elenco di opt-out o un ID mittenteAnnullare la condivisione di un numero di telefono, un pool, un elenco di opt-out o un ID mittente condivisiIdentificare un numero di telefono, un pool, un elenco di opt-out o un ID mittente condivisiResponsabilità e autorizzazioni per numero di telefono, pool, elenco di opt-out o ID mittente condivisiFatturazione e misurazioneQuote di istanzaEsempi di politiche per la condivisione di un ID mittente o di un numero di telefono con Amazon PinpointEsempio di politica per la condivisione di un ID mittente con Amazon Pinpoint e Amazon SNSEsempio di politica per la condivisione di un numero di telefono con Amazon Pinpoint e Amazon SNS

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Lavorare con risorse condivise in AWS Messaggistica SMS per l'utente finale

AWS End User Messaging SMS si integra con AWS Resource Access Manager (AWS RAM) per consentire la condivisione delle risorse. AWS RAM è un servizio che consente di condividere alcune risorse SMS di messaggistica per gli utenti AWS finali con altri Account AWS o tramite AWS Organizations. Con AWS RAM, condividi le risorse che possiedi creando una condivisione di risorse. Una condivisione delle risorse specifica le risorse da condividere e gli utenti con cui condividerle. I consumatori includono:

  • Specifico Account AWS all'interno o all'esterno della sua organizzazione in AWS Organizations

  • Un'unità organizzativa all'interno della sua organizzazione in AWS Organizations

  • La sua intera organizzazione in AWS Organizations

  • Altri AWS servizi come Amazon Pinpoint o Amazon SNS

Per ulteriori informazioni AWS RAM, consulta la Guida per l'AWS RAM utente.

Questo argomento spiega come condividere le tue risorse e come utilizzare le risorse condivise con te.

Importante

Le risorse condivise (numeri di telefono, ID mittente, pool ed elenchi di opt-out) a cui si accede tramite AWS RAM possono essere utilizzate solo con l'API AWS End User Messaging SMS (ad esempio, l'SendTextMessageazione). Non sono supportate con:

  • Amazon SNS (PublishAPI per SMS)

  • Amazon Pinpoint (API) SendMessages

  • La console SMS di messaggistica per l'utente AWS finale

Per inviare da una risorsa condivisa, usa l' AWS CLI or an con l'Amazon Resource Name (ARN) completo della risorsa nella chiamata SendTextMessage API.

Importante

La condivisione delle identità di origine con altri Account AWS non consente a tali account di inviare messaggi in Cina. Ciascuno Account AWS deve essere inserito individualmente nell'elenco dei dispositivi autorizzati per l'invio in Cina, indipendentemente dal fatto che l'identità di origine sia posseduta o condivisa tramite. AWS RAM Se un account di consumo tenta di inviare in Cina utilizzando un'identità di origine condivisa senza la propria lista di autorizzazione in Cina, la richiesta non andrà a buon fine e verrà visualizzato un errore di convalida. DESTINATION_COUNTRY_BLOCKED

Per richiedere l'autorizzazione all'iscrizione in Cina per un account, aprite una richiesta con. Supporto AWS Per ulteriori informazioni, consulta Richiesta di supporto per SMS, MMS e messaggistica vocale tramite Supporto.

Prerequisiti per la condivisione del numero di telefono, del pool, della lista di esclusione o degli ID mittente

  • Per condividere un numero di telefono, un pool, un elenco di opt-out o un ID mittente, devi possederlo nel tuo. Account AWS Ciò significa che la risorsa deve essere allocata o assegnata all’account. Non puoi condividere un numero di telefono, un pool, un elenco di opt-out o un ID mittente che sono stati condivisi con te.

  • Per condividere un numero di telefono, un pool, un elenco di opt-out o un ID mittente con la tua organizzazione o un'unità organizzativa in AWS Organizations, devi abilitare la condivisione con. AWS Organizations Per ulteriori informazioni, consulta Abilitare la condivisione con AWS Organizations nella Guida per l’utente AWS RAM .

Condivisione di un numero di telefono, un pool, un elenco di opt-out o un ID mittente

Quando condividi una risorsa che possiedi con altri Account AWS, consenti loro di fare quanto segue:

  • Opt-Out Elenco: i consumatori che hanno accesso a questa risorsa possono verificare lo stato di un numero di telefono, rimuovere un numero di telefono e aggiungere numeri di telefono all'elenco di esclusione.

  • PhoneNumber— I consumatori con accesso a questa risorsa possono utilizzare il numero di telefono per inviare messaggi.

  • Pool: i consumatori con accesso a questa risorsa possono visualizzare il pool. Tutte le risorse contenute nel pool devono inoltre essere condivise Account AWS affinché altri possano accedervi. È possibile avere una combinazione di risorse condivise e non condivise in un pool.

  • ID mittente: i consumatori con accesso a questa risorsa possono utilizzare l'ID mittente per inviare messaggi.

Per condividere un numero di telefono, un pool, un elenco di opt-out o un ID mittente, devi aggiungerlo a una condivisione di risorse. Una condivisione di risorse è una risorsa AWS RAM che consente di condividere le risorse tra Account AWS. Una condivisione di risorse specifica le risorse da condividere e i consumatori con cui sono condivise. Quando condividi un numero di telefono, un pool, un elenco di opt-out o un ID mittente utilizzando la console SMS di messaggistica utente AWS finale, lo aggiungi a una condivisione di risorse esistente. Per aggiungere il numero di telefono, il pool, l'elenco di opt-out o l'ID del mittente a una nuova condivisione di risorse, devi prima creare la condivisione di risorse utilizzando la console. AWS RAM

Se fai parte di un'organizzazione AWS Organizations e la condivisione all'interno della tua organizzazione è abilitata, ai consumatori dell'organizzazione viene automaticamente concesso l'accesso al numero di telefono, al pool, all'elenco di opt-out o all'ID mittente condivisi. In caso contrario, i consumatori ricevono un invito a partecipare alla condivisione delle risorse e hanno accesso al numero di telefono condiviso, al pool, all'elenco di opt-out o all'ID mittente dopo aver accettato l'invito.

Puoi condividere un numero di telefono, un pool, un elenco di opt-out o un ID mittente di tua proprietà utilizzando la console SMS di messaggistica AWS finale, AWS RAM la console o il. AWS CLI

Nota

Le risorse condivise possono essere utilizzate solo tramite l' AWS CLI API AWS End User Messaging SMS and Voice v2. È necessario utilizzare l'Amazon Resource Name (ARN) completo della risorsa condivisa. L'invio tramite Amazon SNS, Amazon Pinpoint o la console SMS di AWS End User Messaging non è supportato per le risorse condivise.

Per visualizzare le risorse condivise con il tuo account devi utilizzare AWS CLI o la AWS RAM console.

Ti consigliamo di utilizzare la AWS RAM console per condividere le risorse.

Per condividere un numero di telefono, un pool, un elenco di esclusione o un ID mittente di tua proprietà, utilizza AWS Console SMS per la messaggistica con l'utente finale

  1. Aprire la console AWS End User Messaging SMS all'indirizzo https://console.aws.amazon.com/sms-voice/.

  2. Nel riquadro di navigazione, in Configurazioni, scegli il tipo di risorsa e poi la risorsa.

  3. Nella scheda Policy delle risorse, seleziona Modifica.

  4. Puoi modificare la politica basata sulle risorse JSON per modificare le autorizzazioni di condivisione.

  5. Scegli Save changes (Salva modifiche).

Per condividere un numero di telefono, un pool, un elenco di opt-out o un ID mittente di tua proprietà utilizzando AWS RAM console

Consulta Creazione di una condivisione di risorse in Guida per l'utente di AWS RAM .

Per condividere un numero di telefono, un pool, un elenco di esclusione o un ID mittente di tua proprietà, utilizza AWS CLI

Utilizza il comando create-resource-share.

Annullare la condivisione di un numero di telefono, un pool, un elenco di opt-out o un ID mittente condivisi

Quando il proprietario di una risorsa smette di condividere un numero di telefono, un pool, un elenco di opt-out o un ID mittente con un consumatore, la risorsa non viene più visualizzata nella console del consumatore.

Per annullare la condivisione di un numero di telefono, di un pool, di un elenco di opt-out o di un ID mittente condiviso di tua proprietà, devi rimuoverlo dalla condivisione della risorsa. Puoi farlo utilizzando la console SMS di messaggistica per utenti AWS finali, AWS RAM la console o il. AWS CLI

Per annullare la condivisione di un numero di telefono, di un pool, di un elenco di opt-out o di un ID mittente condiviso di tua proprietà utilizzando il AWS RAM console

Consulta Aggiornamento di una condivisione di risorse in Guida per l'utente di AWS RAM .

Per annullare la condivisione di un numero di telefono, un pool, un elenco di esclusione o un ID mittente condiviso di tua proprietà utilizzando AWS CLI

Utilizza il comando disassociate-resource-share.

Identificare un numero di telefono, un pool, un elenco di opt-out o un ID mittente condivisi

I proprietari e i consumatori possono identificare il numero di telefono, il pool, l'elenco di opt-out o gli ID mittente condivisi utilizzando il. AWS CLI

Nota

I numeri di telefono, i pool, l'elenco di opt-out e gli ID mittente non sono generalmente identificabili come risorse condivise nella console SMS di messaggistica per utenti finali. AWS

Per identificare un numero di telefono, un pool, un elenco di opt-out o un ID mittente condivisi utilizzando AWS CLI

Utilizza il comando describe-opt-out-lists, describe-phone-numbers, describe-pools o describe-sender-ids con il parametro impostato su. https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-pools.html https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-sender-ids.html Owner SHARED Il comando restituisce il numero di telefono, il pool, l'elenco di opt-out o gli ID mittente condivisi con te.

Responsabilità e autorizzazioni per numero di telefono, pool, elenco di opt-out o ID mittente condivisi

Autorizzazioni per i proprietari

I proprietari possono aggiornare, visualizzare, condividere, interrompere la condivisione e utilizzare il numero di telefono, il pool, l'elenco di opt-out o gli ID mittente.

Autorizzazioni per gli utenti

I consumatori possono utilizzare e visualizzare il numero di telefono, il pool, l'elenco di opt-out o gli ID mittente.

Fatturazione e misurazione

Al proprietario della risorsa viene fatturato il costo della risorsa. Ai consumatori non vengono addebitate le risorse condivise con loro, ma l'utilizzo delle risorse per inviare messaggi. Non ci sono costi aggiuntivi associati alla condivisione di una risorsa.

Ai consumatori viene addebitato l'invio di un messaggio con send-text-message, send-media-message o send-voice-message e questo viene conteggiato nei limiti di spesa dei consumatori. https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-voice-message.html Per ulteriori informazioni sui prezzi o sui limiti di spesa, AWS vedi Prezzi per la messaggistica per Imposta un limite di spesa per SMS, MMS o voce in AWS Messaggistica SMS per l'utente finale gli utenti finali e.

Quote di istanza

La condivisione di una risorsa non influisce sui limiti della risorsa nell'account del proprietario o del consumatore. Solo l'account del proprietario viene utilizzato per calcolare i limiti della risorsa.

Esempi di politiche per la condivisione di un ID mittente o di un numero di telefono con Amazon Pinpoint

Ti consigliamo di utilizzare la console AWS RAM per creare e gestire le condivisioni di risorse.

L'esempio seguente consente ad Amazon Pinpoint di inviare SMS o messaggi vocali con il numero di telefono specificato.

Per condividere un numero di telefono che possiedi utilizzando AWS Console SMS per la messaggistica con l'utente finale

  1. Aprire la console AWS End User Messaging SMS all'indirizzo https://console.aws.amazon.com/sms-voice/.

  2. Nel pannello di navigazione, in Configurazioni, scegli Numeri di telefono, quindi scegli un numero di telefono.

  3. Nella scheda Policy delle risorse, seleziona Modifica.

  4. Puoi modificare la politica basata sulle risorse JSON per modificare le autorizzazioni di condivisione.

    Nel seguente JSON, apporta le seguenti modifiche e quindi incolla il JSON nella politica delle risorse:

    • Sostituisci Partition con la AWS partizione in cui si trova il numero di telefono.

    • Sostituisci Region con Regione AWS il numero di telefono inserito.

    • Sostituisci Account con il numero di conto che possiede il numero di telefono.

    • Sostituisci Phone-id con l'identificatore del numero di telefono.

  5. Scegli Save changes (Salva modifiche).

L'esempio seguente consente ad Amazon Pinpoint di inviare messaggi SMS con l'ID mittente specificato.

Per condividere un ID mittente di tua proprietà, utilizza AWS Console SMS per la messaggistica con l'utente finale

  1. Aprire la console AWS End User Messaging SMS all'indirizzo https://console.aws.amazon.com/sms-voice/.

  2. Nel riquadro di navigazione, in Configurazioni, scegli ID mittente, quindi scegli un ID mittente.

  3. Nella scheda Policy delle risorse, seleziona Modifica.

  4. Puoi modificare la policy basata sulle risorse JSON per modificare le autorizzazioni di condivisione.

    Nel seguente JSON, apporta le seguenti modifiche e quindi incolla il JSON nella politica delle risorse:

    • Sostituisci Partition con la AWS partizione in cui si trova l'ID del mittente.

    • Sostituisci Region con Regione AWS l'ID mittente inserito.

    • Sostituisci Account con il numero di conto che possiede l'ID mittente.

    • Sostituisci Senderid con l'identificatore dell'ID mittente.

    • Sostituisci Countrycode con il codice ISO-3166 alfa-2 di due lettere per il paese dell'ID mittente.

  5. Scegli Save changes (Salva modifiche).

Esempio di politica per la condivisione di un ID mittente con Amazon Pinpoint e Amazon SNS

Ti consigliamo di utilizzare la console AWS RAM per creare e gestire le condivisioni di risorse.

L'esempio seguente consente ad Amazon Pinpoint e Amazon SNS di inviare messaggi SMS con l'ID mittente specificato.

Per condividere un ID mittente di tua proprietà, utilizza AWS Console SMS per la messaggistica con l'utente finale

  1. Aprire la console AWS End User Messaging SMS all'indirizzo https://console.aws.amazon.com/sms-voice/.

  2. Nel riquadro di navigazione, in Configurazioni, scegli ID mittente, quindi scegli un ID mittente.

  3. Nella scheda Policy delle risorse, seleziona Modifica.

  4. Puoi modificare la policy basata sulle risorse JSON per modificare le autorizzazioni di condivisione.

    Nel seguente JSON, apporta le seguenti modifiche e quindi incolla il JSON nella politica delle risorse:

    • Sostituisci Partition con la AWS partizione in cui si trova il numero di telefono.

    • Sostituisci Region con Regione AWS il numero di telefono inserito.

    • Sostituisci OwnersAccountID con il numero di AWS conto che possiede l'ID mittente.

    • Sostituisci SenderID con l'identificatore dell'ID mittente.

    • Sostituisci ISO con il codice ISO-3166 alfa-2 di due lettere per il paese dell'ID mittente.

    • Sostituiscilo ConsumersAccountID con il numero di AWS conto a cui dare accesso.

    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. Scegli Save changes (Salva modifiche).

Esempio di politica per la condivisione di un numero di telefono con Amazon Pinpoint e Amazon SNS

Ti consigliamo di utilizzare la console AWS RAM per creare e gestire le condivisioni di risorse.

L'esempio seguente consente ad Amazon Pinpoint e Amazon SNS di inviare messaggi SMS con il numero di telefono specificato.

Per condividere un numero di telefono che possiedi utilizzando AWS Console SMS per la messaggistica con l'utente finale

  1. Aprire la console AWS End User Messaging SMS all'indirizzo https://console.aws.amazon.com/sms-voice/.

  2. Nel pannello di navigazione, in Configurazioni, scegli Numeri di telefono, quindi scegli un numero di telefono.

  3. Nella scheda Policy delle risorse, seleziona Modifica.

  4. Puoi modificare la politica basata sulle risorse JSON per modificare le autorizzazioni di condivisione.

    Nel seguente JSON, apporta le seguenti modifiche e quindi incolla il JSON nella politica delle risorse:

    • Sostituisci Partition con la AWS partizione in cui si trova il numero di telefono.

    • Sostituisci Region con Regione AWS il numero di telefono inserito.

    • Sostituisci OwnersAccountID con il numero di AWS conto proprietario del numero di telefono.

    • Sostituisci PhoneNumberID con l'identificatore del numero di telefono.

    • Sostituisci ConsumersAccountID con il numero di AWS conto a cui dare accesso.

    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. Scegli Save changes (Salva modifiche).