View a markdown version of this page

Creando un HealthOmics tienda de referencia - AWS HealthOmics

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Creando un HealthOmics tienda de referencia

Una tienda de referencia en HealthOmics es un almacén de datos para el almacenamiento de genomas de referencia. Puede tener un único almacén de referencia en cada uno Cuenta de AWS y región. Puede crear un almacén de referencia mediante la consola o la CLI.

Crear un almacén de referencia mediante la consola

Para crear un almacén de referencia
  1. Abra la consola de HealthOmics .

  2. Si es necesario, abre el panel de navegación izquierdo (≡). Elige Tienda de referencia.

  3. Elige Genomas de referencia de las opciones de almacenamiento de datos de Genomics.

  4. Puede elegir un genoma de referencia previamente importado o importar uno nuevo. Si no ha importado un genoma de referencia, elija Importe el genoma de referencia en la parte superior derecha.

  5. En el Cree un trabajo de importación del genoma de referencia página, elija entre Creación rápida o Creación manual opción para crear una tienda de referencia y, a continuación, proporcionar la siguiente información.

    • Nombre del genoma de referencia - Un nombre único para esta tienda.

    • Descripción (opcional): una descripción de esta tienda de referencia.

    • Función de IAM - Seleccione un rol con acceso a su genoma de referencia.

    • Referencia de Amazon S3 - Seleccione su archivo de secuencia de referencia en un bucket de Amazon S3.

    • Etiquetas (opcional): proporciona hasta 50 etiquetas para esta tienda de referencia.

Creación de un almacén de referencia mediante la CLI

El siguiente ejemplo muestra cómo crear un almacén de referencia mediante el AWS CLI. Puedes tener una tienda de referencia por AWS Región.

Las tiendas de referencia admiten el almacenamiento de archivos FASTA con las extensiones .fasta, .fa, .fas, .fsa, .faa, .fna, .ffn, .frn, .mpfa, .seq, .txt. El bgzip También se admite la versión de estas extensiones.

En el siguiente ejemplo, reemplace reference store name con el nombre que has elegido para tu tienda de referencia.

aws omics create-reference-store --name "reference store name"

Recibirás una respuesta de JSON con el ID y el nombre de la tienda de referencia, el ARN y la fecha en la que se creó la tienda de referencia.

{ "id": "3242349265", "arn": "arn:aws:omics:us-west-2:555555555555:referenceStore/3242349265", "name": "MyReferenceStore", "creationTime": "2022-07-01T20:58:42.878Z" }

Puedes usar el ID de la tienda de referencia de forma adicional AWS CLI comandos. Puede recuperar la lista de ID de tiendas de referencia vinculadas a su cuenta mediante el lista-reference-stores comando, como se muestra en el siguiente ejemplo.

aws omics list-reference-stores

En respuesta, recibirá el nombre de la tienda de referencia recién creada.

{ "referenceStores": [ { "id": "3242349265", "arn": "arn:aws:omics:us-west-2:555555555555:referenceStore/3242349265", "name": "MyReferenceStore", "creationTime": "2022-07-01T20:58:42.878Z" } ] }

Tras crear un almacén de referencias, puede crear trabajos de importación para cargar en él archivos de referencia genómica. Para ello, debe usar o crear un rol de IAM para acceder a los datos. A continuación, se muestra una política de ejemplo.

JSON
{ "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:GetObject", "s3:GetBucketLocation" ], "Resource": [ "arn:aws:s3:::amzn-s3-demo-bucket1", "arn:aws:s3:::amzn-s3-demo-bucket1/*" ] } ] }

También debe tener una política de confianza similar a la del siguiente ejemplo.

JSON
{ "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": [ "omics.amazonaws.com" ] }, "Action": "sts:AssumeRole" } ] }

