list_references

Omics.Client.list_references(**kwargs)

Retrieves a list of references.

See also: AWS API Documentation

Request Syntax

response = client.list_references(
    filter={
        'createdAfter': datetime(2015, 1, 1),
        'createdBefore': datetime(2015, 1, 1),
        'md5': 'string',
        'name': 'string'
    },
    maxResults=123,
    nextToken='string',
    referenceStoreId='string'
)
Parameters
  • filter (dict) --

    A filter to apply to the list.

    • createdAfter (datetime) --

      The filter's start date.

    • createdBefore (datetime) --

      The filter's end date.

    • md5 (string) --

      An MD5 checksum to filter on.

    • name (string) --

      A name to filter on.

  • maxResults (integer) -- The maximum number of references to return in one page of results.
  • nextToken (string) -- Specify the pagination token from a previous request to retrieve the next page of results.
  • referenceStoreId (string) --

    [REQUIRED]

    The references' reference store ID.

Return type

dict

Returns

Response Syntax

{
    'nextToken': 'string',
    'references': [
        {
            'arn': 'string',
            'creationTime': datetime(2015, 1, 1),
            'description': 'string',
            'id': 'string',
            'md5': 'string',
            'name': 'string',
            'referenceStoreId': 'string',
            'status': 'ACTIVE'|'DELETING'|'DELETED',
            'updateTime': datetime(2015, 1, 1)
        },
    ]
}

Response Structure

  • (dict) --

    • nextToken (string) --

      A pagination token that's included if more results are available.

    • references (list) --

      A list of references.

      • (dict) --

        A genome reference.

        • arn (string) --

          The reference's ARN.

        • creationTime (datetime) --

          When the reference was created.

        • description (string) --

          The reference's description.

        • id (string) --

          The reference's ID.

        • md5 (string) --

          The reference's MD5 checksum.

        • name (string) --

          The reference's name.

        • referenceStoreId (string) --

          The reference's store ID.

        • status (string) --

          The reference's status.

        • updateTime (datetime) --

          When the reference was updated.

Exceptions

  • Omics.Client.exceptions.InternalServerException
  • Omics.Client.exceptions.ThrottlingException
  • Omics.Client.exceptions.ValidationException
  • Omics.Client.exceptions.ResourceNotFoundException
  • Omics.Client.exceptions.AccessDeniedException
  • Omics.Client.exceptions.RequestTimeoutException