Destinazioni degli eventi Amazon Data Firehose - AWS Messaggistica per l'utente finale SMS
Creazione di destinazioni per eventi Amazon Data FirehoseGestione della destinazione degli eventi Amazon Data Firehose

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à.

Destinazioni degli eventi Amazon Data Firehose

Amazon Data Firehose è un servizio completamente gestito per la distribuzione di dati di streaming in tempo reale a più tipi di destinazioni. Amazon Data Firehose fa parte della piattaforma di streaming di dati Kinesis. Per ulteriori informazioni su Amazon Data Firehose, consulta la Amazon Data Firehose Developer Guide.

Alcuni degli esempi di questa sezione presuppongono che tu abbia già installato e configurato il. AWS Command Line Interface Per ulteriori informazioni sulla configurazione di AWS CLI, consulta la Guida AWS Command Line Interface per l'utente.

Prerequisiti

  1. Prima di poter creare una destinazione per eventi Amazon Data Firehose, devi creare un flusso di distribuzione Amazon Data Firehose. Per ulteriori informazioni sulla creazione di stream, consulta Creating an Amazon Data Firehose Delivery Stream nella Amazon Data Firehose Developer Guide.

    Importante

    Per creare la destinazione dell'evento è necessario l'Amazon Resource Name (ARN) del flusso di distribuzione di Amazon Data Firehose.

  2. Devi creare un IAM ruolo che consenta a AWS End User Messaging SMS di scrivere nel flusso di distribuzione, vediIAMpolitica per Amazon Data Firehose.

    Importante

    Avrai bisogno dell'Amazon Resource Name (ARN) del IAM ruolo per creare la destinazione dell'evento.

  3. Hai anche impostato un set di configurazione a cui associare le destinazioni dell'evento, vediGestione del set di configurazione.

Creazione di destinazioni per eventi Amazon Data Firehose

Prima di poter creare una destinazione per eventi Amazon Data Firehose, devi creare uno stream Amazon Data Firehose. Per ulteriori informazioni sulla creazione di gruppi di log, consulta Creating an Amazon Data Firehose Delivery Stream nella Amazon Data Firehose Developer Guide.

È necessario creare un IAM ruolo che consenta a AWS End User Messaging SMS e Voice v2 di inviare dati API allo stream. La sezione seguente contiene informazioni sui requisiti per questo ruolo.

Inoltre, hai già impostato un set di configurazione a cui associare le destinazioni di evento. Consulta Set di configurazione.

IAMpolitica per Amazon Data Firehose

Utilizza l'esempio seguente per creare una policy per l'invio di eventi a uno stream Amazon Data Firehose.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "firehose:PutRecord",
            "Resource": "arn:aws:firehose:us-east-1:111122223333:deliverystream/DeliveryStreamName"
        }
    ]
}

Per ulteriori informazioni sulle IAM politiche, consulta Politiche e autorizzazioni IAM nella Guida per l'IAMutente.

L'istruzione di esempio seguente utilizza le SourceArn condizioni, facoltative ma SourceAccount consigliate, per verificare che solo l'account SMS proprietario di AWS End User Messaging abbia accesso al set di configurazione. In questo esempio, sostituisci accountId con l'ID AWS del tuo account, region con il Regione AWS nome e ConfigSetName con il nome del set di configurazione.

Dopo aver creato la policy, create un nuovo IAM ruolo, quindi allegate la policy ad essa. Quando crei il ruolo, aggiungi anche la seguente policy di attendibilità:

{
    "Version": "2012-10-17",
    "Statement": {
        "Effect": "Allow",
        "Principal": {
            "Service": "sms-voice.amazonaws.com"
        },
        "Action": "sts:AssumeRole",
        "Condition": {
            "StringEquals": {
               "aws:SourceAccount": "accountId"
             },
             "ArnLike": {
               "aws:SourceArn": "arn:aws:sms-voice:region:accountId:configuration-set/ConfigSetName"
              }
        }
    }
}

Per ulteriori informazioni sulla creazione di IAM ruoli, vedere Creazione di IAM ruoli nella Guida IAM per l'utente.

Gestione della destinazione degli eventi Amazon Data Firehose

Create Amazon Data Firehose event destination (Console)