Ahora puede importar un genoma de referencia. En este ejemplo se utiliza el Genome Reference Consortium Human Build 38 (hg38), que es de acceso abierto y está disponible en Registro de datos abiertos sobre AWS. El grupo que aloja estos datos se encuentra en el este de EE. UU. (Ohio). Para usar cubos en otros AWS En las regiones, puede copiar los datos a un bucket de Amazon S3 alojado en su región. Utilice lo siguiente AWS CLI comando para copiar el genoma a su bucket de Amazon S3.

aws s3 cp s3://broad-references/hg38/v0/Homo_sapiens_assembly38.fasta s3://amzn-s3-demo-bucket

A continuación, puede comenzar su trabajo de importación. Reemplazar reference store ID, role ARN, y source file path con tu propia aportación.

aws omics start-reference-import-job --reference-store-id reference store ID --role-arn role ARN --sources source file path

Tras importar los datos, recibirá la siguiente respuesta en JSON.

{ "id": "7252016478", "referenceStoreId": "3242349265", "roleArn": "arn:aws:iam::111122223333:role/OmicsReferenceImport", "status": "CREATED", "creationTime": "2022-07-01T21:15:13.727Z" }

Puede supervisar el estado de un trabajo mediante el siguiente comando. En el siguiente ejemplo, reemplace reference store ID y job ID con tu ID de tienda de referencia y el ID de trabajo sobre el que deseas obtener más información.

aws omics get-reference-import-job --reference-store-id reference store ID --id job ID

En respuesta, recibirás una respuesta con los detalles de esa tienda de referencia y su estado.

{ "id": "7252016478", "referenceStoreId": "3242349265", "roleArn": "arn:aws:iam::555555555555:role/OmicsReferenceImport", "status": "RUNNING", "creationTime": "2022-07-01T21:15:13.727Z", "sources": [ { "sourceFile": "s3://amzn-s3-demo-bucket/Homo_sapiens_assembly38.fasta", "status": "IN_PROGRESS", "name": "MyReference" } ] }

También puedes encontrar la referencia que se importó haciendo una lista de tus referencias y filtrándolas según el nombre de la referencia. Reemplazar reference store ID con el identificador de tu tienda de referencia y agrega un filtro opcional para reducir la lista.

aws omics list-references --reference-store-id reference store ID --filter name=MyReference

En respuesta, recibirá la siguiente información.

{ "references": [ { "id": "1234567890", "arn": "arn:aws:omics:us-west-2:555555555555:referenceStore/1234567890/reference/1234567890", "referenceStoreId": "12345678", "md5": "7ff134953dcca8c8997453bbb80b6b5e", "status": "ACTIVE", "name": "MyReference", "creationTime": "2022-07-02T00:15:19.787Z", "updateTime": "2022-07-02T00:15:19.787Z" } ] }

Para obtener más información sobre los metadatos de referencia, utilice get-reference-metadata Funcionamiento de la API. En el siguiente ejemplo, reemplace reference store ID con tu ID de tienda de referencia y reference ID con el ID de referencia sobre el que deseas obtener más información.

aws omics get-reference-metadata --reference-store-id reference store ID --id reference ID

En respuesta, recibirá la siguiente información.

{ "id": "1234567890", "arn": "arn:aws:omics:us-west-2:555555555555:referenceStore/referencestoreID/reference/referenceID", "referenceStoreId": "1234567890", "md5": "7ff134953dcca8c8997453bbb80b6b5e", "status": "ACTIVE", "name": "MyReference", "creationTime": "2022-07-02T00:15:19.787Z", "updateTime": "2022-07-02T00:15:19.787Z", "files": { "source": { "totalParts": 31, "partSize": 104857600, "contentLength": 3249912778 }, "index": { "totalParts": 1, "partSize": 104857600, "contentLength": 160928 } } }

También puede descargar partes del archivo de referencia utilizando get-reference. En el siguiente ejemplo, reemplace reference store ID con tu ID de tienda de referencia y reference ID con el ID de referencia desde el que deseas realizar la descarga.

aws omics get-reference --reference-store-id reference store ID --id reference ID --part-number 1 outfile.fa