이 페이지는 Cloud Translation API를 통해 번역되었습니다.

TransferOptions
컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

TransferOptions는 전송의 객체에 대해 실행할 작업을 정의합니다.

JSON 표현

JSON 표현
{ "overwriteObjectsAlreadyExistingInSink": boolean, "deleteObjectsUniqueInSink": boolean, "deleteObjectsFromSourceAfterTransfer": boolean, "overwriteWhen": enum (`OverwriteWhen`), "metadataOptions": { object (`MetadataOptions`) } }

{
  "overwriteObjectsAlreadyExistingInSink": boolean,
  "deleteObjectsUniqueInSink": boolean,
  "deleteObjectsFromSourceAfterTransfer": boolean,
  "overwriteWhen": enum (OverwriteWhen),
  "metadataOptions": {
    object (MetadataOptions)
  }
}

필드
`overwriteObjectsAlreadyExistingInSink`	`boolean` 이미 싱크에 있는 객체를 덮어쓸 때 기본적으로 소스와 다른 객체만 덮어쓰기가 실행됩니다. 이 속성이 true이면 이름이 소스의 객체와 일치하는 모든 싱크 객체가 소스 객체로 덮어쓰기됩니다.
`deleteObjectsUniqueInSink`	`boolean` 싱크에만 있는 객체를 삭제해야 하는지 여부입니다. 참고: 이 옵션과 `deleteObjectsFromSourceAfterTransfer`는 상호 배타적입니다.
`deleteObjectsFromSourceAfterTransfer`	`boolean` 객체가 소스에서 싱크로 전송된 후 소스에서 삭제할지 여부입니다. 참고: 이 옵션과 `deleteObjectsUniqueInSink`는 상호 배타적입니다.
`overwriteWhen`	`enum (OverwriteWhen)` 이미 싱크에 있는 객체를 덮어쓸 때 설정하지 않으면 덮어쓰기 동작이 `overwriteObjectsAlreadyExistingInSink`에 의해 결정됩니다.
`metadataOptions`	`object (MetadataOptions)` 전송 작업에 선택된 메타데이터 옵션을 나타냅니다.

OverwriteWhen

소스에서 일치하는 이름의 객체가 발견될 때 싱크에서 객체를 덮어쓸 시기를 지정합니다.

열거형
`OVERWRITE_WHEN_UNSPECIFIED`	덮어쓰기 동작이 지정되지 않았습니다.
`DIFFERENT`	객체의 이름은 동일하지만 HTTP ETag 또는 체크섬 값이 다른 경우에만 대상 객체를 소스 객체로 덮어씁니다.
`NEVER`	소스 객체의 이름이 동일한 경우 대상 객체를 덮어쓰지 않습니다. 이 경우 소스 객체는 전송되지 않습니다.
`ALWAYS`	HTTP Etag 또는 체크섬 값이 동일하더라도 항상 대상 객체를 소스 객체로 덮어씁니다.

MetadataOptions

전송을 실행하기 위한 메타데이터 옵션을 지정합니다.

JSON 표현

JSON 표현
{ "symlink": enum (`Symlink`), "mode": enum (`Mode`), "gid": enum (`GID`), "uid": enum (`UID`), "acl": enum (`Acl`), "storageClass": enum (`StorageClass`), "temporaryHold": enum (`TemporaryHold`), "kmsKey": enum (`KmsKey`), "timeCreated": enum (`TimeCreated`) }

{
  "symlink": enum (Symlink),
  "mode": enum (Mode),
  "gid": enum (GID),
  "uid": enum (UID),
  "acl": enum (Acl),
  "storageClass": enum (StorageClass),
  "temporaryHold": enum (TemporaryHold),
  "kmsKey": enum (KmsKey),
  "timeCreated": enum (TimeCreated)
}

