PutObject

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

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

요청

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

메서드	URI
PUT	/{Key}

요청 헤더

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

참고

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

필드	필수 여부	설명
`Cache-Control`	Optional	캐싱 동작
`Content-Disposition`	Optional	요청 데이터의 표시 방식
`Content-Encoding`	Optional	요청 데이터의 인코딩 방식
`Content-Language`	Optional	요청 데이터의 언어
`Content-Type`	Optional	요청 데이터의 형식
`Content-MD5`	Optional	요청 바디(객체 데이터)의 Base64 인코딩된 128비트 MD5 해시값 객체 데이터 무결성 검증에 사용
`x-amz-checksum-*`	Optional	체크섬 해시 값 키의 `*`에 사용한 알고리즘 입력 지원 알고리즘: `crc32` \| `crc32c` \| `sha1` \| `sha256` \| `crc64nvme` 객체 데이터 무결성 검증에 사용 하나의 알고리즘만 지정 가능
`x-amz-storage-class`	Optional	스토리지 클래스 `STANDARD` (기본값) \| `ONEZONE_IA` \| `DEEP_ARCHIVE` `STANDARD`: Standard Class `ONEZONE_IA`: One Zone-IA(Infrequent Access) Class `DEEP_ARCHIVE`: Archive Class
`x-amz-server-side-encryption`	Optional	서버 측 암호화 방식 `AES256`: SSE-S3 (서버 관리 키) `aws:kms`: SSE-KMS (KMS 관리 키)
`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 값
`x-amz-object-lock-mode`	Optional	객체 보존 모드 `GOVERNANCE` \| `COMPLIANCE` `GOVERNANCE`: 특별 권한으로 우회 가능 `COMPLIANCE`: 누구도 우회 불가 `x-amz-object-lock-retain-until-date`와 함께 지정 Object Lock이 활성화된 버킷에서만 사용 가능
`x-amz-object-lock-retain-until-date`	Optional	객체 보존 만료일 ISO 8601 형식 `x-amz-object-lock-mode`와 함께 지정 Object Lock이 활성화된 버킷에서만 사용 가능
`x-amz-object-lock-legal-hold`	Optional	법적 보존 상태 `ON` \| `OFF` Object Lock이 활성화된 버킷에서만 사용 가능

요청 경로 파라미터

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

필드	타입	필수 여부	설명
`Key`	String	Required	객체 이름 버킷 내 폴더에 저장할 경우, `{폴더 이름}/{파일 이름}` 형태로 입력

요청 예시

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

PUT /object.csv HTTP/1.1
Host: {Bucket}.kr.ncloudstorage.com
Content-Length: 17423
x-amz-checksum-sha256: 2ecf9f32d97***********39aed87829=

<object.csv binary data>

응답

응답 형식을 설명합니다.

응답 헤더

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

참고

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

필드	필수 여부	설명
`x-amz-checksum-*`	-	저장된 객체의 체크섬 값 요청에 체크섬을 지정한 경우에 표시 키의 `*`는 사용한 알고리즘(`crc32` \| `crc32c` \| `sha1` \| `sha256` \| `crc64nvme`)
`x-amz-checksum-type`	-	체크섬 타입 `FULL_OBJECT` \| `COMPOSITE` 요청에 체크섬을 지정한 경우에 표시

응답 상태 코드

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

응답 예시

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

HTTP/1.1 200 OK
ETag: "2dd********************4f6181"
x-amz-checksum-sha256: 2ecf9f32d97***********39aed87829=
x-amz-object-size: 17423

Documentation Index