Skip to main content

reference_metadatas

Creates, updates, deletes, gets or lists a reference_metadatas resource.

Overview

Namereference_metadatas
TypeResource
Idaws.omics.reference_metadatas

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringThe reference's ID. (pattern: <code>[0-9]+</code>)
namestringThe reference's name. (pattern: <code>[\p{L}||\p{M}||\p{Z}||\p{S}||\p{N}||\p{P}]+</code>)
arnstringThe reference's ARN. (pattern: <code>arn:.+</code>)
creation_job_idstringThe reference's creation job ID. (pattern: <code>[a-zA-Z0-9]+</code>)
creation_timestring (date-time)When the reference was created.
creation_typestringThe reference's creation type. (IMPORT)
descriptionstringThe reference's description. (pattern: <code>[\p{L}||\p{M}||\p{Z}||\p{S}||\p{N}||\p{P}]+</code>)
filesobjectThe reference's files.
md_5stringThe reference's MD5 checksum. (pattern: <code>[\p{L}||\p{N}]+</code>)
reference_store_idstringThe reference's reference store ID. (pattern: <code>[0-9]+</code>)
statusstringThe reference's status. (ACTIVE, DELETING, DELETED)
update_timestring (date-time)When the reference was updated.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_reference_metadataselectid, reference_store_id, regionRetrieves metadata for a reference genome. This operation returns the number of parts, part size, and MD5 of an entire file. This operation does not return tags. To retrieve the list of tags for a read set, use the ListTagsForResource API operation.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
idstringThe reference's ID.
reference_store_idstringThe reference's reference store ID.
regionstringAWS region (default: us-east-1)

SELECT examples

Retrieves metadata for a reference genome. This operation returns the number of parts, part size, and MD5 of an entire file. This operation does not return tags. To retrieve the list of tags for a read set, use the ListTagsForResource API operation.

SELECT
id,
name,
arn,
creation_job_id,
creation_time,
creation_type,
description,
files,
md_5,
reference_store_id,
status,
update_time
FROM aws.omics.reference_metadatas
WHERE id = '{{ id }}' -- required
AND reference_store_id = '{{ reference_store_id }}' -- required
AND region = '{{ region }}' -- required
;