Options - AWS DataSync
목차참고 항목

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Options

AWS DataSync작업 설정을 구성합니다. 이러한 옵션에는 파일, 객체 및 관련 메타데이터를 DataSync 처리하는 방법이 포함됩니다. 또한 데이터 무결성을 DataSync 검증하는 방법을 지정하고 작업에 대한 대역폭 제한을 설정하는 등의 옵션을 지정할 수 있습니다.

각 작업 설정에는 기본값이 있습니다. 꼭 필요한 경우가 아니면 작업을 시작하기 Options 전에 이러한 설정을 구성하지 않아도 됩니다.

목차

Atime

파일을 마지막으로 읽거나 쓴 시간을 나타내는 메타데이터를 보존할지 여부를 지정합니다. Atime로 설정하면 모든 소스 파일 (즉BEST_EFFORT, 작업 실행 PREPARING 단계 이전 버전) 에서 원래 Atime 특성을 DataSync 보존하려고 시도합니다.

참고

의 동작은 플랫폼 전체에서 완전히 표준이 Atime 아니므로 는 최선의 노력으로만 이러한 작업을 수행할 DataSync 수 있습니다.

기본값: BEST_EFFORT

BEST_EFFORT: 파일별 Atime 값을 보존하려고 시도합니다(권장).

NONE: Atime을 무시합니다.

참고

Atime이 BEST_EFFORT로 설정된 경우 Mtime이 PRESERVE로 설정되어야 합니다.

Atime이 NONE으로 설정된 경우 Mtime도 NONE이어야 합니다.

유형: String

유효한 값: NONE | BEST_EFFORT

필수 항목 여부: 아니요

BytesPerSecond

DataSync작업에 사용되는 대역폭을 제한합니다. 예를 들어, 에서 최대 1MB를 사용하도록 DataSync 하려면 이 값을 1048576 (=1024*1024) 로 설정합니다.

유형: Long

유효한 범위: 최소값은 -1입니다.

필수 항목 여부: 아니요

Gid

파일 소유자의 POSIX 그룹 ID (GID) 를 지정합니다.

자세한 내용은 참조하세요 DataSync.

기본값: INT_VALUE. 이 ID의 정수 값을 유지합니다.

INT_VALUE: 사용자 ID (UID) 와 GID (권장) 의 정수 값을 유지합니다.

NONE: UID 및 GID를 무시합니다.

유형: String

유효한 값: NONE | INT_VALUE | NAME | BOTH

필수 항목 여부: 아니요

LogLevel

Amazon Logs 로그 그룹에 DataSync 게시하는 CloudWatch 로그 유형을 지정합니다. 로그 그룹을 지정하려면 을 참조하십시오 CloudWatchLogGroupArn.

LogLevel을 OFF로 설정하면 로그가 게시되지 않습니다. BASIC은 전송된 개별 파일 관련 오류에 대한 로그를 게시합니다. TRANSFER는 전송되고 무결성이 확인된 모든 파일 또는 객체에 대한 로그를 게시합니다.

유형: String

유효한 값: OFF | BASIC | TRANSFER

필수 항목 여부: 아니요

Mtime

태스크 실행 PREPARING 단계 전에 파일을 마지막으로 쓴 시간을 나타내는 메타데이터를 보존할지 여부를 지정합니다. 이 옵션은 태스크를 두 번 이상 실행해야 하는 경우에 필요합니다.

Default Value: PRESERVE

PRESERVE: 원본 Mtime을 보존합니다(권장).

NONE: Mtime을 무시합니다.

참고

Mtime이 PRESERVE로 설정된 경우 Atime이 BEST_EFFORT로 설정되어야 합니다.

Mtime이 NONE으로 설정된 경우 Atime도 NONE으로 설정되어야 합니다.

유형: String

유효한 값: NONE | PRESERVE

필수 항목 여부: 아니요

ObjectTags

객체 스토리지 시스템 간에 전송할 때 객체 태그가 보존되는지 여부를 지정합니다. DataSync태스크에서 객체 태그를 무시하도록 하려면 NONE 값을 지정합니다.

