---
title: "버킷 관리 문제"
slug: "objectstorage-troubleshoot-bucket"
tags: ["Classic", "VPC", "Object Storage"]
updated: 2026-10-22T09:07:57Z
published: 2026-10-22T09:07:57Z
canonical: "guide-gov.ncloud-docs.com/objectstorage-troubleshoot-bucket"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide-gov.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 버킷 관리 문제

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

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

## 공유받은 버킷 조회 불가

버킷 권한 관리를 사용해서 다른 계정에 권한을 부여하였으나, 공유받은 계정에서 해당 버킷이 보이지 않습니다.

#### 원인

S3 API 사양에 따라 본인이 소유하고 있는 버킷만 조회할 수 있으므로 권한을 받은 버킷은 콘솔에서 노출되지 않는 것이 정상입니다.

#### 해결 방법

권한을 부여받은 버킷에 접근하려면 API 또는 CLI를 통해 직접 호출해 주십시오.

          참고

          

Object Storage 서비스를 이용 중인 메인 계정에만 권한을 부여할 수 있습니다.

## 버킷 조회 불가

버킷이 조회되지 않습니다.

#### 원인

URL 인코딩하지 않은 Key를 사용하여 객체를 업로드할 경우, 버킷이 조회되지 않을 수 있습니다.

#### 해결 방법

해당 객체에 접근하려면 Javascript SDK를 사용해 주십시오. 문제의 재발을 방지하려면 추후 파일 업로드 시 Key를 URL 인코딩하여 사용해 주십시오.

다음 예제는 Prefix로 지정된 객체를 조회한 후, Key에 URL 인코딩을 적용하여 다시 업로드하고, 문제가 되는 객체를 삭제하는 코드 샘플입니다. 다음 코드를 참고하여 환경에 맞게 작업한 후 실행해 주십시오.

```
import AWS from 'aws-sdk';

const endpoint = new AWS.Endpoint('ENDPOINT');
const region = 'kr-standard';
const bucket_name = 'BUCKET_NAME';
const prefix = 'PREFIX';
const access_key = 'ACCESS_KEY';
const secret_key = 'SECRET_KEY';

const S3 = new AWS.S3({
    endpoint: endpoint,
    region: region,
    credentials: {
        accessKeyId: access_key,
        secretAccessKey: secret_key
    }
});

(async () => {
    let response = await S3.listObjectsV2({
        Bucket: bucket_name,
        Prefix: prefix
    }).promise();

    console.log(response.Contents);

    for (let content of response.Contents) {
        if (encodeURI(content.Key) !== content.Key) {
            console.log(decodeURI(encodeURI(content.Key)));

            // get object
            let inStream = S3.getObject({
                Bucket: bucket_name,
                Key: content.Key,
            }).createReadStream();

            // upload file
            await S3.upload({
                Bucket: bucket_name,
                Key: encodeURI(content.Key),
                Body: inStream
            }).promise();

            // delete invalid file
            await S3.deleteObject({
                Bucket: bucket_name,
                Key: content.Key
            }).promise();
        }
    }
})();
```

## 객체 잠금 해제

버킷에 적용한 객체 잠금이 해제되지 않습니다.

#### 원인

버킷에 객체 잠금을 적용했다면 해제가 불가능합니다.

#### 해결 방법

객체 잠금에 대한 자세한 설명은 [잠금 관리](/docs/objectstorage-use-bucket#%EC%9E%A0%EA%B8%88%EA%B4%80%EB%A6%AC)를 참조해 주십시오.

## "오브젝트 소유자가 아닙니다." 메시지

버킷에 폴더를 생성하거나 파일을 업로드하려고 할 때 오브젝트 소유자가 아니라는 메시지가 나타납니다.

#### 원인

버킷의 업로드 권한이 비활성화된 경우에 발생합니다.

#### 해결 방법

소유자가 버킷의 권한 관리 설정에 진입하여 해당 계정의 업로드 권한을 추가해 주십시오. 권한을 추가하는 방법은 [권한 관리](/docs/objectstorage-use-bucket#%EA%B6%8C%ED%95%9C%EA%B4%80%EB%A6%AC)를 참조해 주십시오.

          참고

          

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