최신 업데이트: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 | 콜백 서비스 서버 응답 예외 |