Select your cookie preferences

We use cookies and similar tools to enhance your experience, provide our services, deliver relevant advertising, and make improvements. Approved third parties also use these tools to help us deliver advertising and provide certain site features.

list_references

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