**이 페이지는 볼트와 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 JobID) ## 설명 이 작업은 작업 시작 날짜, 작업을 시작한 사용자, 작업 상태 코드/메시지, 그리고 Amazon Glacier(Amazon Glacier)가 작업을 완료한 후 알림을 보낼 Amazon Simple Notification Service(Amazon SNS) 토픽 등 이전에 시작한 작업에 대한 정보를 반환합니다. 작업 시작에 대한 자세한 내용은 [작업 시작(POST jobs)](api-initiate-job-post.md) 섹션을 참조하세요. **참고** 이 작업을 통해 작업 상태를 확인할 수 있습니다. 하지만 Amazon Glacier가 작업 완료 후 토픽에 알림을 보낼 수 있도록 작업 시작 요청에서 Amazon SNS 토픽을 설정 및 지정하는 것을 적극 권장합니다. 작업 ID는 Amazon Glacier가 작업을 완료한 후 최소 24시간 동안 만료되지 않습니다. ## Requests ### 구문 작업에 대한 정보를 가져오려면 HTTP `GET` 메서드를 사용하여 요청을 원하는 작업까지 전송합니다. 이때 상대 URI 경로는 작업 시작 시 Amazon Glacier가 반환하는 경로와 동일합니다. ``` 1. GET /{{AccountID}}/vaults/{{VaultName}}/jobs/{{JobID}} 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에 하이픈('-')을 포함할 수 없습니다. **참고** 요청에서 `JobID`를 생략하는 경우에는 응답이 특정 볼트에서 현재 활성화되어 있는 모든 작업의 목록을 반환합니다. 작업 목록 조회에 대한 자세한 내용은 [작업 목록 조회(GET jobs)](api-jobs-get.md) 섹션을 참조하세요. ### 요청 파라미터 이 작업은 요청 파라미터를 사용하지 않습니다. ### 요청 헤더 이 작업은 모든 작업에 일반적인 요청 헤더만 사용합니다. 일반적인 요청 헤더에 대한 내용은 [공통 요청 헤더](api-common-request-headers.md) 섹션을 참조하세요. ### 요청 본문 이 작업에는 요청 본문이 없습니다. ## 응답 ### 구문 ``` HTTP/1.1 201 Created x-amzn-RequestId: x-amzn-RequestId Date: Date Content-Type: application/json Content-Length: Length { "Action": "{{string}}", "ArchiveId": "{{string}}", "ArchiveSHA256TreeHash": "{{string"}}, "ArchiveSizeInBytes": {{number}}, "Completed": {{boolean}}, "CompletionDate": "{{string}}", "CreationDate": "{{string}}", "InventoryRetrievalParameters": { "EndDate": "{{string}}", "Format": "{{string}}", "Limit": "{{string}}", "Marker": "{{string}}", "StartDate": "{{string}}" }, "InventorySizeInBytes": {{number}}, "JobDescription": "{{string}}", "JobId": "{{string}}", "JobOutputPath": "{{string}}", "OutputLocation": { "S3": { "AccessControlList": [ { "Grantee": { "DisplayName": "{{string}}", "EmailAddress": "{{string}}", "ID": "{{string}}", "Type": "{{string}}", "URI": "{{string}}" }, "Permission": "{{string}}" } ], "BucketName": "{{string}}", "CannedACL": "{{string}}", "Encryption": { "EncryptionType": "{{string}}", "KMSContext": "{{string}}", "KMSKeyId": "{{string}}" }, "Prefix": "{{string}}", "StorageClass": "{{string}}", "Tagging": { "{{string}}": "{{string}}" }, "UserMetadata": { "{{string}}": "{{string}}" } } }, "RetrievalByteRange": "{{string}}", "SelectParameters": { "Expression": "{{string}}", "ExpressionType": "{{string}}", "InputSerialization": { "csv": { "Comments": "{{string}}", "FieldDelimiter": "{{string}}", "FileHeaderInfo": "{{string}}", "QuoteCharacter": "{{string}}", "QuoteEscapeCharacter": "{{string}}", "RecordDelimiter": "{{string}}" } }, "OutputSerialization": { "csv": { "FieldDelimiter": "{{string}}", "QuoteCharacter": "{{string}}", "QuoteEscapeCharacter": "{{string}}", "QuoteFields": "{{string}}", "RecordDelimiter": "{{string}}" } } }, "SHA256TreeHash": "{{string}}", "SNSTopic": "{{string}}", "StatusCode": "{{string}}", "StatusMessage": "{{string}}", "Tier": "{{string}}", "VaultARN": "{{string}}" } ``` ### 응답 헤더 이 작업은 대부분의 응답에 일반적인 응답 헤더만 사용합니다. 일반적인 응답 헤더에 대한 내용은 [공통 응답 헤더](api-common-response-headers.md) 섹션을 참조하세요. ### 응답 본문 응답 본문에는 다음과 같은 JSON 필드가 포함됩니다. **작업** 작업 유형입니다. `ArchiveRetrieval`, `InventoryRetrieval` 또는 `Select`입니다. *유형*: 문자열 **ArchiveId** 선택 또는 아카이브 가져오기 작업을 위해 요청된 아카이브 ID입니다. 그렇지 않으면 이 필드는 `null` 값을 갖습니다. *유형*: 문자열 **ArchiveSHA256TreeHash** 아카이브 가져오기 작업에서 전체 아카이브의 SHA256 트리-해시입니다. 인벤토리 가져오기 작업일 때는 이 필드가 `null` 값을 갖습니다. *유형*: 문자열 **ArchiveSizeInBytes** `ArchiveRetrieval` 작업일 경우 이 값은 다운로드를 요청하는 아카이브의 크기(바이트)입니다. `InventoryRetrieval` 작업일 경우 이 값은 `null`입니다. *형식*: 숫자 **Completed** 작업 상태입니다. 아카이브 또는 인벤토리 가져오기 작업이 완료되면 [작업 출력 가져오기(GET output)](api-job-output-get.md)을 사용하여 작업의 출력을 가져올 수 있습니다. *유형*: 부울 **CompletionDate** 작업 요청이 완료된 협정 세계시(UTC) 시간입니다. 작업이 진행 중일 때는 null 값을 갖습니다. *유형*: 문자열 **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** 알림을 받는 Amazon SNS 토픽입니다. *유형*: 문자열 **StatusCode** 작업 상태를 나타내는 코드입니다. *유효한 값*: `InProgress` \| `Succeeded` \| `Failed` *유형*: 문자열 **StatusMessage** 쉽게 이해할 수 있도록 작업 상태를 설명하는 메시지입니다. *유형*: 문자열 **계층** 선택 또는 아카이브 가져오기에 사용할 데이터 액세스 계층입니다. *유효한 값*: `Bulk` \| `Expedited` \| `Standard` *유형*: 문자열 **VaultARN** 작업이 하위 리소스인 볼트의 Amazon 리소스 이름(ARN)입니다. *유형*: 문자열 ### 오류 Amazon Glacier 예외 및 오류 메시지에 대한 자세한 내용은 [오류 응답](api-error-responses.md) 섹션을 참조하세요. ## 예제 다음은 아카이브 가져오기 작업을 요청하는 예제입니다. ### 요청 예제: 작업 설명 가져오기 ``` 1. GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 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 ``` ### 응답의 예 응답 본문에는 지정한 작업을 설명하는 JSON이 포함됩니다. 이때 인벤토리 가져오기 작업 및 아카이브 가져오기 작업의 경우 JSON 필드는 동일합니다. 하지만 필드가 작업 유형에 적용되지 않을 때는 `null` 값을 갖습니다. 다음은 아카이브 가져오기 작업의 응답 예제입니다. 다음 사항에 유의하세요. + `Action` 필드 값은 `ArchiveRetrieval`입니다. + `ArchiveSizeInBytes` 필드는 아카이브 가져오기 작업에서 요청하는 아카이브의 크기를 나타냅니다. + `ArchiveSHA256TreeHash` 필드는 전체 아카이브에 대한 SHA256 트리-해시를 나타냅니다. + `RetrievalByteRange` 필드는 작업 시작 요청에서 요청하는 범위를 나타냅니다. 이 예제에서는 전체 아카이브를 요청합니다. + `SHA256TreeHash` 필드는 작업 시작 요청에서 요청하는 범위에 대한 SHA256 트리-해시를 나타냅니다. 이 예제에서는 `ArchiveSHA256TreeHash` 필드와 동일하며, 이는 전체 아카이브를 요청했다는 것을 의미합니다. + `InventorySizeInBytes` 필드는 아카이브 가져오기 작업에 적용되지 않기 때문에 `null` 값을 갖습니다. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Content-Type: application/json 5. Content-Length: 419 6. { 7. "Action": "ArchiveRetrieval", 8. "ArchiveId": "NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId", 9. "ArchiveSizeInBytes": 16777216, 10. "ArchiveSHA256TreeHash": "beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60", 11. "Completed": false, 12. "CompletionDate": null, 13. "CreationDate": "2012-05-15T17:21:39.339Z", 14. "InventorySizeInBytes": null, 15. "JobDescription": "My ArchiveRetrieval Job", 16. "JobId": "HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID", 17. "RetrievalByteRange": "0-16777215", 18. "SHA256TreeHash": "beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60", 19. "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic", 20. "StatusCode": "InProgress", 21. "StatusMessage": "Operation in progress.", 22. "Tier": "Bulk", 23. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 24. } ``` 다음은 인벤토리 가져오기 작업의 응답 예제입니다. 다음 사항에 유의하세요. + `Action` 필드 값은 `InventoryRetrieval`입니다. + `ArchiveSizeInBytes`, `ArchiveSHA256TreeHash` 및 `RetrievalByteRange` 필드는 인벤토리 가져오기 작업에 적용되지 않기 때문에 null 값을 갖습니다. + 작업이 여전히 진행 중이고 다운로드할 인벤토리가 완전히 준비되지 않았기 때문에 `InventorySizeInBytes` 필드 값은 `null`입니다. 하지만 작업 설명 요청 전에 작업이 완료되었다면 이 필드에서 출력 크기가 반환됩니다. ``` { "Action": "InventoryRetrieval", "ArchiveId": null, "ArchiveSizeInBytes": null, "ArchiveSHA256TreeHash": null, "Completed": false, "CompletionDate": null, "CreationDate": "2012-05-15T23:18:13.224Z", "InventorySizeInBytes": null, "JobDescription": "Inventory Description", "JobId": "HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID", "RetrievalByteRange": null, "SHA256TreeHash": null, "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic", "StatusCode": "InProgress", "StatusMessage": "Operation in progress.", "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" } ``` 다음은 볼트 인벤토리 가져오기의 페이지 매김을 계속하는 데 사용되는 마커를 포함하는 완료된 인벤토리 가져오기 작업의 응답 예제입니다. ``` { "Action": "InventoryRetrieval", "ArchiveId": null, "ArchiveSHA256TreeHash": null, "ArchiveSizeInBytes": null, "Completed": true, "CompletionDate": "2013-12-05T21:51:13.591Z", "CreationDate": "2013-12-05T21:51:12.281Z", "InventorySizeInBytes": 777062, "JobDescription": null, "JobId": "sCC2RZNBF2nildYD_roe0J9bHRdPQUbDRkmTdg-mXi2u3lc49uW6TcEhDF2D9pB2phx-BN30JaBru7PMyOlfXHdStzu8", "NextInventoryRetrievalMarker": null, "RetrievalByteRange": null, "SHA256TreeHash": null, "SNSTopic": null, "StatusCode": "Succeeded", "StatusMessage": "Succeeded", "Tier": "Bulk", "VaultARN": "arn:aws:glacier-devo:us-west-2:836579025725:vaults/inventory-icecube-2", "InventoryRetrievalParameters": { "StartDate": "2013-11-12T13:43:12Z", "EndDate": "2013-11-20T08:12:45Z", "Limit": "120000", "Format": "JSON", "Marker": "vyS0t2jHQe5qbcDggIeD50chS1SXwYMrkVKo0KHiTUjEYxBGCqRLKaiySzdN7QXGVVV5XZpNVG67pCZ_uykQXFMLaxOSu2hO_-5C0AtWMDrfo7LgVOyfnveDRuOSecUo3Ueq7K0" }, } ``` ## 관련 섹션 + [작업 출력 가져오기(GET output)](api-job-output-get.md) + [Amazon Glacier의 ID 및 액세스 관리(IAM)](security-iam.md)