버킷 사용

버킷은 객체를 저장하는 공간이며, Object Storage 서비스를 이용하려면 하나 이상의 버킷을 생성해야 합니다. 네이버 클라우드 플랫폼 콘솔에서 버킷을 쉽게 생성하고 편하게 관리할 수 있습니다.

버킷 생성

Object Storage 서비스 이용 신청을 완료한 상태에서 버킷을 생성하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 Services > Storage > Object Storage 메뉴를 차례대로 클릭해 주십시오.
2. Bucket Management 메뉴를 클릭해 주십시오.
3. [버킷 생성] 버튼을 클릭해 주십시오.
4. 생성할 버킷의 이름을 입력하고 [다음] 버튼을 클릭해 주십시오.
   • 첫 문자와 끝 문자는 알파벳 소문자 또는 숫자만 허용하며, 3~63자 이내로 입력해 주십시오.
   • 마침표(.)와 하이픈(-)은 허용되지만, IP 주소 형태의 이름은 허용하지 않습니다.
   • 버킷 생성 후에는 이름을 변경할 수 없습니다. 버킷 이름은 객체 도메인 생성 시 활용되므로 신중하게 선택해 주십시오.
   • 리전 내에 동일한 버킷 이름이 있을 경우, 등록되지 않습니다. 등록할 버킷의 고유한 이름을 입력해 주십시오.
5. 필요시 버킷의 잠금 여부를 선택해 주십시오.
   주의

   버킷을 잠그면 설정한 기간 동안 객체가 변경되거나 삭제되지 않으며, 중도 해지 및 회원 탈퇴도 불가하므로 신중하게 선택해 주십시오.

   • 잠금을 활성화한 경우, 다음의 내용을 설정해 주십시오.
     • 최대 보존 기간: 버킷이 허용하는 최대 보존 기간으로, 0~365일 이내로 설정 가능
     • 기본 보존 기간: 버킷에 객체가 저장될 때 적용되는 기본 보존 기간으로, 최대 보존 기간 이내로 설정 가능
       • 추후 객체 저장 시 파일별로 보존 기간 설정 가능
6. 필요시 버킷의 암호화 설정 여부를 선택해 주십시오.
   • 암호화 설정에 대한 자세한 내용은 암호화 설정(KMS)을 참고해 주십시오.
   • 암호화를 활성화한 경우, 암호화 키 관리 방법 및 암호화 키를 선택해 주십시오.
     • NCP 관리형 키: 네이버 클라우드 플랫폼에서 관리하는 키
     • KMS 마스터 키: Key Management Service에서 생성한 AES256 또는 RSA-2048 유형 사용 가능. 단, 수렴 암호화를 선택한 AES256 키는 설정 불가
7. [다음] 버튼을 클릭해 주십시오.
8. 버킷의 공개 여부를 선택해 주십시오.
   • 공개 선택 시 버킷에 저장된 폴더/파일 목록이 공개되며, 각 파일에 대한 공개 여부는 파일 업로드 시 설정할 수 있습니다.
9. 필요시 다른 계정에 버킷 이용 권한을 부여하고, [다음] 버튼을 클릭해 주십시오.
   • Object Storage 서비스 이용 신청을 완료한 계정만 추가할 수 있습니다.
   • 버킷에 대한 목록 조회, 파일 업로드, ACL(접근 허용 계정 목록) 조회 및 수정 권한 중에서 선택적으로 부여할 수 있습니다.
10. 입력한 정보를 확인한 후 [버킷 생성] 버튼을 클릭해 주십시오.

암호화 설정(KMS)

버킷의 암호화를 설정하면 네이버 클라우드 플랫폼의 Key Management Service 서비스와 연동하여 버킷에 대한 접근을 제어하고 저장된 객체를 보호할 수 있습니다.
암호화를 한 번 설정한 후에는 해제할 수 없으며, 암호화를 설정하면 다음의 기능을 사용할 수 없습니다.

• 잠금 설정
• 정적 웹 사이트 호스팅
• 공개 여부 설정
• 타 계정 권한 부여
• 수명 주기 정책(Lifecycle Management) 설정

