**이 페이지는 볼트와 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** + [작업 설명(GET JobID)](api-describe-job-get.md) + [작업 출력 가져오기(GET output)](api-job-output-get.md) + [작업 시작(POST jobs)](api-initiate-job-post.md) + [작업 목록 조회(GET jobs)](api-jobs-get.md) # 작업 설명(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` \$1 `Succeeded` \$1 `Failed` *유형*: 문자열 **StatusMessage** 쉽게 이해할 수 있도록 작업 상태를 설명하는 메시지입니다. *유형*: 문자열 **계층** 선택 또는 아카이브 가져오기에 사용할 데이터 액세스 계층입니다. *유효한 값*: `Bulk` \$1 `Expedited` \$1 `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) # 작업 출력 가져오기(GET output) ## 설명 이 작업에서는 [작업 시작(POST jobs)](api-initiate-job-post.md)를 사용하여 시작한 작업의 출력을 다운로드합니다. 작업을 시작할 때 지정한 작업 유형에 따라서 출력 내용은 아카이브 또는 볼트 인벤토리가 될 수 있습니다. 모든 작업 출력을 다운로드하거나, 바이트 범위를 지정하여 출력 일부를 다운로드할 수도 있습니다. 아카이브 가져오기 작업과 인벤토리 가져오기 작업 모두 다운로드 크기를 **작업 출력 가져오기** 응답에서 헤더로 반환되는 크기와 비교하여 맞는지 확인해야 합니다. 아카이브 가져오기 작업일 때는 다운로드 크기가 예상되는 크기와 맞는지도 확인해야 합니다. 출력 일부만 다운로드하는 경우에는 예상되는 크기가 지정한 바이트 범위에 따라 달라집니다. 예를 들어 범위를 `bytes=0-1048575`로 지정하는 경우에는 다운로드 크기가 1,048,576바이트이어야 합니다. 전체 아카이브를 다운로드하는 경우 예상 크기는 Amazon Glacier(Amazon Glacier)에 아카이브를 업로드했을 때의 크기입니다. 예상되는 크기는 **작업 출력 가져오기** 응답에서 헤더로도 반환됩니다. 아카이브 가져오기 작업의 경우, 지정하는 바이트 범위에 따라서 Amazon Glacier가 데이터 부분에 대한 체크섬을 반환합니다. 다운로드한 부분이 정확한 데이터인지 확인하려면 클라이언트에서 체크섬을 계산하여 값이 일치하는지, 그리고 예상한 크기가 맞는지도 함께 확인합니다. 작업 ID는 Amazon Glacier가 작업을 완료한 후 최소 24시간 동안 만료되지 않습니다. 다시 말해서 Amazon Glacier가 작업을 완료한 후 24시간 안에는 언제든지 작업 출력을 다운로드할 수 있습니다. ## Requests ### 구문 작업 출력을 가져오려면 HTTP `GET` 요청을 특정 작업의 `output` URI로 전송합니다. ``` 1. GET /AccountId/vaults/VaultName/jobs/JobID/output HTTP/1.1 2. Host: glacier.Region.amazonaws.com 3. Date: Date 4. Authorization: SignatureValue 5. Range: ByteRangeToRetrieve 6. x-amz-glacier-version: 2012-06-01 ``` **참고** `AccountId` 값은 볼트를 소유한 계정의 AWS 계정 ID입니다. AWS 계정 ID를 지정하거나 선택적으로 단일 '`-`'(하이픈)를 지정할 수 있습니다.이 경우 Amazon Glacier는 요청에 서명하는 데 사용되는 자격 증명과 연결된 AWS 계정 ID를 사용합니다. 계정 ID를 사용하는 경우 ID에 하이픈('-')을 포함할 수 없습니다. ### 요청 파라미터 이 작업은 요청 파라미터를 사용하지 않습니다. ### 요청 헤더 이 작업은 모든 작업에 일반적인 요청 헤더 외에 다음 요청 헤더를 사용합니다. 일반적인 요청 헤더에 대한 자세한 내용은 [공통 요청 헤더](api-common-request-headers.md) 섹션을 참조하세요. | 이름 | 설명 | 필수 | | --- | --- | --- | | Range | 출력에서 가져올 바이트 범위입니다. 예를 들어 첫 번째 1,048,576바이트를 다운로드하려면 범위를 `bytes=0-1048575`로 지정합니다. 자세한 내용은 [Range 헤더 필드 정의](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35) 섹션을 참조하세요. 범위는 작업 시작 요청에서 지정하는 범위에 비례합니다. 기본적으로 이 작업에서는 전체 출력을 다운로드합니다. 작업 출력 크기가 큰 경우에는 `Range` 요청 헤더를 사용하여 출력 중 일부를 가져올 수 있습니다. 이 경우 전체 출력을 작은 바이트 청크로 나누어 다운로드할 수 있습니다. 예를 들어 1GB의 작업 출력을 한 번에 128MB씩 데이터 청크로 나누어 다운로드하여 작업 출력 가져오기 요청을 총 8번 전송한다고 가정하겠습니다. 이때는 다음 프로세스에 따라 작업 출력을 다운로드합니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/amazonglacier/latest/dev/api-job-output-get.html) 유형: 문자열 기본값: None 제약 조건: 없음 | 아니요 | ### 요청 본문 이 작업에는 요청 본문이 없습니다. ## 응답 ### 구문 모든 작업 데이터를 반환하는 가져오기 요청이 전송되면 작업 출력 응답으로 `200 OK` 응답 코드가 반환됩니다. 내용을 부분적으로 요청할 때, 예를 들어 요청에서 `Range` 헤더를 지정하면 응답 코드로 `206 Partial Content`가 반환됩니다. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: x-amzn-RequestId 3. Date: Date 4. Content-Type: ContentType 5. Content-Length: Length 6. x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier 7. 8. [Body containing job output.] ``` ### 응답 헤더 | 헤더 | 설명 | | --- | --- | | Content-Range | Amazon Glacier가 반환하는 바이트 범위입니다. 부분적 출력만 다운로드하는 경우에는 응답에서 Amazon Glacier가 반환한 바이트 범위를 보여줍니다. 예를 들어 `bytes 0-1048575/8388608`는 8MB에서 첫 번째 1MB를 반환합니다. `Content-Range` 헤더에 대한 자세한 내용은 [Content-Range 헤더 필드 정의](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.16) 섹션을 참조하세요. 유형: 문자열 | | Content-Type | Content-Type은 작업 출력이 아카이브인지 또는 볼트 인벤토리인지에 따라 달라집니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/amazonglacier/latest/dev/api-job-output-get.html) 유형: 문자열 | | x-amz-sha256-tree-hash​ | 응답으로 반환되는 데이터 체크섬입니다. 이 헤더는 아카이브 가져오기 작업에 대한 출력을 가져올 때만 반환됩니다. 또한 이 헤더는 작업 시작 요청에서 요청한 데이터 범위가 트리-해시로 정렬되고, 작업 출력 가져오기에서 다운로드되는 범위 또한 트리-해시로 정렬될 경우에 표시됩니다. 트리-해시 정렬 범위에 대한 자세한 내용은 [데이터 다운로드 시 체크섬 수신](checksum-calculations-range.md) 섹션을 참조하세요. 예를 들어 작업 시작 요청에서 가져올 트리-해시 정렬 범위(전체 아카이브 포함)를 지정한 경우에는 다음 조건 하에서 다운로드하는 데이터의 체크섬이 수신됩니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/amazonglacier/latest/dev/api-job-output-get.html) 유형: 문자열 | ### 응답 본문 Amazon Glacier는 작업 출력을 응답 본문에 반환합니다. 이때 출력은 작업 유형에 따라 아카이브 내용 또는 볼트 인벤토리가 될 수 있습니다. 볼트 인벤토리의 경우에는 기본적으로 인벤토리 목록이 아래와 같은 JSON 본문으로 반환됩니다. ``` 1. { 2. "VaultARN": String, 3. "InventoryDate": String, 4. "ArchiveList": [ 5. {"ArchiveId": String, 6. "ArchiveDescription": String, 7. "CreationDate": String, 8. "Size": Number, 9. "SHA256TreeHash": String 10. }, 11. ... 12. ] 13. } ``` 볼트 인벤토리 작업을 시작할 때 CSV(쉼표로 구분된 값) 출력 형식을 요청한 경우 볼트 인벤토리가 본문에서 CSV 형식으로 반환됩니다. CSV 형식에는 "ArchiveId", "ArchiveDescription", "CreationDate", "Size", "SHA256TreeHash" 등 열이 5개 있으며, 각 열의 정의는 해당하는 JSON 필드와 같습니다. **참고** 반환된 CSV 형식에서는 전체 필드가 큰따옴표로 묶여서 반환될 수 있습니다. 쉼표 또는 큰따옴표가 포함된 필드는 항상 큰따옴표로 묶여서 반환됩니다. 예를 들어 `my archive description,1`은 `"my archive description,1"`로 반환됩니다. 큰따옴표로 묶여서 반환되는 필드에 포함된 큰따옴표 문자는 앞에 백슬래시 문자와 함께 *이스케이프 처리됩니다*. 예를 들어 `my archive description,1"2`는 `"my archive description,1\"2"`로, 그리고 `my archive description,1\"2`는 `"my archive description,1\\"2"`로 반환됩니다. 백슬래시 문자는 이스케이프 처리되지 않습니다. JSON 응답 본문에는 다음과 같은 JSON 필드가 포함됩니다. **ArchiveDescription** 아카이브에 대한 설명입니다. *유형*: 문자열 **ArchiveId** 아카이브 ID입니다. *유형*: 문자열 **ArchiveList** 아카이브 메타데이터의 배열입니다. 이 배열을 구성하는 객체는 각각 볼트에 저장된 아카이브 1개의 메타데이터를 나타냅니다. *유형*: 배열 **CreationDate** 아카이브가 생성된 UTC 날짜와 시간입니다. *유형*: ISO 8601 날짜 형식의 문자열 표현입니다. 예: `2013-03-20T17:03:43.221Z` **InventoryDate** 볼트 변경 이후 마지막으로 작성된 볼트 인벤토리의 UTC 날짜와 시간입니다. Amazon Glacier가 하루에 한 번 볼트 인벤토리를 준비하지만, 마지막 인벤토리 이후 볼트에 아카이브 추가 또는 삭제가 있는 경우에만 인벤토리 날짜가 업데이트됩니다. *유형*: ISO 8601 날짜 형식의 문자열 표현입니다. 예: `2013-03-20T17:03:43.221Z` **SHA256TreeHash** 아카이브의 트리-해시입니다. *유형*: 문자열 **Size**: 아카이브 크기(바이트)입니다. *형식*: 숫자 **VaultARN** 아카이브 가져오기가 요청된 Amazon 리소스 이름(ARN) 리소스입니다. *유형*: 문자열 ### 오류 Amazon Glacier 예외 및 오류 메시지에 대한 자세한 내용은 [오류 응답](api-error-responses.md) 섹션을 참조하세요. ## 예제 다음은 아카이브 가져오기 작업을 요청하는 예제입니다. ### 예제 1: 출력 다운로드 이 예는 아카이브 가져오기 작업 시작 요청에 대한 응답으로 Amazon Glacier가 준비한 데이터를 가져옵니다. #### 요청 예시 ``` 1. GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/output 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 ``` #### 응답의 예 다음은 아카이브 가져오기 작업의 응답 예제입니다. 예제를 보면 `Content-Type` 헤더가 `application/octet-stream`이고, `x-amz-sha256-tree-hash` 헤더가 응답에 포함되어 있습니다. 이 말은 모든 작업 데이터가 반환된다는 것을 의미합니다. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60 4. Date: Wed, 10 Feb 2017 12:00:00 GMT 5. Content-Type: application/octet-stream 6. Content-Length: 1048576 7. 8. [Archive data.] ``` 다음은 인벤토리 가져오기 작업의 응답 예제입니다. 예제를 보면 `Content-Type` 헤더가 `application/json`입니다. 또한 응답에 `x-amz-sha256-tree-hash` 헤더가 포함되어 있지 않습니다. ``` 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: 906 6. 7. { 8. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault", 9. "InventoryDate": "2011-12-12T14:19:01Z", 10. "ArchiveList": [ 11. { 12. "ArchiveId": "DMTmICA2n5Tdqq5BV2z7og-A20xnpAPKt3UXwWxdWsn_D6auTUrW6kwy5Qyj9xd1MCE1mBYvMQ63LWaT8yTMzMaCxB_9VBWrW4Jw4zsvg5kehAPDVKcppUD1X7b24JukOr4mMAq-oA", 13. "ArchiveDescription": "my archive1", 14. "CreationDate": "2012-05-15T17:19:46.700Z", 15. "Size": 2140123, 16. "SHA256TreeHash": "6b9d4cf8697bd3af6aa1b590a0b27b337da5b18988dbcc619a3e608a554a1e62" 17. }, 18. { 19. "ArchiveId": "2lHzwhKhgF2JHyvCS-ZRuF08IQLuyB4265Hs3AXj9MoAIhz7tbXAvcFeHusgU_hViO1WeCBe0N5lsYYHRyZ7rrmRkNRuYrXUs_sjl2K8ume_7mKO_0i7C-uHE1oHqaW9d37pabXrSA", 20. "ArchiveDescription": "my archive2", 21. "CreationDate": "2012-05-15T17:21:39.339Z", 22. "Size": 2140123, 23. "SHA256TreeHash": "7f2fe580edb35154041fa3d4b41dd6d3adaef0c85d2ff6309f1d4b520eeecda3" 24. } 25. ] 26. } ``` ### 예제 2: 부분 출력 다운로드 이 예는 아카이브 가져오기 작업 시작 요청에 대한 응답으로 Amazon Glacier가 준비한 아카이브의 일부만 가져옵니다. 요청에서는 옵션 `Range` 헤더를 사용하여 첫 번째 1,024바이트만 가져옵니다. #### 요청 예시 ``` 1. GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/output HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. Range: bytes=0-1023 5. x-amz-glacier-version: 2012-06-01 6. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 ``` #### 응답의 예 다음 성공적인 응답에서는 `206 Partial Content` 응답을 보여줍니다. 이 경우 Amazon Glacier가 반환하는 바이트 범위를 지정하는 `Content-Range` 헤더도 응답에 포함됩니다. ``` 1. HTTP/1.1 206 Partial Content 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Content-Range: bytes 0-1023/8388608 5. Content-Type: application/octet-stream 6. Content-Length: 1024 7. 8. [Archive data.] ``` ## 관련 섹션 + [작업 설명(GET JobID)](api-describe-job-get.md) + [작업 시작(POST jobs)](api-initiate-job-post.md) + [Amazon Glacier의 ID 및 액세스 관리(IAM)](security-iam.md) # 작업 시작(POST jobs) 이 작업은 다음 유형의 Amazon Glacier(Amazon Glacier) 작업을 시작합니다. + `archive-retrieval`: 아카이브 가져오기 + `inventory-retrieval`: 볼트 인벤토리 작성 **Topics** + [아카이브 또는 볼트 인벤토리 가져오기 작업 시작](#api-initiate-job-post-description) + [Requests](#api-initiate-job-post-requests) + [응답](#api-initiate-job-post-responses) + [예제](#api-initiate-job-post-examples) + [관련 섹션](#more-info-api-initiate-job-post) ## 아카이브 또는 볼트 인벤토리 가져오기 작업 시작 아카이브 또는 볼트 인벤토리 가져오기는 비동기식 작업이기 때문에 먼저 작업을 시작해야 합니다. 일단 시작되면 작업을 취소할 수 없습니다. 가져오기 작업은 2단계 프로세스로 구성됩니다. 1. [작업 시작(POST jobs)](#api-initiate-job-post) 작업을 사용하여 가져오기 작업을 시작합니다. **중요** 데이터 가져오기 정책으로 인해 가져오기 작업 시작 요청이 `PolicyEnforcedException`과 함께 실패할 수 있습니다. 데이터 가져오기 정책에 대한 자세한 내용은 [Amazon Glacier 데이터 검색 정책](data-retrieval-policy.md) 섹션을 참조하세요. `PolicyEnforcedException` 예외에 대한 자세한 내용은 [오류 응답](api-error-responses.md) 섹션을 참조하세요. 1. 작업이 완료된 후 [작업 출력 가져오기(GET output)](api-job-output-get.md) 작업을 사용하여 바이트를 다운로드합니다. 가져오기 요청은 비동기식으로 실행됩니다. 가져오기 작업을 시작하면 Amazon Glacier가 작업을 생성한 후 응답으로 작업 ID를 반환합니다. Amazon Glacier가 작업을 완료하면 작업 출력(아카이브 또는 인벤토리 데이터)을 가져올 수 있습니다. 작업 출력 가져오기에 대한 자세한 내용은 [작업 출력 가져오기(GET output)](api-job-output-get.md) 작업을 참조하세요. 작업 출력을 가져오려면 먼저 작업을 완료해야 합니다. 작업 완료 시기는 다음과 같은 옵션으로 알 수 있습니다. + **Amazon SNS 알림 사용**: 작업이 완료된 후 사용자는 Amazon Glacier가 알림 메시지를 게시할 수 있는 Amazon SNS 토픽을 지정할 수 있습니다. 작업 요청 1건당 SNS 토픽 1개를 지정할 수 있습니다. 알림 메시지는 Amazon Glacier가 작업을 마친 후에만 전송됩니다. 작업 요청 1건당 SNS 토픽을 1개 지정하는 것 외에도 모든 가져오기 작업에서 작업 알림 메시지를 전송할 수 있도록 볼트 알림을 구성할 수 있습니다. 자세한 내용은 [볼트 알림 구성 설정(PUT notification-configuration)](api-vault-notifications-put.md) 단원을 참조하십시오. + **작업 세부 정보 가져오기**: 작업이 진행 중일 때 [작업 설명(GET JobID)](api-describe-job-get.md) 요청을 통해 작업 상태 정보를 가져올 수 있습니다. 그러나 Amazon SNS 알림을 사용하여 작업 완료 시점을 확인하는 방법이 더욱 효율적입니다. **참고** 알림 메시지를 통해 가져오는 정보는 [작업 설명(GET JobID)](api-describe-job-get.md)을 호출하여 가져오는 정보와 동일합니다. 특정 이벤트에 대해 볼트에 알림 구성을 추가하고 작업 시작을 요청할 때 SNS 토픽을 지정하면 Amazon Glacier는 두 알림 메시지를 모두 전송합니다. 자세한 내용은 [볼트 알림 구성 설정(PUT notification-configuration)](api-vault-notifications-put.md) 단원을 참조하십시오. ### 볼트 인벤토리 Amazon Glacier는 아카이브를 볼트에 처음 업데이트한 날짜부터 대략 하루에 한 번씩 볼트 인벤토리를 업데이트합니다. 마지막 인벤토리 이후 볼트에 대한 아카이브 추가 또는 삭제가 없는 경우에는 인벤토리 데이터가 업데이트되지 않습니다. 볼트 인벤토리 작업이 시작되면 Amazon Glacier는 마지막으로 생성한 인벤토리, 즉 실시간 데이터가 아닌 특정 시점 스냅샷을 반환합니다. Amazon Glacier가 볼트를 위한 첫 번째 인벤토리를 생성한 뒤, 인벤토리 가져오기가 가능해지기까지는 일반적으로 반나절에서 하루가 걸립니다. 아카이브를 업로드할 때마다 볼트 인벤토리를 가져오는 것이 불필요하다고 생각할 수도 있습니다. 그러나 Amazon Glacier에 업로드하는 아카이브에 대한 메타데이터를 연결하여 클라이언트 측에서 데이터베이스를 관리한다고 가정해보겠습니다. 볼트 인벤토리가 필요에 따라 데이터베이스 정보와 실제 볼트 인벤토리를 서로 조정하는 데 얼마나 유용한지 알게 될 것입니다. 인벤토리 작업 출력으로 반환되는 데이터 필드에 대한 자세한 내용은 [응답 본문](api-job-output-get.md#api-job-output-get-responses-elements) 섹션을 참조하세요. ### 범위가 지정된 인벤토리 가져오기 아카이브 생성 날짜를 기준으로 필터링하거나 제한을 설정하여 가져오는 인벤토리 항목 수를 제한할 수 있습니다. **아카이브 생성 날짜에 따른 필터링** 아카이브가 `StartDate`와 `EndDate` 사이에서 생성되었을 때 **작업 시작** 요청에서 두 파라미터 값을 지정하여 인벤토리 항목을 가져올 수 있습니다. 그러면 `StartDate` 당일 또는 이후 및 `EndDate` 이전에 생성된 아카이브가 반환됩니다. `EndDate` 없이 `StartDate`만 입력하면 `StartDate` 당일 또는 이후에 생성된 모든 아카이브의 인벤토리를 가져옵니다. 반대로 `StartDate` 없이 `EndDate`만 입력하면 `EndDate` 이전에 생성된 모든 아카이브의 인벤토리를 다시 가져옵니다. **가져오기 1건당 인벤토리 항목 수 제한** **작업 시작** 요청에서 `Limit` 파라미터를 설정하여 반환되는 인벤토리 항목 수를 제한할 수 있습니다. 그러면 지정된 `Limit`까지의 인벤토리 항목이 인벤토리 작업 출력에 포함됩니다. 인벤토리 항목이 더 있는 경우에는 결과에 페이지가 매겨집니다. 작업을 마친 후 [작업 설명(GET JobID)](api-describe-job-get.md) 작업을 통해 후속 **작업 시작** 요청에서 사용하는 마커를 확인할 수 있습니다. 마커는 다음 인벤토리 항목 집합을 가져오는 시작점을 나타냅니다. 이전 **작업 설명** 출력의 마커로 **작업 시작** 요청을 반복 생성해 전체 인벤토리를 페이지별로 살펴볼 수 있습니다. null을 반환하는 **작업 설명** 마커를 얻을 때까지 이를 계속합니다. null은 사용할 수 있는 인벤토리 항목이 더 이상 없음을 나타냅니다. `Limit` 파라미터는 날짜 범위 파라미터와 함께 사용할 수 있습니다. ### 범위가 지정된 아카이브 가져오기 아카이브 가져오기는 아카이브 전체 또는 범위로 시작할 수 있습니다. 범위를 지정하여 아카이브를 가져올 때는 반환할 바이트 범위 또는 전체 아카이브를 지정합니다. 지정하는 범위는 메가바이트(MB)로 정렬되어야 합니다. 다시 말해 범위의 시작 값이 1MB로 나누어져야 하고, 범위의 종료 값 \$1 1이 1MB로 나누어지거나 아카이브의 끝과 같아야 합니다. 범위가 지정된 아카이브 가져오기가 메가바이트 정렬을 따르지 않으면 `400` 응답이 반환됩니다. 그 밖에 **작업 출력 가져오기**([작업 출력 가져오기(GET output)](api-job-output-get.md))를 사용해 다운로드하는 데이터의 체크섬 값을 가져오려면 범위가 트리-해시로 정렬되어야 합니다. 트리-해시 정렬 범위에 대한 자세한 내용은 [데이터 다운로드 시 체크섬 수신](checksum-calculations-range.md) 섹션을 참조하세요. ### 신속, 표준, 벌크 계층 아카이브 검색 작업을 시작할 때 요청 본문의 `Tier` 필드에서 다음 옵션 중 하나를 지정할 수 있습니다. + **`Expedited`**: 신속 계층을 사용하면 아카이브 복원에 대한 긴급 요청이 필요한 경우, 빠르게 데이터에 액세스할 수 있습니다. 가장 큰 아카이브(250MB\$1)를 제외한 모든 아카이브의 경우 신속 계층을 사용하여 액세스되는 데이터는 일반적으로 1\$15분 안에 사용할 수 있습니다. + **`Standard`**: 표준 계층을 사용하면 몇 시간 내에 모든 아카이브에 액세스할 수 있습니다. 표준 계층을 사용하여 액세스하는 데이터는 일반적으로 3\$15시간 안에 사용할 수 있습니다. 이 옵션은 계층 옵션을 지정하지 않는 작업 요청의 기본 옵션입니다. + **`Bulk`**: 벌크 계층은 Amazon Glacier에서 가장 저렴한 계층으로서 페타바이트 단위의 대용량 데이터도 저렴한 비용으로 하루 만에 가져올 수 있습니다. 벌크 계층을 사용하여 액세스하는 데이터는 일반적으로 5\$112시간 안에 사용할 수 있습니다. 신속 및 벌크 가져오기에 대한 자세한 내용은 [Amazon Glacier 아카이브 가져오기](downloading-an-archive-two-steps.md) 섹션을 참조하세요. ## Requests 작업을 시작하려면 HTTP `POST` 메서드를 사용하여 작업 요청을 볼트의 `jobs` 하위 리소스로 전송합니다. 또한 요청의 JSON 문서에서 작업 요청에 대한 세부 정보를 지정합니다. 작업 유형은 `Type` 필드로 지정됩니다. 필요하다면 `SNSTopic` 필드를 지정하여 Amazon Glacier가 작업 완료 후 알림 메시지를 게시할 수 있는 Amazon SNS 토픽을 나타낼 수 있습니다. **참고** 토픽이 존재하지 않는 경우, 알림 메시지를 Amazon SNS에 게시하려면 토픽을 직접 생성해야 합니다. Amazon Glacier는 사용자를 위해 토픽을 생성하지 않습니다. 토픽에는 Amazon Glacier 볼트의 게시물을 수신할 권한이 있어야 합니다. Amazon Glacier는 볼트가 토픽을 게시할 권한이 있는지 확인하지 않습니다. 권한이 올바로 구성되어 있지 않으면 작업이 완료되더라도 알림 메시지가 수신되지 않을 수도 있습니다. ### 구문 다음은 작업 시작을 위한 요청 구문입니다. ``` 1. POST /AccountId/vaults/VaultName/jobs HTTP/1.1 2. Host: glacier.Region.amazonaws.com 3. Date: Date 4. Authorization: SignatureValue 5. x-amz-glacier-version: 2012-06-01 6. 7. { 8. "jobParameters": { 9. "ArchiveId": "string", 10. "Description": "string", 11. "Format": "string", 12. "InventoryRetrievalParameters": { 13. "EndDate": "string", 14. "Limit": "string", 15. "Marker": "string", 16. "StartDate": "string" 17. }, 18. "OutputLocation": { 19. "S3": { 20. "AccessControlList": [ 21. { 22. "Grantee": { 23. "DisplayName": "string", 24. "EmailAddress": "string", 25. "ID": "string", 26. "Type": "string", 27. "URI": "string" 28. }, 29. "Permission": "string" 30. } 31. ], 32. "BucketName": "string", 33. "CannedACL": "string", 34. "Encryption": { 35. "EncryptionType": "string", 36. "KMSContext": "string", 37. "KMSKeyId": "string" 38. }, 39. "Prefix": "string", 40. "StorageClass": "string", 41. "Tagging": { 42. "string" : "string" 43. }, 44. "UserMetadata": { 45. "string" : "string" 46. } 47. } 48. }, 49. "RetrievalByteRange": "string", 50. "SelectParameters": { 51. "Expression": "string", 52. "ExpressionType": "string", 53. "InputSerialization": { 54. "csv": { 55. "Comments": "string", 56. "FieldDelimiter": "string", 57. "FileHeaderInfo": "string", 58. "QuoteCharacter": "string", 59. "QuoteEscapeCharacter": "string", 60. "RecordDelimiter": "string" 61. } 62. }, 63. "OutputSerialization": { 64. "csv": { 65. "FieldDelimiter": "string", 66. "QuoteCharacter": "string", 67. "QuoteEscapeCharacter": "string", 68. "QuoteFields": "string", 69. "RecordDelimiter": "string" 70. } 71. } 72. }, 73. "SNSTopic": "string", 74. "Tier": "string", 75. "Type": "string" 76. } 77. } ``` **참고** `AccountId` 값은 볼트를 소유한 계정의 AWS 계정 ID입니다. AWS 계정 ID를 지정하거나 선택적으로 단일 '`-`'(하이픈)를 지정할 수 있습니다.이 경우 Amazon Glacier는 요청에 서명하는 데 사용되는 자격 증명과 연결된 AWS 계정 ID를 사용합니다. 계정 ID를 사용하는 경우 ID에 하이픈('-')을 포함할 수 없습니다. ### 요청 본문 요청은 요청 본문에서 JSON 형식의 다음 데이터를 받습니다. jobParameters 작업 정보를 지정하기 위한 옵션을 제공합니다. *유형*: [jobParameters](api-jobParameters.md) 객체 *필수 항목 여부:* 예 ## 응답 Amazon Glacier가 작업을 생성합니다. 응답으로 작업 URI를 반환합니다. ### 구문 ``` 1. HTTP/1.1 202 Accepted 2. x-amzn-RequestId: x-amzn-RequestId 3. Date: Date 4. Location: location 5. x-amz-job-id: jobId 6. x-amz-job-output-path: jobOutputPath ``` ### 응답 헤더 | 헤더 | 설명 | | --- | --- | | Location | 작업의 상대적 URI 경로입니다. 이 URI 경로를 사용해 작업 상태를 알아볼 수 있습니다. 자세한 내용은 [작업 설명(GET JobID)](api-describe-job-get.md) 단원을 참조하십시오. 유형: 문자열 기본값: None | | x-amz-job-id | 작업 ID입니다. 이 값은 `Location` 헤더에도 포함됩니다. 유형: 문자열 기본값: None | | x-amz-job-output-path | 선택 결과가 저장되는 위치의 경로입니다. 유형: 문자열 기본값: None | ### 응답 본문 이 작업은 응답 본문을 반환하지 않습니다. ### 오류 이 작업에는 모든 Amazon Glacier 작업에 일반적으로 발생할 수 있는 오류 외에 다음 오류도 포함됩니다. Amazon Glacier의 오류에 대한 자세한 내용과 오류 코드 목록은 [오류 응답](api-error-responses.md) 섹션을 참조하세요. | 코드 | 설명 | HTTP 상태 코드 | Type | | --- | --- | --- | --- | | InsufficientCapacityException | 신속 요청을 처리할 수 있는 용량이 부족한 경우에 반환됩니다. 이 오류는 신속 가져오기에만 적용되며 표준 또는 벌크 가져오기에는 적용되지 않습니다. | 503 Service Unavailable | Server | ## 예제 ### 요청 예제: 아카이브 가져오기 작업 시작 ``` 1. POST /-/vaults/examplevault/jobs 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 6. 7. { 8. "Type": "archive-retrieval", 9. "ArchiveId": "NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId", 10. "Description": "My archive description", 11. "SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-ArchiveRetrieval-topic-Example", 12. "Tier" : "Bulk" 13. } ``` 다음은 요청 본문의 `RetrievalByteRange` 필드를 사용하여 가져올 아카이브 범위를 지정하는 예제입니다. ``` { "Type": "archive-retrieval", "ArchiveId": "NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId", "Description": "My archive description", "RetrievalByteRange": "2097152-4194303", "SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-ArchiveRetrieval-topic-Example", "Tier" : "Bulk" } ``` ### 응답의 예 ``` 1. HTTP/1.1 202 Accepted 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 5. x-amz-job-id: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID ``` ### 요청 예제: 인벤토리 가져오기 작업 시작 다음은 인벤토리 가져오기 작업을 시작하여 `examplevault` 볼트에서 아카이브 목록을 가져오는 요청 예제입니다. 요청 본문에서 `Format`이 `CSV`로 설정되어 있으므로 인벤토리가 CSV 형식으로 반환된다는 것을 의미합니다. ``` 1. POST /-/vaults/examplevault/jobs HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. Content-Type: application/x-www-form-urlencoded 5. x-amz-glacier-version: 2012-06-01 6. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 7. 8. { 9. "Type": "inventory-retrieval", 10. "Description": "My inventory job", 11. "Format": "CSV", 12. "SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-InventoryRetrieval-topic-Example" 13. } ``` ### 응답의 예 ``` 1. HTTP/1.1 202 Accepted 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 5. x-amz-job-id: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID ``` ### 요청 예제: 한도가 설정된 날짜 필터링을 사용하여 인벤토리 가져오기 작업을 시작하고, 다음 인벤토리 항목 페이지를 가져오기 위한 후속 요청을 시작합니다. 다음은 날짜 필터링을 사용하고 한도를 설정하여 볼트 인벤토리 가져오기 작업을 시작하는 요청 예제입니다. ``` 1. { 2. "ArchiveId": null, 3. "Description": null, 4. "Format": "CSV", 5. "RetrievalByteRange": null, 6. "SNSTopic": null, 7. "Type": "inventory-retrieval", 8. "InventoryRetrievalParameters": { 9. "StartDate": "2013-12-04T21:25:42Z", 10. "EndDate": "2013-12-05T21:25:42Z", 11. "Limit" : "10000" 12. }, 13. } ``` 다음은 [작업 설명(GET JobID)](api-describe-job-get.md)에서 가져온 마커를 사용하여 다음 인벤토리 항목 페이지를 가져오는 후속 요청의 예제입니다. ``` 1. { 2. "ArchiveId": null, 3. "Description": null, 4. "Format": "CSV", 5. "RetrievalByteRange": null, 6. "SNSTopic": null, 7. "Type": "inventory-retrieval", 8. "InventoryRetrievalParameters": { 9. "StartDate": "2013-12-04T21:25:42Z", 10. "EndDate": "2013-12-05T21:25:42Z", 11. "Limit": "10000", 12. "Marker": "vyS0t2jHQe5qbcDggIeD50chS1SXwYMrkVKo0KHiTUjEYxBGCqRLKaiySzdN7QXGVVV5XZpNVG67pCZ_uykQXFMLaxOSu2hO_-5C0AtWMDrfo7LgVOyfnveDRuOSecUo3Ueq7K0" 13. }, 14. } ``` ### 응답의 예 ``` 1. HTTP/1.1 202 Accepted 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 5. x-amz-job-id: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 6. x-amz-job-output-path: test/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/ ``` ## 관련 섹션 + [작업 설명(GET JobID)](api-describe-job-get.md) + [작업 출력 가져오기(GET output)](api-job-output-get.md) + [Amazon Glacier의 ID 및 액세스 관리(IAM)](security-iam.md) # 작업 목록 조회(GET jobs) ## 설명 이 작업에서는 진행 중인 작업과 최근에 마친 작업을 포함하여 볼트 작업 목록을 조회합니다. **참고** Amazon Glacier(Amazon Glacier)는 최근에 마친 작업을 삭제하기 전에 일정 기간 유지하지만 최종적으로는 완료된 작업을 삭제합니다. 완료된 작업 출력은 가져올 수 있습니다. 완료된 작업이라고 해도 이후 일정 기간은 유지하기 때문에 작업 완료 알림 메시지를 놓치거나 첫 번째 다운로드 시도가 실패하더라도 작업 출력을 가져올 수 있습니다. 예를 들어 아카이브 가져오기 작업을 시작하여 아카이브를 다운로드한다고 가정하겠습니다. 하지만 작업이 완료되어 아카이브를 다운로드하려고 하지만 네트워크 장애가 발생하고 맙니다. 이러한 시나리오에서도 작업이 존재하는 동안에는 아카이브 다운로드를 재시도할 수 있습니다. `List Jobs` 작업은 페이지 매김을 지원합니다. 따라서 항상 응답 `Marker` 필드를 확인해야 합니다. 목록을 조회할 작업이 더 없으면 `Marker` 필드가 `null`로 설정됩니다. 목록을 조회할 작업이 더 있으면 `Marker` 필드가 null이 아닌 값으로 설정되어 이 값을 목록 페이지 매김에 계속해서 사용할 수 있습니다. 특정 작업에서 시작되는 작업 목록을 반환하려면 `marker` 요청 파라미터를 이전 `List Jobs` 요청에서 가져온 해당 작업의 `Marker` 값으로 설정합니다. 요청에서 `limit` 파라미터를 지정하면 응답으로 반환되는 최대 작업 수를 제한할 수 있습니다. 기본 제한은 50개입니다. 반환되는 작업 수가 여기에서 설정하는 제한 값보다 적을 수 있지만 제한 값을 초과할 수는 없습니다. 또한 옵션으로 `statuscode` 파라미터 또는 `completed` 파라미터를 지정하거나 둘 모두 지정하여 반환되는 작업 목록을 필터링할 수도 있습니다. `statuscode` 파라미터를 사용하면 `InProgress`, `Succeeded` 또는 `Failed` 상태와 일치하는 작업만 반환하도록 지정할 수 있습니다. `completed` 파라미터를 사용하면 완료된 작업(`true`) 또는 완료되지 않은 작업(`false`)만 반환하도록 지정할 수 있습니다. ## Requests ### 구문 모든 유형의 작업 목록을 반환하려면 `GET` 요청을 볼트의 `jobs` 하위 리소스 URI로 전송합니다. ``` 1. GET /AccountId/vaults/VaultName/jobs 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에 하이픈('-')을 포함할 수 없습니다. ### 요청 파라미터 | 이름 | 설명 | 필수 | | --- | --- | --- | | completed | 반환할 작업 상태입니다. `true` 또는 `false`를 지정할 수 있습니다. 유형: Boolean 제약 조건: 없음 | 아니요 | | limit | 반환할 작업의 최대 수입니다. 기본 제한은 50개입니다. 반환되는 작업 수가 여기에서 지정하는 제한 값보다 적을 수 있지만 제한 값을 초과할 수는 없습니다. 유형: 문자열 제약 조건: 최소 정수 값 1. 최대 정수 값 50 | 아니요 | | marker | 작업 목록 조회가 시작되는 지점의 작업을 지정할 수 있도록 페이지 매김에 사용되는 불투명한 문자열입니다. 이전 `List Jobs` 응답에서 `marker` 값을 가져옵니다. `marker`는 이전 `List Jobs` 요청에서 시작된 결과에 페이지를 계속해서 매겨야 하는 경우에만 추가합니다. 유형: 문자열 제약 조건: 없음 | 아니요 | | statuscode | 반환할 작업 상태의 유형입니다. 유형: 문자열 제약 조건: `InProgress`, `Succeeded` 또는 `Failed` 값 중 하나입니다. | 아니요 | ### 요청 헤더 이 작업은 대부분의 응답에 일반적인 응답 헤더만 사용합니다. 일반적인 응답 헤더에 대한 내용은 [공통 응답 헤더](api-common-response-headers.md) 섹션을 참조하세요. ### 요청 본문 이 작업에는 요청 본문이 없습니다. ## 응답 ### 구문 ``` HTTP/1.1 200 OK x-amzn-RequestId: x-amzn-RequestId Date: Date Location: Location Content-Type: application/json Content-Length: Length { "JobList": [ { "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" } ], "Marker": "string" } ``` ### 응답 헤더 이 작업은 대부분의 응답에 일반적인 응답 헤더만 사용합니다. 일반적인 응답 헤더에 대한 내용은 [공통 응답 헤더](api-common-response-headers.md) 섹션을 참조하세요. ### 응답 본문 JSON 응답 본문에는 다음과 같은 JSON 필드가 포함됩니다. **JobList** 작업 객체의 목록입니다. 각 작업 객체는 작업을 설명하는 메타데이터를 포함합니다. *유형*: [GlacierJobDescription](api-GlacierJobDescription.md) 객체 배열 **마커** 결과에 페이지를 계속해서 매기는 지점을 나타내는 불투명한 문자열입니다. 새로운 ` List Jobs` 요청에서 `marker` 값을 사용하여 목록의 작업을 추가로 가져옵니다. 목록을 조회할 작업이 더 없을 경우 이 값은 `null`입니다. *유형*: 문자열 ### 오류 Amazon Glacier 예외 및 오류 메시지에 대한 자세한 내용은 [오류 응답](api-error-responses.md) 섹션을 참조하세요. ## 예제 다음은 볼트 작업에 대한 정보를 반환하는 방법을 설명한 예제입니다. 첫 번째 예제에서는 작업 2개로 구성된 목록이, 그리고 두 번째 예제에서는 작업의 하위 집합이 반환됩니다. ### 예제: 모든 작업 반환 #### 요청 예시 다음은 볼트 작업을 반환하는 `GET` 요청 예제입니다. ``` 1. GET /-/vaults/examplevault/jobs 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:00:00 GMT 4. Content-Type: application/json 5. Content-Length: 1444 6. 7. { 8. "JobList": [ 9. { 10. "Action": "ArchiveRetrieval", 11. "ArchiveId": "BDfaUQul0dVzYwAMr8YSa_6_8abbhZq-i1oT69g8ByClfJyBgAGBkWl2QbF5os851P7Y7KdZDOHWJIn4rh1ZHaOYD3MgFhK_g0oDPesW34uHQoVGwoIqubf6BgUEfQm_wrU4Jlm3cA", 12. "ArchiveSizeInBytes": 1048576, 13. "ArchiveSHA256TreeHash": "25499381569ab2f85e1fd0eb93c5406a178ab77c5933056eb5d6e7d4adda609b", 14. "Completed": true, 15. "CompletionDate": "2012-05-01T00:00:09.304Z", 16. "CreationDate": "2012-05-01T00:00:06.663Z", 17. "InventorySizeInBytes": null, 18. "JobDescription": null, 19. "JobId": "hDe9t9DTHXqFw8sBGpLQQOmIM0-JrGtu1O_YFKLnzQ64548qJc667BRWTwBLZC76Ygy1jHYruqXkdcAhRsh0hYv4eVRU", 20. "RetrievalByteRange": "0-1048575", 21. "SHA256TreeHash": "25499381569ab2f85e1fd0eb93c5406a178ab77c5933056eb5d6e7d4adda609b", 22. "SNSTopic": null, 23. "StatusCode": "Succeeded", 24. "StatusMessage": "Succeeded", 25. "Tier": "Bulk", 26. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 27. }, 28. { 29. "Action": "InventoryRetrieval", 30. "ArchiveId": null, 31. "ArchiveSizeInBytes": null, 32. "ArchiveSHA256TreeHash": null, 33. "Completed": true, 34. "CompletionDate": "2013-05-11T00:25:18.831Z", 35. "CreationDate": "2013-05-11T00:25:14.981Z", 36. "InventorySizeInBytes": 1988, 37. "JobDescription": null, 38. "JobId": "2cvVOnBL36btzyP3pobwIceiaJebM1bx9vZOOUtmNAr0KaVZ4WkWgVjiPldJ73VU7imlm0pnZriBVBebnqaAcirZq_C5", 39. "RetrievalByteRange": null, 40. "SHA256TreeHash": null, 41. "SNSTopic": null, 42. "StatusCode": "Succeeded", 43. "StatusMessage": "Succeeded", 44. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 45. "InventoryRetrievalParameters": { 46. "StartDate": "2013-11-12T13:43:12Z", 47. "EndDate": "2013-11-20T08:12:45Z", 48. "Limit": "120000", 49. "Format": "JSON", 50. "Marker": "vyS0t2jHQe5qbcDggIeD50chS1SXwYMrkVKo0KHiTUjEYxBGCqRLKaiySzdN7QXGVVV5XZpNVG67pCZ_uykQXFMLaxOSu2hO_-5C0AtWMDrfo7LgVOyfnveDRuOSecUo3Ueq7K0" 51. } 52. ], 53. "Marker": null 54. } ``` ### 예제: 부분적 작업 목록 조회 #### 요청 예시 다음은 작업을 `GET` 파라미터로 지정하여 반환하는 `marker` 요청 예제입니다. 여기에서는 `limit` 파라미터가 `2`로 설정되어 최대 2개까지 작업을 반환하도록 지정하고 있습니다. ``` 1. GET /-/vaults/examplevault/jobs?marker=HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID&limit=2 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` 필드가 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: 1744 6. 7. { 8. "JobList": [ 9. { 10. "Action": "ArchiveRetrieval", 11. "ArchiveId": "58-3KpZfcMPUznvMZNPaKyJx9wODCsWTnqcjtx2CjKZ6b-XgxEuA8yvZOYTPQfd7gWR4GRm2XR08gcnWbLV4VPV_kDWtZJKi0TFhKKVPzwrZnA4-FXuIBfViYUIVveeiBE51FO4bvg", 12. "ArchiveSizeInBytes": 8388608, 13. "ArchiveSHA256TreeHash": "106086b256ddf0fedf3d9e72f461d5983a2566247ebe7e1949246bc61359b4f4", 14. "Completed": true, 15. "CompletionDate": "2012-05-01T00:25:20.043Z", 16. "CreationDate": "2012-05-01T00:25:16.344Z", 17. "InventorySizeInBytes": null, 18. "JobDescription": "aaabbbccc", 19. "JobId": "s4MvaNHIh6mOa1f8iY4ioG2921SDPihXxh3Kv0FBX-JbNPctpRvE4c2_BifuhdGLqEhGBNGeB6Ub-JMunR9JoVa8y1hQ", 20. "RetrievalByteRange": "0-8388607", 21. "SHA256TreeHash": "106086b256ddf0fedf3d9e72f461d5983a2566247ebe7e1949246bc61359b4f4", 22. "SNSTopic": null, 23. "StatusCode": "Succeeded", 24. "StatusMessage": "Succeeded", 25. "Tier": "Bulk", 26. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 27. }, 28. { 29. "Action": "ArchiveRetrieval", 30. "ArchiveId": "2NVGpf83U6qB9M2u-Ihh61yoFLRDEoh7YLZWKBn80A2i1xG8uieBwGjAr4RkzOHA0E07ZjtI267R03Z-6Hxd8pyGQkBdciCSH1-Lw63Kx9qKpZbPCdU0uTW_WAdwF6lR6w8iSyKdvw", 31. "ArchiveSizeInBytes": 1048576, 32. "ArchiveSHA256TreeHash": "3d2ae052b2978727e0c51c0a5e32961c6a56650d1f2e4ceccab6472a5ed4a0", 33. "Completed": true, 34. "CompletionDate": "2012-05-01T16:59:48.444Z", 35. "CreationDate": "2012-05-01T16:59:42.977Z", 36. "InventorySizeInBytes": null, 37. "JobDescription": "aaabbbccc", 38. "JobId": "CQ_tf6fOR4jrJCL61Mfk6VM03oY8lmnWK93KK4gLig1UPAbZiN3UV4G_5nq4AfmJHQ_dOMLOX5k8ItFv0wCPN0oaz5dG", 39. "RetrievalByteRange": "0-1048575", 40. "SHA256TreeHash": "3d2ae052b2978727e0c51c0a5e32961c6a56650d1f2e4ceccab6472a5ed4a0", 41. "SNSTopic": null, 42. "StatusCode": "Succeeded", 43. "StatusMessage": "Succeeded", 44. "Tier": "Standard", 45. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 46. } 47. ], 48. "Marker": "CQ_tf6fOR4jrJCL61Mfk6VM03oY8lmnWK93KK4gLig1UPAbZiN3UV4G_5nq4AfmJHQ_dOMLOX5k8ItFv0wCPN0oaz5dG" 49. } ``` ## 관련 섹션 + [작업 설명(GET JobID)](api-describe-job-get.md) + [Amazon Glacier의 ID 및 액세스 관리(IAM)](security-iam.md)