

 **이 페이지는 볼트와 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 스토리지 클래스로 마이그레이션하는 것이 좋습니다.

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

# GlacierJobDescription
<a name="api-GlacierJobDescription"></a>

Amazon Glacier(Amazon Glacier) 작업에 대한 설명을 포함합니다.

## 내용
<a name="api-GlacierJobDescription-contents"></a>

**작업**  
작업 유형입니다. `ArchiveRetrieval`, `InventoryRetrieval` 또는 `Select`입니다.  
*유형*: 문자열

**ArchiveId**  
선택 또는 아카이브 가져오기 작업을 위해 요청된 아카이브 ID입니다. 그렇지 않으면 이 필드는 `null` 값을 갖습니다.  
*유형*: 문자열

**ArchiveSHA256TreeHash**  
아카이브 가져오기에서 전체 아카이브의 SHA256 트리-해시입니다. 인벤토리 가져오기 작업일 때는 이 필드가 `null` 값을 갖습니다.  
*유형*: 문자열

**ArchiveSizeInBytes**  
`ArchiveRetrieval` 작업일 경우 이 값은 다운로드를 요청하는 아카이브의 크기(바이트)입니다. `InventoryRetrieval` 작업일 경우 이 값은 `null`입니다.  
*유형*: 숫자

**Completed**  
작업이 완료된 경우에는 `true`이며, 그 밖에는 `false`입니다.  
*유형*: 부울

**CompletionDate**  
작업이 완료된 날짜입니다.  
작업 요청이 완료된 협정 세계시(UTC) 시간입니다. 작업이 진행 중일 때는 null 값을 갖습니다.  
*유형*: ISO 8601 날짜 형식의 문자열 표현입니다. 예: `2013-03-20T17:03:43.221Z`

**CreationDate**  
작업이 시작된 협정 세계시(UTC) 날짜입니다.  
*유형*: ISO 8601 날짜 형식의 문자열 표현입니다. 예: `2013-03-20T17:03:43.221Z`

**InventoryRetrievalParameters**  
범위가 지정된 인벤토리 가져오기에 사용되는 입력 파라미터입니다.  
*유형*: [InventoryRetrievalJobInput](api-InventoryRetrievalJobInput.md) 객체

**InventorySizeInBytes**  
`InventoryRetrieval` 작업일 경우 이 값은 다운로드를 요청하는 인벤토리의 크기(바이트)입니다. `ArchiveRetrieval` 또는 `Select` 작업의 경우, `null` 값을 갖습니다.  
*유형*: 숫자

**JobDescription**  
작업을 시작할 때 입력한 작업 설명입니다.  
*유형*: 문자열

**JobId**  
Amazon Glacier에서 작업을 식별하는 ID입니다.  
*유형*: 문자열

**JobOutputPath**  
작업 출력 위치가 포함되어 있습니다.  
*유형*: 문자열

**OutputLocation**  
 선택 작업 결과와 오류가 저장되는 위치에 관한 정보가 포함된 객체입니다.  
*유형*: [OutputLocation](api-OutputLocation.md) 객체

**RetrievalByteRange**  
아카이브 가져오기 작업에 대해 가져온 바이트 범위이며, 형식은 "*StartByteValue*-*EndByteValue*"를 따릅니다. 아카이브 가져오기에서 범위를 지정하지 않으면 전체 아카이브를 가져옵니다. 이때 *StartByteValue*의 값은 0이고, *EndByteValue*의 값은 아카이브 크기에서 1을 뺀 값입니다. 인벤토리 가져오기 작업일 때는 이 필드가 `null` 값을 갖습니다.  
*유형*: 문자열

**SelectParameters**  
선택에 사용되는 파라미터에 관한 정보를 포함하는 객체입니다.  
*유형*: [SelectParameters](api-SelectParameters.md) 객체

**SHA256TreeHash**  
요청하는 아카이브 범위에 대한 SHA256 트리-해시 값입니다. 아카이브에 대한 [작업 시작(POST jobs)](api-initiate-job-post.md) 요청에서 트리-해시 정렬 범위를 지정하였다면 이 필드가 값을 반환합니다. 아카이브 범위 가져오기에서 트리-해시 정렬에 대한 자세한 내용은 [데이터 다운로드 시 체크섬 수신](checksum-calculations-range.md) 섹션을 참조하세요.  
전체 아카이브를 가져오는 특정 경우에는 이 값이 `ArchiveSHA256TreeHash` 값과 동일합니다.  
이 필드는 다음 상황에서 `null` 값을 갖습니다.  
+ 아카이브 가져오기 작업에서 트리-해시로 정렬되지 않은 범위를 지정할 때
+ 아카이브 작업에서 전체 아카이브와 같은 범위를 지정하고, 작업 상태가 `InProgress`일 때 
+ 인벤토리 작업일 때
+ 작업을 선택합니다.
*유형*: 문자열

**SNSTopic**  
작업 시작([작업 시작(POST jobs)](api-initiate-job-post.md)) 시 알림을 구성한 경우 작업 완료 또는 중단에 대한 알림 메시지가 전송되는 Amazon SNS 토픽의 Amazon 리소스 이름(ARN)입니다.  
*유형*: 문자열

**StatusCode**  
작업 상태를 나타내는 코드입니다.  
*유효한 값*: `InProgress` \$1 `Succeeded` \$1 `Failed`  
*유형*: 문자열

**StatusMessage**  
작업 상태 메시지입니다.  
*유형*: 문자열

**Tier**  
선택 또는 아카이브 가져오기에 사용할 데이터 액세스 계층입니다.  
*유효한 값*: `Expedited` \$1 `Standard` \$1 `Bulk`  
*유형*: 문자열

**VaultARN**  
작업이 하위 리소스인 볼트의 ARN입니다.  
*유형*: 문자열

## 추가 정보
<a name="more-info-api-GlacierJobDescription"></a>
+ [작업 시작(POST jobs)](api-initiate-job-post.md)