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.
Rubriques
Création d'un magasin de références à l'aide de la console
Pour créer un magasin de références
-
Ouvrez la console HealthOmics
. -
Si nécessaire, ouvrez le volet de navigation de gauche (≡). Choisissez Boutique de référence.
-
Choisissez Génomes de référence à partir des options de stockage des données génomiques.
-
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.
-
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 avec le nom que vous avez choisi pour votre boutique de référence.reference store name
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 .
Vous devez également disposer d'une politique de confiance similaire à l'exemple suivant.
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
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, et role ARN avec votre propre contribution.source file
path
aws omics start-reference-import-job --reference-store-id--role-arnreference store ID--sourcesrole ARNsource 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 et reference store ID avec l'identifiant de votre magasin de référence et l'identifiant du poste sur lequel vous souhaitez en savoir plus.job
ID
aws omics get-reference-import-job --reference-store-id--idreference store IDjob 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 avec l'identifiant de votre magasin de référence, et ajoutez un filtre facultatif pour affiner la liste.reference store ID
aws omics list-references --reference-store-id--filter name=reference store IDMyReference
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 avec l'identifiant de votre magasin de référence et reference store ID avec le numéro de référence sur lequel vous souhaitez en savoir plus.reference ID
aws omics get-reference-metadata --reference-store-id--idreference store IDreference 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 avec l'identifiant de votre magasin de référence et reference store ID avec l'identifiant de référence à partir duquel vous souhaitez effectuer le téléchargement.reference ID
aws omics get-reference --reference-store-id--idreference store ID--part-number 1 outfile.fareference ID