기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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