**이 페이지는 볼트와 2012년부터 원래 REST API를 사용하는 Amazon Glacier 서비스의 기존 고객만 사용할 수 있습니다.**
아카이브 스토리지 솔루션을 찾고 있다면 Amazon S3의 Amazon Glacier 스토리지 클래스, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval 및 S3 Glacier Deep Archive를 사용하는 것이 좋습니다. 이러한 스토리지 옵션에 대한 자세한 내용은 [Amazon Glacier 스토리지 클래스](https://aws.amazon.com/s3/storage-classes/glacier/)를 참조하세요.
Amazon Glacier(기존 독립 실행형 볼트 기반 서비스)는 더 이상 신규 고객을 받지 않습니다. Amazon Glacier는 데이터를 볼트에 저장하고 Amazon S3 및 Amazon S3 Glacier 스토리지 클래스와 구별되는 자체 API를 갖춘 독립 실행형 서비스입니다. 기존 데이터는 Amazon Glacier에서 무기한으로 안전하게 보관되며 액세스 가능합니다. 마이그레이션은 필요하지 않습니다. 저비용 장기 아카이브 스토리지의 경우는 [S3 버킷 기반 API, 전체 가용성, 저렴한 비용 및 서비스 통합을 통해 우수한 고객 경험을 제공하는 Amazon S3 Glacier 스토리지 클래스](https://aws.amazon.com/s3/storage-classes/glacier/)를 AWS 권장합니다. S3 APIs AWS 리전 AWS 향상된 기능을 원하는 경우 [Amazon Glacier 볼트에서 Amazon S3 Glacier 스토리지 클래스로 데이터를 전송하기 위한AWS 솔루션 지침](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/)을 사용하여 Amazon S3 Glacier 스토리지 클래스로 마이그레이션하는 것이 좋습니다.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 볼트 목록 조회(GET vaults)
## 설명
이 작업에서는 호출 사용자의 계정에 속한 모든 볼트 목록을 조회합니다. 이때 응답으로 반환되는 목록은 볼트 이름을 기준으로 ASCII 정렬 순서를 따릅니다.
기본적으로 이 작업에서 요청 1건당 반환되는 항목 수는 최대 10개입니다. 목록을 조회할 볼트가 더 있는 경우에는 응답 본문의 `marker` 필드에 새로운 볼트 목록 조회 요청과 함께 목록이 계속되는 지점에 볼트의 Amazon 리소스 이름(ARN)이 추가됩니다. 그렇지 않으면 `marker` 필드는 `null` 값을 갖습니다. 다음 볼트 목록 조회 요청에서는 Amazon Glacier(Amazon Glacier)가 이전 볼트 목록 조회 요청에 대한 응답으로 반환한 값으로 `marker` 파라미터를 설정합니다. 또한 요청 시 `limit` 파라미터를 지정하여 응답으로 반환되는 볼트 수를 제한할 수도 있습니다.
## 요청
볼트 목록을 가져오려면 `GET` 요청을 *볼트* 리소스에 전송합니다.
### 구문
```
1. GET /{{AccountId}}/vaults HTTP/1.1
2. Host: glacier.{{Region}}.amazonaws.com
3. Date: {{Date}}
4. Authorization: {{SignatureValue}}
5. x-amz-glacier-version: 2012-06-01
```
**참고**
`AccountId` 값은 AWS 계정 ID입니다. 이 값은 요청 서명에 사용된 자격 증명과 연결된 AWS 계정 ID와 일치해야 합니다. AWS 계정 ID 또는 선택적으로 하나의 '`-`'(하이픈)을 지정할 수 있습니다. 이 경우에 Amazon Glacier는 요청 서명에 사용된 자격 증명과 연결된 AWS 계정 ID를 사용합니다. 계정 ID를 지정하는 경우 ID에 하이픈('-')을 포함하지 않습니다.
### 요청 파라미터
이 작업은 다음 요청 파라미터를 사용합니다.
| 이름 | 설명 | 필수 |
| --- | --- | --- |
| limit | 반환할 볼트의 최대 수입니다. 기본 제한은 10개입니다. 반환되는 볼트 수가 지정한 제한보다 적을 수 있지만 제한을 초과할 수는 없습니다.
유형: 문자열
제약 조건: 최소 정수 값 1. 최대 정수 값 10 | 아니요 |
| marker | 페이지 매김에 사용되는 문자열입니다. `marker`는 볼트 목록 조회가 시작되는 볼트 ARN을 지정합니다. (`marker`에서 지정하는 볼트는 반환 목록에 포함되지 않습니다.) 이전 볼트 목록 조회 응답에서 `marker` 값을 가져옵니다. `marker`는 이전 볼트 목록 조회 요청에서 시작된 결과에 페이지를 계속해서 매겨야 하는 경우에만 포함해야 합니다. 마커에 대해 빈 값("")을 지정하면 첫 번째 볼트부터 볼트 목록을 반환합니다.
유형: 문자열
제약 조건: 없음 | 아니요 |
### 요청 헤더
이 작업은 모든 작업에 일반적인 요청 헤더만 사용합니다. 일반적인 요청 헤더에 대한 내용은 [공통 요청 헤더](api-common-request-headers.md) 섹션을 참조하세요.
### 요청 본문
이 작업에는 요청 본문이 없습니다.
## 응답
### 구문
```
HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length
{
"Marker": String
"VaultList": [
{
"CreationDate": String,
"LastInventoryDate": String,
"NumberOfArchives": Number,
"SizeInBytes": Number,
"VaultARN": String,
"VaultName": String
},
...
]
}
```
### 응답 헤더
이 작업은 대부분의 응답에 일반적인 응답 헤더만 사용합니다. 일반적인 응답 헤더에 대한 내용은 [공통 응답 헤더](api-common-response-headers.md) 섹션을 참조하세요.
### 응답 본문
JSON 응답 본문에는 다음과 같은 JSON 필드가 포함됩니다.
**CreationDate**
볼트가 생성된 날짜(UTC)입니다.
*유형*: 문자열. ISO 8601 날짜 형식의 문자열 표현입니다. 예: `2013-03-20T17:03:43.221Z`
**LastInventoryDate**
마지막 볼트 인벤토리의 날짜(UTC)입니다. 인벤토리가 아직 볼트에서 실행되지 않은 경우, 예를 들어 볼트를 방금 생성한 경우 이 필드는 null 값을 가질 수 있습니다. 볼트 인벤토리의 시작에 대한 자세한 내용은 [작업 시작(POST jobs)](api-initiate-job-post.md) 섹션을 참조하세요.
*유형*: ISO 8601 날짜 형식의 문자열 표현입니다. 예: `2013-03-20T17:03:43.221Z`
**마커**
결과에 페이지를 계속해서 매기는 지점을 나타내는 `vaultARN`입니다. 다른 볼트 목록 조회 요청에서 `marker`를 사용하여 목록에서 추가 볼트를 가져올 수 있습니다. 볼트가 더 없을 경우 이 값은 `null`입니다.
*유형*: 문자열
**NumberOfArchives**
마지막 인벤토리 날짜를 기준으로 볼트의 아카이브 수입니다.
*유형*: 숫자
**SizeInBytes**
마지막 인벤토리 날짜를 기준으로 아카이브별 오버헤드를 포함하여 볼트에 저장된 모든 아카이브의 총 크기(바이트)입니다.
*유형*: 숫자
**VaultARN**
볼트의 Amazon 리소스 이름(ARN)입니다.
*유형*: 문자열
**VaultList**
각각 볼트에 대해 설명하는 객체의 배열입니다.
*유형*: 배열
**VaultName**
볼트 이름입니다.
*유형*: 문자열
### 오류
Amazon Glacier 예외 및 오류 메시지에 대한 자세한 내용은 [오류 응답](api-error-responses.md) 섹션을 참조하세요.
## 예시
### 예제: 모든 볼트 목록 조회
다음은 볼트 목록을 조회하는 예제입니다. 요청에서 `marker` 파라미터와 `limit` 파라미터를 지정하지 않았기 때문에 최대 10개까지 볼트가 반환됩니다.
#### 요청 예시
```
1. GET /-/vaults HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```
#### 응답의 예
`Marker`가 `null` 값을 갖기 때문에 더 이상 목록을 조회할 볼트가 없다는 것을 의미합니다.
```
1. HTTP/1.1 200 OK
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:02:00 GMT
4. Content-Type: application/json
5. Content-Length: 497
6.
7. {
8. "Marker": null,
9. "VaultList": [
10. {
11. "CreationDate": "2012-03-16T22:22:47.214Z",
12. "LastInventoryDate": "2012-03-21T22:06:51.218Z",
13. "NumberOfArchives": 2,
14. "SizeInBytes": 12334,
15. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1",
16. "VaultName": "examplevault1"
17. },
18. {
19. "CreationDate": "2012-03-19T22:06:51.218Z",
20. "LastInventoryDate": "2012-03-21T22:06:51.218Z",
21. "NumberOfArchives": 0,
22. "SizeInBytes": 0,
23. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault2",
24. "VaultName": "examplevault2"
25. },
26. {
27. "CreationDate": "2012-03-19T22:06:51.218Z",
28. "LastInventoryDate": "2012-03-25T12:14:31.121Z",
29. "NumberOfArchives": 0,
30. "SizeInBytes": 0,
31. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault3",
32. "VaultName": "examplevault3"
33. }
34. ]
35. }
```
### 예제: 부분적 볼트 목록 조회
다음은 `marker`에서 지정한 볼트부터 볼트 2개를 반환하는 예제입니다.
#### 요청 예시
```
1. GET /-/vaults?limit=2&marker=arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1 HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```
#### 응답의 예
목록에서 볼트 2개가 반환됩니다. `Marker`에 볼트 ARN이 포함되어 있으므로 다른 볼트 목록 조회 요청에서 페이지 매김이 계속 됩니다.
```
1. HTTP/1.1 200 OK
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:02:00 GMT
4. Content-Type: application/json
5. Content-Length: 497
6.
7. {
8. "Marker": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault3",
9. "VaultList": [
10. {
11. "CreationDate": "2012-03-16T22:22:47.214Z",
12. "LastInventoryDate": "2012-03-21T22:06:51.218Z",
13. "NumberOfArchives": 2,
14. "SizeInBytes": 12334,
15. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1",
16. "VaultName": "examplevault1"
17. },
18. {
19. "CreationDate": "2012-03-19T22:06:51.218Z",
20. "LastInventoryDate": "2012-03-21T22:06:51.218Z",
21. "NumberOfArchives": 0,
22. "SizeInBytes": 0,
23. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault2",
24. "VaultName": "examplevault2"
25. }
26. ]
27. }
```
## 관련 섹션
+ [볼트 만들기(PUT vault)](api-vault-put.md)
+ [볼트 삭제(DELETE vault)](api-vault-delete.md)
+ [작업 시작(POST jobs)](api-initiate-job-post.md)
+ [Amazon Glacier의 ID 및 액세스 관리(IAM)](security-iam.md)
## 참고
언어 특정 Amazon SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/list-vaults.html)