本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 建立 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 
```