Création de nouvelles versions de magasins HealthOmics d'annotations

Vous pouvez créer de nouvelles versions de magasins d'annotations pour collecter différentes versions de vos bases de données d'annotations. Cela vous permet d'organiser vos données d'annotation, qui sont mises à jour régulièrement.

Pour créer une nouvelle version d'un magasin d'annotations existant, utilisez l'create-annotation-store-versionAPI comme indiqué dans l'exemple suivant.

aws omics create-annotation-store-version \
     --name my_annotation_store \
     --version-name my_version  

Vous recevrez la réponse suivante avec l'ID de version du magasin d'annotations, confirmant qu'une nouvelle version de votre annotation a été créée.

{
     "creationTime": "2023-07-21T17:15:49.251040+00:00",
     "id": "3b93cdef69d2",
     "name": "my_annotation_store",
     "reference": {
         "referenceArn": "arn:aws:omics:us-west-2:555555555555:referenceStore/6505293348/reference/5987565360"
     },
     "status": "CREATING",
     "versionName": "my_version"
}             

Pour mettre à jour la description d'une version du magasin d'annotations, vous pouvez l'utiliser update-annotation-store-versionpour ajouter des mises à jour à une version du magasin d'annotations.

aws omics update-annotation-store-version \
    --name my_annotation_store \
    --version-name my_version \
    --description "New Description"    

Vous recevrez la réponse suivante, confirmant que la version du magasin d'annotations a été mise à jour.

{
     "storeId": "4934045d1c6d",
     "id": "2a3f4a44aa7b",
     "description":"New Description",
     "status": "ACTIVE",
     "name": "my_annotation_store",
     "versionName": "my_version",
     "creation Time": "2023-07-21T17:20:59.380043+00:00",
     "updateTime": "2023-07-21T17:26:17.892034+00:00"
}              

Pour afficher les détails d'une version du magasin d'annotations, utilisez get-annotation-store-version.

aws omics get-annotation-store-version --name my_annotation_store --version-name my_version              

Vous recevrez une réponse avec le nom de la version, le statut et d'autres détails.

{
     "storeId": "4934045d1c6d",
     "id": "2a3f4a44aa7b",
     "status": "ACTIVE",
     "versionArn": "arn:aws:omics:us-west-2:555555555555:annotationStore/my_annotation_store/version/my_version",
     "name": "my_annotation_store",
     "versionName": "my_version",
     "creationTime": "2023-07-21T17:15:49.251040+00:00",
     "updateTime": "2023-07-21T17:15:56.434223+00:00",
     "statusMessage": "",
     "versionSizeBytes": 0
    }        
      

Pour afficher toutes les versions d'un magasin d'annotations, vous pouvez utiliser list-annotation-store-versions, comme indiqué dans l'exemple suivant.

aws omics list-annotation-store-versions --name my_annotation_store

Vous recevrez une réponse contenant les informations suivantes

{
  "annotationStoreVersions": [
    {
     "storeId": "4934045d1c6d",
     "id": "2a3f4a44aa7b",
     "status": "CREATING",
     "versionArn": "arn:aws:omics:us-west-2:555555555555:annotationStore/my_annotation_store/version/my_version_2",
     "name": "my_annotation_store",
     "versionName": "my_version_2",
     "creation Time": "2023-07-21T17:20:59.380043+00:00",
     "versionSizeBytes": 0
    },
    {
     "storeId": "4934045d1c6d",
     "id": "4934045d1c6d",
     "status": "ACTIVE",
     "versionArn": "arn:aws:omics:us-west-2:555555555555:annotationStore/my_annotation_store/version/my_version_1",
     "name": "my_annotation_store",
     "versionName": "my_version_1",
     "creationTime": "2023-07-21T17:15:49.251040+00:00",
     "updateTime": "2023-07-21T17:15:56.434223+00:00",
     "statusMessage": "",
     "versionSizeBytes": 0
    }
}             

Si vous n'avez plus besoin d'une version du magasin d'annotations, vous pouvez l'utiliser delete-annotation-store-versionspour supprimer une version du magasin d'annotations, comme indiqué dans l'exemple suivant.

aws omics delete-annotation-store-versions --name my_annotation_store --versions my_version  

Si la version du magasin est supprimée sans erreur, vous recevrez la réponse suivante.

{
  "errors": []
}                

S'il y a des erreurs, vous recevrez une réponse avec les détails des erreurs, comme indiqué.

{
  "errors": [
    {
      "versionName": "my_version",
      "message": "Version with versionName: my_version was not found."
    }
  ]
}  

Si vous essayez de supprimer une version du magasin d'annotations pour laquelle une tâche d'importation est active, vous recevrez une réponse contenant une erreur, comme indiqué.

{
  "errors": [
    {
      "versionName": "my_version",
      "message": "version has an inflight import running"
    }
  ]
}  

Dans ce cas, vous pouvez forcer la suppression de la version du magasin d'annotations, comme illustré dans l'exemple suivant.

aws omics delete-annotation-store-versions --name my_annotation_store --versions my_version --force