Informations Amazon SQS dans CloudTrail Événements de gestion dans CloudTrail Événements liés aux données dans CloudTrail Exemples : événements CloudTrail de gestion pour Amazon SQS Exemples : événements CloudTrail liés aux données pour Amazon SQS

Journalisation des appels d'API Amazon SQS à l'aide d' AWS CloudTrail

Amazon SQS est intégré AWS CloudTrail pour enregistrer les appels Amazon SQS d'un utilisateur, d'un rôle ou d'un service. AWS CloudTrail capture les appels d'API liés à la norme Amazon SQS et aux files d'attente FIFO sous forme d'événements, y compris les interactions initiées via la console Amazon SQS ou de manière programmatique via des appels aux API Amazon SQS.

Rubriques

Informations Amazon SQS dans CloudTrail
Événements de gestion dans CloudTrail
Événements liés aux données dans CloudTrail
Exemples : événements CloudTrail de gestion pour Amazon SQS
Exemples : événements CloudTrail liés aux données pour Amazon SQS

Informations Amazon SQS dans CloudTrail

CloudTrail est activé par défaut lorsque vous créez votre AWS compte. Lorsqu'une activité d'événement Amazon SQS prise en charge se produit, elle est enregistrée dans un CloudTrail événement, avec d'autres événements de AWS service, dans l'historique des événements. Vous pouvez consulter, rechercher et télécharger les événements récents pour votre AWS compte. Pour plus d'informations, consultez la section Affichage des événements avec l'historique des CloudTrail événements dans le guide de AWS CloudTrail l'utilisateur.

Les API Amazon SQS qui appellent des opérations de gestion des files d'attente, telles que celles-ci, AddPermission sont classées comme des événements de gestion et sont connectées CloudTrail par défaut. Les API Amazon SQS qui sont des opérations à volume élevé effectuées sur une file d'attente Amazon SQS, par exemple, sont SendMessage classées dans la catégorie des événements de données et sont enregistrées une fois que vous vous êtes inscrit. CloudTrail

À l'aide des informations CloudTrail collectées, vous pouvez identifier une demande spécifique adressée à une API Amazon SQS, l'adresse IP ou l'identité du demandeur, ainsi que la date et l'heure de la demande. Si vous configurez un CloudTrail suivi, vous pouvez diffuser des CloudTrail événements en continu vers un compartiment Amazon S3 avec une diffusion facultative vers Amazon CloudWatch Logs et AWS EventBridge. Si vous ne configurez pas de suivi, vous pouvez uniquement consulter l'historique des événements de gestion dans les événements de la CloudTrail console. Pour plus d'informations, consultez Présentation de la création d'un journal de suivi dans le Guide de l'utilisateur AWS CloudTrail.

Événements de gestion dans CloudTrail

Voici les actions d'API qu'Amazon SQS journalise sous forme d'événements de gestion :

Les API Amazon SQS suivantes ne sont pas prises en charge pour CloudTrail la journalisation :

Événements liés aux données dans CloudTrail

Les événements de données fournissent des informations sur les opérations effectuées pour ou au niveau d'une ressource, telles que l'envoi ou la réception d'un message Amazon SQS vers ou depuis une file d'attente Amazon SQS. Les événements de données sont des activités volumineuses qui CloudTrail ne sont pas enregistrées par défaut. Vous pouvez activer la journalisation des actions de l'API Data Events pour votre file d'attente SQS à l'aide CloudTrail des API. Pour plus d'informations, consultez Journalisation des événements de données dans le Guide de l'utilisateur AWS CloudTrail .

Avec CloudTrail, vous pouvez utiliser des sélecteurs d'événements avancés pour décider quelles activités de l'API Amazon SQS sont enregistrées et enregistrées. Pour journaliser les événements de données Amazon SQS, vous devez inclure le type de ressource AWS::SQS::Queue. Une fois cette configuration effectuée, vous pouvez peaufiner vos préférences de journalisation en spécifiant les événements de données à enregistrer, par exemple en utilisant le filtre eventName pour suivre les événements SendMessage. Pour plus d'informations, consultez AdvancedEventSelector dans la Référence d'API AWS CloudTrail .

