View a markdown version of this page

SQS - AWS IoT Core
RequisitiParametersEsempiConsulta anche

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

SQS

L’operazione SQS (sqs) invia i dati da un messaggio MQTT a una coda Amazon Simple Queue Service (Amazon SQS).

Nota

L'azione SQS non supporta le code Amazon SQS FIFO (). First-In-First-Out Poiché il motore di regole è un servizio completamente distribuito, non vi è alcuna garanzia in merito all'ordine dei messaggi quando viene attivata l'operazione SQS.

Requisiti

Questa operazione della regola presenta i seguenti requisiti:

  • Un ruolo IAM che AWS IoT può assumere per eseguire l'operazione. sqs:SendMessage Per ulteriori informazioni, consulta Concessione di un AWS IoT regola l'accesso che richiede.

    Nella AWS IoT console, puoi scegliere o creare un ruolo per consentire l'esecuzione AWS IoT di questa azione basata sulla regola.

  • Se utilizzi un AWS KMS cliente che è riuscito AWS KMS key a crittografare i dati inattivi in Amazon SQS, il servizio deve disporre dell'autorizzazione per utilizzarli per AWS KMS key conto del chiamante. Per ulteriori informazioni, consulta Gestione delle chiavi nella Guida per gli sviluppatori di Amazon Simple Queue Service.

Parameters

Quando crei una AWS IoT regola con questa azione, devi specificare le seguenti informazioni:

queueUrl

L’URL della coda Amazon SQS in cui scrivere i dati. La regione in questo URL non deve necessariamente essere la stessa della tua Regione AWS AWS IoT regola.

Nota

Potrebbero esserci costi aggiuntivi per il trasferimento incrociato dei dati Regioni AWS utilizzando l'azione della regola SQS. Per ulteriori informazioni, consulta i prezzi di Amazon SQS.

Supporta modelli sostitutivi: API e solo AWS CLI

useBase64

Imposta questo parametro su true per configurare l'operazione della regola per codificare in base64 i dati del messaggio prima di scrivere i dati nella coda Amazon SQS. L’impostazione predefinita è false.

Supporta modelli di sostituzione: no

roleArn

Il ruolo IAM che permette l'accesso alla coda Amazon SQS. Per ulteriori informazioni, consulta Requisiti.

Supporta modelli di sostituzione: no

Esempi

Il seguente esempio JSON definisce un'azione SQS in una regola. AWS IoT 

{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'", 
        "ruleDisabled": false, 
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "sqs": {
                    "queueUrl": "https://sqs.us-east-2.amazonaws.com/123456789012/my_sqs_queue", 
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_sqs"
                }
            }
        ]
    }
}

Il seguente esempio JSON definisce un'azione SQS con modelli di sostituzione in una regola. AWS IoT 

{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'",
        "ruleDisabled": false,
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "sqs": {
                    "queueUrl": "https://sqs.us-east-2.amazonaws.com/123456789012/${topic()}",
                    "useBase64": true,
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_sqs"
                }
            }
        ]
    }
}

Consulta anche