버킷 관리

생성한 버킷을 사용하다 보면 생성 당시 설정했던 버킷 옵션을 변경해야 하는 상황이 발생할 수 있습니다. Object Storage 서비스에서는 이미 생성한 버킷의 설정을 간단하게 변경할 수 있도록 지원하고 있습니다.
생성하여 사용 중인 버킷을 관리하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 Services > Storage > Object Storage 메뉴를 차례대로 클릭해 주십시오.
2. Bucket Management 메뉴를 클릭해 주십시오.
3. 버킷 이름 옆에 있는 에 마우스 커서를 올려 주십시오.
4. 필요한 관리 기능을 선택해 주십시오.
   
   • 버킷 정보
   • 버킷 삭제
   • 버킷 삭제 취소
   • 접근 제어
   • 권한 관리
   • 로그 관리
   • 잠금 관리
   • 정적 웹 사이트 호스팅
   • 이벤트 관리

버킷 정보

버킷 정보 화면이 나타나면 버킷의 상세 정보를 확인하거나 기능 버튼을 통해 버킷을 설정할 수 있습니다.
사용할 수 있는 기능과 목록에 표시되는 정보는 다음과 같습니다.

항목	설명
기능 버튼	[버킷 삭제]: 선택한 버킷 삭제 [버킷 삭제 취소]: 실행 중인 버킷 삭제 취소 [접근 제어]: 버킷 접근이 허용되는 서버 정의(VPC 환경에서만 표시) [권한 관리]: 버킷 공개 여부 설정 및 버킷 이용 권한을 타 계정에 부여 [잠금 관리]: 버킷 잠금 설정 [로그 관리]: 버킷 접근 로그를 저장하도록 설정
버킷 목록	버킷을 선택해 상세 정보를 확인하고 각 영역에서 을 클릭해 설정 변경 이름/버킷 이름: 버킷의 이름 크기: 버킷의 용량 생성(업로드)된 날짜: 버킷이 최초로 생성된 날짜 이벤트 관리: 버킷에 설정된 이벤트 알람 목록 접근 제어: 버킷 접근이 허용된 서버 목록 권한 관리: 버킷의 공개 여부 및 버킷 이용이 가능한 계정 목록 잠금 관리: 버킷의 잠금 설정 여부 암호화 관리: 버킷에 저장된 객체의 암호화 설정 여부 로그 관리: 버킷 접근 로그의 설정 정보 정적 웹 사이트 호스팅: 정적 웹 사이트 호스팅의 설정 여부 및 엔드포인트 정보

버킷 삭제

버킷을 삭제하는 방법은 다음과 같습니다.

1. 버킷이 다른 서비스와 연동된 경우, 버킷 삭제 팝업 창에 연동 서비스 목록이 표시됩니다. 연동된 서비스를 확인하고 계속 진행하려면 [다음] 버튼을 클릭해 주십시오.
2. 삭제하려는 버킷의 이름을 입력하고 [확인] 버튼을 클릭해 주십시오.
3. 삭제 팝업 창에서 작업이 완료됨을 확인하고 창을 닫아 주십시오.

버킷 삭제 취소

버킷 삭제가 실행되면 버킷 삭제 취소 메뉴가 활성화되어 삭제를 취소할 수 있습니다.
버킷 삭제를 취소하려면, 버킷 삭제 취소 팝업 창에서 [확인] 버튼을 클릭해 주십시오.

접근 제어

특정 서버에서만 버킷에 접근할 수 있도록 설정할 수 있습니다. 설정하는 방법은 다음과 같습니다.

1. 접근 제어 팝업 창이 나타나면 접근 제어 설정 항목의 을 클릭하여 기능을 활성화해 주십시오.
2. VPC 서버 목록에 표시된 서버 중 접근을 허용할 서버를 선택하고 을 클릭해 주십시오.
   • 선택된 서버가 ACL 설정 정보 목록으로 이동합니다.
   • 선택을 취소하려면 을 클릭해 주십시오.
   • 본인 소유의 VPC 내 서버를 설정할 수 있습니다.