Événements de données Amazon SQS :

Des frais supplémentaires s’appliquent pour les événements de données. Pour plus d’informations, consultez Tarification d’AWS CloudTrail.

Exemples : événements CloudTrail de gestion pour Amazon SQS

Les exemples suivants montrent les entrées du CloudTrail journal pour les API prises en charge :

AddPermission

L'exemple suivant montre une entrée de CloudTrail journal pour un appel d'AddPermissionAPI.


{
	  "Records": [
	    {
	      "eventVersion": "1.06",
	      "userIdentity": {
	        "type": "IAMUser",
	        "principalId": "AKIAI44QH8DHBEXAMPLE",
	        "arn": "arn:aws:iam::123456789012:user/Alice",
	        "accountId": "123456789012",
	        "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
	        "userName": "Alice"
	      },
	      "eventTime": "2018-06-28T22:23:46Z",
	      "eventSource": "sqs.amazonaws.com",
	      "eventName": "AddPermission",
	      "awsRegion": "us-east-2",
	      "sourceIPAddress": "203.0.113.0",
	      "userAgent": "Mozilla/5.0 (X11; Linux x86_64; rv:24.0) Gecko/20100101 Firefox/24.0",
	      "requestParameters": {
	        "actions": [
	          "SendMessage"
	        ],
	        "AWSAccountIds": [
	          "123456789012"
	        ],
	        "label": "MyLabel",
	        "queueUrl": "https://sqs.us-east-2.amazon.com/123456789012/MyQueue"
	      },
	      "responseElements": null,
	      "requestID": "123abcde-f4gh-50ij-klmn-60o789012p30",
	      "eventID": "0987g654-32f1-09e8-d765-c4f3fb2109fa"
	    }
	  ]
	}

CreateQueue

L'exemple suivant montre une entrée de CloudTrail journal pour un appel d'CreateQueueAPI.


{
	  "Records": [
	    {
	      "eventVersion": "1.06",
	      "userIdentity": {
	        "type": "IAMUser",
	        "principalId": "AKIAI44QH8DHBEXAMPLE",
	        "arn": "arn:aws:iam::123456789012:user/Alejandro",
	        "accountId": "123456789012",
	        "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
	        "userName": "Alejandro"
	      },
	      "eventTime": "2018-06-28T22:23:46Z",
	      "eventSource": "sqs.amazonaws.com",
	      "eventName": "CreateQueue",
	      "awsRegion": "us-east-2",
	      "sourceIPAddress": "203.0.113.1",
	      "userAgent": "Mozilla/5.0 (X11; Linux x86_64; rv:24.0) Gecko/20100101 Firefox/24.0",
	      "requestParameters": {
	        "queueName": "MyQueue"
	      },
	      "responseElements": {
	        "queueUrl": "https://sqs.us-east-2.amazon.com/123456789012/MyQueue"
	      },
	      "requestID": "123abcde-f4gh-50ij-klmn-60o789012p30",
	      "eventID": "0987g654-32f1-09e8-d765-c4f3fb2109fa"
	    }
	  ]
	}

DeleteQueue

L'exemple suivant montre une entrée de CloudTrail journal pour un appel d'DeleteQueueAPI.


{
	  "Records": [
	    {
	      "eventVersion": "1.06",
	      "userIdentity": {
	        "type": "IAMUser",
	        "principalId": "AKIAI44QH8DHBEXAMPLE",
	        "arn": "arn:aws:iam::123456789012:user/Carlos",
	        "accountId": "123456789012",
	        "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
	        "userName": "Carlos"
	      },
	      "eventTime": "2018-06-28T22:23:46Z",
	      "eventSource": "sqs.amazonaws.com",
	      "eventName": "DeleteQueue",
	      "awsRegion": "us-east-2",
	      "sourceIPAddress": "203.0.113.2",
	      "userAgent": "Mozilla/5.0 (X11; Linux x86_64; rv:24.0) Gecko/20100101 Firefox/24.0",
	      "requestParameters": {
	        "queueUrl": "https://sqs.us-east-2.amazon.com/123456789012/MyQueue"
	      },
	      "responseElements": null,
	      "requestID": "123abcde-f4gh-50ij-klmn-60o789012p30",
	      "eventID": "0987g654-32f1-09e8-d765-c4f3fb2109fa"
	    }
	  ]
	}

