일반적인 문제
    • PDF

    일반적인 문제

    • PDF

    기사 요약

    Object Storage 서비스를 이용하면서 다음과 같은 문제를 겪을 수 있습니다. 문제별 원인과 해결 방법을 확인하고 적절하게 조치해 주십시오.

    업로드 오류

    암호화 설정이 적용된 버킷에 파일 업로드 시 오류가 발생합니다.

    원인

    메인 계정의 API Key를 사용하여 암호화 설정이 적용된 버킷 또는 객체에 대해 업로드 API를 호출할 경우, 권한 관련 오류가 발생할 수 있습니다.

    해결 방법

    메인 계정의 API Key로 업로드 API를 호출한 것은 아닌지 확인해 주십시오. 서브 계정을 생성한 후 서브 계정의 API Key를 사용하여 요청해 주십시오. 더 자세한 설명은 암호화 설정 이용하기서브 계정 생성 및 관리를 참조해 주십시오.

    여러 파일 업로드, 다운로드

    • 콘솔에서 여러 파일을 한 번에 다운로드하거나 업로드할 수 없습니다.
    • 콘솔에서 파일이 1개씩만 업로드됩니다.
    • 콘솔에서 파일이 1개씩만 다운로드됩니다.

    원인

    콘솔에서는 버킷 내 파일을 1개 단위로만 업로드, 다운로드할 수 있습니다.

    해결 방법

    여러 개의 파일을 한 번에 업로드하거나 다운로드하려면 S3 브라우저를 사용해야 합니다. S3 브라우저를 연동하고 설정하는 방법은 다음과 같습니다.

    1. 시작하기 전에를 참조하여 S3 브라우저를 연동해 주십시오.
    2. S3 브라우저를 실행해 주십시오.
    3. Menu > Account > Add New Account 메뉴를 차례대로 클릭해 주십시오.
    4. 다음과 같이 설정해 주십시오.
      • Account Type: S3 Compatible Storage
      • REST Endpoint: kr.object.fin-ncloudstorage.com
      • Access Key ID: 네이버 클라우드 플랫폼 계정의 Access Key ID 입력
      • Secret Access Key: 네이버 클라우드 플랫폼 계정의 Secret Access Key 입력
      • Use secure transfer(SSL/TLS): 선택
    5. [Task] 탭에서 정상적으로 연결이 되는지 확인해 주십시오.
    6. 파일 업로드/다운로드를 수행해 주십시오.
    참고

    Acceess Key ID와 Secret Access Key는 네이버 클라우드 플랫폼 포털 마이페이지 > 계정관리 > 인증키 관리 메뉴에서 확인할 수 있습니다.

    404 NoSuchKey 오류

    404 NoSuchKey 오류가 발생합니다.

    원인

    실제 저장되는 키 값에 특수 문자가 포함되어 있거나 공백 및 경로 앞에 '/' 가 포함되어 있으면 오류가 발생할 수 있습니다.

    해결 방법

    정확한 객체명을 확인해야 합니다. 객체명을 확인하는 방법은 다음과 같습니다.

    • API로 확인하려면, ListObjectsV2 API를 호출해 주십시오.
    • CLI로 확인하려면 명령어를 다음과 같이 입력해 주십시오.
      aws s3api --endpoint-url=https://kr.object.fin-ncloudstorage.com list-objects-v2 --bucket <bucket_name> --query 'Contents[].Key'
      
      참고

      더 자세한 내용은 Object Storage CLI 가이드를 참조해 주십시오.

    • 반환되는 객체가 많은 경우, --prefix 옵션을 사용하여 결과를 필터링해 주십시오.

    파일 접근 권한

    최상위 폴더가 '공개'임에도 파일 업로드 시 접근 권한이 없다는 메시지가 나타납니다.

    원인

    객체가 업로드되는 폴더의 권한과 관계없이 파일 업로드 시 '공개 안함' 상태로 파일이 업로드됩니다. 파일의 공개 권한이 '공개 안함'일 경우, 해당 오류가 발생할 수 있습니다.

    해결 방법

    S3 API 등을 통해 객체를 업로드한 후, 객체의 접근 제한 설정을 'public-read'로 변경해 주십시오.

    • 객체에 적용할 ACL을 설정하는 방법은 PutObjectACL를 참조해 주십시오.
    • 접근 제한 목록은 Object Storage API 가이드의 접근 제어 목록(ACL)을 참조해 주십시오.

    콘솔에서 객체를 업로드할 경우에는 업로드 창에서 [권한 및 메타 데이터 설정] 버튼을 클릭하면 공개 여부를 선택할 수 있습니다.

    CORS 오류

    CORS (Cross-origin resource sharing) 오류가 발생합니다.

    원인

    CORS 설정에 문제가 있을 경우 발생합니다.

    해결 방법

    CLI로 버킷의 CORS 설정을 확인하고 테스트하는 방법은 다음과 같습니다.

    1. CORS 규칙 조회
      다음 명령어를 실행하여 CORS 설정이 올바르게 구성되었는지 확인해 주십시오.
      aws --endpoint-url=https://kr.object.fin-ncloudstorage.com s3api get-bucket-cors --bucket <bucket_name>
      
    2. CORS 설정 테스트
      curl을 통해 OPTION 요청을 보내고, Origin 헤더와 Access-Control-Request-Method 헤더를 설정하여 CORS 설정을 확인해 주십시오.
      i https://kr.object.fin-ncloudstorage.com/<bucket_name>/<object_name> -H "Access-Control-Request-Method: <method>" --request OPTIONS -H "Origin: <origin>"
      
    3. 응답 확인
      응답 헤더에 Access-Control-Allow-Origin 헤더와 Access-Control-Allow-Methods 헤더가 있는지 확인해 주십시오.
      예를 들어, 다음과 같은 헤더가 있으면 CORS 요청이 허용되었다는 뜻입니다.
      Access-Control-Allow-Origin: <origin>
      Access-Control-Allow-Methods: <method>

    API로 CORS 설정을 확인하는 방법은 OptionsObjectCORS API 가이드를 참조해 주십시오.

    Access Denied 오류

    자바 SDK를 이용하여 Object storage에 파일 업로드를 하면 Access Denied 오류가 발생합니다.

    원인

    API로 파일 업로드 및 버킷 생성 시 권한이 없는 상태로 생성되어서 발생하는 문제입니다.

    해결 방법

    • 파일 업로드 또는 폴더 생성 시 접근 제어 목록(ACL)을 설정할 수 있습니다. 자세한 내용은 PutBucketACL을 참조해 주십시오.
    • 업로드한 객체의 공개 설정은 콘솔에서 폴더 단위로 수행할 수 있습니다. 자세한 설명은 Java용 AWS SDK를 참조해 주십시오.

    버킷 삭제 후 Multiplart-upload 잔여 문제

    버킷을 삭제했으나 멀티파트 업로드(Multiplart-upload)가 남아 있습니다.

    원인

    멀티파트 업로드를 완료하지 않을 경우, 잔여 파일이 버킷에 남게 됩니다. 잔여 파일은 버킷 용량에 포함되어 과금되므로 불완전한 멀티파트 객체를 삭제해야 합니다.

    해결 방법

    API를 호출하여 불완전한 멀티파트 객체를 확인하고 삭제하는 방법은 다음과 같습니다.

    1. 업로드가 취소되었거나 완료되지 않은 멀티파트 업로드 정보를 조회해 주십시오(ListMultipartUploads 참조).
    2. 멀티파트 업로드 중 완료되지 않은 업로드를 중지한 후 삭제해 주십시오(AbortMultipartUpload 참조).

    CLI에서 미완료 멀티파트 업로드를 확인하고 삭제하는 방법은 미완료 멀티파트 업로드 삭제를 참조해 주십시오.

    Cloud Advisor 서비스를 사용하면 불완전한 멀티파트 업로드 객체에 대한 알림을 받을 수 있습니다.

    데이터 삭제 불가

    Object Storage의 데이터가 삭제되지 않습니다.

    원인

    객체 잠금 상태인 데이터인 경우에는 데이터를 삭제할 수 없습니다.

    해결 방법

    객체 잠금 상태인 데이터는 삭제할 수 없고, 객체 잠금은 만료일 전까지 해제할 수 없습니다. 데이터를 삭제할 수 없기 때문에 회원 탈퇴 시에도 영향을 주기 때문에 데이터를 객체 잠금하기 전에는 주의해 주십시오.

    참고

    이 가이드에서 필요한 정보를 찾지 못했거나 추가로 필요한 정보가 있으신 경우, 언제든지 아래의 피드백 아이콘을 클릭하여 의견을 보내 주십시오. 전달해 주신 의견을 참고하여 더 유용한 정보를 제공하겠습니다.


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

    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.