Ingests your application events into CloudTrail Lake. A required parameter, auditEvents
, accepts the JSON records (also called payload) of events that you want CloudTrail to ingest. You can add up to 100 of these events (or up to 1 MB) per PutAuditEvents
request.
POST /PutAuditEvents?channelArn=channelArn
&externalId=externalId
HTTP/1.1
Content-type: application/json
{
"auditEvents": [
{
"eventData": "string
",
"eventDataChecksum": "string
",
"id": "string
"
}
]
}
URI Request Parameters
The request uses the following URI parameters.
The ARN or ID (the ARN suffix) of a channel.
Pattern: arn:.*
Required: Yes
A unique identifier that is conditionally required when the channel's resource policy includes an external ID. This value can be any string, such as a passphrase or account number.
Length Constraints: Minimum length of 2. Maximum length of 1224.
Pattern: [\w+=,.@:\/-]*
The request accepts the following data in JSON format.
The JSON payload of events that you want to ingest. You can also point to the JSON event payload in a file.
Type: Array of AuditEvent objects
Array Members: Minimum number of 1 item. Maximum number of 100 items.
Required: Yes
HTTP/1.1 200
Content-type: application/json
{
"failed": [
{
"errorCode": "string",
"errorMessage": "string",
"id": "string"
}
],
"successful": [
{
"eventID": "string",
"id": "string"
}
]
}
Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
Lists events in the provided event payload that could not be ingested into CloudTrail, and includes the error code and error message returned for events that could not be ingested.
Type: Array of ResultErrorEntry objects
Array Members: Minimum number of 0 items. Maximum number of 100 items.
Lists events in the provided event payload that were successfully ingested into CloudTrail.
Type: Array of AuditEventResultEntry objects
Array Members: Minimum number of 0 items. Maximum number of 100 items.
For information about the errors that are common to all actions, see Common Errors.
The caller's account ID must be the same as the channel owner's account ID.
HTTP Status Code: 400
The channel could not be found.
HTTP Status Code: 400
The schema type of the event is not supported.
HTTP Status Code: 400
Two or more entries in the request have the same event ID.
HTTP Status Code: 400
The specified channel ARN is not a valid channel ARN.
HTTP Status Code: 400
The operation requested is not supported in this region or account.
HTTP Status Code: 400
For more information about using this API in one of the language-specific AWS SDKs, see the following:
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4