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à.
# Iscrizione ai report giornalieri sull'utilizzo degli SMS di Amazon SNS
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.
## Sottoscrizione ai report di utilizzo giornalieri
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**
1. Da chi Account AWS invia messaggi SMS, accedi alla console [Amazon S3](https://console.aws.amazon.com/s3/).
1. Scegli **Crea bucket**.
1. Per **Bucket Name (Nome bucket)**, si consiglia di immettere un nome univoco per l'account e l'organizzazione. Ad esempio, utilizzare il modello `--`.
Per informazioni sulle convenzioni e sulle restrizioni per i nomi di bucket, consulta [Regole per la denominazione dei bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/BucketRestrictions.html#bucketnamingrules) nella *Guida per l'utente di Amazon Simple Storage Service*.
1. Scegli **Create** (Crea).
1. Nella tabella **All Buckets (Tutti i bucket)**, seleziona il bucket.
1. Nella sezione **Permissions (Autorizzazioni)**, scegliere **Bucket policy (Policy bucket)**.
1. 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](#example_bucket_policy).
Se utilizzi la politica di esempio, ricordati di sostituirla {{my-s3-bucket}} con il nome del bucket che hai scelto nello Step 3.
1. Scegli **Save** (Salva).
**Sottoscrizione ai report di utilizzo giornalieri**
1. Accedi alla console [Amazon SNS](https://console.aws.amazon.com/sns/).
1. Nel riquadro di navigazione, selezionare **Text messaging (SMS) (Messaggi di testo (SMS))**.
1. Nella pagina **Text messaging (SMS) (Messaggi di testo (SMS))**, nella sezione **Text messaging preferences (Preferenze per i messaggi di testo)**, scegliere **Edit (Modifica)**.
1. 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)**.
1. 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html). 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.
------
#### [ JSON ]
****
```
{
"Version":"2012-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:us-west-1:123456789012:*"
}
}
},
{
"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:us-west-1:123456789012:*"
}
}
},
{
"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:us-west-1:123456789012:*"
}
}
}
]
}
```
------
**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](https://aws.amazon.com/premiumsupport/knowledge-center/copy-s3-objects-account/) 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:
```
{{}}/SMSUsageReports/{{}}/{{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
```