**이 페이지는 볼트와 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 vault)
<a name="api-vault-get"></a>

## 설명
<a name="api-vault-get-description"></a>

이 작업에서는 볼트의 Amazon 리소스 이름(ARN), 볼트 생성 날짜, 볼트에 저장된 아카이브 수, 볼트에 저장된 모든 아카이브의 총 크기 등 볼트에 대한 정보를 반환합니다. 아카이브의 수와 총 크기는 Amazon Glacier(Amazon Glacier)가 마지막으로 생성한 볼트 인벤토리를 기준으로 합니다([Amazon Glacier에서의 볼트 작업](working-with-vaults.md) 참조). Amazon Glacier는 거의 매일 볼트 인벤토리를 생성합니다. 이는 아카이브를 볼트에 추가하거나 삭제한 직후에 볼트 설명 요청을 전송하더라도 응답에 변경 내용이 반영되지 않을 수도 있다는 것을 의미합니다.

## 요청
<a name="api-vault-get-requests"></a>

볼트 정보를 가져오려면 `GET` 요청을 특정 볼트 리소스의 URI로 전송합니다.

### 구문
<a name="api-vault-get-requests-syntax"></a>

```
1. GET /{{AccountId}}/vaults/{{VaultName}} 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 또는 선택적으로 하나의 '`-`'(하이픈)을 지정할 수 있습니다. 이 경우에 Amazon Glacier는 요청 서명에 사용된 자격 증명과 연결된 AWS 계정 ID를 사용합니다. 계정 ID를 사용하는 경우 ID에 하이픈('-')을 포함할 수 없습니다.

### 요청 파라미터
<a name="api-vault-get-requests-parameters"></a>

이 작업은 요청 파라미터를 사용하지 않습니다.

### 요청 헤더
<a name="api-vault-get-requests-headers"></a>

이 작업은 모든 작업에 일반적인 요청 헤더만 사용합니다. 일반적인 요청 헤더에 대한 내용은 [공통 요청 헤더](api-common-request-headers.md) 섹션을 참조하세요.

### 요청 본문
<a name="api-vault-get-requests-elements"></a>

이 작업에는 요청 본문이 없습니다.

## 응답
<a name="api-vault-get-responses"></a>

### 구문
<a name="api-vault-get-responses-syntax"></a>

```
HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length

{
  "CreationDate" : String,
  "LastInventoryDate" : String,
  "NumberOfArchives" : Number,
  "SizeInBytes" : Number,
  "VaultARN" : String,
  "VaultName" : String
}
```

### 응답 헤더
<a name="api-vault-get-responses-headers"></a>

이 작업은 대부분의 응답에 일반적인 응답 헤더만 사용합니다. 일반적인 응답 헤더에 대한 내용은 [공통 응답 헤더](api-common-response-headers.md) 섹션을 참조하세요.

### 응답 본문
<a name="api-vault-get-responses-elements"></a>

JSON 응답 본문에는 다음과 같은 JSON 필드가 포함됩니다.

**CreationDate**  
볼트가 생성된 UTC 날짜입니다.  
**유형: ISO 8601 날짜 형식의 문자열 표현입니다. 예: `2013-03-20T17:03:43.221Z`

**LastInventoryDate**  
Amazon Glacier가 마지막 볼트 인벤토리를 완료한 UTC 날짜입니다. 볼트 인벤토리의 시작에 대한 자세한 내용은 [작업 시작(POST jobs)](api-initiate-job-post.md) 섹션을 참조하세요.  
*유형*: ISO 8601 날짜 형식의 문자열 표현입니다(예: `2013-03-20T17:03:43.221Z`).

**NumberOfArchives**  
마지막 볼트 인벤토리를 기준으로 볼트에 저장된 아카이브 수입니다. 인벤토리가 아직 볼트에서 실행되지 않은 경우, 예를 들어 볼트를 방금 생성한 경우 이 필드는 null 값을 반환합니다.  
*형식*: 숫자

**SizeInBytes**  
마지막 인벤토리 날짜를 기준으로 아카이브별 오버헤드를 포함하여 볼트에 저장된 아카이브의 총 크기(바이트)입니다. 인벤토리가 아직 볼트에서 실행되지 않은 경우, 예를 들어 볼트를 방금 생성한 경우 이 필드는 `null` 값을 반환합니다.  
*형식*: 숫자

**VaultARN**  
볼트의 Amazon 리소스 이름(ARN)입니다.  
*유형*: 문자열

**VaultName**  
생성 시 지정한 볼트 이름입니다. 볼트 이름은 볼트의 ARN에도 포함됩니다.  
*유형*: 문자열

### 오류
<a name="api-vault-get-responses-errors"></a>

Amazon Glacier 예외 및 오류 메시지에 대한 자세한 내용은 [오류 응답](api-error-responses.md) 섹션을 참조하세요.

## 예시
<a name="api-vault-get-examples"></a>

### 요청 예시
<a name="api-vault-get-example-request"></a>

다음은 이름이 `examplevault`인 볼트에 대한 정보를 가져오는 방법을 설명한 예제입니다.

```
GET /-/vaults/examplevault HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```

### 응답의 예
<a name="api-vault-get-example-response"></a>

```
 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: 260
 6. 
 7. {
 8.   "CreationDate" : "2012-02-20T17:01:45.198Z",
 9.   "LastInventoryDate" : "2012-03-20T17:03:43.221Z",
10.   "NumberOfArchives" : 192,
11.   "SizeInBytes" : 78088912,
12.   "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault",
13.   "VaultName" : "examplevault"
14. }
```

## 관련 섹션
<a name="related-sections-vault-get"></a>

 
+ [볼트 만들기(PUT vault)](api-vault-put.md)
+ [볼트 목록 조회(GET vaults)](api-vaults-get.md)
+ [볼트 삭제(DELETE vault)](api-vault-delete.md)
+ [작업 시작(POST jobs)](api-initiate-job-post.md)
+ [Amazon Glacier의 ID 및 액세스 관리(IAM)](security-iam.md)

## 참고
<a name="api-vault-get_SeeAlso"></a>

언어 특정 Amazon SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+  [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/describe-vault.html)