Default Value: PRESERVE

유형: String

유효한 값: PRESERVE | NONE

필수 항목 여부: 아니요

OverwriteMode

대상 위치의 데이터를 덮어쓸지 아니면 보존할지 지정합니다. NEVER로 설정하면 예를 들어, 대상 파일이 소스 파일로 대체되지 않습니다(대상 파일이 소스 파일과 다른 경우에도). 대상의 파일을 수정하고 파일을 동기화하는 경우 이 값을 사용하여 변경 내용을 덮어쓰지 않도록 보호할 수 있습니다.

일부 스토리지 클래스에는 Amazon S3 스토리지 비용에 영향을 미칠 수 있는 특정 동작이 있습니다. 자세한 내용은 참조하세요DataSync.

유형: String

유효한 값: ALWAYS | NEVER

필수 항목 여부: 아니요

PosixPermissions

파일의 읽기, 쓰기 또는 실행과 같은 특정 목적을 위해 파일에 액세스할 수 있는 사용자 또는 그룹을 지정합니다.

자세한 내용은 참조하세요 DataSync.

기본값: PRESERVE

PRESERVE: POSIX 스타일 권한을 보존합니다(권장).

NONE: 권한을 무시합니다.

참고

AWS DataSync는 소스 위치의 기존 권한을 보존할 수 있습니다.

유형: String

유효한 값: NONE | PRESERVE

필수 항목 여부: 아니요

PreserveDeletedFiles

원본에 존재하지 않는 대상 위치의 파일을 보존할지 여부를 지정합니다. 이 옵션은 Amazon S3 스토리지 비용에 영향을 줄 수 있습니다. 작업에서 객체를 삭제하는 경우 특정 스토리지 클래스에 대한 최소 스토리지 기간 요금이 발생할 수 있습니다. 자세한 내용은 참조하세요DataSync.

기본값: PRESERVE

PRESERVE: 이러한 대상 파일을 무시합니다 (권장).

REMOVE: 원본에 없는 대상 파일을 삭제합니다.

참고

이 매개 변수를 로 REMOVE 설정하면 TransferMode 로 설정할 수 없습니다ALL. 모든 데이터를 전송할 때 대상 위치를 스캔하지 DataSync 않으며 무엇을 삭제할지 모릅니다.

유형: String

유효한 값: PRESERVE | REMOVE

필수 항목 여부: 아니요

PreserveDevices

블록 및 문자 장치의 메타데이터를 DataSync 보존할지 여부를 지정하고 대상에서 해당 장치 이름과 메타데이터를 사용하여 파일을 다시 생성합니다. DataSync이러한 디바이스의 이름과 메타데이터만 복사합니다.

참고

DataSync는 터미널이 아니므로 e nd-of-file (EOF) 마커를 반환하지 않으므로 이러한 디바이스의 실제 콘텐츠를 복사할 수 없습니다.

기본값: NONE

NONE: 특수 디바이스를 무시합니다(권장).

PRESERVE: 문자 및 블록 디바이스 메타데이터를 보존합니다. 이 옵션은 현재 EFS EFS에서는 지원되지 않습니다.

유형: String

유효한 값: NONE | PRESERVE

필수 항목 여부: 아니요

SecurityDescriptorCopyFlags

소스에서 대상 객체로 복사되는 SMB 보안 설명자의 구성 요소를 지정합니다.

이 값은 SMB 위치와 Amazon FSx for Windows File Server 위치 간 전송이나 두 FSx for Windows File Server 위치 간 전송에만 사용됩니다. 자세한 내용은 DataSync참조하세요.

기본값: OWNER_DACL

OWNER_DACL: 복사된 각 객체에 대해 다음 메타데이터를 DataSync 복사합니다.

  • 객체 소유자의 입니다.

  • 객체에 대한 액세스 권한을 부여할지 여부를 결정하는 NTFS 임의 액세스 제어 목록(DACL)입니다.

    DataSync이 옵션으로는 NTFS 시스템 액세스 제어 목록 (SACL) 을 복사하지 않습니다.