Per creare una destinazione per eventi Amazon Data Firehose utilizzando la SMS console AWS End User Messaging, segui questi passaggi:

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

  2. Nel riquadro di navigazione, in Configurazioni, scegli Set di configurazione.

  3. Nella pagina Set di configurazione, scegliete il set di configurazione a cui aggiungere una destinazione per l'evento.

  4. Nella pagina dei dettagli del set di configurazione, scegli Aggiungi evento di destinazione.

  5. Nella sezione Dettagli dell'evento, inserisci un nome descrittivo per il nome della destinazione dell'evento.

  6. Dal menu a discesa Tipo di destinazione scegli Amazon Data Firehose.

  7. Per IAMrole arn inserisci il nome ARN del ruolo. IAM Per ulteriori informazioni sul IAM ruolo arn, vedere. IAMpolitica per Amazon Data Firehose

  8. Per Delivery stream arn, entra nel gruppo ARN di log di Amazon Data Firehose a cui inviare gli eventi.

  9. Attiva la pubblicazione degli eventi.

  10. In Tipi di eventi, scegli:

    • Tutti SMS gli eventi (consigliato): scegli questa opzione per inviare tutti SMS gli eventi elencati Tipi di eventi per SMSMMS, e voce ad Amazon Data Firehose.

    • SMSEventi personalizzati: scegli SMS eventi specifici da inviare ad Amazon Data Firehose. Per modificare l'elenco degli eventi, scegli Modifica selezione SMS eventi. In Modifica selezione SMS eventi, seleziona solo gli eventi che desideri inviare ad Amazon Data Firehose. Scegli Salva selezione.

    • Tutti gli eventi vocali (consigliato): scegli questa opzione per inviare tutti gli eventi vocali elencati in Tipi di eventi per SMSMMS, e voce Amazon Data Firehose.

    • Eventi vocali personalizzati: scegli eventi vocali specifici da inviare ad Amazon Data Firehose. Per modificare l'elenco degli eventi, scegli Modifica la selezione degli eventi vocali. In Modifica la selezione degli eventi vocali, seleziona solo gli eventi che desideri inviare ad Amazon Data Firehose. Scegli Salva selezione.

    • Tutti MMS gli eventi (consigliato): scegli questa opzione per inviare tutti MMS gli eventi elencati Tipi di eventi per SMSMMS, e voce ad Amazon Data Firehose.

    • MMSEventi personalizzati: scegli gli MMS eventi specifici da inviare ad Amazon Data Firehose. Per modificare l'elenco degli eventi, scegli Modifica selezione MMS eventi. In Modifica selezione MMS eventi, seleziona solo gli eventi che desideri inviare ad Amazon Data Firehose. Scegli Salva selezione.

  11. Scegliere Crea evento.

Create Amazon Data Firehose event destination (AWS CLI)

Dopo aver creato il IAM ruolo e il flusso di distribuzione di Amazon Data Firehose, puoi creare la destinazione dell'evento.

Puoi usare il create-event-destinationcomando per creare una destinazione per un evento.

$ aws pinpoint-sms-voice-v2 create-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event-types eventTypes \
> --kinesis-firehose-destination IamRoleArn=arn:aws:iam::111122223333:role/AKFSMSRole,DeliveryStreamArn=arn:aws:firehose:us-east-1:111122223333:deliverystream/MyDeliveryStream

Nel comando precedente, apporta le modifiche seguenti:

  • Replace (Sostituisci) eventDestinationName con un nome che descrive la destinazione dell'evento.

  • Replace (Sostituisci) configurationSet con il nome del set di configurazione a cui si desidera associare la destinazione dell'evento.

  • Replace (Sostituisci) eventTypes con uno o più dei tipi di eventi elencati inTipi di eventi per SMSMMS, e voce.

  • Sostituisci il valore di IamRoleArn con Amazon Resource Name (ARN) di un IAM ruolo con le politiche descritte inIAMpolitica per Amazon Data Firehose.

  • Sostituisci il valore ARN di DeliveryStreamArn con lo stream Amazon Data Firehose a cui desideri inviare gli eventi.

Update Amazon Data Firehose event destination (Console)

