Options - AWS DataSync
내용참고

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

Options

전송 작업이 구성된 방식을 나타냅니다. 이러한 옵션에는 DataSync가 전송 중에 파일, 객체 및 관련 메타데이터 처리 방법이 포함됩니다. 또한 다른 옵션 중에서 데이터 무결성을 확인하고, 작업에 대한 대역폭 제한 설정 방법을 지정할 수 있습니다.

각 옵션에는 기본값이 있습니다. 필요한 경우가 아니라면 StartTaskExecution을 호출하기 전에 이러한 옵션을 구성하지 않아도 됩니다.

각 작업 실행에 대해 작업 옵션을 재정의할 수도 있습니다. 예를 들어 개별 실행에 대해 LogLevel을 조정할 수 있습니다.

내용

Atime

파일을 마지막으로 읽거나 쓴 시간을 나타내는 메타데이터를 보존할지 여부를 지정합니다.

참고

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

  • BEST_EFFORT (기본값) - DataSync는 모든 소스 파일(즉, 작업 실행 PREPARING 단계 이전의 버전)에서 원래 Atime 속성을 보존하려고 시도합니다. 이 옵션이 권장됩니다.

  • NONE - Atime을 무시합니다.

참고

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

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

타입: 문자열

유효 값: NONE | BEST_EFFORT

필수 여부: 아니요

BytesPerSecond

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

참고

향상된 모드 작업에는 적용되지 않습니다.

타입: Long

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

필수 여부: 아니요

Gid

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

  • INT_VALUE(기본값) - 사용자 ID(UID)와 GID의 정수 값을 보존합니다(권장).

  • NONE - UID와 GID를 무시합니다.

자세한 내용은 Understanding how DataSync handles file and object metadata 섹션을 참조하세요.

타입: 문자열

유효 값: NONE | INT_VALUE | NAME | BOTH

필수 여부: 아니요

LogLevel

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

  • BASIC - 기본 정보(예: 전송 오류)만 포함된 로그를 게시합니다.

  • TRANSFER - DataSync 작업이 전송하는 모든 파일 또는 객체에 대한 로그를 게시하고 데이터 무결성 검사를 수행합니다.

  • OFF - 로그가 게시되지 않습니다.

타입: 문자열

유효 값: OFF | BASIC | TRANSFER

필수 여부: 아니요

Mtime

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

  • PRESERVE(기본값) - 원래 Mtime을 보존합니다(권장).

  • NONE - Mtime을 무시합니다.

참고

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

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

타입: 문자열

유효 값: NONE | PRESERVE

필수 여부: 아니요

ObjectTags

객체 스토리지 시스템 간에 전송할 때 DataSync가 객체 태그(기본 동작)의 PRESERVE 여부를 지정합니다. DataSync 태스크에서 객체 태그를 무시하도록 하려면 NONE 값을 지정합니다.

타입: 문자열

유효 값: PRESERVE | NONE

필수 여부: 아니요

OverwriteMode

DataSync가 대상 위치의 데이터를 수정할지 또는 보존할지 여부를 지정합니다.

  • ALWAYS(기본값) - DataSync는 소스 데이터(메타데이터 포함)가 변경될 때 대상 위치의 데이터를 수정합니다.

    DataSync에서 객체를 덮어쓰는 경우, 특정 Amazon S3 스토리지 클래스(예: 검색 또는 조기 삭제)에 대한 추가 요금이 발생할 수 있습니다. 자세한 내용은 Storage class considerations with Amazon S3 transfers 섹션을 참조하세요.

  • NEVER - DataSync는 소스 데이터가 변경된 경우에도 대상 위치의 데이터를 덮어쓰지 않습니다. 이 옵션을 사용하여 대상의 파일 또는 객체에 대한 변경 사항을 덮어쓰지 않도록 보호할 수 있습니다.

타입: 문자열

유효 값: ALWAYS | NEVER

필수 여부: 아니요

PosixPermissions

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

자세한 내용은 Understanding how DataSync handles file and object metadata 섹션을 참조하세요.

  • PRESERVE(기본값) - POSIX 스타일 권한을 보존합니다(권장).

  • NONE - POSIX 스타일 권한을 무시합니다.

참고

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

타입: 문자열

유효 값: NONE | PRESERVE

필수 여부: 아니요

PreserveDeletedFiles

소스 파일 시스템에 존재하지 않는 목적지 장소에 파일을 보존할지 여부를 지정하는 값입니다. 이 옵션은 Amazon S3 스토리지 비용에 영향을 줄 수 있습니다. 작업에서 객체를 삭제하는 경우 특정 스토리지 클래스에 대한 최소 스토리지 기간 요금이 발생할 수 있습니다. 자세한 내용은 DataSync에서 Amazon S3 스토리지 클래스 작업 시 고려 사항을 참조하세요.

  • PRESERVE(기본값) - 대상 파일을 무시합니다(권장).

  • REMOVE - 소스에 없는 대상 파일을 삭제합니다.