필드
`symlink`	`enum (Symlink)` 전송에서 심볼릭 링크를 처리하는 방법을 지정합니다. 기본적으로 심볼릭 링크는 보존되지 않습니다. POSIX 파일 시스템이 포함된 전송에만 적용되며 다른 전송에서는 무시됩니다.
`mode`	`enum (Mode)` 전송에서 각 파일의 모드 속성을 처리하는 방법을 지정합니다. 기본적으로 모드는 보존되지 않습니다. POSIX 파일 시스템이 포함된 전송에만 적용되며 다른 전송에서는 무시됩니다.
`gid`	`enum (GID)` 전송에서 각 파일의 POSIX 그룹 ID (GID) 속성을 처리하는 방법을 지정합니다. 기본적으로 GID는 보존되지 않습니다. POSIX 파일 시스템이 포함된 전송에만 적용되며 다른 전송에서는 무시됩니다.
`uid`	`enum (UID)` 전송에서 각 파일의 POSIX 사용자 ID (UID) 속성을 처리하는 방법을 지정합니다. 기본적으로 UID는 보존되지 않습니다. POSIX 파일 시스템이 포함된 전송에만 적용되며 다른 전송에서는 무시됩니다.
`acl`	`enum (Acl)` Google Cloud Storage 버킷 간에 전송할 때 각 객체의 ACL을 보존하는 방법을 지정합니다. 지정하지 않으면 기본 동작은 ACL_DESTINATION_BUCKET_DEFAULT와 동일합니다.
`storageClass`	`enum (StorageClass)` Google Cloud Storage 버킷으로 전송되는 객체에 설정할 스토리지 클래스를 지정합니다. 지정하지 않으면 기본 동작은 `STORAGE_CLASS_DESTINATION_BUCKET_DEFAULT`와 동일합니다.
`temporaryHold`	`enum (TemporaryHold)` Google Cloud Storage 버킷 간의 전송을 위해 각 객체의 임시 보류 상태를 보존하는 방법을 지정합니다. 지정하지 않으면 기본 동작은 `TEMPORARY_HOLD_PRESERVE`와 동일합니다.
`kmsKey`	`enum (KmsKey)` Google Cloud Storage 버킷 간의 전송을 위해 각 객체의 Cloud KMS 고객 관리 암호화 키 (CMEK)가 보존되는 방식을 지정합니다. 지정하지 않으면 기본 동작은 `KMS_KEY_DESTINATION_BUCKET_DEFAULT`와 동일합니다.
`timeCreated`	`enum (TimeCreated)` 전송을 위해 각 객체의 `timeCreated` 메타데이터가 보존되는 방식을 지정합니다. 지정하지 않으면 기본 동작은 `TIME_CREATED_SKIP`와 동일합니다. 이 동작은 Cloud Storage, Amazon S3, S3 호환 스토리지, Azure 소스에서 Cloud Storage 버킷으로 전송하는 경우에 지원됩니다.

심볼릭 링크

전송 작업 중에 심볼릭 링크를 건너뛸지 또는 보존할지 여부입니다.

열거형
`SYMLINK_UNSPECIFIED`	심볼릭 링크 동작이 지정되지 않았습니다.
`SYMLINK_SKIP`	전송 작업 중에 심볼릭 링크를 보존하지 않습니다.
`SYMLINK_PRESERVE`	전송 작업 중에 심볼릭 링크를 보존합니다.

모드

파일 모드 속성을 처리하기 위한 옵션입니다.

열거형
`MODE_UNSPECIFIED`	모드 동작이 지정되지 않았습니다.
`MODE_SKIP`	전송 작업 중에 모드를 보존하지 마세요.
`MODE_PRESERVE`	전송 작업 중 보존 모드

GID

파일 GID 속성을 처리하기 위한 옵션입니다.

열거형
`GID_UNSPECIFIED`	GID 동작이 지정되지 않았습니다.
`GID_SKIP`	전송 작업 중에 GID를 보존하지 마세요.
`GID_NUMBER`	전송 작업 중에 GID를 보존합니다.

UID

파일 UID 속성을 처리하기 위한 옵션입니다.

