View a markdown version of this page

Création d'un HealthOmics magasin de référence - AWS HealthOmics

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Création d'un HealthOmics magasin de référence

Une boutique de référence dans HealthOmics est un magasin de données pour le stockage de génomes de référence. Vous pouvez avoir un seul magasin de référence dans chaque Compte AWS et région. Vous pouvez créer un magasin de référence à l'aide de la console ou de l'interface de ligne de commande.

Création d'un magasin de références à l'aide de la console

Pour créer un magasin de références
  1. Ouvrez la console HealthOmics .

  2. Si nécessaire, ouvrez le volet de navigation de gauche (≡). Choisissez Boutique de référence.

  3. Choisissez Génomes de référence à partir des options de stockage des données génomiques.

  4. Vous pouvez soit choisir un génome de référence précédemment importé, soit en importer un nouveau. Si vous n'avez pas importé de génome de référence, choisissez Importer le génome de référence en haut à droite.

  5. Sur le Créer une tâche d'importation du génome de référence page, choisissez soit Création rapide ou Création manuelle option pour créer un magasin de référence, puis fournir les informations suivantes.

    • Nom du génome de référence - Un nom unique pour cette boutique.

    • Descriptif (facultatif) - Description de ce magasin de référence.

    • Rôle IAM - Sélectionnez un rôle avec accès à votre génome de référence.

    • Référence tirée d'Amazon S3 - Sélectionnez votre fichier de séquence de référence dans un compartiment Amazon S3.

    • Balises (facultatif) - Fournissez jusqu'à 50 étiquettes pour ce magasin de référence.

Création d'un magasin de référence à l'aide de la CLI

L'exemple suivant vous montre comment créer un magasin de référence à l'aide du AWS CLI. Vous pouvez avoir un magasin de référence par AWS Région.

Les magasins de référence prennent en charge le stockage des fichiers FASTA avec les extensions .fasta, .fa, .fas, .fsa, .faa, .fna, .ffn, .frn, .mpfa, .seq, .txt. Le bgzip la version de ces extensions est également prise en charge.

Dans l'exemple suivant, remplacez reference store name avec le nom que vous avez choisi pour votre boutique de référence.

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

Vous recevez une réponse JSON contenant l'ID et le nom du magasin de référence, l'ARN et l'horodatage de la création de votre magasin de référence.

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

Vous pouvez utiliser l'ID du magasin de référence en plus AWS CLI commandes. Vous pouvez récupérer la liste des identifiants des magasins de référence associés à votre compte en utilisant le liste de magasins de référence commande, comme illustré dans l'exemple suivant.

aws omics list-reference-stores

En réponse, vous recevez le nom de la boutique de référence que vous venez de créer.

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

Après avoir créé un magasin de référence, vous pouvez créer des tâches d'importation pour y charger des fichiers de référence génomiques. Pour ce faire, vous devez utiliser ou créer un rôle IAM pour accéder aux données. Voici un exemple de politique .

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/*" ] } ] }

Vous devez également disposer d'une politique de confiance similaire à l'exemple suivant.

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

Vous pouvez désormais importer un génome de référence. Cet exemple utilise le Genome Reference Consortium Human Build 38 (hg38), qui est en libre accès et disponible auprès du Registre des données ouvertes sur AWS. Le bucket qui héberge ces données est basé dans l'est des États-Unis (Ohio). Pour utiliser des seaux dans d'autres AWS Régions, vous pouvez copier les données vers un compartiment Amazon S3 hébergé dans votre région. Utilisez ce qui suit AWS CLI commande pour copier le génome dans votre compartiment Amazon S3.

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

Vous pouvez ensuite commencer votre tâche d'importation. Remplacer reference store ID, role ARN, et source file path avec votre propre contribution.

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

Une fois les données importées, vous recevez la réponse suivante au format JSON.

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

Vous pouvez contrôler l'état d'une tâche à l'aide de la commande suivante. Dans l'exemple suivant, remplacez reference store ID et job ID avec l'identifiant de votre magasin de référence et l'identifiant du poste sur lequel vous souhaitez en savoir plus.

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

En réponse, vous recevez une réponse contenant les informations relatives à ce magasin de référence et son statut.

{ "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" } ] }

Vous pouvez également trouver la référence qui a été importée en répertoriant vos références et en les filtrant en fonction du nom de la référence. Remplacer reference store ID avec l'identifiant de votre magasin de référence, et ajoutez un filtre facultatif pour affiner la liste.

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

En réponse, vous recevez les informations suivantes.

{ "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" } ] }

Pour en savoir plus sur les métadonnées de référence, utilisez obtenir les métadonnées de référence Fonctionnement de l'API. Dans l'exemple suivant, remplacez reference store ID avec l'identifiant de votre magasin de référence et reference ID avec le numéro de référence sur lequel vous souhaitez en savoir plus.

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

Vous recevez les informations suivantes en réponse.

{ "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 } } }

Vous pouvez également télécharger des parties du fichier de référence en utilisant obtenir une référence. Dans l'exemple suivant, remplacez reference store ID avec l'identifiant de votre magasin de référence et reference ID avec l'identifiant de référence à partir duquel vous souhaitez effectuer le téléchargement.

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