이 페이지에서는 새 객체에 보존 조치를 기본적으로 적용하고 개별 객체에 보존 조치를 적용하는 등 객체 보존 조치를 사용하는 방법을 설명합니다.
필수 권한
Cloud Storage에서 이 기능을 사용하려면 먼저 Cloud Storage에서 버킷과 객체를 보고 업데이트할 수 있는 권한이 있어야 합니다.
버킷이 포함된 프로젝트의 소유자라면 필요한 권한이 있을 가능성이 높습니다.
IAM을 사용하는 경우에는 관련 버킷에 대한
storage.buckets.update
,storage.buckets.get
,storage.objects.update
,storage.objects.get
권한이 있어야 합니다. 이러한 권한이 있는 스토리지 관리자와 같은 역할을 얻는 방법은 IAM 권한 사용을 참조하세요.ACL을 사용하는 경우에는 관련 버킷과 해당 버킷 내 객체에 대한 소유자 권한이 있어야 합니다. 이를 수행하는 방법은 ACL 설정을 참조하세요.
기본 이벤트 기반 보존 조치 속성 사용
다음 작업에서는 버킷에 대한 기본 이벤트 기반 보존 조치 속성을 설정하고 보는 방법을 보여줍니다. 이 속성이 사용 설정되어 있으면 버킷에 새로 추가되는 객체에 자동으로 이벤트 기반 보존 조치가 적용됩니다.
기본 이벤트 기반 보존 조치 속성 설정
버킷의 기본 이벤트 기반 보존 조치 속성을 사용 설정하거나 중지하려면 다음을 수행하세요.
콘솔
- Google Cloud 콘솔에서 Cloud Storage 버킷 페이지로 이동합니다.
버킷 목록에서 기본 이벤트 기반 보존 조치 속성을 설정하려는 버킷의 이름을 클릭합니다.
페이지 상단의 보호 탭을 선택합니다.
버킷의 현재 상태가 기본 이벤트 기반 보존 조치 옵션 섹션에 표시됩니다.
기본 이벤트 기반 보존 조치 옵션 섹션에서 현재 상태를 클릭하여 변경합니다.
상태가 사용 설정됨 또는 사용 중지됨으로 표시됩니다.
Google Cloud 콘솔에서 실패한 Cloud Storage 작업에 대한 자세한 오류 정보를 가져오는 방법은 문제 해결을 참조하세요.
명령줄
gcloud storage buckets update
명령어를 적절한 플래그와 함께 사용합니다.
gcloud storage buckets update gs://BUCKET_NAME FLAG
각 항목의 의미는 다음과 같습니다.
BUCKET_NAME
은 관련 버킷의 이름입니다. 예를 들면my-bucket
입니다.FLAG
가--default-event-based-hold
이면 기본 이벤트 기반 객체 보존 조치가 사용 설정되고--no-default-event-based-hold
이면 기본 이벤트 기반 객체 보존 조치가 중지됩니다.
클라이언트 라이브러리
C++
자세한 내용은 Cloud Storage C++ API 참고 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
다음 샘플에서는 버킷에서 기본 이벤트 기반 보존 조치를 사용 설정합니다.
다음 샘플에서는 버킷에서 기본 이벤트 기반 보존 조치를 사용 중지합니다.
C#
자세한 내용은 Cloud Storage C# API 참조 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
다음 샘플에서는 버킷에서 기본 이벤트 기반 보존 조치를 사용 설정합니다.
다음 샘플에서는 버킷에서 기본 이벤트 기반 보존 조치를 사용 중지합니다.
Go
자세한 내용은 Cloud Storage Go API 참조 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
다음 샘플에서는 버킷에서 기본 이벤트 기반 보존 조치를 사용 설정합니다.
다음 샘플에서는 버킷에서 기본 이벤트 기반 보존 조치를 사용 중지합니다.
Java
자세한 내용은 Cloud Storage Java API 참조 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
다음 샘플에서는 버킷에서 기본 이벤트 기반 보존 조치를 사용 설정합니다.
다음 샘플에서는 버킷에서 기본 이벤트 기반 보존 조치를 사용 중지합니다.
Node.js
자세한 내용은 Cloud Storage Node.js API 참조 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
다음 샘플에서는 버킷에서 기본 이벤트 기반 보존 조치를 사용 설정합니다.
다음 샘플에서는 버킷에서 기본 이벤트 기반 보존 조치를 사용 중지합니다.
PHP
자세한 내용은 Cloud Storage PHP API 참조 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
다음 샘플에서는 버킷에서 기본 이벤트 기반 보존 조치를 사용 설정합니다.
다음 샘플에서는 버킷에서 기본 이벤트 기반 보존 조치를 사용 중지합니다.
Python
자세한 내용은 Cloud Storage Python API 참조 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
다음 샘플에서는 버킷에서 기본 이벤트 기반 보존 조치를 사용 설정합니다.
다음 샘플에서는 버킷에서 기본 이벤트 기반 보존 조치를 사용 중지합니다.
Ruby
자세한 내용은 Cloud Storage Ruby API 참조 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
다음 샘플에서는 버킷에서 기본 이벤트 기반 보존 조치를 사용 설정합니다.
다음 샘플에서는 버킷에서 기본 이벤트 기반 보존 조치를 사용 중지합니다.
REST API
JSON API
Authorization
헤더에 대한 액세스 토큰을 생성하려면 gcloud CLI가 설치 및 초기화되어 있어야 합니다.또는 OAuth 2.0 Playground를 사용하여 액세스 토큰을 만들고
Authorization
헤더에 포함할 수 있습니다.다음 정보를 포함하는 JSON 파일을 만듭니다.
{ "defaultEventBasedHold": STATE }
여기서 STATE는
true
또는false
입니다.cURL
을 사용하여PATCH
버킷 요청으로 JSON API를 호출합니다.curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=defaultEventBasedHold"
각 항목의 의미는 다음과 같습니다.
JSON_FILE_NAME
은 2단계에서 만든 파일의 경로입니다.BUCKET_NAME
은 관련 버킷의 이름입니다. 예를 들면my-bucket
입니다.
XML API
XML API는 객체 보존 조치 작업에 사용할 수 없습니다. gcloud CLI와 같은 다른 Cloud Storage 도구 중 하나를 대신 사용하세요.
버킷의 기본 보존 상태 확인
버킷에서 새 객체에 기본적으로 이벤트 기반 보존 조치가 적용되는지 확인하려면 다음을 수행하세요.
콘솔
- Google Cloud 콘솔에서 Cloud Storage 버킷 페이지로 이동합니다.
버킷 목록에서 기본 이벤트 기반 상태를 확인하려는 버킷의 이름을 클릭합니다.
페이지 상단의 보호 탭을 선택합니다.
상태가 기본 이벤트 기반 보존 조치 옵션 섹션에 표시됩니다.
Google Cloud 콘솔에서 실패한 Cloud Storage 작업에 대한 자세한 오류 정보를 가져오는 방법은 문제 해결을 참조하세요.
명령줄
gcloud storage buckets describe
명령어를 --format
플래그와 함께 사용합니다.
gcloud storage buckets describe gs://BUCKET_NAME --format="default(default_event_based_hold)"
여기서 BUCKET_NAME
은 상태를 보려는 버킷의 이름입니다. 예를 들면 my-bucket
입니다.
성공하면 다음 예시와 비슷한 응답이 표시됩니다.
default_event_based_hold: true
클라이언트 라이브러리
C++
자세한 내용은 Cloud Storage C++ API 참고 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
C#
자세한 내용은 Cloud Storage C# API 참고 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Go
자세한 내용은 Cloud Storage Go API 참고 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Java
자세한 내용은 Cloud Storage Java API 참고 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
자세한 내용은 Cloud Storage Node.js API 참고 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
PHP
자세한 내용은 Cloud Storage PHP API 참고 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
자세한 내용은 Cloud Storage Python API 참고 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Ruby
자세한 내용은 Cloud Storage Ruby API 참고 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
REST API
JSON API
Authorization
헤더에 대한 액세스 토큰을 생성하려면 gcloud CLI가 설치 및 초기화되어 있어야 합니다.또는 OAuth 2.0 Playground를 사용하여 액세스 토큰을 만들고
Authorization
헤더에 포함할 수 있습니다.cURL
을 사용하여 원하는fields
가 포함된GET
버킷 요청으로 JSON API를 호출합니다.curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=defaultEventBasedHold"
여기서
BUCKET_NAME
은 관련 버킷의 이름입니다. 예를 들면my-bucket
입니다.버킷에 기본 이벤트 기반 보존 조치가 사용 설정되어 있으면 다음 예시와 같은 응답이 표시됩니다.
{ "defaultEventBasedHold": true }
XML API
XML API는 객체 보존 조치 작업에 사용할 수 없습니다. gcloud CLI와 같은 다른 Cloud Storage 도구 중 하나를 대신 사용하세요.
개별 객체 보존 조치 관리
다음 태스크에서는 개별 객체에 대한 보존 조치를 수정하고 보는 방법을 보여줍니다.
객체 보존 조치 적용 또는 해제
버킷의 객체에 보존 조치를 적용하거나 해제하려면 다음 안내를 따르세요.
콘솔
- Google Cloud 콘솔에서 Cloud Storage 버킷 페이지로 이동합니다.
버킷 목록에서 보존 조치를 적용하거나 삭제하려는 객체가 있는 버킷의 이름을 클릭합니다.
보존 조치를 적용하거나 삭제할 객체의 이름 옆에 있는 체크박스를 선택합니다.
보존 조치 관리 버튼을 클릭합니다.
보존 조치 관리 창이 나타납니다.
원하는 경우 각 보존 조치 유형의 체크박스를 전환합니다.
보존 설정 저장을 클릭합니다.
Google Cloud 콘솔에서 실패한 Cloud Storage 작업에 대한 자세한 오류 정보를 가져오는 방법은 문제 해결을 참조하세요.
명령줄
gcloud storage objects update
명령어를 적절한 플래그와 함께 사용합니다.
gcloud storage objects update gs://BUCKET_NAME/OBJECT_NAME FLAG
각 항목의 의미는 다음과 같습니다.
BUCKET_NAME
은 관련 버킷의 이름입니다. 예를 들면my-bucket
입니다.OBJECT_NAME
은 관련 객체의 이름입니다. 예를 들면pets/dog.png
입니다.FLAG
는 다음 중 하나입니다.--event-based-hold
: 객체의 이벤트 기반 보존 조치를 사용 설정합니다.--no-event-based-hold
: 객체의 이벤트 기반 보존 조치를 중지합니다.--temporary-hold
: 객체의 임시 보존을 사용 설정합니다.--no-temporary-hold
: 객체의 임시 보존을 중지합니다.
보존 조치 유형에 대한 자세한 내용은 객체 보존 조치를 참조하세요.
클라이언트 라이브러리
C++
자세한 내용은 Cloud Storage C++ API 참고 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
다음 샘플에서는 객체에 이벤트 기반 보존 조치를 설정합니다.
다음 샘플에서는 객체에서 이벤트 기반 보존 조치를 해제합니다.
다음 샘플에서는 객체에 임시 보존 조치를 설정합니다.
다음 샘플에서는 객체에서 임시 보존 조치를 해제합니다.
C#
자세한 내용은 Cloud Storage C# API 참조 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
다음 샘플에서는 객체에 이벤트 기반 보존 조치를 설정합니다.
다음 샘플에서는 객체에서 이벤트 기반 보존 조치를 해제합니다.
다음 샘플에서는 객체에 임시 보존 조치를 설정합니다.
다음 샘플에서는 객체에서 임시 보존 조치를 해제합니다.
Go
자세한 내용은 Cloud Storage Go API 참조 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
다음 샘플에서는 객체에 이벤트 기반 보존 조치를 설정합니다.
다음 샘플에서는 객체에서 이벤트 기반 보존 조치를 해제합니다.
다음 샘플에서는 객체에 임시 보존 조치를 설정합니다.
다음 샘플에서는 객체에서 임시 보존 조치를 해제합니다.
Java
자세한 내용은 Cloud Storage Java API 참조 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
다음 샘플에서는 객체에 이벤트 기반 보존 조치를 설정합니다.
다음 샘플에서는 객체에서 이벤트 기반 보존 조치를 해제합니다.
다음 샘플에서는 객체에 임시 보존 조치를 설정합니다.
다음 샘플에서는 객체에서 임시 보존 조치를 해제합니다.
Node.js
자세한 내용은 Cloud Storage Node.js API 참조 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
다음 샘플에서는 객체에 이벤트 기반 보존 조치를 설정합니다.
다음 샘플에서는 객체에서 이벤트 기반 보존 조치를 해제합니다.
다음 샘플에서는 객체에 임시 보존 조치를 설정합니다.
다음 샘플에서는 객체에서 임시 보존 조치를 해제합니다.
PHP
자세한 내용은 Cloud Storage PHP API 참조 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
다음 샘플에서는 객체에 이벤트 기반 보존 조치를 설정합니다.
다음 샘플에서는 객체에서 이벤트 기반 보존 조치를 해제합니다.
다음 샘플에서는 객체에 임시 보존 조치를 설정합니다.
다음 샘플에서는 객체에서 임시 보존 조치를 해제합니다.
Python
자세한 내용은 Cloud Storage Python API 참조 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
다음 샘플에서는 객체에 이벤트 기반 보존 조치를 설정합니다.
다음 샘플에서는 객체에서 이벤트 기반 보존 조치를 해제합니다.
다음 샘플에서는 객체에 임시 보존 조치를 설정합니다.
다음 샘플에서는 객체에서 임시 보존 조치를 해제합니다.
Ruby
자세한 내용은 Cloud Storage Ruby API 참조 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
다음 샘플에서는 객체에 이벤트 기반 보존 조치를 설정합니다.
다음 샘플에서는 객체에서 이벤트 기반 보존 조치를 해제합니다.
다음 샘플에서는 객체에 임시 보존 조치를 설정합니다.
다음 샘플에서는 객체에서 임시 보존 조치를 해제합니다.
REST API
JSON API
Authorization
헤더에 대한 액세스 토큰을 생성하려면 gcloud CLI가 설치 및 초기화되어 있어야 합니다.또는 OAuth 2.0 Playground를 사용하여 액세스 토큰을 만들고
Authorization
헤더에 포함할 수 있습니다.다음 정보를 포함하는 JSON 파일을 만듭니다.
{ "HOLD_TYPE": STATE }
각 항목의 의미는 다음과 같습니다.
HOLD_TYPE
은 객체에서 설정하거나 해제하려는 보존 조치 유형입니다. 예를 들면temporaryHold
또는eventBasedHold
입니다. 보존 조치 유형에 대한 자세한 내용은 객체 보존 조치를 참조하세요.STATE
는 보존 조치를 적용하려면true
이고 보존 조치를 해제하려면false
입니다.
cURL
을 사용하여PATCH
객체 요청으로 JSON API를 호출합니다.curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME"
각 항목의 의미는 다음과 같습니다.
JSON_FILE_NAME
은 2단계에서 만든 파일의 경로입니다.BUCKET_NAME
은 관련 버킷의 이름입니다. 예를 들면my-bucket
입니다.OBJECT_NAME
은 관련 객체의 URL 인코딩 이름입니다. 예를 들어pets/dog.png
는pets%2Fdog.png
로 URL 인코딩됩니다.
XML API
XML API는 객체 보존 조치 작업에 사용할 수 없습니다. gcloud CLI와 같은 다른 Cloud Storage 도구 중 하나를 대신 사용하세요.
객체의 보존 상태 확인
객체에 어떤 보존 조치가 적용되었는지 확인하려면 객체 메타데이터 보기의 일반 안내를 따릅니다.
다음 단계
- 객체에 적용 가능한 다양한 보존 조치 유형을 비롯하여 객체 보존 조치에 대해 자세히 알아보기
- 보존 정책 사용 방법 알아보기
- 경합 상태 방지를 위한 요청 전제조건 사용 방법 알아보기