KRM API object.gdc.goog/v1

object.gdc.goog/v1

객체 스토리지 v1 API 그룹의 API 스키마 정의가 포함되어 있습니다.

버킷

버킷 API의 스키마를 정의합니다.

표시 위치: - BucketList

필드 설명
apiVersion 문자열 object.gdc.goog/v1
kind 문자열 Bucket
metadata ObjectMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
spec BucketSpec
status BucketStatus

BucketInfo

BucketInfo API의 스키마를 정의합니다.

표시 위치: - BucketInfoList

필드 설명
apiVersion 문자열 object.gdc.goog/v1
kind 문자열 BucketInfo
metadata ObjectMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
spec BucketInfoSpec
status BucketInfoStatus

BucketInfoList

BucketInfos 목록을 포함합니다.

필드 설명
apiVersion 문자열 object.gdc.goog/v1
kind 문자열 BucketInfoList
metadata ListMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
items BucketInfo 배열

BucketInfoSpec

BucketInfoSpec은 BucketInfo 리소스의 원하는 상태를 정의합니다.

표시 위치: - BucketInfo

필드 설명
description 문자열 버킷 콘텐츠에 대한 설명입니다.
storageClass ObjectStorageClass 데이터에 액세스해야 하는 빈도를 정의합니다. 사용 가능한 옵션은 Standard 및 Nearline입니다. Standard는 웹사이트, 스트리밍 동영상, 모바일 앱과 같이 자주 액세스하는 핫 데이터에 적합합니다. 30일 이상 저장할 수 있는 데이터에 사용됩니다. Nearline은 데이터 백업, 롱테일 멀티미디어 콘텐츠를 비롯해 60일 이상 저장될 수 있는 데이터에 적합합니다.
bucketPolicy GlobalBucketPolicy 버킷 리소스의 정책을 정의합니다. 지정하지 않으면 기본 정책이 적용됩니다.
location 문자열 버킷의 객체 데이터가 있는 물리적 장소를 정의합니다. 지정하지 않으면 버킷이 생성되는 위치로 기본 설정됩니다.
bucketName 문자열 프로비저닝된 버킷의 네임스페이스가 지정되지 않은 이름입니다. 로컬 도구와 라이브러리를 사용할 때 버킷을 참조하는 데 사용됩니다.
zonalEndpoints 문자열 배열 버킷에 연결할 수 있는 영역 DNS 엔드포인트입니다. 맞춤 장애 조치가 필요한 경우 이러한 엔드포인트를 사용하세요.
globalEndpoint 문자열 이 버킷의 데이터가 포함된 모든 영역으로 트래픽을 동적으로 라우팅하는 전역 엔드포인트입니다. 자동 장애 조치가 필요한 경우 이 엔드포인트를 사용하세요.
region 문자열 버킷이 저장된 리전입니다.
encryption EncryptionStatus 버킷의 암호화 상태입니다.
allowDegradedWrites 불리언 동기 버킷에만 사용됩니다. 복제 영역 중 하나를 사용할 수 없기 때문에 S3 작업이 비동기 복제로 되돌아가야 하는지 여부를 확인합니다. 이렇게 하면 복제 영역 중 하나가 다운되는 경우 동기식 버킷이 읽기 전용이 되지 않습니다. 비어 있으면 기본값은 false입니다.

BucketInfoStatus

BucketInfo의 관찰된 상태를 정의합니다.

표시 위치: - BucketInfo

필드 설명
conditions Condition 배열

BucketList

버킷 목록을 포함합니다.

필드 설명
apiVersion 문자열 object.gdc.goog/v1
kind 문자열 BucketList
metadata ListMeta metadata 필드는 Kubernetes API 문서를 참고하세요.
items 버킷 배열

BucketPolicy

버킷의 정책을 정의합니다.

표시 위치: - BucketSpec

