Gestione di uno stream nel cloud AWS

AWS IoT fornisce AWS SDK e AWS CLI comandi che puoi utilizzare per gestire uno stream nel AWS cloud. È possibile utilizzare questi comandi per effettuare le seguenti operazioni:

• Creare un flusso. CLI / SDK

• Descrivere un flusso per ottenere le informazioni. CLI / SDK

• Elenca gli stream nel tuo. Account AWSCLI / SDK

• Aggiorna l'elenco dei file o la descrizione del flusso in un flusso. CLI / SDK

• Eliminare un flusso. CLI / SDK

Nota

Al momento, i flussi non sono visibili nella AWS Management Console. È necessario utilizzare AWS CLI o AWS SDK per gestire uno stream in. AWS IoT Inoltre, l'SDK per Embedded C è l'unico SDK che supporta i trasferimenti di file basati su MQTT.

Prima di utilizzare la distribuzione di file AWS IoT basata su MQTT dai dispositivi, è necessario assicurarsi che i dispositivi soddisfino le seguenti condizioni, come illustrato nelle sezioni successive:

• Una politica che riflette le autorizzazioni corrette richieste per la trasmissione di dati tramite MQTT.

• Il dispositivo può connettersi al Device Gateway. AWS IoT

• Una dichiarazione politica in cui si afferma che è possibile etichettare le risorse. Se CreateStream viene chiamato con tag, allora iot:TagResource è obbligatorio.

Prima di utilizzare la distribuzione di file AWS IoT basata su MQTT dai dispositivi, è necessario seguire i passaggi nelle sezioni successive per assicurarsi che i dispositivi siano autorizzati correttamente e possano connettersi al AWS IoT Device Gateway.

Concedere le autorizzazioni ai tuoi dispositivi

È possibile procedere come descritto in Creazione di una policy AWS IoT per creare una policy del dispositivo o utilizzare una policy del dispositivo esistente. Collegare la policy ai certificati associati ai dispositivi e aggiungere le seguenti autorizzazioni alla policy del dispositivo.

JSON

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "iot:Connect"
            ],
            "Resource": [
            "arn:aws:iot:us-east-1:123456789012:client/${iot:Connection.Thing.ThingName}"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "iot:Receive",
                "iot:Publish"
            ],
            "Resource": [
            "arn:aws:iot:us-east-1:123456789012:topic/$aws/things/${iot:Connection.Thing.ThingName}/streams/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": "iot:Subscribe",
            "Resource": [
            "arn:aws:iot:us-east-1:123456789012:topicfilter/$aws/things/${iot:Connection.Thing.ThingName}/streams/*"
            ]
        }
    ]
}

Connect i tuoi dispositivi a AWS IoT

È necessario connettersi ai dispositivi che utilizzano la consegna di file AWS IoT basata su MQTT. AWS IoT AWS IoT La distribuzione di file basata su MQTT si integra con AWS IoT il AWS cloud, quindi i dispositivi devono connettersi direttamente all'endpoint del Data Plane. AWS IoT

Nota

L'endpoint del piano AWS IoT dati è specifico della regione and. Account AWS È necessario utilizzare l'endpoint per la Account AWS e la regione in cui sono registrati i dispositivi. AWS IoT

Per ulteriori informazioni, consulta Connect a AWS IoT Core.

TagResource Utilizzo

L'azione CreateStream API crea un flusso per la distribuzione di uno o più file di grandi dimensioni in blocchi su MQTT.

Una chiamata CreateStream API riuscita richiede le seguenti autorizzazioni:

• iot:CreateStream

• iot:TagResource(se CreateStream è con tag)

La politica che supporta queste due autorizzazioni è mostrata di seguito:

JSON

{
    "Version": "2012-10-17",
    "Statement": {
        "Action": [
            "iot:CreateStream",
            "iot:TagResource"
        ],
        "Effect": "Allow",
        "Resource": "arn:aws:iot:us-east-1:123456789012:stream/streamId"
    }
}

L'azione della dichiarazione iot:TagResource politica è necessaria per garantire che un utente non possa creare o aggiornare un tag su una risorsa senza le autorizzazioni appropriate. Senza l'azione specifica della dichiarazione politica diiot:TagResource, la chiamata CreateStream API restituirà un AccessDeniedException se la richiesta include tag.

Per ulteriori informazioni, consulta i seguenti link:

• CreateStream

• TagResource

• Tag