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 で最大 1 MB を使用する場合は、この値を 1048576 (=1024*1024) に設定します。

注記

拡張モードタスクには適用されません。

型: 長整数

有効な範囲: 最小値は -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 ロググループに公開する、ログのタイプを指定します。ロググループを指定するには、「CloudWatchLogGroupAn」を参照してください。

  • 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 ストレージのコストに影響します。タスクでオブジェクトを削除すると、特定のストレージクラスに対して最小ストレージ期間料金が発生する可能性があります。詳細については、「Considerations when working with Amazon S3 storage classes in DataSync」を参照してください。

  • 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 の場所との間、または 2 つの FSx for Windows File Server の場所との間の転送にのみ使用されます。詳細については、「Understanding how DataSync handles file and object metadata」を参照してください。

  • OWNER_DACL (デフォルト) - DataSync は、コピーされたオブジェクトごとに、次のメタデータをコピーします。

    • オブジェクトの所有者

    • NTFS 任意アクセスコントロールリスト (DACLs) は、オブジェクトへのアクセスを許可するかどうかを決定します。

      このオプションでは DataSync は NTFS システムアクセス制御リスト (SACL) をコピーしません。

  • OWNER_DACL_SACL - DataSync は、コピーされたオブジェクトごとに、次のメタデータをコピーします。

    • オブジェクトの所有者

    • NTFS 任意アクセスコントロールリスト (DACLs) は、オブジェクトへのアクセスを許可するかどうかを決定します。

    • SACL は管理者が保護されたオブジェクトへのアクセス試行を記録するために使用します。

      SACL をコピーするには、DataSync が SMB ロケーションにアクセスするために使用する Windows ユーザーに追加のアクセス許可を付与する必要があります。適切なアクセス許可を持つユーザーを選択する方法については、SMB、FSx for Windows File Server 、または FSx for ONTAP に必要なアクセス許可を参照してください (転送の場所のタイプによって異なります)。

  • NONE - SMB セキュリティ記述子コンポーネントはコピーされません。デスティネーションオブジェクトは、送信先の場所にアクセスするために提供されたユーザーが所有します。DACLs と SACLs は、送信先サーバーの設定に基づいて設定されます。

タイプ: 文字列

有効な値: 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 を無視します。

詳細については、「Metadata copied by DataSync」を参照してください。

タイプ: 文字列

有効な値: NONE | INT_VALUE | NAME | BOTH

必須: いいえ

VerifyMode

DataSync が転送の終了時にデータの整合性をチェックするかどうかと方法を指定します。

  • ONLY_FILES_TRANSFERRED (推奨) - DataSync は、転送元の場所で転送されたデータ (メタデータを含む) のチェックサムを計算します。転送の最後に、DataSync はこのチェックサムを転送先のデータに対して計算されたチェックサムと比較します。

    注記

    これは、拡張モードタスクのデフォルトのオプションです。

    S3 Glacier Flexible Retrieval または S3 Glacier Deep Archive ストレージクラスに転送する場合は、このオプションをお勧めします。詳細については、「Storage class considerations with Amazon S3 locations」を参照してください。

  • POINT_IN_TIME_CONSISTENT - 転送の最後に、DataSync は送信元と送信先全体をチェックして、両方の場所が完全に同期されていることを確認します。

    注記

    は基本モードタスクのデフォルトのオプションであり、現在、拡張モードタスクではサポートされていません。

    マニフェストを使用する場合、DataSync はマニフェストにリストされているもののみをスキャンおよび検証します。

    S3 Glacier Flexible Retrieval または S3 Glacier Deep Archive ストレージクラスに転送する場合は、このオプションは使用できません。詳細については、「Storage class considerations with Amazon S3 locations」を参照してください。

  • NONE - DataSync は、転送中にのみデータ整合性チェックを実行します。他のオプションとは異なり、転送の終了時に追加の検証はありません。

タイプ: 文字列

有効な値: POINT_IN_TIME_CONSISTENT | ONLY_FILES_TRANSFERRED | NONE

必須: いいえ

以下の資料も参照してください。

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。