OWNER_DACL_SACL: 복사된 각 객체에 대해 다음 메타데이터를 DataSync 복사합니다.

  • 객체 소유자의 입니다.

  • 객체에 대한 액세스 권한을 부여할지 여부를 결정하는 NTFS 임의 액세스 제어 목록(DACL)입니다.

  • SACL은 관리자가 보안 객체에 액세스하려는 시도를 로깅하는 데 사용됩니다.

    SACL을 복사하려면 SMB 위치에 액세스하는 데 DataSync 사용하는 Windows 사용자에게 추가 권한을 부여해야 합니다. 파일, 폴더 및 메타데이터에 대한 충분한 권한을 보장하는 사용자 선택에 대한 자세한 내용을 알아보려면 user(사용자)를 참조하세요.

NONE: SMB 보안 설명자 구성 요소는 복사되지 않습니다. 대상 객체는 대상 위치에 액세스하기 위해 제공된 사용자가 소유합니다. DACL 및 SACL은 대상 서버의 구성을 기반으로 설정됩니다.

유형: String

유효한 값: NONE | OWNER_DACL | OWNER_DACL_SACL

필수 항목 여부: 아니요

TaskQueueing

여러 작업을 실행할 때 특정 시나리오에서 전송 작업을 대기열에 넣을지 여부를 지정합니다. ENABLED기본값입니다.

유형: String

유효한 값: ENABLED | DISABLED

필수 항목 여부: 아니요

TransferMode

소스와 대상 위치 간에 다른 데이터와 메타데이터만 DataSync 전송할지 여부를 결정합니다.

CHANGED: 소스 위치에서 대상 위치로 새롭거나 다른 콘텐츠인 데이터 또는 메타데이터만 DataSync 복사합니다.

ALL: 대상의 내용을 비교하지 않고 모든 소스 위치 콘텐츠를 대상에 DataSync 복사합니다.

유형: String

유효한 값: CHANGED | ALL

필수 항목 여부: 아니요

Uid

파일 소유자의 POSIX 사용자 ID (UID) 를 지정합니다.

자세한 내용은 참조하세요 DataSync.

기본값: INT_VALUE. 이 ID의 정수 값을 유지합니다.

INT_VALUE: UID 및 그룹 ID (GID) 의 정수 값을 보존합니다 (권장).

NONE: UID 및 GID를 무시합니다.

유형: String

유효한 값: NONE | INT_VALUE | NAME | BOTH

필수 항목 여부: 아니요

VerifyMode

전송 중에 데이터 무결성을 DataSync 검사하는 방법과 시기를 지정합니다.

기본값: POINT_IN_TIME_CONSISTENT

ONLY_FILES_TRANSFERRED(권장): 소스 위치에서 전송된 파일 및 메타데이터의 체크섬을 DataSync 계산합니다. 전송이 끝나면 이 체크섬을 대상의 해당 파일에 대해 계산된 체크섬과 비교합니다. DataSync

S3 Glacier Flexible Retrieval 또는 S3 Glacier Deep Archive 스토리지 클래스로 전송할 때 사용하는 것이 좋습니다. 자세한 내용은 Amazon S3.

POINT_IN_TIME_CONSISTENT: 전송이 끝나면 전체 소스와 대상을 DataSync 검색하여 두 위치 모두 완전히 동기화되었는지 확인합니다.

S3 Glacier Flexible Retrieval 또는 S3 Glacier Deep Archive 스토리지 클래스로 전송할 때는 이 옵션을 사용할 수 없습니다. 자세한 내용은 Amazon S3.

NONE: 전송 종료 시 추가 인증을 실행하지 DataSync 않습니다. 하지만 전송 중 체크섬 확인을 통해 모든 데이터 전송에 대한 무결성 검사를 수행합니다.

유형: String

유효한 값: POINT_IN_TIME_CONSISTENT | ONLY_FILES_TRANSFERRED | NONE

필수 항목 여부: 아니요

참고 항목

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.