열거형
`UID_UNSPECIFIED`	UID 동작이 지정되지 않았습니다.
`UID_SKIP`	전송 작업 중에 UID를 보존하지 마세요.
`UID_NUMBER`	전송 작업 중에 UID를 보존합니다.

Acl

Cloud Storage 객체 ACL을 처리하기 위한 옵션입니다.

열거형
`ACL_UNSPECIFIED`	ACL 동작이 지정되지 않았습니다.
`ACL_DESTINATION_BUCKET_DEFAULT`	해당하는 경우 대상 버킷의 기본 객체 ACL을 사용합니다.
`ACL_PRESERVE`	객체의 원본 ACL을 보존합니다. 서비스 계정에 소스 객체에 대한 `storage.objects.getIamPolicy` 권한이 있어야 합니다. 소스 버킷 또는 대상 버킷에서 균일한 버킷 수준 액세스가 사용 설정되어서는 안 됩니다.

StorageClass

Google Cloud Storage 객체 스토리지 클래스를 처리하기 위한 옵션입니다.

열거형
`STORAGE_CLASS_UNSPECIFIED`	스토리지 클래스 동작이 지정되지 않았습니다.
`STORAGE_CLASS_DESTINATION_BUCKET_DEFAULT`	대상 버킷의 기본 스토리지 클래스를 사용합니다.
`STORAGE_CLASS_PRESERVE`	객체의 원래 스토리지 클래스를 보존합니다. Google Cloud Storage 버킷에서의 전송에만 지원됩니다. REGIONAL 및 MULTI_REGIONAL 스토리지 클래스는 대상 버킷에 쓸 수 있도록 STANDARD에 매핑됩니다.
`STORAGE_CLASS_STANDARD`	스토리지 클래스를 STANDARD로 설정합니다.
`STORAGE_CLASS_NEARLINE`	스토리지 클래스를 NEARLINE으로 설정합니다.
`STORAGE_CLASS_COLDLINE`	스토리지 클래스를 COLDLINE으로 설정합니다.
`STORAGE_CLASS_ARCHIVE`	스토리지 클래스를 ARCHIVE로 설정합니다.

TemporaryHold

Google Cloud Storage 객체의 임시 보류를 처리하는 옵션입니다.

열거형
`TEMPORARY_HOLD_UNSPECIFIED`	임시 보류 동작이 지정되지 않았습니다.
`TEMPORARY_HOLD_SKIP`	대상 객체에 임시 보존을 설정하지 않습니다.
`TEMPORARY_HOLD_PRESERVE`	객체의 원래 임시 보관 상태를 보존합니다.

KmsKey

Google Cloud Storage 객체의 KmsKey 설정을 처리하는 옵션입니다.

열거형
`KMS_KEY_UNSPECIFIED`	KmsKey 동작이 지정되지 않았습니다.
`KMS_KEY_DESTINATION_BUCKET_DEFAULT`	대상 버킷의 기본 암호화 설정을 사용합니다.
`KMS_KEY_PRESERVE`	객체의 원래 Cloud KMS 고객 관리 암호화 키(CMEK)(있는 경우)를 보존합니다. Cloud KMS 암호화 키를 사용하지 않는 객체는 대상 버킷의 암호화 설정을 사용하여 암호화됩니다.

TimeCreated

Google Cloud Storage 객체의 timeCreated 메타데이터를 처리하기 위한 옵션입니다.

열거형
`TIME_CREATED_UNSPECIFIED`	TimeCreated 동작이 지정되지 않았습니다.
`TIME_CREATED_SKIP`	소스 객체의 `timeCreated` 메타데이터는 보존하지 않습니다.
`TIME_CREATED_PRESERVE_AS_CUSTOM_TIME`	대상 객체의 `customTime` 필드에 소스 객체의 `timeCreated` 또는 `lastModified` 메타데이터를 보존합니다. 소스 객체의 `customTime` 필드에 저장된 값은 대상 객체에 전파되지 않습니다.

TransferOptions 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.