**이 페이지는 볼트와 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 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)