RemovePermission

L'exemple suivant montre une entrée de CloudTrail journal pour un appel d'RemovePermissionAPI.


{
	  "Records": [
	    {
	      "eventVersion": "1.06",
	      "userIdentity": {
	        "type": "IAMUser",
	        "principalId": "AKIAI44QH8DHBEXAMPLE",
	        "arn": "arn:aws:iam::123456789012:user/Jane",
	        "accountId": "123456789012",
	        "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
	        "userName": "Jane"
	      },
	      "eventTime": "2018-06-28T22:23:46Z",
	      "eventSource": "sqs.amazonaws.com",
	      "eventName": "RemovePermission",
	      "awsRegion": "us-east-2",
	      "sourceIPAddress": "203.0.113.3",
	      "userAgent": "Mozilla/5.0 (X11; Linux x86_64; rv:24.0) Gecko/20100101 Firefox/24.0",
	      "requestParameters": {
	        "label": "label",
	        "queueUrl": "https://sqs.us-east-2.amazon.com/123456789012/MyQueue"
	      },
	      "responseElements": null,
	      "requestID": "123abcde-f4gh-50ij-klmn-60o789012p30",
	      "eventID": "0987g654-32f1-09e8-d765-c4f3fb2109fa"
	    }
	  ]
	}

SetQueueAttributes

L'exemple suivant montre une entrée de CloudTrail journal pour SetQueueAttributes :


{
	  "Records": [
	    {
	      "eventVersion": "1.06",
	      "userIdentity": {
	        "type": "IAMUser",
	        "principalId": "AKIAI44QH8DHBEXAMPLE",
	        "arn": "arn:aws:iam::123456789012:user/Maria",
	        "accountId": "123456789012",
	        "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
	        "userName": "Maria"
	      },
	      "eventTime": "2018-06-28T22:23:46Z",
	      "eventSource": "sqs.amazonaws.com",
	      "eventName": "SetQueueAttributes",
	      "awsRegion": "us-east-2",
	      "sourceIPAddress": "203.0.113.4",
	      "userAgent": "Mozilla/5.0 (X11; Linux x86_64; rv:24.0) Gecko/20100101 Firefox/24.0",
	      "requestParameters": {
	        "attributes": {
	          "VisibilityTimeout": "100"
	        },
	        "queueUrl": "https://sqs.us-east-2.amazon.com/123456789012/MyQueue"
	      },
	      "responseElements": null,
	      "requestID": "123abcde-f4gh-50ij-klmn-60o789012p30",
	      "eventID": "0987g654-32f1-09e8-d765-c4f3fb2109fa"
	    }
	  ]
	}

Exemples : événements CloudTrail liés aux données pour Amazon SQS

Voici des exemples d' CloudTrail événements spécifiques aux API d'événements de données Amazon SQS :

SendMessage

