Iscrizione ai report giornalieri sull'utilizzo degli SMS di Amazon SNS

Modalità Focus

Iscrizione ai report giornalieri sull'utilizzo degli SMS di Amazon SNS - Amazon Simple Notification Service

Informazioni contenute nei report di utilizzo giornalieri Sottoscrizione ai report di utilizzo giornalieri

Puoi monitorare le consegne di SMS effettuando la sottoscrizione a report di utilizzo di SMS giornalieri a partire da Amazon SNS. Per ogni giorno in cui invii almeno un messaggio SMS, Amazon SNS fornisce un report di utilizzo in un file CSV per il bucket Amazon S3 specificato. Sono necessarie 24 ore prima che il rapporto sull'utilizzo degli SMS sia disponibile nel bucket Amazon S3.

Informazioni contenute nei report di utilizzo giornalieri

Il report di utilizzo include le seguenti informazioni per ogni SMS inviato dal tuo account.

Tenere presente che il report non include messaggi che vengono inviati ai destinatari che hanno scelto di non ricevere i messaggi.

Tempo di pubblicazione per messaggio (in UTC)
ID messaggio
Numero di telefono di destinazione
Tipo di messaggio
Stato della consegna
Costo del messaggio (in USD)
Numero di parte (un messaggio viene suddiviso in più parti se è troppo lungo per un unico messaggio)
Numero totale di parti

Nota

Se Amazon SNS non ha ricevuto il numero di parte, impostiamo il suo valore su zero.

Per eseguire la sottoscrizione ai report di utilizzo giornalieri, devi creare un bucket Amazon S3 con le autorizzazioni appropriate.

Creazione di un bucket Amazon S3 per i report di utilizzo giornalieri

Da chi Account AWS invia messaggi SMS, accedi alla console Amazon S3.
Scegli Crea bucket.
Per Bucket Name (Nome bucket), si consiglia di immettere un nome univoco per l'account e l'organizzazione. Ad esempio, utilizzare il modello <my-bucket-prefix>-<account_id>-<org-id>.

Per informazioni sulle convenzioni e sulle restrizioni per i nomi di bucket, consulta Regole per la denominazione dei bucket nella Guida per l'utente di Amazon Simple Storage Service.
Scegli Create (Crea).
Nella tabella All Buckets (Tutti i bucket), seleziona il bucket.
Nella sezione Permissions (Autorizzazioni), scegliere Bucket policy (Policy bucket).
Nella finestra Bucket Policy Editor (Editor policy bucket), specifica una policy che autorizzi il principale del servizio Amazon SNS a scrivere nel tuo bucket. Per vedere un esempio, consulta Esempio di policy di bucket.

Se utilizzi la politica di esempio, ricordati di sostituirla my-s3-bucket con il nome del bucket che hai scelto nello Step 3.
Scegli Save (Salva).

Sottoscrizione ai report di utilizzo giornalieri

Accedi alla console Amazon SNS.
Nel riquadro di navigazione, selezionare Text messaging (SMS) (Messaggi di testo (SMS)).
Nella pagina Text messaging (SMS) (Messaggi di testo (SMS)), nella sezione Text messaging preferences (Preferenze per i messaggi di testo), scegliere Edit (Modifica).
Nella pagina Edit text messaging preferences (Modifica preferenze di messaggistica di testo), nella sezione Details (Dettagli), specificare Amazon S3 bucket name for usage reports (Nome del bucket Amazon S3 per i report di utilizzo).
Scegli Save changes (Salva modifiche).

Esempio di policy di bucket

La policy seguente consente al principale del servizio Amazon SNS di eseguire le operazioni s3:PutObject, s3:GetBucketLocation e s3:ListBucket.

AWS fornisce strumenti per tutti i servizi con i responsabili dei servizi a cui è stato concesso l'accesso alle risorse del tuo account. Quando il principale di una dichiarazione sulla politica del bucket di Amazon S3 è un problema secondario confuso. Per limitare la regione e l'account da cui il bucket può ricevere report di utilizzo giornalieri, utilizzare aws:SourceArn come mostrato nell'esempio sottostante. Se non si desidera limitare le regioni che possono generare questi report, utilizzare aws:SourceAccount per limitare in base a quale account sta generando i report. Se non si conosce l'ARN della risorsa, utilizzare aws:SourceAccount.

Utilizzare l'esempio seguente che include la protezione "confused deputy" quando crei un bucket Amazon S3 per ricevere report di utilizzo di SMS giornalieri da Amazon SNS.


{
    "Version": "2008-10-17",
    "Statement": [
        {
            "Sid": "AllowPutObject",
            "Effect": "Allow",
            "Principal": {
                "Service": "sns.amazonaws.com"
            },
            "Action": "s3:PutObject",
            "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*",
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "account_id"
                },
                "ArnLike": {
                    "aws:SourceArn": "arn:aws:sns:region:account_id:*"
                }
            }
        },
        {
            "Sid": "AllowGetBucketLocation",
            "Effect": "Allow",
            "Principal": {
                "Service": "sns.amazonaws.com"
            },
            "Action": "s3:GetBucketLocation",
            "Resource": "arn:aws:s3:::amzn-s3-demo-bucket",
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "account_id"
                },
                "ArnLike": {
                    "aws:SourceArn": "arn:aws:sns:region:account_id:*"
                }
            }
        },
        {
            "Sid": "AllowListBucket",
            "Effect": "Allow",
            "Principal": {
                "Service": "sns.amazonaws.com"
            },
            "Action": "s3:ListBucket",
            "Resource": "arn:aws:s3:::amzn-s3-demo-bucket",
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "account_id"
                },
                "ArnLike": {
                    "aws:SourceArn": "arn:aws:sns:region:account_id:*"
                }
            }
        }
    ]
}

Nota

Puoi pubblicare report sull'utilizzo nei bucket Amazon S3 di proprietà dell' Account AWS che è specificato nell'elemento Condition nella policy di Amazon S3. Per pubblicare report di utilizzo in un bucket Amazon S3 di Account AWS proprietà di un altro, vedi Come posso copiare oggetti Amazon S3 da un altro? Account AWS.

Esempio di report di utilizzo giornaliero

Dopo la sottoscrizione ai report di utilizzo giornalieri, Amazon SNS inserisce un file CSV con i dati sull'utilizzo nella seguente posizione:


<my-s3-bucket>/SMSUsageReports/<region>/YYYY/MM/DD/00x.csv.gz

Ogni file può contenere fino a 50.000 record. Se i record di un giorno superano questa quota, Amazon SNS aggiunge più file. Di seguito viene riportato un esempio di report:


PublishTimeUTC,MessageId,DestinationPhoneNumber,MessageType,DeliveryStatus,PriceInUSD,PartNumber,TotalParts
2016-05-10T03:00:29.476Z,96a298ac-1458-4825-a7eb-7330e0720b72,1XXX5550100,Promotional,Message has been accepted by phone carrier,0.90084,0,1
2016-05-10T03:00:29.561Z,1e29d394-d7f4-4dc9-996e-26412032c344,1XXX5550100,Promotional,Message has been accepted by phone carrier,0.34322,0,1
2016-05-10T03:00:30.769Z,98ba941c-afc7-4c51-ba2c-56c6570a6c08,1XXX5550100,Transactional,Message has been accepted by phone carrier,0.27815,0,1