本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 创建 HealthOmics 注释库版本
<a name="annotation-store-versioning"></a>

**重要**  
AWS HealthOmics 变体存储和注释存储不再向新客户开放。现有客户可以继续正常使用该服务。有关更多信息，请参阅 [AWS HealthOmics 变体存储和注释存储可用性变更](variant-store-availability-change.md)。

您可以创建新版本的注解存储库，以收集不同版本的注释数据库。这可以帮助您整理注释数据，这些数据会定期更新。

要创建现有注释库的新版本，请使用 **create-annotation-store-version**API，如以下示例所示。

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

您将收到以下带有注释存储版本 ID 的响应，确认注释的新版本已创建。

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

要更新注释库版本的描述，您可以使用**update-annotation-store-version**向注释库版本添加更新。

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

您将收到以下回复，确认注释库版本已更新。

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

要查看注释库版本的详细信息，请使用**get-annotation-store-version**。

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

您将收到包含版本名称、状态和其他详细信息的回复。

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

要查看注释存储库的所有版本，可以使用 **list-annotation-store-versions**，如以下示例所示。

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

您将收到包含以下信息的回复

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

如果您不再需要注释库版本，则可以使用**delete-annotation-store-versions**删除注释库版本，如以下示例所示。

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

如果删除商店版本时没有出现错误，您将收到以下响应。

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

如果存在错误，您将收到包含错误详细信息的回复，如图所示。

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

如果您尝试删除导入任务处于活动状态的注释库版本，则会收到一条错误响应，如图所示。

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

在这种情况下，您可以强制删除注释存储版本，如以下示例所示。

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