jobParameters - Amazon S3 Glacier
목차추가 정보

이 페이지는 저장소와 2012년부터 출시된 원본 REST API를 사용하는 S3 Glacier 서비스의 기존 고객만 이용할 수 있습니다.

아카이브 스토리지 솔루션을 찾고 있다면 Amazon S3의 S3 Glacier 스토리지 클래스, S3 Glacier 인스턴트 검색, S3 Glacier 플렉서블 검색 및 S3 Glacier Deep Archive를 사용하는 것이 좋습니다. 이러한 스토리지 옵션에 대한 자세한 내용은 Amazon S3 사용 설명서의 S3 Glacier 스토리지 클래스 및 S3 Glacier 스토리지 클래스를 사용한 장기 데이터 스토리지를 참조하십시오. 이러한 스토리지 클래스는 Amazon S3 API를 사용하며, 모든 지역에서 사용할 수 있으며, Amazon S3 콘솔 내에서 관리할 수 있습니다. 스토리지 비용 분석, 스토리지 렌즈, 다중 암호화 옵션을 포함한 보안 기능 등과 같은 기능을 제공합니다.

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

jobParameters

작업을 정의하기 위한 옵션을 제공합니다.

목차

ArchiveId

원하는 아카이브의 ID입니다. Type 필드가 select 또는 archive-retrieval로 설정된 경우에 이 필드는 필수입니다. 인벤토리 가져오기 작업을 요청하면서 이 필드를 지정하면 오류가 발생합니다.

유효한 값: 반드시 이전에 Amazon S3 Glacier(S3 Glacier)에 대한 요청을 통해 얻은 유효한 아카이브 ID이어야 합니다.

유형: 문자열

필수 항목 여부: Type이 select 또는 archive-retrieval로 설정된 경우, 필수입니다.

설명

작업 설명(옵션)입니다.

유효 값: 설명은 1,024바이트보다 작거나 같아야 합니다. 허용되는 문자는 제어 코드를 제외한 7비트 ASCII로 그 중에서도 특히 ASCII 값 32~126 십진수 또는 0x20~0x7E 16진수입니다.

유형: 문자열

필수 항목 여부: 아니요

형식

(선택 사항) 볼트 인벤토리 가져오기 작업을 시작할 때 출력 형식입니다. 인벤토리 작업을 시작하면서 Format 필드를 지정하지 않으면 JSON이 기본 형식으로 사용됩니다.

유효한 값: CSV | JSON

유형: 문자열

필수 항목 여부: 아니요

InventoryRetrievalParameters

범위가 지정된 인벤토리 가져오기에 사용되는 입력 파라미터입니다.

유형: InventoryRetrievalJobInput 객체

필수 항목 여부: 아니요

OutputLocation

선택 작업 결과가 저장되는 위치에 관한 정보를 담는 객체입니다.

유형: OutputLocation 객체

필수 항목 여부: select 작업의 경우, 예.

RetrievalByteRange

archive-retrieval에 대해 검색할 바이트 범위는 ‘StartByteValue~EndByteValue’ 형식이 되어야 합니다. 이 필드를 지정하지 않으면 전체 아카이브를 가져옵니다. 이 필드를 지정할 경우에는 바이트 범위가 메가바이트(1024*1024)로 정렬되어야 합니다. 메가바이트 정렬은 StartByteValue가 1MB로 나누어지고, EndByteValue + 1이 1MB로 나누어지거나 혹은 아카이브 끝이 아카이브 바이트 크기 값에서 1을 뺀 값으로 지정되어야 한다는 것을 의미합니다. [RetrievalByteRange]가 메가바이트로 정렬되지 않으면 400 응답이 반환됩니다.

inventory-retrieval 또는 select 작업 요청에 대해 이 필드를 지정하면 오류가 발생합니다.

유형: 문자열

필수 항목 여부: 아니요

SelectParameters

선택에 사용되는 파라미터에 관한 정보를 포함하는 객체입니다.

유형: SelectParameters 객체

필수 항목 여부: 아니요

SNSTopic

작업이 완료되고 출력을 다운로드할 수 있을 때 S3 Glacier가 알림 메시지를 전송하는 Amazon SNS 토픽의 Amazon 리소스 이름(ARN)입니다. 지정된 주제는 알림 메시지를 구독자에게 게시합니다.

이때 SNS 주제는 반드시 존재해야 합니다. 존재하지 않는 경우, S3 Glacier는 자동으로 토픽을 생성하지 않습니다. 또한 SNS 주제는 작업을 생성한 계정에서 메시지를 주제에 게시할 수 있는 정책이 필요합니다. SNS 토픽 이름에 대한 자세한 정보는 Amazon Simple Notification Service의 API 참조에서 토픽 생성을 참조하세요.

유형: 문자열

필수 항목 여부: 아니요

티어

선택 또는 아카이브 가져오기 작업에 사용할 계층입니다. 기본값으로 Standard가 사용됩니다.

유효한 값: Expedited | Standard | Bulk

유형: 문자열

필수 항목 여부: 아니요

유형

작업 유형입니다. 아카이브에서 선택 쿼리를 수행하거나 아카이브를 가져오거나 볼트의 인벤토리를 가져오는 작업을 시작할 수 있습니다.

유효한 값: select | archive-retrieval | inventory-retrieval

유형: 문자열

필수 항목 여부: 예

추가 정보