Retrieve batch upload error log

GET <errorLogRef>

Retrieves the error log. Make this request only if the upload status of a batch file is error.

Attribute	Type	Description	Example
`errorLogRef`	string	The URI of the error log. If you do not know the URI, first retrieve the batch file upload status. In the response, if the status is `error`, the `status` object contains a `log` key. The `log` key contains the URI of the error log.	`https://sitecore-batch-service-dev-eu-west-1.s3.amazonaws.com/...`

Attribute

Type

Description

Example

errorLogRef

string

The URI of the error log.

If you do not know the URI, first retrieve the batch file upload status. In the response, if the status is error, the status object contains a log key. The log key contains the URI of the error log.

https://sitecore-batch-service-dev-eu-west-1.s3.amazonaws.com/...

The error log contains error information for each guest record that could not be processed. Records that were processed successfully are not included in the error log.

Logs contain the following information:

ref - the unique identifier passed in with the guest record.
code - a numeric code that identifies the type of error.
message - details about the error type.

Frequent errors you might encounter during the batch file upload process:

Code	Message	Description
`400`	`Validation error`	For example, if you are using data extensions, these errors might occur because of data inconsistencies, such as: Incorrect data type - the data type assigned to an extension field does not match the type defined for this extension's schema. Undefined attribute - the file includes attributes that do not exist in the schema.
`400`	`Identity information missing`
`402`	`Unsupported mode`	You are trying to use a mode that is not supported for the Batch API. The supported modes are: `insert` `create` `upsert` `merge` `delete` `gdpr_delete`
`403`	`Action not allowed`	You do not have sufficient permissions to perform the action, or you are attempting to delete a guest that has a current active session.
`404`	`Resource not found`	In a deletion process, you are attempting to delete a guest that does not exist.
`409`	`Resource conflict`	In a creation process, you are attempting to create an existing identity.
`500`	`Server error`	There is an internal server error, unrelated to the import process.

curl -X GET 'https://sitecore-batch-service-dev-eu-west-1.s3.amazonaws.com/xyzsla2xze5vxn02kf283wo020jg/3ee694e5-0b77-2d1e-af19-1aa78f500785/import.gz?AWSAccessKeyId=AKIAI2JLVI7OT2L6QDRQ&Expires=1459953714&Signature=yIG7nFv5w%2B2N%2Fkz11Eh7BjqSt2U%3D'

Structure of error logs:

{"ref": "<UUID>", "code":"<error_code>", "message":"<reason_for_failure>"}

If you have suggestions for improving this article, let us know!