PutMetadata

객체 메타데이터 업데이트 옵션을 설명합니다.

JSON 표현 
{
  "customMetadata": {
    string: string,
    ...
  },
  "contentDisposition": string,
  "contentEncoding": string,
  "contentLanguage": string,
  "contentType": string,
  "cacheControl": string,
  "customTime": string,
  "objectRetention": {
    object (ObjectRetention)
  }
}
필드
customMetadata

map (key: string, value: string)

(선택사항) 객체의 커스텀 메타데이터를 업데이트합니다. 이 작업은 개별 커스텀 메타데이터 키-값 쌍을 추가하거나 설정합니다. 빈 값으로 지정된 키는 값이 삭제됩니다. 요청에 포함되지 않은 기존 커스텀 메타데이터 키는 변경되지 않습니다. 자세한 내용은 커스텀 메타데이터를 참조하세요.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
contentDisposition

string

(선택사항) 객체 Content-Disposition 고정 메타데이터를 업데이트합니다. 요청에서 설정되지 않은 값은 무시됩니다. 메타데이터를 삭제하려면 빈 값을 설정합니다. 자세한 내용은 Content-Disposition을 참조하세요.
contentEncoding

string

(선택사항) 객체 Content-Encoding 고정 메타데이터를 업데이트합니다. 요청에서 설정되지 않은 값은 무시됩니다. 메타데이터를 삭제하려면 빈 값을 설정합니다. 자세한 내용은 Content-Encoding을 참조하세요.
contentLanguage

string

(선택사항) 객체 Content-Language 고정 메타데이터를 업데이트합니다. 메타데이터 값은 ISO 639-1 언어 코드를 사용해야 합니다. 메타데이터 값의 최대 길이는 100자입니다. 요청에서 설정되지 않은 값은 무시됩니다. 메타데이터를 삭제하려면 빈 값을 설정합니다. 자세한 내용은 Content-Language를 참조하세요.
contentType

string

(선택사항) 객체 Content-Type 고정 메타데이터를 업데이트합니다. 요청에서 설정되지 않은 값은 무시됩니다. 메타데이터를 삭제하려면 빈 값을 설정합니다. 자세한 내용은 Content-Type을 참조하세요.
cacheControl

string

(선택사항) 객체 Cache-Control 고정 메타데이터를 업데이트합니다. 요청에서 설정되지 않은 값은 무시됩니다. 메타데이터를 삭제하려면 빈 값을 설정합니다. 또한 Custom-Time의 값은 줄일 수 없습니다. 자세한 내용은 Cache-Control을 참조하세요.
customTime

string

(선택사항) 객체 Custom-Time 고정 메타데이터를 업데이트합니다. 요청에서 설정되지 않은 값은 무시됩니다. 메타데이터를 삭제하려면 빈 값을 설정합니다. 시간은 RFC 3339 형식으로 지정해야 합니다(예: YYYY-MM-DD'T'HH:MM:SS'Z' 또는 YYYY-MM-DD'T'HH:MM:SS.SS'Z'). 자세한 내용은 Custom-Time을 참조하세요.
objectRetention

object (ObjectRetention)

(선택사항) 객체의 보관 구성 업데이트 객체의 보관을 삭제하려면 retentionMode와 retainUntilTime을 모두 설정하지 않은 상태로 두어야 합니다 (생략). retentionMode를 RETENTION_MODE_UNSPECIFIED로 설정하면 아무 작업도 하지 않는 것으로 처리됩니다. 설정되지 않은 필드와 달리 보관 설정을 수정하거나 삭제하지 않습니다. LOCKED 보관 모드가 있는 객체는 보관을 삭제하거나 retainUntilTime을 줄일 수 없습니다. 자세한 내용은 객체 보관을 참조하세요.

ObjectRetention

객체 보관 업데이트 옵션을 설명합니다.

JSON 표현 
{
  "retainUntilTime": string,
  "retentionMode": enum (RetentionMode)
}
필드
retainUntilTime

string

(필수 항목) 객체의 보관 만료 시간으로, 이 시간 동안 객체가 삭제되거나 덮어쓰기되지 않도록 보호됩니다. 시간은 RFC 3339 형식으로 지정해야 합니다(예: YYYY-MM-DD'T'HH:MM:SS'Z' 또는 YYYY-MM-DD'T'HH:MM:SS.SS'Z'). 객체의 보관을 삭제하려면 retentionMode와 retainUntilTime을 모두 설정하지 않은 상태로 두어야 합니다 (생략). retentionMode를 RETENTION_MODE_UNSPECIFIED로 설정하면 아무 작업도 하지 않는 것으로 처리됩니다. 설정되지 않은 필드와 달리 보관 설정을 수정하거나 삭제하지 않습니다.
retentionMode

enum (RetentionMode)

(필수 항목) 보관 모드입니다.

RetentionMode

보관 모드입니다.

열거형
RETENTION_MODE_UNSPECIFIED 보관 모드가 지정되지 않았습니다.
LOCKED 보관 모드가 LOCKED인 경우 retainUntilTime을 삭제하거나 줄일 수 없습니다.
UNLOCKED 보관 모드가 UNLOCKED인 경우 retainUntilTime을 삭제하거나 수정할 수 있습니다.