3. 서버 선택을 완료했다면 [확인] 버튼을 클릭해 주십시오.
   • 접근이 허용된 서버 목록은 > 버킷 정보 메뉴에서 확인할 수 있습니다.

권한 관리

버킷을 전 세계에 공개할 수 있고, 네이버 클라우드 플랫폼의 다른 사용자에게 버킷의 이용 권한을 부여할 수 있습니다. 설정하는 방법은 다음과 같습니다.

1. 권한 관리 팝업 창이 나타나면 공개 관리 항목에서 공개 여부를 선택해 주십시오.
   • 공개 안함: 버킷 내 폴더/파일 목록 비공개
   • 공개: 전 세계 누구에게나 버킷에 저장된 폴더/파일 목록 공개. 각 파일에 대한 공개 여부는 파일 업로드 시 설정
2. 다른 계정 권한 항목에서 이용 권한을 부여할 계정을 입력하고 권한을 선택한 후, [추가] 버튼을 클릭해 주십시오.
   • Object Storage 서비스 이용 신청을 완료한 계정만 추가할 수 있습니다.
   • 버킷에 대한 목록 조회, 파일 업로드, ACL(접근 허용 계정 목록) 조회 및 수정 권한 중에서 선택적으로 부여할 수 있습니다.
3. [확인] 버튼을 클릭해 주십시오.

로그 관리

접근 로그 관리를 통해 버킷에 접근한 요청 이력을 저장할 수 있습니다. 로그 관리를 설정하면 매시간 25~35분에 이전 1시간 동안의 로그가 생성됩니다.(<예시> 17시 00분 00초~17시 59분 59초의 로그는 18시 25~35분에 생성)
접근 로그 관리를 설정하는 방법은 다음과 같습니다.

1. 로그 관리 팝업 창이 나타나면 로그를 저장할 버킷을 선택하고 버킷에 저장될 접근 로그의 접두어(prefix)를 입력한 후 [추가] 버튼을 클릭해 주십시오.
   • 본인 소유의 버킷에만 설정할 수 있습니다.
   • 한 버킷에 하나의 접두어(prefix)만 설정할 수 있습니다.
   • 로그 저장 버킷을 여러 개 설정할 수 있습니다.
   • 저장 정보의 입력을 취소하려면 [삭제] 버튼을 클릭해 주십시오.
2. [확인] 버튼을 클릭해 주십시오.
   • 접근 로그 설정 내역은 > 버킷 정보 메뉴에서 확인할 수 있습니다.

접근 로그 예시

Object Storage 서비스에서 수행된 모든 요청에 대한 상세 정보는 JSON 형식으로 저장됩니다.
다음은 Object Storage 버킷의 객체를 조회했을 때의 로그 예제입니다.

