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 Pinpoint con AWS CloudTrail
Amazon Pinpoint se integra con AWS CloudTrail, que es un servicio que proporciona un registro de las medidas adoptadas por un usuario, un rol o un servicio de AWS en Amazon Pinpoint. CloudTrail captura las llamadas a la API de Amazon Pinpoint como eventos. Las llamadas capturadas incluyen las llamadas realizadas desde la consola de Amazon Pinpoint y las llamadas de código a las operaciones de la API de Amazon Pinpoint.
Si crea un registro de seguimiento, puede habilitar la entrega continua de eventos de CloudTrail a un bucket de Amazon Simple Storage Service (Amazon S3), incluidos los eventos para Amazon Pinpoint. Si no configura un registro de seguimiento, puede ver los eventos más recientes en la consola de CloudTrail con el Historial de eventos. Mediante la información recopilada por CloudTrail, puede determinar la solicitud que se realizó a Amazon Pinpoint, la dirección IP desde la que se realizó, quién la realizó y cuándo se realizó, entre otras cosas.
Para obtener más información acerca de CloudTrail, incluso cómo configurarlo y habilitarlo, consulte la Guía del usuario de AWS CloudTrail.
Información de Amazon Pinpoint en CloudTrail
CloudTrail se habilita en su cuenta de AWS cuando la crea. Cuando se produce una actividad de eventos compatible en Amazon Pinpoint, la actividad se registra en un evento de CloudTrail junto con otros eventos de servicios de AWS en Historial de eventos. Puede ver, buscar y descargar los últimos eventos de la cuenta de AWS. Para obtener más información, consulte Visualización de eventos con el historial de eventos de CloudTrail.
Para mantener un registro continuo de los eventos de la cuenta de AWS, incluidos los eventos de Amazon Pinpoint, cree un registro de seguimiento. Un registro de seguimiento permite a CloudTrail enviar archivos de registro a un bucket de Amazon S3. De manera 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 de seguimiento registra los eventos de todas las regiones de la partición de AWS y envía los archivos de registro al bucket de Amazon S3 especificado. También es posible configurar otros servicios de AWS para analizar en profundidad y actuar en función de los datos de eventos recopilados en los registros de CloudTrail. Para obtener más información, consulte los siguientes temas:
Cada entrada de registro o evento contiene información sobre quién generó la solicitud. La información de identidad le ayuda a determinar:
-
Si la solicitud se realizó con las credenciales raíz o del usuario de AWS Identity and Access Management.
-
Si la solicitud se realizó con credenciales de seguridad temporales de un rol o fue un usuario federado.
-
Si la solicitud la realizó otro servicio de AWS.
Para obtener más información, consulte Elemento userIdentity de CloudTrail.
Puede crear un registro de seguimiento y almacenar los archivos de registro en el bucket de Amazon S3 durante el tiempo que desee. Además, puede definir reglas de ciclo de vida de Amazon S3 para archivar o eliminar archivos de registros de forma automática. De forma predeterminada, los archivos de registro se cifran con cifrado del servidor (SSE) de Amazon S3.
Si desea recibir notificaciones de la entrega de archivos de registro, configure CloudTrail para que publique notificaciones de Amazon SNS cuando se envíen archivos de registro nuevos. Para obtener más información, consulte Configuración de notificaciones de Amazon SNS para CloudTrail.
También puede agregar archivos de registro de Amazon Pinpoint desde varias regiones de AWS y varias cuentas de AWS en un solo bucket de Amazon S3. Para obtener más información, consulte Recepción de archivos de registro de CloudTrail de varias regiones y Recepción de archivos de registro de CloudTrail de varias cuentas.
Puede utilizar CloudTrail para registrar las acciones de las siguientes API de Amazon Pinpoint:
Acciones de la API de Amazon Pinpoint que CloudTrail puede registrar
La API de Amazon Pinpoint admite el registro de las siguientes acciones como eventos en archivos de registros de CloudTrail:
Las siguientes acciones de la API de Amazon Pinpoint no se registran en CloudTrail:
-
PutEvents
-
SendMessages
-
SendUsersMessages
Acciones de la API de correo electrónico de Amazon Pinpoint que CloudTrail puede registrar
La API de correo electrónico de Amazon Pinpoint admite el registro de las siguientes acciones como eventos en los archivos de registro de CloudTrail:
La siguiente acción de la API de correo electrónico de Amazon Pinpoint no está registrada en CloudTrail:
-
SendEmail
Acciones de la versión 1 de la API de SMS y voz de Amazon Pinpoint que CloudTrail puede registrar
La API de SMS y voz de Amazon Pinpoint versión 1 admite el registro de las siguientes acciones como eventos en los archivos de registro de CloudTrail:
La siguiente acción de la versión 1 de la API de SMS y voz de Amazon Pinpoint no está registrada en CloudTrail:
-
SendVoiceMessage
Acciones de la versión 2 de la API de SMS y voz de Amazon Pinpoint que CloudTrail puede registrar
La API de SMS y voz de Amazon Pinpoint versión 2 admite el registro de las siguientes acciones como eventos en los archivos de registro de CloudTrail:
Las siguientes acciones de la API versión 2 de SMS y voz de Amazon Pinpoint no están registradas en CloudTrail:
Ejemplos: entradas del archivo de registro de Amazon Pinpoint
Un registro de seguimiento es una configuración que permite la entrega de eventos como archivos de registros en un bucket de Amazon S3 que especifique. Los archivos log de CloudTrail pueden contener una o varias entradas de log. Un evento representa una única solicitud desde cualquier origen. Incluye información sobre la acción solicitada, la fecha y la hora de la acción, los parámetros de la solicitud, etc. Los archivos de registro de CloudTrail no rastrean el orden en la pila de las llamadas públicas a la API, por lo que estas no aparecen en ningún orden específico.
En el ejemplo siguiente, se muestra una entrada de registro de CloudTrail que demuestra las acciones GetCampaigns y CreateCampaign de la API de Amazon Pinpoint.
{
"Records": [
{
"awsRegion": "us-east-1",
"eventID": "example0-09a3-47d6-a810-c5f9fd2534fe",
"eventName": "GetCampaigns",
"eventSource": "pinpoint.amazonaws.com",
"eventTime": "2018-02-03T00:56:48Z",
"eventType": "AwsApiCall",
"eventVersion": "1.05",
"readOnly": true,
"recipientAccountId": "123456789012",
"requestID": "example1-b9bb-50fa-abdb-80f274981d60",
"requestParameters": {
"application-id": "example71dfa4c1aab66332a5839798f",
"page-size": "1000"
},
"responseElements": null,
"sourceIPAddress": "192.0.2.0",
"userAgent": "Jersey/${project.version} (HttpUrlConnection 1.8.0_144)",
"userIdentity": {
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"accountId": "123456789012",
"arn": "arn:aws:iam::123456789012:root",
"principalId": "123456789012",
"sessionContext": {
"attributes": {
"creationDate": "2018-02-02T16:55:29Z",
"mfaAuthenticated": "false"
}
},
"type": "Root"
}
},
{
"awsRegion": "us-east-1",
"eventID": "example0-09a3-47d6-a810-c5f9fd2534fe",
"eventName": "CreateCampaign",
"eventSource": "pinpoint.amazonaws.com",
"eventTime": "2018-02-03T01:05:16Z",
"eventType": "AwsApiCall",
"eventVersion": "1.05",
"readOnly": false,
"recipientAccountId": "123456789012",
"requestID": "example1-b9bb-50fa-abdb-80f274981d60",
"requestParameters": {
"Description": "***",
"HoldoutPercent": 0,
"IsPaused": false,
"MessageConfiguration": "***",
"Name": "***",
"Schedule": {
"Frequency": "ONCE",
"IsLocalTime": true,
"StartTime": "2018-02-03T00:00:00-08:00",
"Timezone": "utc-08"
},
"SegmentId": "exampleda204adf991a80281aa0e591",
"SegmentVersion": 1,
"application-id": "example71dfa4c1aab66332a5839798f"
},
"responseElements": {
"ApplicationId": "example71dfa4c1aab66332a5839798f",
"CreationDate": "2018-02-03T01:05:16.425Z",
"Description": "***",
"HoldoutPercent": 0,
"Id": "example54a654f80948680cbba240ede",
"IsPaused": false,
"LastModifiedDate": "2018-02-03T01:05:16.425Z",
"MessageConfiguration": "***",
"Name": "***",
"Schedule": {
"Frequency": "ONCE",
"IsLocalTime": true,
"StartTime": "2018-02-03T00:00:00-08:00",
"Timezone": "utc-08"
},
"SegmentId": "example4da204adf991a80281example",
"SegmentVersion": 1,
"State": {
"CampaignStatus": "SCHEDULED"
},
"Version": 1
},
"sourceIPAddress": "192.0.2.0",
"userAgent": "aws-cli/1.14.9 Python/3.4.3 Linux/3.4.0+ botocore/1.8.34",
"userIdentity": {
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"accountId": "123456789012",
"arn": "arn:aws:iam::123456789012:user/userName",
"principalId": "AIDAIHTHRCDA62EXAMPLE",
"type": "IAMUser",
"userName": "userName"
}
}
]
}En el ejemplo siguiente, se muestra una entrada de registro de CloudTrail que demuestra las acciones CreateConfigurationSet y CreateConfigurationSetEventDestination de la API de SMS y voz de Amazon Pinpoint.
{
"Records": [
{
"eventVersion":"1.05",
"userIdentity":{
"type":"IAMUser",
"principalId":"AIDAIHTHRCDA62EXAMPLE",
"arn":"arn:aws:iam::111122223333:user/SampleUser",
"accountId":"111122223333",
"accessKeyId":"AKIAIOSFODNN7EXAMPLE",
"userName":"SampleUser"
},
"eventTime":"2018-11-06T21:45:55Z",
"eventSource":"sms-voice.amazonaws.com",
"eventName":"CreateConfigurationSet",
"awsRegion":"us-east-1",
"sourceIPAddress":"192.0.0.1",
"userAgent":"PostmanRuntime/7.3.0",
"requestParameters":{
"ConfigurationSetName":"MyConfigurationSet"
},
"responseElements":null,
"requestID":"56dcc091-e20d-11e8-87d2-9994aexample",
"eventID":"725843fc-8846-41f4-871a-7c52dexample",
"readOnly":false,
"eventType":"AwsApiCall",
"recipientAccountId":"123456789012"
},
{
"eventVersion":"1.05",
"userIdentity":{
"type":"IAMUser",
"principalId":"AIDAIHTHRCDA62EXAMPLE",
"arn":"arn:aws:iam::111122223333:user/SampleUser",
"accountId":"111122223333",
"accessKeyId":"AKIAIOSFODNN7EXAMPLE",
"userName":"SampleUser"
},
"eventTime":"2018-11-06T21:47:08Z",
"eventSource":"sms-voice.amazonaws.com",
"eventName":"CreateConfigurationSetEventDestination",
"awsRegion":"us-east-1",
"sourceIPAddress":"192.0.0.1",
"userAgent":"PostmanRuntime/7.3.0",
"requestParameters":{
"EventDestinationName":"CloudWatchEventDestination",
"ConfigurationSetName":"MyConfigurationSet",
"EventDestination":{
"Enabled":true,
"MatchingEventTypes":[
"INITIATED_CALL",
"INITIATED_CALL"
],
"CloudWatchLogsDestination":{
"IamRoleArn":"arn:aws:iam::111122223333:role/iamrole-01",
"LogGroupArn":"arn:aws:logs:us-east-1:111122223333:log-group:clientloggroup-01"
}
}
},
"responseElements":null,
"requestID":"81de1e73-e20d-11e8-b158-d5536example",
"eventID":"fcafc21f-7c93-4a3f-9e72-fca2dexample",
"readOnly":false,
"eventType":"AwsApiCall",
"recipientAccountId":"111122223333"
}
]
}