Per aggiornare una destinazione di evento Amazon Data Firehose utilizzando la SMS console AWS End User Messaging, segui questi passaggi:

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

  2. Nel riquadro di navigazione, in Configurazioni, scegli Set di configurazione.

  3. Nella pagina Set di configurazione, scegliete il set di configurazione a cui aggiungere una destinazione per l'evento.

  4. Nella pagina Set di configurazione, scegliete il set di configurazione da modificare.

  5. Nella pagina dei dettagli del set di configurazione, scegli una destinazione dell'evento Amazon Data Firehose e poi Modifica.

  6. Per IAMrole arn inserisci il nome ARN del IAM ruolo. Per ulteriori informazioni sul IAM ruolo arn, vedere. IAMpolitica per Amazon Data Firehose

  7. Per Delivery stream arn, entra nel gruppo ARN di log di Amazon Data Firehose a cui inviare gli eventi.

  8. In Tipi di eventi, scegli:

    • Tutti SMS gli eventi (consigliato): scegli questa opzione per inviare tutti SMS gli eventi elencati Tipi di eventi per SMSMMS, e voce ad Amazon Data Firehose.

    • SMSEventi personalizzati: scegli questa opzione per scegliere SMS eventi specifici a cui inviare CloudWatch. Per modificare l'elenco degli eventi, scegli Modifica selezione SMS eventi. In Modifica selezione SMS eventi, seleziona solo gli eventi che desideri inviare ad Amazon Data Firehose. Scegli Salva selezione.

    • Tutti gli eventi vocali (consigliato): scegli questa opzione per inviare tutti gli eventi vocali elencati in Tipi di eventi per SMSMMS, e voce Amazon Data Firehose.

    • Eventi vocali personalizzati: scegli questa opzione per scegliere eventi vocali specifici da inviare ad Amazon Data Firehose. Per modificare l'elenco degli eventi, scegli Modifica la selezione degli eventi vocali. In Modifica la selezione degli eventi vocali, seleziona solo gli eventi che desideri inviare ad Amazon Data Firehose. Scegli Salva selezione.

    • Tutti MMS gli eventi (consigliato): scegli questa opzione per inviare tutti MMS gli eventi elencati Tipi di eventi per SMSMMS, e voce ad Amazon Data Firehose.

    • MMSEventi personalizzati: scegli questa opzione per scegliere MMS eventi specifici a cui inviare CloudWatch. Per modificare l'elenco degli eventi, scegli Modifica selezione MMS eventi. In Modifica selezione MMS eventi, seleziona solo gli eventi che desideri inviare ad Amazon Data Firehose. Scegli Salva selezione.

  9. Scegli Modifica evento.

Update Amazon Data Firehose event destination (AWS CLI)

È possibile utilizzare il update-event-destinationcomando per aggiornare la destinazione di un evento.

La procedura per aggiornare una destinazione di eventi Amazon Data Firehose è simile alla procedura per la creazione di una destinazione di evento.

$ aws pinpoint-sms-voice-v2 create-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event-types eventTypes \
> --kinesis-firehose-destination IamRoleArn=arn:aws:iam::111122223333:role/AKFSMSRole,DeliveryStreamArn=arn:aws:firehose:us-east-1:111122223333:deliverystream/MyDeliveryStream

Nel comando precedente, apporta le modifiche seguenti:

  • Replace (Sostituisci) eventDestinationName con un nome della destinazione dell'evento che desideri modificare.

  • Replace (Sostituisci) configurationSet con il nome del set di configurazione a cui si desidera associare la destinazione dell'evento. È possibile associare la destinazione di evento a un set di configurazione diverso.

  • Replace (Sostituisci) eventTypes con uno dei tipi di eventi elencati inTipi di eventi per SMSMMS, e voce.

  • Sostituisci il valore di IamRoleArn con Amazon Resource Name (ARN) di un IAM ruolo con le politiche descritte inIAMpolitica per Amazon Data Firehose.

  • Sostituisci il valore ARN di DeliveryStreamArn con lo stream Amazon Data Firehose a cui desideri inviare gli eventi.

Delete an Amazon Data Firehose event destination (Console)

Il processo di eliminazione di una destinazione di evento è lo stesso indipendentemente dal tipo di destinazione che si desidera eliminare.

Per eliminare la destinazione di un evento Amazon Data Firehose nella console

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

  2. Nel riquadro di navigazione, in Configurazioni, scegli Set di configurazione.

  3. Nella pagina Set di configurazione, scegliete il set di configurazione da cui rimuovere la destinazione di un evento.

  4. Nella sezione Tutte le destinazioni, scegliete una destinazione per l'evento, quindi scegliete Elimina.

Delete an Amazon Data Firehose event destination (AWS CLI)

È possibile utilizzare il delete-event-destinationcomando per eliminare la destinazione di un evento.

Il processo di eliminazione di una destinazione di evento è lo stesso indipendentemente dal tipo di destinazione che si desidera eliminare.

Per eliminare una destinazione di evento Amazon Data Firehose nel AWS CLI

  • Alla riga di comando esegui il comando riportato di seguito:

    $ aws pinpoint-sms-voice-v2 delete-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSetName

    Nel comando precedente, apporta le modifiche seguenti:

    • Replace (Sostituisci) eventDestinationName con il nome o Amazon Resource Name (ARN) della destinazione dell'evento che desideri eliminare.

    • Replace (Sostituisci) configurationSetName con il nome o ARN del set di configurazione a cui è associata la destinazione dell'evento.