L'exemple suivant montre un événement CloudTrail de données pourSendMessage.



				{
  "eventVersion": "1.09",
  "userIdentity": {
    "type": "AssumedRole",
    "principalId": "EXAMPLE_PRINCIPAL_ID",
    "arn": "arn:aws:sts::123456789012:assumed-role/RoleToBeAssumed/SessionName",
    "accountId": "123456789012",
    "accessKeyId": "ACCESS_KEY_ID",
    "sessionContext": {
      "sessionIssuer": {
        "type": "Role",
        "principalId": "AKIAI44QH8DHBEXAMPLE",
        "arn": "arn:aws:sts::123456789012:assumed-role/RoleToBeAssumed",
        "accountId": "123456789012",
        "userName": "RoleToBeAssumed"
      },
      "attributes": {
        "creationDate": "2023-11-07T22:13:06Z",
        "mfaAuthenticated": "false"
      }
    }
  },
  "eventTime": "2023-11-07T23:59:11Z",
  "eventSource": "sqs.amazonaws.com",
  "eventName": "SendMessage",
  "awsRegion": "ap-southeast-4",
  "sourceIPAddress": "10.0.118.80",
  "userAgent": "aws-cli/1.29.16 md/Botocore#1.31.16 ua/2.0 os/linux#5.4.250-173.369.amzn2int.x86_64 md/arch#x86_64 lang/python#3.8.17 md/pyimpl#CPython cfg/retry-mode#legacy botocore/1.31.16",
  "requestParameters": {
    "queueUrl": "https://sqs.ap-southeast-4.amazonaws.com/123456789012/MyQueue",
    "messageBody": "HIDDEN_DUE_TO_SECURITY_REASONS",
    "messageDeduplicationId": "MsgDedupIdSdk1ae1958f2-bbe8-4442-83e7-4916e3b035aa",
    "messageGroupId": "MsgGroupIdSdk16"
  },
  "responseElements": {
    "mD5OfMessageBody": "9a4e3f7a614d9dd9f8722092dbda17a2",
    "mD5OfMessageSystemAttributes": "f88f0587f951b7f5551f18ae699c3a9d",
    "messageId": "93bb6e2d-1090-416c-81b0-31eb1faa8cd8",
    "sequenceNumber": "18881790870905840128"
  },
  "requestID": "c4584600-fe8a-5aa3-a5ba-1bc42f055fae",
  "eventID": "98c735d8-70e0-4644-9432-b6ced4d791b1",
  "readOnly": false,
  "resources": [
    {
      "accountId": "123456789012",
      "type": "AWS::SQS::Queue",
      "ARN": "arn:aws:sqs:ap-southeast-4:123456789012:MyQueue"
    }
  ],
  "eventType": "AwsApiCall",
  "managementEvent": false,
  "recipientAccountId": "123456789012",
  "eventCategory": "Data",
  "tlsDetails": {
    "tlsVersion": "TLSv1.2",
    "cipherSuite": "ECDHE-RSA-AES128-GCM-SHA256",
    "clientProvidedHostHeader": "sqs.ap-southeast-4.amazonaws.com"
  }

ReceiveMessage

L'exemple suivant montre un événement CloudTrail de données pourReceiveMessage.



				{
  "eventVersion": "1.09",
  "userIdentity": {
    "type": "AssumedRole",
    "principalId": "EXAMPLE_PRINCIPAL_ID",
    "arn": "arn:aws:sts::123456789012:assumed-role/RoleToBeAssumed/SessionName",
    "accountId": "123456789012",
    "accessKeyId": "ACCESS_KEY_ID",
    "sessionContext": {
      "sessionIssuer": {
        "type": "Role",
        "principalId": "AKIAI44QH8DHBEXAMPLE",
        "arn": "arn:aws:sts::123456789012:assumed-role/RoleToBeAssumed",
        "accountId": "123456789012",
        "userName": "RoleToBeAssumed"
      },
      "attributes": {
        "creationDate": "2023-11-07T22:13:06Z",
        "mfaAuthenticated": "false"
      }
    }
  },
  "eventTime": "2023-11-07T23:59:24Z",
  "eventSource": "sqs.amazonaws.com",
  "eventName": "ReceiveMessage",
  "awsRegion": "ap-southeast-4",
  "sourceIPAddress": "10.0.118.80",
  "userAgent": "aws-cli/1.29.16 md/Botocore#1.31.16 ua/2.0 os/linux#5.4.250-173.369.amzn2int.x86_64 md/arch#x86_64 lang/python#3.8.17 md/pyimpl#CPython cfg/retry-mode#legacy botocore/1.31.16",
  "requestParameters": {
    "queueUrl": "https://sqs.ap-southeast-4.amazonaws.com/123456789012/MyQueue",
    "maxNumberOfMessages": 10
  },
  "responseElements": null,
  "requestID": "8b4d4643-8f49-52cd-a6e8-1b875ed54b99",
  "eventID": "f3f23ab7-b0a4-4b71-afc0-141209c49206",
  "readOnly": true,
  "resources": [
    {
      "accountId": "123456789012",
      "type": "AWS::SQS::Queue",
      "ARN": "arn:aws:sqs:ap-southeast-4:123456789012:MyQueue"
    }
  ],
  "eventType": "AwsApiCall",
  "managementEvent": false,
  "recipientAccountId": "123456789012",
  "eventCategory": "Data",
  "tlsDetails": {
    "tlsVersion": "TLSv1.2",
    "cipherSuite": "ECDHE-RSA-AES128-GCM-SHA256",
    "clientProvidedHostHeader": "sqs.ap-southeast-4.amazonaws.com"
  }
}

DeleteMessageBatch

L'exemple suivant montre un événement CloudTrail de données pourDeleteMessageBatch.



				{
  "eventVersion": "1.09",
  "userIdentity": {
    "type": "AssumedRole",
    "principalId": "EXAMPLE_PRINCIPAL_ID",
    "arn": "arn:aws:sts::123456789012:assumed-role/RoleToBeAssumed/SessionName",
    "accountId": "123456789012",
    "accessKeyId": "ACCESS_KEY_ID",
    "sessionContext": {
      "sessionIssuer": {
        "type": "Role",
        "principalId": "AKIAI44QH8DHBEXAMPLE",
        "arn": "arn:aws:sts::123456789012:assumed-role/RoleToBeAssumed",
        "accountId": "123456789012",
        "userName": "RoleToBeAssumed"
      },
      "attributes": {
        "creationDate": "2023-11-07T22:13:06Z",
        "mfaAuthenticated": "false"
      }
    }
  },
  "eventTime": "2023-11-07T23:59:24Z",
  "eventSource": "sqs.amazonaws.com",
  "eventName": "DeleteMessageBatch",
  "awsRegion": "ap-southeast-4",
  "sourceIPAddress": "10.0.118.80",
  "userAgent": "aws-cli/1.29.16 md/Botocore#1.31.16 ua/2.0 os/linux#5.4.250-173.369.amzn2int.x86_64 md/arch#x86_64 lang/python#3.8.17 md/pyimpl#CPython cfg/retry-mode#legacy botocore/1.31.16",
  "requestParameters": {
    "queueUrl": "https://sqs.ap-southeast-4.amazonaws.com/123456789012/MyQueue",
    "entries": [
      {
        "id": "0",
        "receiptHandle": "AQEBefxM1O4zyZGF87DehbRbmri91w2W7mMdD0GrBjQa8e/hpb4RbXHPZ9tLBVleECbChQIE5NtaDuoZhZPOkTy0eN46EyRR4jXDzE3AlkbPlX1mA9f2fUuTrXx8aeCoCA3I3woNg3fXXAoo5ctLgci0Z/hlLS94tjAZqV2krc4BaC2pYgjyHWcW019HwIV8T/bjNMIeZoQwOM5V+o9vHPfewz5QGr5SKpDo7uE7Umyk5n5CJZvcn1efp/mrwtaCIb9M7cCQUYcZm2ZmZDnIO9XpGTAi3m2dQ0M83pnNh0nvDfpkHpoa+hX1TrUmxCupCWHJwA8HFJ1O/CCJsodMNFthLBA9S57dkBZCsw41G8jAmgQ0MkvZ0UL5mg0OFQQd1Yrw0zvthjCgiwdzn0yXoMzxIZMBxkY14E4nVVZ7N5XEMtMmgxsI1XF/h8oRk2C7gByzg2kYJ0LnUvLJFT8DQE28JZppEC9klvrdR/BWiPT7asc="
      }
    ]
  },
  "responseElements": {
    "successful": [
      {
        "id": "0"
      }
    ],
    "failed": []
  },
  "requestID": "fe423091-5642-5ba5-9256-6d5587de52f1",
  "eventID": "88c8020d-d769-4985-8ecb-ee0b59acc418",
  "readOnly": false,
  "resources": [
    {
      "accountId": "123456789012",
      "type": "AWS::SQS::Queue",
      "ARN": "arn:aws:sqs:ap-southeast-4:123456789012:MyQueue"
    }
  ],
  "eventType": "AwsApiCall",
  "managementEvent": false,
  "recipientAccountId": "123456789012",
  "eventCategory": "Data",
  "tlsDetails": {
    "tlsVersion": "TLSv1.2",
    "cipherSuite": "ECDHE-RSA-AES128-GCM-SHA256",
    "clientProvidedHostHeader": "sqs.ap-southeast-4.amazonaws.com"
  }
}

ChangeMessageVisibilityBatch

L'exemple suivant montre un événement CloudTrail de données pourChangeMessageVisibilityBatch.



				{
  "eventVersion": "1.09",
  "userIdentity": {
    "type": "AssumedRole",
    "principalId": "EXAMPLE_PRINCIPAL_ID",
    "arn": "arn:aws:sts::123456789012:assumed-role/RoleToBeAssumed/SessionName",
    "accountId": "123456789012",
    "accessKeyId": "ACCESS_KEY_ID",
    "sessionContext": {
      "sessionIssuer": {
        "type": "Role",
        "principalId": "AKIAI44QH8DHBEXAMPLE",
        "arn": "arn:aws:sts::123456789012:assumed-role/RoleToBeAssumed",
        "accountId": "123456789012",
        "userName": "RoleToBeAssumed"
      },
      "attributes": {
        "creationDate": "2023-11-07T22:13:06Z",
        "mfaAuthenticated": "false"
      }
    }
  },
  "eventTime": "2023-11-07T23:59:01Z",
  "eventSource": "sqs.amazonaws.com",
  "eventName": "ChangeMessageVisibilityBatch",
  "awsRegion": "ap-southeast-4",
  "sourceIPAddress": "10.0.118.80",
  "userAgent": "aws-cli/1.29.16 md/Botocore#1.31.16 ua/2.0 os/linux#5.4.250-173.369.amzn2int.x86_64 md/arch#x86_64 lang/python#3.8.17 md/pyimpl#CPython cfg/retry-mode#legacy botocore/1.31.16",
  "requestParameters": {
    "visibilityTimeout": 0,
    "entries": [
      {
        "id": "0",
        "receiptHandle": "AQEB2M5cVYg5gslhWME6537hdjcaPnOYPA5M0W460TTb0DzPle631yPWm8qxd4O1hDj/B4ntTMnsgBTa95t14tNx7Vn96jKJ5rIoZ7iI8TRmkT1caKodKIPs8w9yndZq50c2FPQxtyH+2L3UHf/abV3szqVWXOLZR4PwX8zZkWVQGNCNnY2q2lGCG586F8QwvrOFYoXNwB8ymd1t77e1PDPknq1Io3JFuzkEsndkkETy4fV1QqVCSTR1izaTKF44f/l5PHX17nXxaC+DURVlMPXOuSFACGmWqAoyk50HKwGOjLQgpySL/TcnQXClvFq8kNXGwyVzJsbwHpOHxI7oce69vaD6DaWFP75d3hx+PJeG9pauQCKzVP3skt3Hw/zDC7YfKcALD3aCwMmeNDwT3w0BUG6XZdG5lYhtFtTQYV7YuS3i/Jh3HShGbtm07JKOEFiPkxv2+XNaAX3gFEpbng6zamTanfyMXCJIiglAEqiyWHQ=",
        "visibilityTimeout": 2271
      }
    ],
    "queueUrl": "https://sqs.ap-southeast-4.amazonaws.com/123456789012/MyQueue"
  },
  "responseElements": {
    "successful": [
      {
        "id": "0"
      }
    ]
  },
  "requestID": "d49ab65f-9dc7-54b8-875c-eb9b4c42988b",
  "eventID": "ca16c8c2-c4ba-4eb5-a54c-e650a10266d4",
  "readOnly": false,
  "resources": [
    {
      "accountId": "123456789012",
      "type": "AWS::SQS::Queue",
      "ARN": "arn:aws:sqs:ap-southeast-4:123456789012:MyQueue"
    }
  ],
  "eventType": "AwsApiCall",
  "managementEvent": false,
  "recipientAccountId": "123456789012",
  "eventCategory": "Data",
  "tlsDetails": {
    "tlsVersion": "TLSv1.2",
    "cipherSuite": "ECDHE-RSA-AES128-GCM-SHA256",
    "clientProvidedHostHeader": "sqs.ap-southeast-4.amazonaws.com"
  }
}

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Journalisation et surveillance

Surveillance des files d'attente à l'aide CloudWatch