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 de llamadas a la API de Amazon Textract con AWS CloudTrail

Amazon Textract está integrado con AWS CloudTrail un servicio que proporciona un registro de las acciones realizadas por un usuario, un rol o un AWS servicio en Amazon Textract. CloudTrail captura todas las llamadas a la API de Amazon Textract como eventos. Las llamadas capturadas incluyen llamadas desde la consola de Amazon Textract y llamadas de código a las operaciones de la API de Amazon Textract.

Si crea un registro, puede habilitar la entrega continua de CloudTrail eventos a un bucket de Amazon S3, incluidos los eventos de Amazon Textract. Si no configura un registro, puede seguir viendo los eventos más recientes en la CloudTrail consola, en el historial de eventos. Con la información recopilada por CloudTrail, puede determinar la solicitud que se realizó a Amazon Textract, la dirección IP desde la que se realizó la solicitud, quién la hizo, cuándo se hizo y detalles adicionales.

Para obtener más información CloudTrail, consulte la Guía del AWS CloudTrail usuario.

Información sobre Amazon Textract en CloudTrail

CloudTrail está activado en su AWS cuenta al crearla. Cuando se produce actividad en Amazon Textract, esa actividad se registra en un CloudTrail evento junto con otros eventos de AWS servicio en el historial de eventos. Puede ver, buscar y descargar los eventos recientes en su AWS cuenta. Para obtener más información, consulta Visualización de eventos con el historial de CloudTrail eventos.

Para obtener un registro continuo de los eventos de su AWS cuenta, incluidos los de Amazon Textract, cree un registro. Un registro permite CloudTrail enviar archivos de registro a un bucket de Amazon S3. De forma predeterminada, cuando se crea un registro de seguimiento en la consola, el registro de seguimiento se aplica a todas las regiones de AWS. El registro registra los eventos de todas las regiones de la AWS partición y envía los archivos de registro al bucket de Amazon S3 que usted especifique. Además, puede configurar otros AWS servicios para analizar más a fondo los datos de eventos que se recopilan en los CloudTrail registros y actuar en función de ellos. Para más información, consulte los siguientes temas:

Todas las operaciones de Amazon Textract se registran en la referencia de la API CloudTrail y se documentan en ella. Por ejemplo, las llamadas a DetectDocumentTextAnalyzeDocument, y GetDocumentText las acciones generan entradas en los archivos de CloudTrail registro.

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

Para obtener más información, consulte el Elemento userIdentity de CloudTrail .

Parámetros de solicitud y campos de respuesta que no están registrados

Por motivos de privacidad, algunos parámetros de solicitud y campos de respuesta no se registran, por ejemplo, los bytes de la imagen de la solicitud o la información de los cuadros delimitadores de respuestas. Los nombres de los buckets y archivos de Amazon S3 proporcionados en los parámetros de la solicitud se incluyen en las entradas de registro. CloudTrail En un CloudTrail registro no se proporciona información sobre los bytes de imagen transmitidos a una solicitud. La siguiente tabla muestra los parámetros de entrada y los parámetros de respuesta que no se registran para cada operación de Amazon Textract.

Descripción de las entradas del archivo de registro de Amazon Textract

Un registro es una configuración que permite la entrega de eventos como archivos de registro a un bucket de Amazon S3 que usted especifique. CloudTrail Los archivos de registro contienen una o más entradas de registro. Un evento representa una única solicitud de cualquier fuente e incluye información sobre la operación solicitada, la fecha y la hora de la operación, los parámetros de la solicitud, etc. CloudTrail los archivos de registro no son un seguimiento ordenado de las llamadas a la API pública, por lo que no aparecen en ningún orden específico.

El siguiente ejemplo muestra una entrada de CloudTrail registro que demuestra la AnalyzeDocument operación. Los bytes de imagen de la entrada document y los resultados del análisis (responseElements) no se registran.

{
    "eventVersion": "1.05",
    "userIdentity": {
        "type": "IAMUser",
        "principalId": "AIDACKCEVSQ6C2EXAMPLE",
        "arn": "arn:aws:iam::111111111111:user/janedoe",
        "accountId": "111111111111",
        "accessKeyId": "AIDACKCEVSQ6C2EXAMPLE",
        "userName": "janedoe"
    },
    "eventTime": "2019-04-03T23:56:31Z",
    "eventSource": "textract.amazonaws.com",
    "eventName": "AnalyzeDocument",
    "awsRegion": "us-east-1",
    "sourceIPAddress": "198.51.100.0",
    "userAgent": "",
    "requestParameters": {
        "document": {},
        "featureTypes": [
            "TABLES"
        ]
    },
    "responseElements": null,
    "requestID": "e387676b-d1f0-4ea7-85d6-f5a344052dce",
    "eventID": "c5db79ce-e4ea-4401-8517-784481d559f7",
    "eventType": "AwsApiCall",
    "recipientAccountId": "111111111111"
}

El siguiente ejemplo muestra una entrada de CloudTrail registro de la StartDocumentAnalysis operación. La entrada de registro incluye el nombre del bucket de Amazon S3 y el nombre del archivo de imagendocumentLocation. El registro también incluye la respuesta de la operación.

{
    "Records": [
        {
            "eventVersion": "1.05",
            "userIdentity": {
                "type": "IAMUser",
                "principalId": "AIDACKCEVSQ6C2EXAMPLE",
                "arn": "arn:aws:iam::111111111111:user/janedoe",
                "accountId": "11111111111",
                "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
                "userName": "janedoe"
            },
            "eventTime": "2019-04-04T01:42:24Z",
            "eventSource": "textract.amazonaws.com",
            "eventName": "StartDocumentAnalysis",
            "awsRegion": "us-east-1",
            "sourceIPAddress": "198.51.100.0",
            "userAgent": "",
            "requestParameters": {
                "documentLocation": {
                    "s3Object": {
                        "bucket": "bucket",
                        "name": "document.png"
                    }
                },
                "featureTypes": [
                    "TABLES"
                ]
            },
            "responseElements": {
                "jobId": "f3c718b444fa603d5d625ab967008f4b620d4650c9db8ca1cae01ef7efe51373"
            },
            "requestID": "9ae352e8-9de1-41ad-b77b-85aa348c2e82",
            "eventID": "f741bca0-c3cb-4805-82ea-baf76439deef",
            "eventType": "AwsApiCall",
            "recipientAccountId": "111111111111"
        }

    ]
}