{
    "container_id": "ab71fd06-0000-0000-0000-5592541ad8f4",
    "container_name": "bckt100",
    "container_region": "FKR",
    "content_embedded": false,
    "credential_type": "hmac",
    "delete_marker": false,
    "e_tag": "6e86371700000000035d441b821",
    "format": 1,
    "headers": {
        "Accept": [
            "*/*"
        ],
        "Accept-Encoding": [
            "gzip, deflate, br"
        ],
        "Authorization": [
            "AWS4-HMAC-SHA256 Credential=ncp_iam_BFA000000000000006nh/20250311/us-east-1/execute-api/aws4_request, SignedHeaders=host;x-amz-date, Signature=8af104c3b00000000000000000000000000000003cb455aa9"
        ],
        "Cache-Control": [
            "no-cache"
        ],
        "Connection": [
            "keep-alive"
        ],
        "Host": [
            "kr.object.fin-ncloudstorage.com"
        ],
        "Postman-Token": [
            "3dfe6ce1-0000-0000-0000-81ef9cfb5ea5"
        ],
        "User-Agent": [
            "PostmanRuntime/7.43.0"
        ],
        "X-Amz-Date": [
            "20250311T072131Z"
        ]
    },
    "https": {
        "cipher_suite": "TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384",
        "protocol": "TLSv1.2"
    },
    "interface_type": "s3",
    "is_secure": true,
    "last_changed": "2025-03-11T07:15:41.180Z",
    "last_modified": "2025-03-11T07:15:41.180Z",
    "object_length": "1222615",
    "object_name": "Data1.xlsx",
    "principals": {
        "aws": "ncp_iam_BFA000000000000006nh",
        "identity": "ncp-0000-0000000000-0000-0000-0000-000000000002"
    },
    "protocol": "HTTP/1.1",
    "proxy_enabled": false,
    "region": "FIN-REAL-FKR",
    "remote_address": "123.45.123.45",
    "remote_user": "ncp_iam_BFA000000000000006nh",
    "request_id": "82e1edbe-0000-0000-0000-7632db57a302",
    "request_latency": "104",
    "request_method": "GET",
    "request_type": "REST.GET.OBJECT",
    "request_uri": "/bckt100/Data1.xlsx",
    "response_length": "1222615",
    "segment_count": "1",
    "server_name": "kr.object.fin-ncloudstorage.com",
    "stat": {
        "client_wait": 55.217,
        "post_transfer": 0.011,
        "pre_transfer": 21.333,
        "storage_wait": 26.671,
        "total_transfer": 81.046,
        "turn_around_time": 47.595
    },
    "status": 200,
    "storage_account_id": "ncp-0000-0",
    "storage_location_id": "789de67b-0000-0000-0000-43926b79f765",
    "tag_last_modified": "2025-03-11T07:15:41.180Z",
    "time_finish": "11/Mar/2025:07:21:31 +0000",
    "time_start": "11/Mar/2025:07:21:31 +0000",
    "timestamp_finish": "1741677691881",
    "timestamp_start": "1741677691777",
    "type": "http",
    "user_agent": "PostmanRuntime/7.43.0",
    "version_name": "00000195-840f-29fc-7305-58252309d3b3",
    "version_transient": true
}

로그 필드에 대한 설명은 다음과 같습니다.

잠금 관리

버킷에 객체 잠금(WORM: Write Once Read Many)을 설정하면, 설정한 기간에 객체가 변경되거나 삭제되지 않도록 보호할 수 있습니다. 장기간 객체를 저장할 때 객체 잠금을 설정하면 뜻하지 않은 객체의 변형 또는 삭제를 방지할 수 있습니다.

• 객체 잠금을 설정한 후에는 중도 해지 및 회원 탈퇴가 불가하므로 신중하게 선택해 주십시오.
• 객체 잠금을 설정한 기간에는 잠금을 해제할 수 없으나, 최대 보존 기간과 기본 보존 기간은 변경할 수 있습니다.
• 버킷을 생성할 때 또는 버킷이 비어있을 때 객체 잠금을 설정할 수 있습니다.
• 객체 잠금을 설정한 버킷은 파일을 업로드할 때 헤더에 Content MD5 값을 필수로 추가해야 합니다.
• 잠금 관리 팝업 창이 나타나면 다음의 내용을 설정할 수 있습니다.
  • 최대 보존 기간: 버킷이 허용하는 최대 보존 기간으로, 0~365일을 설정할 수 있습니다.
  • 기본 보존 기간: 버킷에 객체가 저장될 때 적용되는 기본 보존 기간으로, 최대 보존 기간 이내로 설정할 수 있으며 추후 객체 저장 시 보존 기간을 따로 설정할 수 있습니다.

정적 웹 사이트 호스팅

두 가지 유형의 호스팅 기능을 사용할 수 있습니다.

• 정적 웹 사이트 호스팅: 버킷 엔드포인트를 웹 주소로 사용합니다. 웹 사이트 엔드포인트의 콘텐츠에 접근하려면 버킷 안의 모든 파일이 공개로 설정되어야 합니다.
• 파일에 대한 요청 리다이렉션: 요청을 다른 버킷이나 도메인으로 리다이렉션합니다.

호스팅하는 방법은 다음과 같습니다.

