get_job_execution_bookmark

EtlJobsApi.get_job_execution_bookmark(id, executionid, filepath, role_id, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Get a presigned URL for a job bookmark file

Returns a presigned GET URL for a bookmark manifest. Not allowed while the execution is starting, running, or stopping. filepath is required and must be a URL-decoded S3 URI.

Parameters:

  • id (str) – UUID of the parent ETL job. (required)

  • executionid (str) – Glue JobRun / execution ID that produced the bookmark. (required)

  • filepath (str) – URL-decoded S3 URI of the bookmark file to download. Missing this parameter returns IPV-1052. (required)

  • role_id (str) – Amorphic role ID sent for authorization. Missing this header returns AUTH-1001. (required)

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

JobFilePresignedGetResponse

Returns:

Returns the result object.

Request and Response Examples

HTTP: GET /jobs/{id}/executions/{executionid}/bookmark

Success (HTTP 200)

Presigned download URL in the url field.

Request / response example

{
  "url": "https://s3.amazonaws.com/example-etl-bucket/bookmarks/jr_a1b2c3d4e5f6/manifest.json?X-Amz-Algorithm=AWS4-HMAC-SHA256"
}

Errors

Documented error codes: IPV-1052, GE-1008.

HTTP 400

Missing filepath, execution still running, missing job, or insufficient access.

filepath query omitted

{
  "Message": "IPV-1052 - Missing mandatory parameter(s) filepath in queryStringParameters/pathParameters"
}

Bookmark download while execution is active

{
  "Message": "Job bookmark manifest file cannot be downloaded as it is in running state"
}

HTTP 500

Uncaught backend failure. Typical Message is “GE-1008 - Could not complete the request. Please try again.”

Request / response example

{
  "Message": "GE-1008 - Could not complete the request. Please try again."
}