start_hcls_store_job

HclsApi.start_hcls_store_job(hcls_name, id, role_id, hcls_jobs, content_type=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

Start an HCLS data import job

Starts a data import job against the given store. omics-storage requires DatasetId, JobName, and ImportJobConfig (reference stores use ReferenceGenome and FileName; sequence stores also use ReadSetName, SampleId, SubjectId). healthlake requires DatasetId and JobName (dataset must have completed .ndjson files). health-imaging requires DatasetId and JobName (dataset must have completed .dcm files; JobName pattern ^[A-Za-z0-9_#.-]{1,64}$). Only one active HealthLake import job is allowed per store.

Parameters:

  • hcls_name (str) – HCLS service type. Valid values: healthlake (FHIR datastore), omics-storage (Omics reference/sequence stores), omics-workflows (Omics workflows), health-imaging (HealthImaging datastore). (required)

  • id (str) – StoreId to import data into. (required)

  • role_id (str) – Amorphic role identifier used for authorization. (required)

  • hcls_jobs (HclsJobs) – (required)

  • content_type (str) – Request content type. Use application/json for JSON bodies.

  • _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:

Status

Returns:

Returns the result object.

Request and Response Examples

HTTP: POST /hcls/{hcls_name}/{id}/jobs

Success (HTTP 200)

Successfully started the HCLS import job. Response typically includes Message and JobId.

Errors

HTTP 400

Invalid input

HTTP 500

Something went wrong at backend