**이 페이지는 볼트와 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 스토리지 클래스로 마이그레이션하는 것이 좋습니다. 기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 작업에서 사용되는 데이터 형식 다음은 Amazon Glacier에서 작업에 사용되는 데이터 형식입니다. **Topics** + [CSVInput](api-CSVInput.md) + [CSVOutput](api-CSVOutput.md) + [암호화](api-Encryption.md) + [GlacierJobDescription](api-GlacierJobDescription.md) + [권한 부여](api-Grant.md) + [피부여자](api-Grantee.md) + [InputSerialization](api-InputSerialization.md) + [InventoryRetrievalJobInput](api-InventoryRetrievalJobInput.md) + [jobParameters](api-jobParameters.md) + [OutputLocation](api-OutputLocation.md) + [OutputSerialization](api-OutputSerialization.md) + [S3Location](api-S3Location.md) + [SelectParameters](api-SelectParameters.md) # CSVInput 쉼표로 분리된 값(CSV) 파일에 대한 정보를 포함합니다. ## 내용 **설명** 행의 시작에 존재할 경우, 해당 행을 무시해야 함을 나타내는 데 사용되는 단일 문자입니다. *유형*: 문자열 *필수 항목 여부*: 아니요 **FieldDelimiter** 한 레코드 내에서 개별 필드를 서로 분리하는 데 사용되는 단일 문자입니다. 문자는 32\$1126 범위의 `\n`, `\r`, 혹은 ASCII 문자여야 합니다. 기본값은 쉼표입니다 (`,`). *유형*: 문자열 *기본값*: / *필수 항목 여부*: 아니요 **FileHeaderInfo** 입력의 첫 번째 줄에 할 일을 설명하는 값입니다. *유형*: 문자열 *유효한 값*: `Use` \$1 `Ignore` \$1 `None` *필수 항목 여부*: 아니요 **QuoteCharacter** 필드 구분 기호가 값의 일부인 이스케이프 문자로 사용되는 단일 문자입니다. *유형*: 문자열 *필수 항목 여부*: 아니요 **QuoteEscapeCharacter** 이미 이스케이프된 값 내의 따옴표 문자를 이스케이프하는 데 사용되는 단일 문자입니다. *유형*: 문자열 *필수 항목 여부*: 아니요 **RecordDelimiter** 개별 레코드를 서로 분리하는 데 사용되는 단일 문자입니다. *유형*: 문자열 *필수 항목 여부*: 아니요 ## 추가 정보 + [작업 시작(POST jobs)](api-initiate-job-post.md) # CSVOutput 작업 결과가 저장되는 쉼표로 분리된 값(CSV) 형식에 관한 정보를 포함합니다. ## 내용 **FieldDelimiter** 한 레코드 내에서 개별 필드를 서로 분리하는 데 사용되는 단일 문자입니다. *유형*: 문자열 *필수 항목 여부*: 아니요 **QuoteCharacter** 필드 구분 기호가 값의 일부인 이스케이프 문자로 사용되는 단일 문자입니다. *유형*: 문자열 *필수 항목 여부*: 아니요 **QuoteEscapeCharacter** 이미 이스케이프된 값 내의 따옴표 문자를 이스케이프하는 데 사용되는 단일 문자입니다. *유형*: 문자열 *필수 항목 여부*: 아니요 **QuoteFields** 모든 출력 필드가 따옴표 안에 포함되어야 하는지를 나타내는 값입니다. *유효한 값*: `ALWAYS` \$1 `ASNEEDED` *유형*: 문자열 *필수 항목 여부*: 아니요 **RecordDelimiter** 개별 레코드를 서로 분리하는 데 사용되는 단일 문자입니다. *유형*: 문자열 *필수 항목 여부*: 아니요 ## 추가 정보 + [작업 시작(POST jobs)](api-initiate-job-post.md) # 암호화 작업 결과를 Amazon S3에 저장하는 데 사용되는 암호화 관련 정보를 포함합니다. ## 내용 **암호화** Amazon S3에서 작업 결과를 저장할 때 사용되는 서버 측 암호화 알고리즘입니다. 기본값은 암호화 없음입니다. *유형*: 문자열 *유효한 값*: `aws:kms` \$1 `AES256` *필수 항목 여부*: 아니요 ****KMSContext 선택 사항입니다. 암호화 유형이 `aws:kms,`인 경우 이 값을 사용하여 작업 결과의 암호화 컨텍스트를 지정할 수 있습니다. *유형*: 문자열 *필수 항목 여부*: 아니요 ****KMSKeyId 개체 암호화에 사용할 AWS Key Management Service(AWS KMS) 키 ID입니다. *유형*: 문자열 *필수 항목 여부*: 아니요 ## 추가 정보 + [작업 시작(POST jobs)](api-initiate-job-post.md) # GlacierJobDescription Amazon Glacier(Amazon Glacier) 작업에 대한 설명을 포함합니다. ## 내용 **작업** 작업 유형입니다. `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입니다. *유형*: 문자열 ## 추가 정보 + [작업 시작(POST jobs)](api-initiate-job-post.md) # 권한 부여 권한 부여에 대한 정보가 들어 있습니다. ## 내용 ****피부여자 피부여자입니다. **유형: [피부여자](api-Grantee.md) 객체 *필수 항목 여부*: 아니요 **권한** 피부여자에게 부여된 권한입니다. *유형*: 문자열 **유효한 값: `FULL_CONTROL` \$1 `WRITE` \$1 `WRITE_ACP` \$1 `READ` \$1 `READ_ACP` *필수 항목 여부*: 아니요 ## 추가 정보 + [작업 시작(POST jobs)](api-initiate-job-post.md) # 피부여자 피부여자에 대한 정보가 들어 있습니다. ## 내용 ****DisplayName 피부여자의 표시 이름입니다. *유형*: 문자열 *필수 항목 여부*: 아니요 ****EmailAddress 피부여자의 이메일 주소입니다. *유형*: 문자열 *필수 항목 여부*: 아니요 **ID**: 피부여자의 정식 사용자 ID입니다. *유형*: 문자열 *필수 항목 여부*: 아니요 **유형** 피부여자의 유형입니다. *유형*: 문자열 *유효한 값*: `AmazonCustomerByEmail` \$1 `CanonicalUser` \$1 `Group` *필수 항목 여부*: 아니요 ****URI 피부여자 그룹의 URI입니다. *유형*: 문자열 *필수 항목 여부*: 아니요 ## 추가 정보 + [작업 시작(POST jobs)](api-initiate-job-post.md) # InputSerialization 아카이브가 직렬화되는 방법을 설명합니다. ## 내용 **CSV** CSV로 인코딩된 객체의 직렬화를 설명하는 객체입니다. **유형: [CSVInput](api-CSVInput.md) 객체 *필수 항목 여부*: 아니요 ## 추가 정보 + [작업 시작(POST jobs)](api-initiate-job-post.md) # InventoryRetrievalJobInput 범위가 지정된 인벤토리 가져오기 작업을 지정하기 위한 옵션을 제공합니다. ## 내용 **EndDate** 볼트 인벤토리 가져오기에서 지정하는 날짜(UTC) 범위의 끝이며, 이 날짜 이전에 생성된 아카이브도 포함됩니다. **유효한 값: ISO 8601 날짜 형식(`YYYY-MM-DDThh:mm:ssTZD`)의 초 단위 문자열 표현입니다. 예: `2013-03-20T17:03:43Z` **유형: 문자열입니다. ISO 8601 날짜 형식(`YYYY-MM-DDThh:mm:ssTZD`)의 초 단위 문자열 표현입니다. 예: `2013-03-20T17:03:43Z` *필수 항목 여부*: 아니요 **형식**. 볼트 인벤토리 목록의 출력 형식이며, 볼트 인벤토리 가져오기 작업을 시작할 때 [작업 시작(POST jobs)](api-initiate-job-post.md) 요청에서 설정합니다. *유효한 값*: `CSV` \$1 `JSON` *필수 항목 여부*: 아니요 *유형*: 문자열 **Limit** 볼트 인벤토리 가져오기 요청을 할 때마다 반환될 수 있는 인벤토리 항목의 최대 수를 지정합니다. *유효 값*: 1보다 크거나 같은 정수 값 *유형*: 문자열 *필수 항목 여부*: 아니요 **마커** 볼트 인벤토리 가져오기 결과에 페이지를 계속해서 매기는 지점을 나타내는 불투명한 문자열입니다. 인벤토리 항목을 추가로 가져오려면 새로운 `Initiate Job` 요청에서 이 마커를 사용하면 됩니다. 인벤토리 항목이 더 없을 경우 이 값은 null 입니다. *유형*: 문자열 *필수 항목 여부*: 아니요 **StartDate** 볼트 인벤토리 가져오기에서 지정하는 날짜(UTC) 범위의 시작이며, 이 날짜 당일 또는 이후에 생성된 아카이브도 포함됩니다. **유효한 값: ISO 8601 날짜 형식(`YYYY-MM-DDThh:mm:ssTZD`)의 초 단위 문자열 표현입니다. 예: `2013-03-20T17:03:43Z` **유형: 문자열입니다. ISO 8601 날짜 형식(`YYYY-MM-DDThh:mm:ssTZD`)의 초 단위 문자열 표현입니다. 예: `2013-03-20T17:03:43Z` *필수 항목 여부*: 아니요 ## 추가 정보 + [작업 시작(POST jobs)](api-initiate-job-post.md) # jobParameters 작업을 정의하기 위한 옵션을 제공합니다. ## 내용 **ArchiveId** 원하는 아카이브의 ID입니다. `Type` 필드가 `select` 또는 `archive-retrieval`로 설정된 경우에 이 필드는 필수입니다. 인벤토리 가져오기 작업 요청에 대해 이 필드를 지정하면 오류가 발생합니다. *유효한 값*: Amazon Glacier(Amazon Glacier)에 대한 이전 요청에서 얻은 유효한 아카이브 ID이어야 합니다. *유형*: 문자열 *필수 항목 여부*: `Type`이 `select` 또는 `archive-retrieval`로 설정된 경우, 예 **설명** 작업 설명(옵션)입니다. *유효한 값*: 설명은 1,024바이트보다 작거나 같아야 합니다. 허용되는 문자는 제어 코드를 제외한 7비트 ASCII로 그 중에서도 특히 ASCII 값 32\$1126 십진수 또는 0x20\$10x7E 16진수입니다. *유형*: 문자열 *필수 항목 여부*: 아니요 **형식**. (선택 사항) 볼트 인벤토리 가져오기 작업을 시작할 때 출력 형식입니다. 인벤토리 작업을 시작하면서 `Format` 필드를 지정하지 않으면 JSON이 기본 형식으로 사용됩니다. *유효한 값*: `CSV` \$1 `JSON` *유형*: 문자열 *필수 항목 여부*: 아니요 **InventoryRetrievalParameters** 범위가 지정된 인벤토리 가져오기에 사용되는 입력 파라미터입니다. *유형*: [InventoryRetrievalJobInput](api-InventoryRetrievalJobInput.md) 객체 *필수 항목 여부*: 아니요 **OutputLocation** 선택 작업 결과가 저장되는 위치에 관한 정보가 포함된 객체입니다. *유형*: [OutputLocation](api-OutputLocation.md) 객체 *필수 항목 여부*: `select` 작업의 경우, 예. **RetrievalByteRange** `archive-retrieval`에 대해 검색할 바이트 범위는 ‘*StartByteValue*\$1*EndByteValue*’ 형식이 되어야 합니다. 이 필드를 지정하지 않으면 전체 아카이브를 가져옵니다. 이 필드를 지정할 경우에는 바이트 범위가 메가바이트(1024\$11024)로 정렬되어야 합니다. 메가바이트 정렬은 *StartByteValue*가 1MB로 나누어지고, *EndByteValue* \$1 1이 1MB로 나누어지거나 혹은 아카이브 끝이 아카이브 바이트 크기 값에서 1을 뺀 값으로 지정되어야 한다는 것을 의미합니다. **RetrievalByteRange**가 메가바이트로 정렬되지 않으면 `400` 응답이 반환됩니다. `inventory-retrieval` 또는 `select` 작업 요청에 대해 이 필드를 지정하면 오류가 발생합니다. *유형*: 문자열 *필수 항목 여부*: 아니요 **SelectParameters** 선택에 사용되는 파라미터에 관한 정보를 포함하는 객체입니다. **유형: [SelectParameters](api-SelectParameters.md) 객체 *필수 항목 여부*: 아니요 **SNSTopic** 작업이 완료되고 출력을 다운로드할 수 있을 때 Amazon Glacier가 알림 메시지를 전송하는 Amazon SNS 토픽의 Amazon 리소스 이름(ARN)입니다. 지정된 토픽은 알림 메시지를 구독자에게 게시합니다. 이때 SNS 토픽은 반드시 존재해야 합니다. 존재하지 않는 경우, Amazon Glacier는 자동으로 토픽을 생성하지 않습니다. 또한 SNS 토픽은 작업을 생성한 계정에서 메시지를 토픽에 게시할 수 있는 정책이 필요합니다. SNS 토픽 이름에 대한 자세한 정보는 *Amazon Simple Notification Service*의 **API 참조에서 [CreateTopic](https://docs.aws.amazon.com/sns/latest/api/API_CreateTopic.html)을 참조하세요. *유형*: 문자열 *필수 항목 여부*: 아니요 **계층** 선택 또는 아카이브 가져오기 작업에 사용할 계층입니다. 기본값으로 `Standard`가 사용됩니다. *유효한 값*: `Expedited` \$1 `Standard` \$1 `Bulk` *유형*: 문자열 *필수 항목 여부*: 아니요 **유형** 작업 유형입니다. 아카이브에서 선택 쿼리를 수행하거나 아카이브를 가져오거나 볼트의 인벤토리를 가져오는 작업을 시작할 수 있습니다. *유효한 값*: `select` \$1 `archive-retrieval` \$1 `inventory-retrieval` *유형*: 문자열 *필수 항목 여부*: 예 ## 추가 정보 + [작업 시작(POST jobs)](api-initiate-job-post.md) # OutputLocation 작업 결과와 오류가 저장되는 위치에 관한 정보를 포함합니다. ## 내용 **S3** 복원 요청 결과를 수신할 Amazon S3 위치를 설명하는 객체입니다. *유형*: [S3Location](api-S3Location.md) *필수 항목 여부*: 예 ## 추가 정보 + [작업 시작(POST jobs)](api-initiate-job-post.md) # OutputSerialization 출력이 직렬화되는 방법을 설명합니다. ## 내용 **CSV** 쉼표로 분리된 값(CSV)으로 인코딩된 쿼리 결과의 직렬화를 설명하는 객체입니다. **유형: [CSVOutput](api-CSVOutput.md) 객체 *필수 항목 여부*: 아니요 ## 추가 정보 + [작업 시작(POST jobs)](api-initiate-job-post.md) # S3Location 작업 결과가 저장되는 Amazon S3 내 위치에 관한 정보를 포함합니다. ## 내용 **AccessControlList** 저장된 결과에 대한 액세스를 제어하는 권한의 목록입니다. *유형*: [권한 부여](api-Grant.md) 객체 배열 *필수 항목 여부*: 아니요 **BucketName** 작업 결과가 저장되는 Amazon S3 버킷의 이름입니다. 버킷은 입력 아카이브 객체를 포함하는 볼트와 동일한 AWS 리전에 있어야 합니다. *유형*: 문자열 *필수 항목 여부*: 예 **CannedACL** 작업 결과에 적용되는 미리 준비된 액세스 제어 목록(ACL)입니다. *유형*: 문자열 *유효한 값*: `private` \$1 `public-read` \$1 `public-read-write` \$1 `aws-exec-read` \$1 `authenticated-read` \$1 `bucket-owner-read` \$1 `bucket-owner-full-control` *필수 항목 여부*: 아니요 **암호화** 작업 결과를 Amazon S3에 저장하는 데 사용되는 암호화에 관한 정보를 포함하는 객체입니다. **유형: [암호화](api-Encryption.md) 객체 *필수 항목 여부*: 아니요 **접두사**  이 요청의 결과 앞에 추가되는 접두사입니다. 접두사의 최대 길이는 512바이트입니다. *유형*: 문자열 *필수 항목 여부*: 예 **StorageClass** 작업 결과 저장에 사용하는 스토리지 클래스입니다. *유형*: 문자열 *유효한 값*: `STANDARD` \$1 `REDUCED_REDUNDANCY` \$1 `STANDARD_IA` *필수 항목 여부*: 아니요 **태그 지정** 작업 결과에 적용되는 태그 집합입니다. *유형*: 문자열 간 맵 *필수 항목 여부*: 아니요 **UserMetadata** 작업 결과와 함께 Amazon S3에 저장할 메타데이터 맵입니다. *유형*: 문자열 간 맵 *필수 항목 여부*: 아니요 ## 추가 정보 + [작업 시작(POST jobs)](api-initiate-job-post.md) # SelectParameters 선택에 사용되는 파라미터에 관한 정보를 포함합니다. ## 내용 **표현식** 객체 선택에 사용되는 표현식입니다. 표현식은 128,000자 할당량을 초과하면 안 됩니다. *유형*: 문자열 *필수 항목 여부*: 예 **ExpressionType** 제공된 표현식의 유형입니다(예: `SQL`). *유효 값*: `SQL` *유형*: 문자열 *필수 항목 여부*: 예 **InputSerialization** 선택에서 객체의 직렬화된 형식을 설명합니다. **유형: [InputSerialization](api-InputSerialization.md) 객체 *필수 항목 여부*: 아니요 **OutputSerialization** 선택 작업의 결과가 직렬화되는 방법을 설명합니다. *필수 항목 여부*: 아니요 **유형: [OutputSerialization](api-OutputSerialization.md) 객체 ## 추가 정보 + [작업 시작(POST jobs)](api-initiate-job-post.md)