다큐멘트 센터 Object Storage API HTTP Response Status Code

HTTP Response Status Code

최신 업데이트:2025-08-18 15:32:58

이 문서는 오브젝트 스토리지 및 멀티미디어 처리 서비스에서 발생할 수 있는 예외 상태 코드 체계를 설명하는 API 오류 코드 참조 가이드입니다.

인터페이스 반환 코드 반환 메시지 반환 코드 설명
일반 200 OK 작업 성공
304 Not Modified 파일이 최신 상태
401 Authorization Required 요청 헤더에 인증 필요
401 AK/SK Not Found AK/SK를 찾을 수 없음
401 Token Invalid 요청 토큰이 잘못됨
401 ExpireTime Is Null ExpireTime(만료시간) 값 없음
401 Token Format Invalid 요청 토큰 형식 오류
404 Bucket Not Found 버킷이 존재하지 않음
404 File Not Found 리소스를 찾을 수 없음
404 bucketErrorPage 리소스를 찾을 수 없음
405 Token Required 토큰 필요
406 File Already Exist 파일이 이미 존재함
401 The Persistent File Already Exists 이미 영구 파일이 존재함
406 File Is Busy, Please Retry Later 파일 처리 중, 나중에 다시 시도해 주세요
404 Bucket Not Binding Mirror 버킷에 미러 소스가 바인딩되어 있지 않음
401 Bucket Access Denied 버킷 접근 거부
500 Internal Server Error 서버 내부 오류
파일 업로드 401 Token Expired 요청 토큰이 만료됨
401 Unsupported PutPolicy Decoding PutPolicy 디코딩 예외
401 PutPolicy Invalid PutPolicy가 올바르지 않음
401 PutPolicy Is Null PutPolicy가 null임
401 Deadline Is Empty Deadline 값이 없음
401 Deadline Invalid Deadline 값이 잘못됨
401 Scope Format Is Invalid Scope 형식이 올바르지 않음
401 Scope Is Empty Scope 값이 없음
401 Putpolicy Scope Invalid 버킷명과 파일명의 조합 형식 오류
401 The BucketName In Scope Is Empty 버킷명이 없음
401 File Name Invalid 파일명 오류
401 Param Invalid, ReturnUrl Can’t Exist With CallbackUrl 잘못된 파라미터, returnUrl과 callbackUrl을 동시에 사용할 수 없음
401 CallbackUrl Invalid | ReturnUrl Invalid | PersistentNotifyUrl Invalid CallbackUrl, ReturnUrl, PersistentNotifyUrl은 http:// 또는 https://로 시작해야 함
401 ReturnBody Invalid 잘못된 ReturnBody
401 CallbackBody Invalid 잘못된 callbackBody
401 Saveas String Invalid 사용자 정의 작업에서 버킷과 파일명 조합 형식이 올바르지 않음
400 File Transmission Fail 파일 전송 실패
401 FileName Invalid 파일명 오류
401 Upload File Cannot be Empty 업로드할 파일이 지정되지 않음
401 PersistentOps Invalid 잘못된 persistentOps
401 CallbackUrl Is Not Public Address | ReturnUrl Is Not Public Address | PersistentNotifyUrl Is Not Public Address CallbackUrl, ReturnUrl, PersistentNotifyUrl이 퍼블릭 네트워크 주소가 아님
401 CallbackUrl Invalid | ReturnUrl Invalid 잘못된 CallbackUrl 또는 ReturnUrl
401 File Too Large 업로드 파일이 용량 제한을 초과함
401 Saveas String Invalid 영구 처리 후 사용자 정의 작업에서 버킷과 파일명 조합 형식이 올바르지 않음
579 Callback Failed 파일 업로드 성공, 콜백 실패
추가 업로드 409 ObjectNotAppendable Normal 오브젝트에 대한 append 연산 시도
403 ObjectTypeNotSupport appendable 오브젝트에 대한 put/copy/move 연산 시도
409 PositionNotEqualToLength append 시 위치가 오브젝트 크기와 다름
413 EntityTooLarge append 내용이 2GB를 초과함
409 MissingPosition 오브젝트 append 시 위치 파라미터 누락
400 InvalidLocalFile 객체 append 시 로컬(클라이언트) 파일이 없음
400 InvalidObjectName 객체 append 시 서버 오브젝트 없음
mkblk 401 Block Too Large 업로드 블록이 시스템 기본값보다 큼
bput 401 nextChunkOffset is not correct 잘못된 ctx 메시지, 현재 조각의 시작 위치를 찾을 수 없음
401 Block Cannot find by ctx 잘못된 ctx 메시지, 해당 블록(found block)을 찾을 수 없음
401 ctx can not be null ctx 필드가 비어 있음
412 Cannot find upload block file 업로드 블록을 찾을 수 없음
mkfile 400 Make file Fail 서버 블록 파일 생성 실패
401 Check the block is complete upload. 블록이 완전히 업로드되었는지 확인 못함
401 save db error 파일 중복 업로드, 데이터 저장 실패
412 Check the blocks are all upload. 블록 중 일부가 업로드되지 않아, 모든 블록이 업로드되어야 함
이미지 처리 404 Watermark Image Url Invalid 워터마크 이미지 URL이 올바르지 않음
404 WaterMark Image Not Found 워터마크 이미지를 찾을 수 없음
401 Bucket Open Image Protect Function, Unable To Get Original Image 원본 이미지 보호 기능 활성화로 원본 접근 불가
401 Non-standard Type Of Op 잘못된 작업 유형
401 Image Process Param Error 이미지 작업 파라미터 오류
579 Get WaterMark Image Fail 워터마크 이미지 다운로드 실패
파일 트랜스코딩 400 Tranfer Parameters Error 트랜스코딩 파라미터 오류
401 Ops Invalid 잘못된 Ops
404 Video Persistent Progress Info Not Found 비디오 영구 처리 진행 정보 없음
579 Json callback 콜백 서비스 서버 응답 예외
이 문서의 내용이 도움이 되었습니까?
아니오
정상적으로 제출되었습니다.피드백을 주셔서 감사합니다.앞으로도 개선을 위해 노력하겠습니다.