As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Criação de HealthOmics versões de armazenamento de anotações
<a name="annotation-store-versioning"></a>

**Importante**  
AWS HealthOmics lojas de variantes e lojas de anotações não estão mais abertas a novos clientes. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte [AWS HealthOmics alteração na disponibilidade da loja de variantes e da loja de anotações](variant-store-availability-change.md).

Você pode criar novas versões de repositórios de anotações para coletar diferentes versões de seus bancos de dados de anotações. Isso ajuda você a organizar seus dados de anotação, que são atualizados regularmente.

Para criar uma nova versão de um repositório de anotações existente, use a **create-annotation-store-version**API conforme mostrado no exemplo a seguir.

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

Você receberá a seguinte resposta com o ID da versão do armazenamento de anotações, confirmando que uma nova versão da sua anotação foi criada.

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

Para atualizar a descrição de uma versão do armazenamento de anotações, você pode usar **update-annotation-store-version**para adicionar atualizações a uma versão do armazenamento de anotações. 

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

Você receberá a seguinte resposta, confirmando que a versão do armazenamento de anotações foi atualizada.

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

Para ver os detalhes de uma versão do armazenamento de anotações, use. **get-annotation-store-version**

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

Você receberá uma resposta com o nome da versão, status e outros detalhes.

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

Para visualizar todas as versões de um repositório de anotações, você pode usar **list-annotation-store-versions**, conforme mostrado no exemplo a seguir.

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

Você receberá uma resposta com as seguintes informações

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

Se você não precisar mais de uma versão do armazenamento de anotações, poderá usá-la **delete-annotation-store-versions**para excluir uma versão do armazenamento de anotações, conforme mostrado no exemplo a seguir.

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

Se a versão da loja for excluída sem erros, você receberá a seguinte resposta.

```
{
  "errors": []
}
```

Se houver erros, você receberá uma resposta com os detalhes dos erros, conforme mostrado.

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

Se você tentar excluir uma versão do armazenamento de anotações que tenha um trabalho de importação ativo, você receberá uma resposta com um erro, conforme mostrado.

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

Nesse caso, você pode forçar a exclusão da versão do armazenamento de anotações, conforme mostrado no exemplo a seguir.

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