ExecutionService

GetExecutionDownloadCredentials

Get temporary, read-only S3 credentials scoped to an execution's storage location. Use these for bulk or repeated downloads via the AWS CLI or SDK instead of per-object presigned URLs.

get/v1/executions/{execution_id}/credentials

Request

  • Base URL: https://cloud-api.usw2.elembio.io
  • URL: https://cloud-api.usw2.elembio.io/v1/executions/{execution_id}/credentials
  • Auth: API key in header x-api-key

Path parameters

execution_idstring required

The execution ID

Query parameters

prefixstring

Optional path prefix within the execution to scope credentials to. Execution-relative, identical semantics to ListExecutionFilesRequest.prefix. ".." segments are rejected. When omitted, credentials are scoped to the whole execution (the execution root).

expirationSecondsinteger

Lifetime of the returned credentials, in seconds. Optional; defaults to 1 hour (when 0 or unset). Minimum 900s. Capped by AWS: up to 36h (129600s) for federation-token connections, or the role's MaxSessionDuration (12h typical) for role-backed connections. Values below the minimum or above the cap are rejected.

Response

Success

Example response

{
  "s3": {
    "expiration": "2023-01-15T01:30:15.01Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.