Registrazione delle chiamate API di Amazon SQS tramite AWS CloudTrail - Amazon Simple Queue Service
Informazioni su Amazon SQS in CloudTrailEventi di gestione in CloudTrailEventi relativi ai dati in CloudTrailEsempi: eventi CloudTrail di gestione per Amazon SQSEsempi: eventi CloudTrail relativi ai dati per Amazon SQS

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Registrazione delle chiamate API di Amazon SQS tramite AWS CloudTrail

Amazon SQS è integrato AWS CloudTrail per registrare le chiamate Amazon SQS da un utente, ruolo o servizio. AWS CloudTrail acquisisce le chiamate API relative alle code standard e FIFO di Amazon SQS come eventi, incluse le interazioni avviate tramite la console Amazon SQS e programmaticamente tramite chiamate alle API di Amazon SQS.

Informazioni su Amazon SQS in CloudTrail

CloudTrail è attivata per impostazione predefinita quando crei il tuo account. AWS Quando si verifica un'attività di evento Amazon SQS supportata, viene registrata in un CloudTrail evento, insieme ad altri eventi di AWS servizio, nella cronologia degli eventi. Puoi visualizzare, cercare e scaricare eventi recenti per il tuo AWS account. Per ulteriori informazioni, consulta Visualizzazione degli eventi con cronologia degli CloudTrail eventi nella Guida AWS CloudTrail per l'utente.

Le API di Amazon SQS che richiamano le operazioni di gestione delle code, ad esempio, AddPermission sono classificate come eventi di gestione e vengono registrate per impostazione predefinita. CloudTrail Le API di Amazon SQS che sono operazioni ad alto volume eseguite su una coda Amazon SQS, ad esempio, SendMessage sono classificate come eventi relativi ai dati e vengono registrate dopo l'attivazione. CloudTrail

Utilizzando le informazioni CloudTrail raccolte, puoi identificare una richiesta specifica a un'API Amazon SQS, l'indirizzo IP o l'identità del richiedente e la data e l'ora della richiesta. Se configuri un CloudTrail trail, puoi distribuire continuamente CloudTrail eventi a un bucket Amazon S3 con una consegna opzionale ad Amazon CloudWatch Logs e. AWS EventBridge Se non configuri un trail, puoi solo visualizzare la cronologia degli eventi di gestione negli eventi nella console. CloudTrail Per ulteriori informazioni, consultare Panoramica per la creazione di un percorso nella Guida per l'utente di AWS CloudTrail.

Eventi di gestione in CloudTrail

Amazon SQS registra le seguenti azioni API come eventi di gestione:

Le seguenti API Amazon SQS non sono supportate per la registrazione: CloudTrail

Eventi relativi ai dati in CloudTrail

Gli eventi di dati forniscono informazioni sulle operazioni eseguite su o in una risorsa, come l'invio o la ricezione di un messaggio Amazon SQS da e verso una coda Amazon SQS. Gli eventi relativi ai dati sono attività ad alto volume che CloudTrail non vengono registrate per impostazione predefinita. È possibile abilitare la registrazione delle azioni tramite l'API degli eventi relativi ai dati per la coda SQS utilizzando le API. CloudTrail Per ulteriori informazioni, consultare Registrazione di eventi di dati nella Guida per l'utente di AWS CloudTrail .

Con CloudTrail, puoi utilizzare selettori di eventi avanzati per decidere quali attività dell'API Amazon SQS vengono registrate e registrate. Per effettuare il logging di eventi di dati di Amazon SQS, devi includere il tipo di risorsa AWS::SQS::Queue. Una volta impostato il tipo di risorsa, puoi affinare ulteriormente le tue preferenze di logging selezionando eventi di dati specifici da registrare, ad esempio utilizzando il filtro eventName per tenere traccia degli eventi SendMessage. Per ulteriori informazioni, consulta AdvancedEventSelector nella documentazione di riferimento dell'API AWS CloudTrail .

Eventi di dati di Amazon SQS:

Per gli eventi di dati sono previsti costi aggiuntivi. Per ulteriori informazioni, consulta la sezione Prezzi di AWS CloudTrail.

Esempi: eventi CloudTrail di gestione per Amazon SQS

Gli esempi seguenti mostrano le voci di CloudTrail registro per le API supportate:

AddPermission

L'esempio seguente mostra una voce di CloudTrail registro per una chiamata AddPermission API.

{
	  "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'esempio seguente mostra una voce di CloudTrail registro per una chiamata CreateQueue API.

{
	  "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'esempio seguente mostra una voce di CloudTrail registro per una chiamata DeleteQueue API.

{
	  "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'esempio seguente mostra una voce di CloudTrail registro per una chiamata RemovePermission API.

{
	  "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'esempio seguente mostra una voce di CloudTrail registro perSetQueueAttributes:

{
	  "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"
	    }
	  ]
	}

Esempi: eventi CloudTrail relativi ai dati per Amazon SQS

Di seguito sono riportati alcuni esempi di CloudTrail eventi specifici delle API per eventi di dati di Amazon SQS:

SendMessage

L'esempio seguente mostra un evento di CloudTrail dati per. SendMessage


				{
  "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'esempio seguente mostra un evento di CloudTrail dati perReceiveMessage.


				{
  "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'esempio seguente mostra un evento di CloudTrail dati perDeleteMessageBatch.


				{
  "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'esempio seguente mostra un evento di CloudTrail dati perChangeMessageVisibilityBatch.


				{
  "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"
  }
}