Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Registro AWS IoT Llamadas a la API OTA con AWS CloudTrail

FreeRTOS está integrado con CloudTrail un servicio que captura las llamadas a la API de AWS IoT OTA y envía los archivos de registro a un bucket de Amazon S3 que usted especifique. CloudTrail captura las llamadas a la API desde su código a las API de AWS IoT OTA. Con la información recopilada CloudTrail, puedes determinar la solicitud que se hizo a AWS IoT OTA, la dirección IP de origen desde la que se hizo la solicitud, quién la hizo, cuándo se hizo, etc.

Para obtener más información sobre CloudTrail cómo configurarla y habilitarla, consulta la Guía del AWS CloudTrail usuario .

Información sobre FreeRTOS en CloudTrail

Cuando el CloudTrail registro está activado en tu AWS cuenta, las llamadas a la API realizadas a las acciones de la AWS IoT OTA se registran en archivos de CloudTrail registro, donde se escriben junto con otros registros de AWS servicio. CloudTrail determina cuándo crear y escribir en un archivo nuevo en función del período de tiempo y el tamaño del archivo.

Las siguientes acciones del plano de control AWS IoT OTA se registran mediante CloudTrail:

Cada entrada de registro contiene información sobre quién generó la solicitud. La información de identidad del usuario en la entrada de registro le ayuda a determinar lo siguiente:

Para obtener más información, consulte el elemento CloudTrail UserIdentity. AWS IoT Las acciones de OTA se documentan en la referencia de la API de AWS IoT OTA.

Puede almacenar sus archivos de registro en su bucket de Amazon S3 durante todo el tiempo que desee, pero también puede definir reglas de ciclo de vida de Amazon S3 para archivar o eliminar archivos de registro automáticamente. De forma predeterminada, los archivos de registro se cifran con el cifrado del servidor (SSE) de Amazon S3.

Si desea recibir una notificación cuando se entreguen los archivos de registro, puede configurarlo CloudTrail para que publique las notificaciones de Amazon SNS. Para obtener más información, consulte Configurar las notificaciones de Amazon SNS para. CloudTrail

También puede agregar archivos de registro AWS IoT OTA de varias AWS regiones y AWS cuentas en un único bucket de Amazon S3.

Para obtener más información, consulte Recepción de archivos de CloudTrail registro de varias regiones y Recepción de archivos de CloudTrail registro de varias cuentas.

Descripción de las entradas de archivos de registro de FreeRTOS

CloudTrail los archivos de registro pueden contener una o más entradas de registro. En cada entrada se enumeran varios JSON-formatted eventos. Una entrada de registro representa una única solicitud de cualquier origen e incluye información sobre la acción solicitada, la fecha y la hora de la acción, los parámetros de la solicitud, etcétera. Las entradas de registro no son un rastro de la pila ordenada de las llamadas API públicas, por lo que no aparecen en ningún orden específico.

El siguiente ejemplo muestra una entrada de CloudTrail registro que muestra el registro desde una llamada a la CreateOTAUpdate acción.

{
    "eventVersion": "1.05",
    "userIdentity": {
        "type": "IAMUser",
        "principalId": "EXAMPLE",
        "arn": "arn:aws:iam::your_aws_account:user/your_user_id",
        "accountId": "your_aws_account",
        "accessKeyId": "your_access_key_id",
        "userName": "your_username",
        "sessionContext": {
            "attributes": {
                "mfaAuthenticated": "false",
                "creationDate": "2018-08-23T17:27:08Z"
            }
        },
        "invokedBy": "apigateway.amazonaws.com"
    },
    "eventTime": "2018-08-23T17:27:19Z",
    "eventSource": "iot.amazonaws.com",
    "eventName": "CreateOTAUpdate",
    "awsRegion": "your_aws_region",
    "sourceIPAddress": "apigateway.amazonaws.com",
    "userAgent": "apigateway.amazonaws.com",
    "requestParameters": {
        "targets": [
            "arn:aws:iot:your_aws_region:your_aws_account:thing/Thing_CMH"
        ],
        "roleArn": "arn:aws:iam::your_aws_account:role/Role_FreeRTOSJob",
        "files": [
            {
                "fileName": "/sys/mcuflashimg.bin",
                "fileSource": {
                    "fileId": 0,
                    "streamId": "your_stream_id"
                },
                "codeSigning": {
                    "awsSignerJobId": "your_signer_job_id"
                }
            }
        ],
        "targetSelection": "SNAPSHOT",
        "otaUpdateId": "FreeRTOSJob_CMH-23-1535045232806-92"
    },
    "responseElements": {
        "otaUpdateArn": "arn:aws:iot:your_aws_region:your_aws_account:otaupdate/FreeRTOSJob_CMH-23-1535045232806-92",
        "otaUpdateStatus": "CREATE_PENDING",
        "otaUpdateId": "FreeRTOSJob_CMH-23-1535045232806-92"
    },
    "requestID": "c9649630-a6f9-11e8-8f9c-e1cf2d0c9d8e",
    "eventID": "ce9bf4d9-5770-4cee-acf4-0e5649b845c0",
    "eventType": "AwsApiCall",
    "recipientAccountId": "recipient_aws_account"
}