# AWS CLI을 사용한 Amazon Glacier 예제
다음 코드 예제는 Amazon Glacier와 함께 AWS Command Line Interface를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다.
*작업*은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.
각 예시에는 전체 소스 코드에 대한 링크가 포함되어 있으며, 여기에서 컨텍스트에 맞춰 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있습니다.
**Topics**
+ [작업](#actions)
## 작업
### `abort-multipart-upload`
다음 코드 예시에서는 `abort-multipart-upload` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
다음 명령은 `my-vault`라는 이름의 저장소에 진행 중인 멀티파트 업로드를 삭제합니다.
```
aws glacier abort-multipart-upload --account-id - --vault-name my-vault --upload-id 19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ
```
이 명령은 출력을 생성하지 않습니다. Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다. 업로드 ID는 `aws glacier initiate-multipart-upload` 명령으로 반환되며 `aws glacier list-multipart-uploads`를 사용하여 가져올 수도 있습니다.
AWS CLI를 사용하여 Amazon Glacier에 멀티파트 업로드를 수행하는 방법에 대한 자세한 내용은 **AWS CLI 사용 설명서의 Amazon Glacier 사용을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [AbortMultipartUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/abort-multipart-upload.html)를 참조하세요.
### `abort-vault-lock`
다음 코드 예시에서는 `abort-vault-lock` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**진행 중인 저장소 잠금 프로세스 중단**
다음 `abort-vault-lock` 예시에서는 지정된 저장소에서 저장소 잠금 정책을 삭제하고 저장소 잠금의 잠금 상태를 잠금 해제로 재설정합니다.
```
aws glacier abort-vault-lock \
--account-id - \
--vault-name MyVaultName
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *Amazon Glacier API 개발자 안내서*의 [Abort Vault Lock (DELETE lock-policy)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-AbortVaultLock.html)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [AbortVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/abort-vault-lock.html) 섹션을 참조하세요.
### `add-tags-to-vault`
다음 코드 예시에서는 `add-tags-to-vault` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
다음 명령은 이름이 지정된 `my-vault`에 두 개의 태그를 추가합니다.
```
aws glacier add-tags-to-vault --account-id - --vault-name my-vault --tags id=1234,date=july2015
```
Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [AddTagsToVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/add-tags-to-vault.html) 섹션을 참조하세요.
### `complete-multipart-upload`
다음 코드 예시에서는 `complete-multipart-upload` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
다음 명령은 3MiB 아카이브에 대한 멀티파트 업로드를 완료합니다.
```
aws glacier complete-multipart-upload --archive-size 3145728 --checksum 9628195fcdbcbbe76cdde456d4646fa7de5f219fb39823836d81f0cc0e18aa67 --upload-id 19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ --account-id - --vault-name my-vault
```
Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.
업로드 ID는 `aws glacier initiate-multipart-upload` 명령으로 반환되며 `aws glacier list-multipart-uploads`를 사용하여 가져올 수도 있습니다. 체크섬 파라미터는 아카이브의 SHA-256 트리 해시를 16진수로 사용합니다.
트리 해시를 계산하는 방법에 대한 지침을 비롯해 AWS CLI를 사용하여 Amazon Glacier에 멀티파트 업로드를 수행하는 방법에 대한 자세한 내용은 **AWS CLI 사용 설명서의 Amazon Glacier 사용을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [CompleteMultipartUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/complete-multipart-upload.html)를 참조하세요.
### `complete-vault-lock`
다음 코드 예시에서는 `complete-vault-lock` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**진행 중인 저장소 잠금 프로세스 완료**
다음 `complete-vault-lock` 예시에서는 지정된 저장소의 진행 중인 잠금 진행 상황을 완료하고 저장소 잠금의 잠금 상태를 `Locked`로 설정합니다. `initiate-lock-process`를 실행할 때 `lock-id` 파라미터 값을 가져옵니다.
```
aws glacier complete-vault-lock \
--account-id - \
--vault-name MyVaultName \
--lock-id 9QZgEXAMPLEPhvL6xEXAMPLE
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *Amazon Glacier API 개발자 안내서*의 [Complete Vault Lock (POST lockId)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-CompleteVaultLock.html)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [CompleteVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/complete-vault-lock.html) 섹션을 참조하세요.
### `create-vault`
다음 코드 예시에서는 `create-vault` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
다음 명령은 `my-vault`라는 새 볼트를 생성합니다.
```
aws glacier create-vault --vault-name my-vault --account-id -
```
Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.
+ API 세부 정보는 **AWS CLI 명령 참조의 [CreateVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/create-vault.html)를 참조하세요.
### `delete-archive`
다음 코드 예시에서는 `delete-archive` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**볼트에서 아카이브를 삭제하는 방법**
다음 `delete-archive` 예시에서는 `example_vault`에서 지정된 아카이브를 제거합니다.
```
aws glacier delete-archive \
--account-id 111122223333 \
--vault-name example_vault \
--archive-id Sc0u9ZP8yaWkmh-XGlIvAVprtLhaLCGnNwNl5I5x9HqPIkX5mjc0DrId3Ln-Gi_k2HzmlIDZUz117KSdVMdMXLuFWi9PJUitxWO73edQ43eTlMWkH0pd9zVSAuV_XXZBVhKhyGhJ7w
```
이 명령은 출력을 생성하지 않습니다.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DeleteArchive](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-archive.html)를 참조하세요.
### `delete-vault-access-policy`
다음 코드 예시에서는 `delete-vault-access-policy` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**저장소의 액세스 정책 제거**
다음 `delete-vault-access-policy` 예시에서는 지정된 저장소에 대한 액세스 정책을 제거합니다.
```
aws glacier delete-vault-access-policy \
--account-id 111122223333 \
--vault-name example_vault
```
이 명령은 출력을 생성하지 않습니다.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DeleteVaultAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-vault-access-policy.html) 섹션을 참조하세요.
### `delete-vault-notifications`
다음 코드 예시에서는 `delete-vault-notifications` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**저장소에 대한 SNS 알림 제거**
다음 `delete-vault-notifications` 예시에서는 지정된 볼트에 대해 Amazon Simple Notification Service(Amazon SNS)에서 전송한 알림을 제거합니다.
```
aws glacier delete-vault-notifications \
--account-id 111122223333 \
--vault-name example_vault
```
이 명령은 출력을 생성하지 않습니다.
+ API 세부 정보는 **AWS CLI 명령 참조의 [DeleteVaultNotifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-vault-notifications.html)를 참조하세요.
### `delete-vault`
다음 코드 예시에서는 `delete-vault` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
다음 명령은 `my-vault`라는 볼트를 삭제합니다.
```
aws glacier delete-vault --vault-name my-vault --account-id -
```
이 명령은 출력을 생성하지 않습니다. Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.
+ API 세부 정보는 **AWS CLI 명령 참조의 [DeleteVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-vault.html)를 참조하세요.
### `describe-job`
다음 코드 예시에서는 `describe-job` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
다음 명령은 `my-vault`라는 저장소의 인벤토리 검색 작업에 대한 정보를 검색합니다.
```
aws glacier describe-job --account-id - --vault-name my-vault --job-id zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW
```
출력:
```
{
"InventoryRetrievalParameters": {
"Format": "JSON"
},
"VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault",
"Completed": false,
"JobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW",
"Action": "InventoryRetrieval",
"CreationDate": "2015-07-17T20:23:41.616Z",
"StatusCode": "InProgress"
}
```
작업 ID는 `aws glacier initiate-job` 및 `aws glacier list-jobs`의 출력에서 찾을 수 있습니다. Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/describe-job.html)을 참조하세요.
### `describe-vault`
다음 코드 예시에서는 `describe-vault` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
다음 명령은 `my-vault`라는 볼트에 대한 데이터를 검색합니다.
```
aws glacier describe-vault --vault-name my-vault --account-id -
```
Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/describe-vault.html) 섹션을 참조하세요.
### `get-data-retrieval-policy`
다음 코드 예시에서는 `get-data-retrieval-policy` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
다음 명령은 사용 중인 계정에 대한 데이터 검색 정책을 가져옵니다.
```
aws glacier get-data-retrieval-policy --account-id -
```
출력:
```
{
"Policy": {
"Rules": [
{
"BytesPerHour": 10737418240,
"Strategy": "BytesPerHour"
}
]
}
}
```
Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [GetDataRetrievalPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-data-retrieval-policy.html) 섹션을 참조하세요.
### `get-job-output`
다음 코드 예시에서는 `get-job-output` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
다음 명령은 볼트 인벤토리 작업의 출력을 `output.json`라는 현재 디렉터리의 파일에 저장합니다.
```
aws glacier get-job-output --account-id - --vault-name my-vault --job-id zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW output.json
```
`job-id`는 `aws glacier list-jobs`의 출력에서 확인할 수 있습니다. 참고로 출력 파일 이름은 옵션 이름이 접두사로 붙지 않는 위치 인수입니다. Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.
출력:
```
{
"status": 200,
"acceptRanges": "bytes",
"contentType": "application/json"
}
```
`output.json`:
```
{"VaultARN":"arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault","InventoryDate":"2015-04-07T00:26:18Z","ArchiveList":[{"ArchiveId":"kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw","ArchiveDescription":"multipart upload test","CreationDate":"2015-04-06T22:24:34Z","Size":3145728,"SHA256TreeHash":"9628195fcdbcbbe76cdde932d4646fa7de5f219fb39823836d81f0cc0e18aa67"}]}
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [GetJobOutput](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-job-output.html)을 참조하세요.
### `get-vault-access-policy`
다음 코드 예시에서는 `get-vault-access-policy` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**저장소의 액세스 정책 검색**
다음 `get-vault-access-policy` 예시에서는 지정된 저장소에 대한 액세스 정책을 검색합니다.
```
aws glacier get-vault-access-policy \
--account-id 111122223333 \
--vault-name example_vault
```
출력:
```
{
"policy": {
"Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:ListJobs\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"},{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:UploadArchive\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"}]}"
}
}
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [GetVaultAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-vault-access-policy.html) 섹션을 참조하세요.
### `get-vault-lock`
다음 코드 예시에서는 `get-vault-lock` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**저장소 잠금의 세부 정보 가져오기**
다음 `get-vault-lock` 예시에서는 지정된 저장소에 대한 잠금에 대한 세부 정보를 검색했습니다.
```
aws glacier get-vault-lock \
--account-id - \
--vault-name MyVaultName
```
출력:
```
{
"Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"Define-vault-lock\",\"Effect\":\"Deny\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:99999999999:vaults/MyVaultName\",\"Condition\":{\"NumericLessThanEquals\":{\"glacier:ArchiveAgeinDays\":\"365\"}}}]}",
"State": "Locked",
"CreationDate": "2019-07-29T22:25:28.640Z"
}
```
자세한 내용은 *Amazon Glacier API 개발자 안내서*의 [Get Vault Lock (GET lock-policy)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-GetVaultLock.html)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [GetVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-vault-lock.html) 섹션을 참조하세요.
### `get-vault-notifications`
다음 코드 예시에서는 `get-vault-notifications` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
다음 명령은 `my-vault`라는 저장소의 알림 구성 설명을 가져옵니다.
```
aws glacier get-vault-notifications --account-id - --vault-name my-vault
```
출력:
```
{
"vaultNotificationConfig": {
"Events": [
"InventoryRetrievalCompleted",
"ArchiveRetrievalCompleted"
],
"SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault"
}
}
```
볼트에 대한 알림이 구성되지 않은 경우에는 오류가 반환됩니다. Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.
+ API 세부 정보는 **AWS CLI 명령 참조의 [GetVaultNotifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-vault-notifications.html)를 참조하세요.
### `initiate-job`
다음 코드 예시에서는 `initiate-job` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
다음 명령은 `my-vault` 저장소 인벤토리를 가져오는 작업을 시작합니다.
```
aws glacier initiate-job --account-id - --vault-name my-vault --job-parameters '{"Type": "inventory-retrieval"}'
```
출력:
```
{
"location": "/0123456789012/vaults/my-vault/jobs/zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW",
"jobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW"
}
```
Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.
다음 명령은 `my-vault` 저장소에서 아카이브를 가져오는 작업을 시작합니다.
```
aws glacier initiate-job --account-id - --vault-name my-vault --job-parameters file://job-archive-retrieval.json
```
`job-archive-retrieval.json`은 작업 유형, 아카이브 ID 및 일부 선택적 파라미터를 지정하는 로컬 폴더의 JSON 파일입니다.
```
{
"Type": "archive-retrieval",
"ArchiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw",
"Description": "Retrieve archive on 2015-07-17",
"SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-topic"
}
```
아카이브 ID는 `aws glacier upload-archive` 및 `aws glacier get-job-output` 출력에 표시됩니다.
출력:
```
{
"location": "/011685312445/vaults/mwunderl/jobs/l7IL5-EkXyEY9Ws95fClzIbk2O5uLYaFdAYOi-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav",
"jobId": "l7IL5-EkXy2O5uLYaFdAYOiEY9Ws95fClzIbk-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav"
}
```
작업 파라미터 형식에 대한 자세한 내용은 *Amazon Glacier API 참조*의 작업 시작 섹션을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [InitiateJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/initiate-job.html) 섹션을 참조하세요.
### `initiate-multipart-upload`
다음 코드 예시에서는 `initiate-multipart-upload` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
다음 명령은 파일당 파트 크기가 1MB(1024 x 1024바이트)인 `my-vault` 저장소에 멀티파트 업로드를 시작합니다.
```
aws glacier initiate-multipart-upload --account-id - --part-size 1048576 --vault-name my-vault --archive-description "multipart upload test"
```
아카이브 설명 파라미터는 선택 사항입니다. Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.
이 명령은 성공하면 업로드 ID를 출력합니다. `aws glacier upload-multipart-part`를 사용하여 아카이브의 각 부분을 업로드할 때 업로드 ID를 사용합니다. AWS CLI를 사용하여 Amazon Glacier에 멀티파트 업로드를 수행하는 방법에 대한 자세한 내용은 **AWS CLI 사용 설명서의 Amazon Glacier 사용을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [InitiateMultipartUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/initiate-multipart-upload.html) 섹션을 참조하세요.
### `initiate-vault-lock`
다음 코드 예시에서는 `initiate-vault-lock` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**저장소 잠금 프로세스 시작**
다음 `initiate-vault-lock` 예시에서는 지정된 저장소에 저장소 잠금 정책을 설치하고 저장소 잠금의 잠금 상태를 `InProgress`로 설정합니다. 24시간 내에 `complete-vault-lock`을 호출하여 저장소 잠금 프로세스를 마치면 저장소 잠금 상태가 `Locked`로 설정됩니다.
```
aws glacier initiate-vault-lock \
--account-id - \
--vault-name MyVaultName \
--policy file://vault_lock_policy.json
```
`vault_lock_policy.json`의 콘텐츠:
```
{"Policy":"{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"Define-vault-lock\",\"Effect\":\"Deny\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:999999999999:vaults/examplevault\",\"Condition\":{\"NumericLessThanEquals\":{\"glacier:ArchiveAgeinDays\":\"365\"}}}]}"}
```
출력은 저장소 잠금 프로세스를 완료하는 데 사용할 수 있는 저장소 잠금 ID입니다.
```
{
"lockId": "9QZgEXAMPLEPhvL6xEXAMPLE"
}
```
자세한 내용은 *Amazon Glacier API 개발자 안내서*의 [Initiate Vault Lock (POST lock-policy)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-InitiateVaultLock.html)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [InitiateVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/initiate-vault-lock.html) 섹션을 참조하세요.
### `list-jobs`
다음 코드 예시에서는 `list-jobs` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
다음 명령은 `my-vault`라는 볼트에 대해 진행 중인 작업과 최근에 완료된 작업을 나열합니다.
```
aws glacier list-jobs --account-id - --vault-name my-vault
```
출력:
```
{
"JobList": [
{
"VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault",
"RetrievalByteRange": "0-3145727",
"SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault",
"Completed": false,
"SHA256TreeHash": "9628195fcdbcbbe76cdde932d4646fa7de5f219fb39823836d81f0cc0e18aa67",
"JobId": "l7IL5-EkXyEY9Ws95fClzIbk2O5uLYaFdAYOi-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav",
"ArchiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw",
"JobDescription": "Retrieve archive on 2015-07-17",
"ArchiveSizeInBytes": 3145728,
"Action": "ArchiveRetrieval",
"ArchiveSHA256TreeHash": "9628195fcdbcbbe76cdde932d4646fa7de5f219fb39823836d81f0cc0e18aa67",
"CreationDate": "2015-07-17T21:16:13.840Z",
"StatusCode": "InProgress"
},
{
"InventoryRetrievalParameters": {
"Format": "JSON"
},
"VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault",
"Completed": false,
"JobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW",
"Action": "InventoryRetrieval",
"CreationDate": "2015-07-17T20:23:41.616Z",
"StatusCode": ""InProgress""
}
]
}
```
Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [ListJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-jobs.html)를 참조하세요.
### `list-multipart-uploads`
다음 코드 예시에서는 `list-multipart-uploads` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
다음 명령은 `my-vault` 이름의 저장소에 대해 진행 중인 모든 멀티파트 업로드를 보여줍니다.
```
aws glacier list-multipart-uploads --account-id - --vault-name my-vault
```
Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.
AWS CLI를 사용하여 Amazon Glacier에 멀티파트 업로드를 수행하는 방법에 대한 자세한 내용은 **AWS CLI 사용 설명서의 Amazon Glacier 사용을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [ListMultipartUploads](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-multipart-uploads.html)를 참조하세요.
### `list-parts`
다음 코드 예시에서는 `list-parts` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
다음 명령은 `my-vault` 저장소에 대한 멀티파트 업로드에 대해 업로드된 부분을 나열합니다.
```
aws glacier list-parts --account-id - --vault-name my-vault --upload-id "SYZi7qnL-YGqGwAm8Kn3BLP2ElNCvnB-5961R09CSaPmPwkYGHOqeN_nX3-Vhnd2yF0KfB5FkmbnBU9GubbdrCs8ut-D"
```
출력:
```
{
"MultipartUploadId": "SYZi7qnL-YGqGwAm8Kn3BLP2ElNCvnB-5961R09CSaPmPwkYGHOqeN_nX3-Vhnd2yF0KfB5FkmbnBU9GubbdrCs8ut-D",
"Parts": [
{
"RangeInBytes": "0-1048575",
"SHA256TreeHash": "e1f2a7cd6e047350f69b9f8cfa60fa606fe2f02802097a9a026360a7edc1f553"
},
{
"RangeInBytes": "1048576-2097151",
"SHA256TreeHash": "43cf3061fb95796aed99a11a6aa3cd8f839eed15e655ab0a597126210636aee6"
}
],
"VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault",
"CreationDate": "2015-07-18T00:05:23.830Z",
"PartSizeInBytes": 1048576
}
```
Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.
AWS CLI를 사용하여 Amazon Glacier에 멀티파트 업로드를 수행하는 방법에 대한 자세한 내용은 **AWS CLI 사용 설명서의 Amazon Glacier 사용을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [ListParts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-parts.html) 섹션을 참조하세요.
### `list-provisioned-capacity`
다음 코드 예시에서는 `list-provisioned-capacity` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**프로비저닝된 용량 단위를 검색하는 방법**
다음 `list-provisioned-capacity` 예시에서는 지정된 계정에 프로비저닝된 용량 단위의 세부 정보를 검색합니다.
```
aws glacier list-provisioned-capacity \
--account-id 111122223333
```
출력:
```
{
"ProvisionedCapacityList": [
{
"CapacityId": "HpASAuvfRFiVDbOjMfEIcr8K",
"ExpirationDate": "2020-03-18T19:59:24.000Z",
"StartDate": "2020-02-18T19:59:24.912Z"
}
]
}
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [ListProvisionedCapacity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-provisioned-capacity.html) 섹션을 참조하세요.
### `list-tags-for-vault`
다음 코드 예시에서는 `list-tags-for-vault` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
다음 명령은 `my-vault`라는 볼트에 적용된 태그를 나열합니다.
```
aws glacier list-tags-for-vault --account-id - --vault-name my-vault
```
출력:
```
{
"Tags": {
"date": "july2015",
"id": "1234"
}
}
```
Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [ListTagsForVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-tags-for-vault.html) 섹션을 참조하세요.
### `list-vaults`
다음 코드 예시에서는 `list-vaults` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
다음 명령은 기본 계정 및 리전 내 볼트를 나열합니다.
```
aws glacier list-vaults --account-id -
```
출력:
```
{
"VaultList": [
{
"SizeInBytes": 3178496,
"VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault",
"LastInventoryDate": "2015-04-07T00:26:19.028Z",
"VaultName": "my-vault",
"NumberOfArchives": 1,
"CreationDate": "2015-04-06T21:23:45.708Z"
}
]
}
```
Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.
+ API 세부 정보는 **AWS CLI 명령 참조의 [ListVaults](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-vaults.html)를 참조하세요.
### `purchase-provisioned-capacity`
다음 코드 예시에서는 `purchase-provisioned-capacity` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**프로비저닝된 용량 단위를 구매하는 방법**
다음 `purchase-provisioned-capacity` 예시에서는 프로비저닝된 용량 단위를 구매합니다.
```
aws glacier purchase-provisioned-capacity \
--account-id 111122223333
```
출력:
```
{
"capacityId": "HpASAuvfRFiVDbOjMfEIcr8K"
}
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [PurchaseProvisionedCapacity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/purchase-provisioned-capacity.html) 섹션을 참조하세요.
### `remove-tags-from-vault`
다음 코드 예시에서는 `remove-tags-from-vault` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
다음 명령은 `my-vault`라는 저장소에서 `date` 키가 있는 태그를 제거합니다.
```
aws glacier remove-tags-from-vault --account-id - --vault-name my-vault --tag-keys date
```
Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [RemoveTagsFromVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/remove-tags-from-vault.html) 섹션을 참조하세요.
### `set-data-retrieval-policy`
다음 코드 예시에서는 `set-data-retrieval-policy` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
다음 명령은 사용 중인 계정에 대한 데이터 검색 정책을 구성합니다.
```
aws glacier set-data-retrieval-policy --account-id - --policy file://data-retrieval-policy.json
```
`data-retrieval-policy.json`은 데이터 검색 정책을 지정하는 현재 폴더의 JSON 파일입니다.
```
{
"Rules":[
{
"Strategy":"BytesPerHour",
"BytesPerHour":10737418240
}
]
}
```
Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.
다음 명령은 인라인 JSON을 사용하여 데이터 검색 정책을 `FreeTier`로 설정합니다
```
aws glacier set-data-retrieval-policy --account-id - --policy '{"Rules":[{"Strategy":"FreeTier"}]}'
```
정책 형식 지정에 대한 자세한 내용은 *Amazon Glacier API 참조*에서 데이터 검색 정책 설정을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [SetDataRetrievalPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/set-data-retrieval-policy.html) 섹션을 참조하세요.
### `set-vault-access-policy`
다음 코드 예시에서는 `set-vault-access-policy` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
**저장소의 액세스 정책 설정**
다음 `set-vault-access-policy` 예시에서는 권한 정책을 지정된 저장소에 연결합니다.
```
aws glacier set-vault-access-policy \
--account-id 111122223333 \
--vault-name example_vault
--policy '{"Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:ListJobs\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"},{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:UploadArchive\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"}]}"}'
```
이 명령은 출력을 생성하지 않습니다.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [SetVaultAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/set-vault-access-policy.html) 섹션을 참조하세요.
### `set-vault-notifications`
다음 코드 예시에서는 `set-vault-notifications` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
다음 명령은 `my-vault`라는 볼트에 대한 SNS 알림을 구성합니다.
```
aws glacier set-vault-notifications --account-id - --vault-name my-vault --vault-notification-config file://notificationconfig.json
```
`notificationconfig.json`은 게시할 SNS 주제와 이벤트를 지정하는 현재 폴더의 JSON 파일입니다.
```
{
"SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault",
"Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"]
}
```
Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.
+ API 세부 정보는 **AWS CLI 명령 참조의 [SetVaultNotifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/set-vault-notifications.html)를 참조하세요.
### `upload-archive`
다음 코드 예시에서는 `upload-archive` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
다음 명령은 `archive.zip`이라는 현재 폴더의 아카이브를 `my-vault`라는 볼트에 업로드합니다.
```
aws glacier upload-archive --account-id - --vault-name my-vault --body archive.zip
```
출력:
```
{
"archiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw",
"checksum": "969fb39823836d81f0cc028195fcdbcbbe76cdde932d4646fa7de5f21e18aa67",
"location": "/0123456789012/vaults/my-vault/archives/kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw"
}
```
Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.
업로드된 아카이브를 검색하려면 aws glacier initiate-job 명령을 사용하여 검색 작업을 시작하세요.
+ API 세부 정보는 **AWS CLI 명령 참조의 [UploadArchive](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/upload-archive.html)를 참조하세요.
### `upload-multipart-part`
다음 코드 예시에서는 `upload-multipart-part` 코드를 사용하는 방법을 보여줍니다.
**AWS CLI**
다음 명령은 아카이브의 첫 번째 1MiB(1024 x 1024바이트) 부분을 업로드합니다.
```
aws glacier upload-multipart-part --body part1 --range 'bytes 0-1048575/*' --account-id - --vault-name my-vault --upload-id 19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ
```
Amazon Glacier에서는 작업을 수행할 때 계정 ID 인수가 필요하지만 하이픈을 사용하여 사용 중인 계정을 지정할 수 있습니다.
본문 파라미터는 로컬 파일 시스템의 부분 파일 경로를 사용합니다. 범위 파라미터는 완성된 아카이브에서 부분이 차지하는 바이트를 나타내는 HTTP 콘텐츠 범위를 사용합니다. 업로드 ID는 `aws glacier initiate-multipart-upload` 명령으로 반환되며 `aws glacier list-multipart-uploads`를 사용하여 가져올 수도 있습니다.
AWS CLI를 사용하여 Amazon Glacier에 멀티파트 업로드를 수행하는 방법에 대한 자세한 내용은 **AWS CLI 사용 설명서의 Amazon Glacier 사용을 참조하세요.
+ API 세부 정보는 **AWS CLI 명령 참조의 [UploadMultipartPart](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/upload-multipart-part.html)를 참조하세요.