필드 설명
lockingPolicy LockingPolicy 객체 잠금 정책입니다. 설정하면 객체 버전 관리가 사용 설정되고 버킷에 저장된 모든 객체에 이 정책이 적용됩니다. 잠긴 객체는 잠금이 만료될 때까지 삭제할 수 없습니다. 버킷을 만들 때만 사용 설정할 수 있으며 나중에 사용 중지할 수 없습니다. 사용 설정되지 않은 경우 객체 잠금 및 버전 관리가 사용 중지되며 사용 설정할 수 없습니다.
corsPolicy CorsPolicy 버킷에 설정된 맞춤 CORS 정책 사용자의 정책입니다. 버킷에 추가 CORS 정책이 필요한 경우 CorsPolicy를 사용 설정해야 합니다. 그렇지 않으면 버킷에 기본 UI 콘솔 CORS 정책만 적용됩니다. 버킷이 생성된 후 언제든지 CorsPolicy를 추가하거나 수정할 수 있습니다.
lifecyclePolicy LifecyclePolicy 버킷에 설정된 맞춤 수명 주기 정책 사용자의 정책입니다. 버킷이 생성된 후에는 언제든지 LifecyclePolicy를 추가, 수정, 삭제할 수 있습니다.

BucketSpec

BucketSpec은 버킷 리소스의 원하는 상태를 정의합니다.

표시 위치: - 버킷

필드 설명
description 문자열 버킷 콘텐츠에 대한 설명입니다.
storageClass ObjectStorageClass 데이터에 액세스해야 하는 빈도를 정의합니다. 사용 가능한 옵션은 Standard 및 Nearline입니다. Standard는 웹사이트, 스트리밍 동영상, 모바일 앱과 같이 자주 액세스하는 핫 데이터에 적합합니다. 30일 이상 저장할 수 있는 데이터에 사용됩니다. Nearline은 데이터 백업, 롱테일 멀티미디어 콘텐츠를 비롯해 60일 이상 저장될 수 있는 데이터에 적합합니다.
bucketPolicy BucketPolicy 버킷 리소스의 정책을 정의합니다. 지정하지 않으면 기본 정책이 적용됩니다.
location 문자열 버킷의 객체 데이터가 있는 물리적 장소를 정의합니다. 지정하지 않으면 버킷이 생성되는 위치로 기본 설정됩니다.

BucketStatus

버킷의 관찰된 상태를 정의합니다.

표시 위치: - 버킷

필드 설명
fullyQualifiedName 문자열 프로비저닝된 버킷의 이름입니다. 이 이름은 외부 도구와 라이브러리를 사용할 때 버킷을 참조하는 데 사용됩니다.
conditions Condition 배열 버킷의 상태를 지정합니다. 지원되는 조건에는 BucketReady이 포함됩니다. BucketReady가 True이면 버킷이 프로비저닝되었으며 사용할 준비가 되었음을 나타냅니다.
endpoint 문자열 버킷에 연결할 수 있는 DNS 엔드포인트입니다.
region 문자열 버킷이 저장된 리전입니다.
encryption EncryptionStatus 버킷의 암호화 상태입니다.
errorStatus ErrorStatus ErrorStatus에는 관찰된 시간이 포함된 가장 최근 오류가 포함됩니다.

CorsPolicy

버킷에 맞춤 CORS 정책을 설정하는 전략을 정의합니다.

표시 위치: - BucketPolicy - GlobalBucketPolicy

필드 설명
enableCorsPolicy 불리언 사용자가 버킷에 맞춤 정책을 적용할지 여부를 정의합니다. 예인 경우 CorsDetail에 정의된 맞춤 정책이 읽혀집니다. 그렇지 않으면 맞춤 정책이 설정되어 있어도 CorsDetail이 사용되지 않습니다.
corsDetail CorsRule 배열 설정되는 맞춤 CORS 정책의 세부정보입니다.

CorsRule

CORS 규칙과 관련된 정보를 정의합니다.

표시 위치: - CorsPolicy

필드 설명
allowedHeaders 문자열 배열 Access-Control-Request-Headers 헤더에 지정된 헤더입니다.
allowedMethods 문자열 배열 허용된 출처에서 실행할 수 있는 HTTP 메서드입니다.
allowedOrigins 문자열 배열 버킷에 액세스할 수 있는 출처입니다.
exposeHeaders 문자열 배열 액세스할 수 있는 응답의 헤더입니다.
id 문자열 규칙의 고유 식별자입니다. 값은 255자(영문 기준)를 초과할 수 없습니다.

EncryptionStatus

EncryptionStatus는 버킷의 암호화 상태를 정의합니다.

표시 위치: - BucketInfoSpec - BucketStatus

