MENU
      PutObject

        PutObject


        기사 요약

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

        오브젝트를 업로드하고 메타데이터를 생성합니다.
        이미 저장된 오브젝트를 다시 업로드하면 덮어쓰기되고, 기존에 있던 메타데이터를 다시 생성하면 새로 입력한 값으로 업데이트됩니다.

        요청

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

        메서드URI
        PUT/v1/AUTH_{project_id}/{container}/{object}

        요청 헤더

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

        필드타입필수 여부설명
        X-Auth-TokenStringOptional발급한 토큰 값
        X-Object-Meta-{name}StringOptional설정할 메타데이터
        • {name} 부분에 메타데이터의 키 입력
        • 헤더 값에 메타데이터 값 입력
        X-Object-ManifestStringConditional대용량 오브젝트를 업로드할 경우 오브젝트(SLO)의 매니페스트
        • 입력 포맷: {container}/{prefix}
        X-Delete-AtIntegerOptional오브젝트의 자동 삭제 예정 시각(Unix Timestamp)
        • 데이터를 일시적으로 저장하기 원할 때 사용
        • 입력된 일시에 오브젝트 삭제
        X-Delete-AfterIntegerOptional오브젝트의 자동 삭제 예정 시점(초 단위로 입력)
        • 데이터를 일시적으로 저장하기 원할 때 사용
        • 업로드 시점부터 입력된 시간 후에 오브젝트 삭제
        X-Detect-Content-TypeBooleanOptional파일 확장자를 기반으로 오브젝트의 MIME 타입 자동 설정
        • true | false
          • true: MIME 타입 감지 및 자동 결정
          • false: 자동 감지 없이 Content-Type에 입력된 MIME 타입으로 설정
        X-Copy-FromStringOptional오브젝트 복사
        • 입력 포맷: {container}/{object}
        • Range 헤더와 조합 가능
        X-Copy-From-AccountStringOptional다른 계정으로 오브젝트 복사
        Content-DispositionStringOptional브라우저의 응답 처리 방식
        Content-EncodingStringOptional오브젝트의 인코딩 방식
        Content-TypeStringOptional오브젝트의 MIME 타입
        Content-LengthIntegerOptional오브젝트의 용량
        • chunked transfer encoding을 사용하는 경우 설정 불필요
        Transfer-EncodingStringOptionalchunked transfer encoding 사용 설정
        • chunked
        • 설정 시 Content-Length 헤더 제외 필요
        ETagStringOptionalETag 헤더 값
        If-None-MatchStringOptionalETag 조건 헤더
        • 자세한 내용은 RFC2616에서 확인

        요청 경로 파라미터

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

        필드타입필수 여부설명
        project_idStringRequired프로젝트 ID
        containerStringRequired대상 오브젝트가 저장될 컨테이너 이름
        objectStringRequired저장할 오브젝트 이름

        요청 쿼리 파라미터

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

        필드타입필수 여부설명
        temp_url_sigStringOptioanl저장할 리소스에 접근할 수 있는 임시 URL의 서명
        • 승인된 요청임을 검증
        temp_url_expiresIntegerOptioanl저장할 리소스에 접근할 수 있는 임시 URL의 만료 시간(Unix Timestamp)
        multipart-manifestStringConditional대용량 오브젝트의 멀티파트 업로드 선언
        • 값으로 put을 입력하면 멀티파트 업로드로 인식되어 파트를 한 파일로 조합하도록 서버에 지시
        • 요청 바디에 파트 조합에 대한 매니페스트를 작성해야 함

        요청 예시

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

        curl -L -X PUT 'https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}' \
        -H 'X-Auth-Token: {token}' \
        -H 'X-Object-Meta-collection: C1' \
        -H 'X-Detect-Content-Type: true' \
        -T '@{/FILE_PATH/OBJECT}'
        Curl

        응답

        응답 형식을 설명합니다.

        응답 헤더

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

        필드타입필수 여부설명
        Content-TypeString-응답 결과의 MIME 타입
        Content-LengthString-응답 결과의 길이(Byte)
        ETagString-ETag 헤더 값
        Last-ModifiedString-오브젝트의 가장 최근 수정 시간(UTC)
        X-Trans-IdString-해당 요청의 트랜잭션 ID
        X-Openstack-Request-IdString-해당 요청의 트랜잭션 ID
        • X-Trans-Id와 동일
        DateString-해당 요청의 응답 시간(UTC)

        응답 상태 코드

        응답 상태 코드에 대한 설명은 다음과 같습니다.

        HTTP 상태 코드코드메시지설명
        201-Created요청 성공
        408-Request Timeout요청 타임아웃

        응답 예시

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

        HTTP/1.1 201 Created
        Last-Modified: Mon, 17 Sep 2018 07:36:47 GMT
        Content-Length: 0
        Etag: 95444a08aec383972a52eaaac43e6dce
        Content-Type: text/html; charset=UTF-8
        X-Trans-Id: txe5ad93db05334b1cb44d2-005b9f598e
        X-Openstack-Request-Id: txe5ad93db05334b1cb44d2-005b9f598e
        Date: Mon, 17 Sep 2018 07:36:46 GMT
        HTTP

        이 문서가 도움이 되었습니까?

        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.