Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Protokollierung AWS Clean Rooms API-Aufrufe mit AWS CloudTrail
AWS Clean Rooms ist in einen Dienst integriert AWS CloudTrail, der eine Aufzeichnung der von einem Benutzer, einer Rolle oder einem AWS-Service Benutzer ausgeführten Aktionen bereitstellt AWS Clean Rooms. CloudTrail erfasst alle API-Aufrufe AWS Clean Rooms als Ereignisse. Zu den erfassten Aufrufen gehören Aufrufe von der AWS Clean Rooms Konsole und Codeaufrufe an die AWS Clean Rooms API-Operationen. Wenn Sie einen Trail erstellen, können Sie die kontinuierliche Übertragung von CloudTrail Ereignissen an einen Amazon S3-Bucket aktivieren, einschließlich Ereignissen für AWS Clean Rooms. Wenn Sie keinen Trail konfigurieren, können Sie trotzdem die neuesten Ereignisse in der CloudTrail Konsole im Event-Verlauf einsehen. Anhand der gesammelten Informationen können Sie ermitteln CloudTrail, an welche Anfrage gestellt wurde AWS Clean Rooms, von welcher IP-Adresse aus die Anfrage gestellt wurde, wer die Anfrage gestellt hat, wann sie gestellt wurde und weitere Details.
Weitere Informationen CloudTrail dazu finden Sie im AWS CloudTrail Benutzerhandbuch.
AWS Clean Rooms Informationen in CloudTrail
CloudTrail ist auf Ihrem aktiviert AWS-Konto , wenn Sie das Konto erstellen. Wenn eine Aktivität stattfindet AWS Clean Rooms, wird diese Aktivität zusammen mit anderen AWS-Service Ereignissen im CloudTrail Eventverlauf in einem Ereignis aufgezeichnet. Sie können in Ihrem AWS-Konto die neusten Ereignisse anzeigen, suchen und herunterladen. Weitere Informationen finden Sie unter Ereignisse mit dem CloudTrail Ereignisverlauf anzeigen.
Für eine fortlaufende Aufzeichnung der Ereignisse in Ihrem AWS-Konto, einschließlich der Ereignisse für AWS Clean Rooms, erstellen Sie einen Trail. Ein Trail ermöglicht CloudTrail die Übermittlung von Protokolldateien an einen Amazon S3-Bucket. Wenn Sie einen Trail in der Konsole anlegen, gilt dieser für alle AWS-Regionen-Regionen. Der Trail protokolliert Ereignisse aus allen Regionen in der AWS Partition und übermittelt die Protokolldateien an den von Ihnen angegebenen Amazon S3-Bucket. Darüber hinaus können Sie andere so konfigurieren, AWS-Services dass die in den CloudTrail Protokollen gesammelten Ereignisdaten weiter analysiert und entsprechend reagiert wird. Weitere Informationen finden Sie hier:
Alle AWS Clean Rooms Aktionen werden von der AWS Clean Rooms API-Referenz protokolliert CloudTrail und darin dokumentiert .
Jeder Ereignis- oder Protokolleintrag enthält Informationen zu dem Benutzer, der die Anforderung generiert hat. Die Identitätsinformationen unterstützen Sie bei der Ermittlung der folgenden Punkte:
-
Ob die Anfrage mit Anmeldeinformationen des Stammbenutzers oder des IAM-Benutzers gestellt wurde.
-
Gibt an, ob die Anforderung mit temporären Sicherheitsanmeldeinformationen für eine Rolle oder einen Verbundbenutzer gesendet wurde.
-
Ob die Anforderung aus einem anderen AWS-Service gesendet wurde.
Weitere Informationen finden Sie unter CloudTrail -Element userIdentity.
Verstehen AWS Clean Rooms Protokolldateieinträge
Ein Trail ist eine Konfiguration, die die Übertragung von Ereignissen als Protokolldateien an einen von Ihnen angegebenen Amazon S3-Bucket ermöglicht. CloudTrail Protokolldateien enthalten einen oder mehrere Protokolleinträge. Ein Ereignis stellt eine einzelne Anforderung aus einer beliebigen Quelle dar und enthält Informationen über die angeforderte Aktion, Datum und Uhrzeit der Aktion, Anforderungsparameter usw. CloudTrail Logdateien sind kein geordneter Stack-Trace der öffentlichen API-Aufrufe, daher erscheinen sie in keiner bestimmten Reihenfolge.
Anmerkung
AWS Clean Rooms redigiert nur bestimmte Anforderungsparameter, die seine API definiert. Wenn Sie zusätzliche Felder hinzufügen, die nicht Teil der API sind, CloudTrail zeichnet sie genau so auf, wie Sie sie gesendet haben, und redigiert sie nicht. Füge keine Passwörter oder andere vertrauliche Informationen in Felder ein, die nicht Teil der API sind.
Beispiel AWS Clean Rooms CloudTrail Ereignisse
Die folgenden Beispiele veranschaulichen CloudTrail Ereignisse für:
StartProtectedQuery (erfolgreich)
{ "eventVersion": "1.08", "userIdentity": { "type": "AssumedRole", "principalId": "EXAMPLE_PRINCIPAL_ID", "arn": "arn:aws:sts::123456789012:assumed-role/query-runner/jdoe", "accountId": "123456789012", "accessKeyId": "EXAMPLE_KEY_ID", "sessionContext": { "sessionIssuer": { "type": "Role", "principalId": "EXAMPLE_PRINCIPAL_ID", "arn": "arn:aws:iam::123456789012:role/query-runner", "accountId": "123456789012", "userName": "query-runner" }, "webIdFederationData": {}, "attributes": { "creationDate": "2023-04-07T19:34:32Z", "mfaAuthenticated": "false" } } }, "eventTime": "2023-04-07T19:53:32Z", "eventSource": "cleanrooms.amazonaws.com", "eventName": "StartProtectedQuery", "awsRegion": "us-east-2", "sourceIPAddress": "203.0.113.1", "userAgent": "aws-internal/3", "requestParameters": { "resultConfiguration": { "outputConfiguration": { "s3": { "resultFormat": "CSV", "bucket": "cleanrooms-queryresults-jdoe-test", "keyPrefix": "test" } } }, "sqlParameters": "***", "membershipIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "type": "SQL" }, "responseElements": { "Access-Control-Expose-Headers": "x-amzn-RequestId,x-amzn-ErrorType,x-amzn-ErrorMessage,Date", "protectedQuery": { "createTime": 1680897212.279, "id": "f5988bf1-771a-4141-82a8-26fcc4e41c9f", "membershipArn": "arn:aws:cleanrooms:us-east-2:123456789012:membership/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "membershipId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "resultConfiguration": { "outputConfiguration": { "s3": { "bucket": "cleanrooms-queryresults-jdoe-test", "keyPrefix": "test", "resultFormat": "CSV" } } }, "sqlParameters": "***", "status": "SUBMITTED" } }, "requestID": "7464211b-2277-4b55-9723-fb4f259aefd2", "eventID": "f7610f5e-74b9-420f-ae43-206571ebcbf7", "readOnly": false, "eventType": "AwsApiCall", "managementEvent": true, "recipientAccountId": "123456789012", "eventCategory": "Management" }
StartProtectedQuery (gescheitert)
{ "eventVersion": "1.08", "userIdentity": { "type": "AssumedRole", "principalId": "EXAMPLE_PRINCIPAL_ID", "arn": "arn:aws:sts::123456789012:assumed-role/query-runner/jdoe", "accountId": "123456789012", "accessKeyId": "EXAMPLE_KEY_ID", "sessionContext": { "sessionIssuer": { "type": "Role", "principalId": "EXAMPLE_PRINCIPAL_ID", "arn": "arn:aws:iam::123456789012:role/query-runner", "accountId": "123456789012", "userName": "query-runner" }, "webIdFederationData": {}, "attributes": { "creationDate": "2023-04-07T19:34:32Z", "mfaAuthenticated": "false" } } }, "eventTime": "2023-04-07T19:47:27Z", "eventSource": "cleanrooms.amazonaws.com", "eventName": "StartProtectedQuery", "awsRegion": "us-east-2", "sourceIPAddress": "203.0.113.1", "userAgent": "aws-internal/3", "errorCode": "ValidationException", "requestParameters": { "resultConfiguration": { "outputConfiguration": { "s3": { "resultFormat": "CSV", "bucket": "cleanrooms-queryresults-jdoe-test", "keyPrefix": "test" } } }, "sqlParameters": "***", "membershipIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "type": "SQL" }, "responseElements": { "Access-Control-Expose-Headers": "x-amzn-RequestId,x-amzn-ErrorType,x-amzn-ErrorMessage,Date", "message": "Column(s) [identifier] is not allowed in select" }, "requestID": "e29f9f74-8299-4a83-9d18-5ddce7302f07", "eventID": "c8ee3498-8e4e-44b5-87e4-ab9477e56eb5", "readOnly": false, "eventType": "AwsApiCall", "managementEvent": true, "recipientAccountId": "123456789012", "eventCategory": "Management" }
