翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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**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 
```