필드 설명
type EncryptionType 버킷에 사용할 암호화 유형을 정의합니다. 사용 가능한 옵션은 다음과 같습니다. - CMEK - 고객에게 청구되는 HSM에 루트가 있는 KMS 지원 키를 만드는 고객 관리 암호화 키 고객은 KMS를 통해 이러한 키에 액세스하고 키를 관리할 수 있습니다.
keyRef ObjectReference KeyRef는 버킷의 객체를 암호화하는 데 기본 키로 사용되는 키를 참조합니다.

GlobalBucketPolicy

버킷의 정책을 정의합니다.

표시 위치: - BucketInfoSpec

필드 설명
corsPolicy CorsPolicy 버킷에 설정된 맞춤 CORS 정책 사용자의 정책입니다. 버킷에 추가 CORS 정책이 필요한 경우 CorsPolicy를 사용 설정해야 합니다. 그렇지 않으면 버킷에 기본 UI 콘솔 CORS 정책만 적용됩니다. 버킷이 생성된 후 언제든지 CorsPolicy를 추가하거나 수정할 수 있습니다.
lifecyclePolicy LifecyclePolicy 버킷에 설정된 맞춤 수명 주기 정책 사용자의 정책입니다. 버킷이 생성된 후에는 언제든지 LifecyclePolicy를 추가, 수정, 삭제할 수 있습니다.

LifecycleExpiration

표시 위치: - LifecycleRule

필드 설명
date 시간 객체를 삭제해야 하는 특정 날짜입니다.
days 정수 이 객체에 규칙이 적용되는 기간(일)입니다.

LifecycleNoncurrentExpiration

표시 위치: - LifecycleRule

필드 설명
noncurrentDays 정수 수명 주기 규칙이 작업을 수행하기 전 객체가 이전 버전 상태로 유지되는 기간(일)입니다.

LifecyclePolicy

표시 위치: - BucketPolicy - GlobalBucketPolicy

필드 설명
enable 불리언 사용자가 버킷에서 맞춤 수명 주기 정책을 사용 설정하기를 원하는지 여부를 정의합니다.
lifecycleRules LifecycleRule 배열 버킷의 객체에 만료 작업을 수행할 수 있는 하나 이상의 수명 주기 구성 규칙으로 구성됩니다.

LifecycleRule

표시 위치: - LifecyclePolicy

필드 설명
id 문자열 규칙의 고유 식별자입니다. 값은 255자(영문 기준)를 초과할 수 없습니다.
status LifecycleRuleStatus 수명 주기 규칙의 상태입니다. 이 규칙이 조치를 취하는지 여부를 나타냅니다. 상태는 언제든지 변경할 수 있으며 '사용' 규칙만 적용됩니다.
expiration LifecycleExpiration 현재 버전의 객체에 대한 만료 동작입니다. 만료 또는 NoncurrentExpiration, 또는 둘 다 제공해야 합니다. 만료 동작이 없는 규칙은 무시됩니다.
noncurrentExpiration LifecycleNoncurrentExpiration 이전 객체의 만료 동작입니다.
filter LifecycleRuleFilter 규칙의 필터입니다. 필터가 비어 있으면 규칙이 버킷의 모든 객체에 적용됩니다.

LifecycleRuleFilter

수명 주기 규칙에 설정할 수 있는 필터를 정의합니다.

표시 위치: - LifecycleRule

필드 설명
prefixFilter 문자열 제공된 접두사와 객체를 일치시킵니다. 빈 문자열의 접두사는 버킷의 모든 객체에 적용됨을 의미합니다.
tagFilters 태그 배열 제공된 태그와 객체를 일치시킵니다. 객체의 태그는 키와 값이 정확하게 일치해야 합니다.

LifecycleRuleStatus

기본 유형: string

표시 위치: - LifecycleRule

LockingPolicy

버킷의 객체를 잠그는 전략을 정의합니다.

표시 위치: - BucketPolicy

필드 설명
defaultObjectRetentionDays 정수 모든 객체의 각 버전이 보관되는 최소 일수를 지정합니다. 보관 기간 중에는 객체를 삭제할 수 없습니다. 버킷에 객체가 포함되어 있는 경우에도 삭제할 수 없습니다. 지정하지 않으면 기본 객체 보관 기간이 설정되지 않습니다. 생성 후 수정할 수 있지만 변경사항은 새 객체와 버전에만 적용됩니다. 기존 객체와 버전은 이전 값을 계속 사용합니다.

태그

수명 주기 필터에서 사용할 수 있는 객체의 태그를 정의합니다.

표시 위치: - LifecycleRuleFilter

필드 설명
key 문자열
value 문자열