GetObject

Classic/VPC 환경에서 이용 가능합니다.

Ncloud Storage 버킷에 저장된 객체를 조회합니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드	URI
GET	/{Key}

요청 헤더에 대한 설명은 다음과 같습니다.

참고

Ncloud Storage API에서 공통으로 사용하는 헤더에 대한 정보는 Ncloud Storage 요청 헤더를 참조해 주십시오.

필드	필수 여부	설명
`Range`	Optional	조회 범위(Byte)
`x-amz-server-side-encryption-customer-algorithm`	Optional	사용자 암호화 알고리즘 (AES256)
`x-amz-server-side-encryption-customer-key`	Optional	사용자 제공 암호화 키
`x-amz-server-side-encryption-customer-key-MD5`	Optional	사용자 제공 암호화 키의 MD5 값

요청 경로 파라미터에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`Key`	String	Required	객체 이름 ListObjectsV2 참조

요청 쿼리 파라미터에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`partNumber`	String	Optional	객체 파트 번호 ListParts 참조 객체의 일부 파트만 조회하는 경우, 입력
`versionId`	String	Optional	객체 버전 아이디 ListObjectVersions 참조 버전 관리가 설정된 버킷에서 객체의 특정 버전을 조회하는 경우, 입력

요청 예시는 다음과 같습니다.

GET /object.csv HTTP/1.1
Host: bucket.kr.ncloudstorage.com

응답 형식을 설명합니다.

응답 헤더에 대한 설명은 다음과 같습니다.

참고

Ncloud Storage API에서 공통으로 사용하는 헤더에 대한 정보는 Ncloud Storage 응답 헤더를 참조해 주십시오.

필드	필수 여부	설명
`x-amz-object-lock-mode`	-	객체 보존 모드 `GOVERNANCE` \| `COMPLIANCE` 객체에 보존이 설정된 경우에 표시
`x-amz-object-lock-retain-until-date`	-	객체 보존 만료일 ISO 8601 형식 객체에 보존이 설정된 경우에 표시
`x-amz-object-lock-legal-hold`	-	법적 보존 상태 `ON` \| `OFF` 객체에 법적 보존이 설정된 경우에 표시

Ncloud Storage API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud Storage 응답 상태 코드를 참조해 주십시오.

응답 예시는 다음과 같습니다.

HTTP/1.1 200 OK

<object data>