1. 정적 웹 사이트 호스팅 팝업 창이 나타나면 을 클릭해 기능을 활성화해 주십시오.
2. 호스팅 유형을 선택해 주십시오.
3. 선택한 유형에 따른 설정 내용을 입력해 주십시오.
   • 정적 웹 사이트 호스팅을 선택한 경우, 다음의 내용을 설정해 주십시오.
     • 인덱스 파일: 웹 사이트의 기본 페이지이며 필수 입력
     • 오류 파일: 오류 발생 시 반환할 사용자 오류 페이지 설정
   • 파일에 대한 요청 리다이렉션을 선택한 경우, 다음의 내용을 설정해 주십시오.
     • 호스트 이름: 리다이렉션할 호스트이며 대상 버킷의 웹 사이트 주소 또는 개인 도메인 입력
     • 프로토콜: 환경에 맞게 없음, http, https 중에서 선택
4. [확인] 버튼을 클릭해 주십시오.
5. 버킷 웹 사이트 엔드포인트를 확인하고 [확인] 버튼을 클릭해 주십시오.
   • 을 클릭하면 엔드포인트 주소를 복사할 수 있습니다.

이벤트 관리

버킷에서 특정 이벤트가 발생하면 알람을 전달하도록 설정할 수 있습니다.

알람을 전달할 수 있는 이벤트는 다음과 같습니다.

알람 설정

이벤트 알람을 설정하는 방법은 다음과 같습니다.

1. 이벤트 관리 팝업 창이 나타나면 [생성] 버튼을 클릭해 주십시오.
2. 버킷 이벤트 생성 팝업 창이 나타나면 이벤트를 설정해 주십시오.
   • 이벤트 이름: 이벤트의 이름 입력
     • 알파벳, 숫자, 하이픈(-), 언더바(_)를 사용할 수 있고, 첫 문자는 알파벳 또는 숫자만 허용
   • 필터: 특정 객체에 대해서 이벤트를 필터링할 때 사용할 조건 입력
     • 정규 표현식으로 입력해 주십시오.(<예시> 접두사 images/: ^images/)
     • 필터는 객체 경로에 적용되며, 미입력 시 모든 객체에 대해 이벤트 발생
   • 이벤트 유형: 원하는 이벤트 유형 다중 선택
   • 대상: 이벤트 알람이 전달되는 목적지 선택. Cloud Functions만 지원
     • Cloud Functions를 선택하면 설정된 트리거 목록 표시. 트리거가 없다면 [트리거 생성] 버튼을 클릭해 새로운 트리거 생성. 트리거 생성에 대한 자세한 방법은 Object Storage 타입 트리거 참조
   • 재귀 호출 주의: 안내문 숙지 후 체크 박스 클릭
3. [생성] 버튼을 클릭해 주십시오.

알람 메시지 예시

Object Storage에서 보내는 알람 메시지 구조는 다음과 같습니다.

{
    "container_name": "버킷 이름",
    "event_name": "이벤트 이름",
    "event_type": "이벤트 종류",
    "event_version": "1.0",
    "object_length": "객체 크기",
    "object_name": "객체 키",
    "region": "리전 이름",
    "remote_address": "요청 IP",
    "remote_user_sha256": "사용자 Access Key의 SHA256 hash hex값",
    "remote_user_type": "사용자 종류",
    "request_method": "요청 Method",
    "request_type": "요청 종류",
    "timestamp_finish": "요청 처리가 끝난 시간, 유닉스 시간, 밀리초",
    "timestamp_start": "요청 처리를 시작한 시간, 유닉스 시간, 밀리초"
}

remote_user_type이 user가 아닌 경우 remote_address와 remote_user_sha256은 null이 들어갑니다.

알람 메시지 예시는 다음과 같습니다.

{
    "container_name": "mybucket",
    "event_name": "testevent",
    "event_type": "ObjectCreated:PUT",
    "event_version": "1.0",
    "object_length": "1000",
    "object_name": "test.png",
    "region": "FKR",
    "remote_address": "127.0.0.1",
    "remote_user_sha256": "ef5dd4b34d9de8d98182a9be416576efbd162b9a915d8b302ba8c3fa0c81b764",
    "remote_user_type": "user",
    "request_method": "PUT",
    "request_type": "REST.PUT.OBJECT",
    "timestamp_finish": "1609426801000",
    "timestamp_start": "1609426800000"
}