참고

이 파라미터를 REMOVE로 설정하면, TransferMode를 ALL으로 설정할 수 없습니다. 모든 데이터를 전송할 때 DataSync는 목적지 위치를 스캔하지 않으므로 무엇을 삭제해야 할지 모릅니다.

타입: 문자열

유효 값: PRESERVE | REMOVE

필수 여부: 아니요

PreserveDevices

DataSync가 소스 위치에서 블록 및 문자 장치의 메타데이터를 보존해야 하는지 여부와 목적지에 해당 장치 이름과 메타데이터를 사용하여 파일을 다시 생성해야 하는지 여부를 지정하십시오. DataSync는 이러한 디바이스의 이름과 메타데이터만 복사합니다.

참고

DataSync는 터미널이 아니고 EOF(파일 끝) 마커를 반환하지 않으므로 이러한 장치의 실제 내용을 복사할 수 없습니다.

  • NONE(기본값) - 특수 디바이스를 무시합니다(권장).

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

타입: 문자열

유효 값: NONE | PRESERVE

필수 여부: 아니요

SecurityDescriptorCopyFlags

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

이 값은 SMB와 Amazon FSx for Windows File Server 위치 간이나, 두 개의 Windows File Server용 FSx 위치 간의 전송에만 사용됩니다. 자세한 내용은 Understanding how DataSync handles file and object metadata 섹션을 참조하세요.

  • OWNER_DACL(기본값) - 복사된 각 객체에 대해 DataSync는 다음 메타데이터를 복사합니다.

    • 객체 소유자

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

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

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

    • 객체 소유자

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

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

      SACL을 복사하려면 DataSync가 SMB 위치에 액세스하는 데 사용하는 Windows 사용자에게 추가 권한을 부여해야 합니다. 올바른 권한을 가진 사용자를 선택하는 방법에 대한 자세한 내용은 SMB, FSx for Windows File Server 또는 FSx for ONTAP에 필요한 권한(전송 시 위치 유형에 따라 다름)을 참조하세요.

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

타입: 문자열

유효 값: NONE | OWNER_DACL | OWNER_DACL_SACL

필수 여부: 아니요

TaskQueueing

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

타입: 문자열

유효 값: ENABLED | DISABLED

필수 여부: 아니요

TransferMode

DataSync가 초기 복사 후 위치 간에 다른 데이터(메타데이터 포함)만 전송할지 아니면 작업을 실행할 때마다 모든 데이터를 전송할지 지정합니다. 반복 전송을 계획하는 경우 이전 작업 실행 이후 변경된 내용만 전송해야 할 수 있습니다.

  • CHANGED (기본값) - 초기 전체 전송 후 DataSync는 소스 위치와 대상 위치 간에 다른 데이터와 메타데이터만 복사합니다.

  • ALL - DataSync는 위치 간의 차이를 비교하지 않고 소스의 모든 데이터를 대상으로 복사합니다.

타입: 문자열

유효 값: CHANGED | ALL

필수 여부: 아니요

Uid

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

  • INT_VALUE(기본값) - UID와 그룹 ID(GID)의 정수 값을 보존합니다(권장).

  • NONE - UID와 GID를 무시합니다.

자세한 내용은 DataSync에서 복사한 메타데이터를 참조하세요.

타입: 문자열

유효 값: NONE | INT_VALUE | NAME | BOTH

필수 여부: 아니요

VerifyMode

DataSync가 전송이 끝날 때 데이터의 무결성을 확인하는지 여부와 방법을 지정합니다.

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

    참고

    이는 향상된 모드 작업의 기본 옵션입니다.

    S3 Glacier Flexible Retrieval 또는 S3 Glacier Deep Archive 스토리지 클래스로 전송하는 경우 이 옵션을 사용하는 것이 좋습니다. 자세한 내용은 Amazon S3 위치의 스토리지 클래스 고려 사항을 참조하세요.

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

    참고

    는 기본 모드 작업의 기본 옵션이며 현재 향상된 모드 작업에서는 지원되지 않습니다.

    매니페스트를 사용하는 경우 DataSync는 매니페스트에 나열된 항목만 스캔하고 확인합니다.

    S3 Glacier Flexible Retrieval 또는 S3 Glacier Deep Archive 스토리지 클래스로 전송하는 경우 이 옵션을 사용할 수 없습니다. 자세한 내용은 Amazon S3 위치의 스토리지 클래스 고려 사항을 참조하세요.

  • NONE - DataSync는 전송 중에만 데이터 무결성 검사를 수행합니다. 다른 옵션과 달리 전송이 끝날 때 추가 확인은 없습니다.

타입: 문자열

유효 값: POINT_IN_TIME_CONSISTENT | ONLY_FILES_TRANSFERRED | NONE

필수 여부: 아니요

참고

언어별 AWS SDKs