

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# `SharedStorage` セクション
<a name="SharedStorage-v3"></a>

**(オプション)** クラスターの共有ストレージの設定。

AWS ParallelCluster は、[Amazon EBS](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AmazonEBS.html)、[FSx for ONTAP](https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/what-is-fsx-ontap.html)、[FSx for OpenZFS ](https://docs.aws.amazon.com/fsx/latest/OpenZFSGuide/what-is-fsx.html)共有ストレージボリューム、[Amazon EFS](https://docs.aws.amazon.com/efs/latest/ug/whatisefs.html) および [FSx for Lustre](https://docs.aws.amazon.com/fsx/latest/LustreGuide/what-is.html) 共有ストレージファイルシステム、または[ファイルキャッシュ](https://docs.aws.amazon.com/fsx/latest/FileCacheGuide/what-is.html)の使用をサポートしています。

`SharedStorage` セクションで、外部ストレージまたはマネージドストレージのいずれかを定義できます。
+ **外部ストレージ**とは、ユーザーが管理する既存のボリュームまたはファイルシステムを指します。 AWS ParallelCluster は作成も削除もしません。
+ **AWS ParallelCluster マネージドストレージ**とは、 が AWS ParallelCluster 作成し、削除できるボリュームまたはファイルシステムを指します。

[共有ストレージクォータ](shared-storage-quotas-v3.md)および共有ストレージの設定方法の詳細については、[共有ストレージ](shared-storage-quotas-integration-v3.md)*「 の使用 AWS ParallelCluster*」の「」を参照してください。

**注記**  
 AWS Batch がスケジューラとして使用されている場合、FSx for Lustre はクラスターヘッドノードでのみ使用できます。

```
SharedStorage:
  - MountDir: string
    Name: string
    StorageType: Ebs
    EbsSettings:
      VolumeType: string
      Iops: integer
      Size: integer
      Encrypted: boolean
      KmsKeyId: string
      SnapshotId: string
      Throughput: integer
      VolumeId: string
      DeletionPolicy: string
      Raid:
        Type: string
        NumberOfVolumes: integer
  - MountDir: string
    Name: string
    StorageType: Efs
    EfsSettings:
      Encrypted: boolean
      KmsKeyId: string
      EncryptionInTransit: boolean
      IamAuthorization: boolean
      PerformanceMode: string
      ThroughputMode: string
      ProvisionedThroughput: integer
      FileSystemId: string
      DeletionPolicy: string
      AccessPointId: string
  - MountDir: string
    Name: string
    StorageType: FsxLustre
    FsxLustreSettings:
      StorageCapacity: integer
      DeploymentType: string
      ImportedFileChunkSize: integer
      DataCompressionType: string
      ExportPath: string
      ImportPath: string
      WeeklyMaintenanceStartTime: string
      AutomaticBackupRetentionDays: integer
      CopyTagsToBackups: boolean
      DailyAutomaticBackupStartTime: string
      PerUnitStorageThroughput: integer
      BackupId: string
      KmsKeyId: string
      FileSystemId: string
      AutoImportPolicy: string
      DriveCacheType: string
      StorageType: string
      DeletionPolicy: string
      DataRepositoryAssociations:
      - Name: string
        BatchImportMetaDataOnCreate: boolean
        DataRepositoryPath: string
        FileSystemPath: string
        ImportedFileChunkSize: integer
        AutoExportPolicy: string
        AutoImportPolicy: string
  - MountDir: string
    Name: string
    StorageType: FsxOntap
    FsxOntapSettings:
      VolumeId: string
  - MountDir: string
    Name: string
    StorageType: FsxOpenZfs
    FsxOpenZfsSettings:
      VolumeId: string
  - MountDir: string
    Name: string
    StorageType: FileCache
    FileCacheSettings:
      FileCacheId: string
```

## `SharedStorage` 更新ポリシー
<a name="SharedStorage-v3.update-policies"></a>
+ マネージド/外部 EBS、マネージド EFS、マネージド FSx Lustre の場合、更新ポリシーは [更新ポリシー: このリスト値の設定では、コンピューティングフリートを停止するか、QueueUpdateStrategy が設定されている必要があります。既存の値を削除する場合は、コンピューティングフリートを停止する必要があります。](using-pcluster-update-cluster-v3.md#update-policy-update-cluster-v3) です。
+ 外部 EFS、FSx Lustre、FSx ONTAP、FSx OpenZfs、File Cache の場合、更新ポリシーは [更新ポリシー: この設定は、更新中に変更できます。](using-pcluster-update-cluster-v3.md#update-policy-setting-supported-v3) です。

## `SharedStorage` のプロパティ
<a name="SharedStorage-v3.properties"></a>

`MountDir` **(必須)**、`String`)  
共有ストレージがマウントされているパス。  
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`Name` **(必須)**、`String`)  
共有ストレージの名前。この名前は設定を更新するときに使用します。  
 AWS ParallelCluster マネージド共有ストレージを指定し、 の値を変更すると`Name`、既存のマネージド共有ストレージとデータは削除され、新しいマネージド共有ストレージが作成されます。クラスターの更新で `Name` の値を変更することは、既存のマネージド共有ストレージを新しいマネージド共有ストレージに置き換えることと同等です。既存の共有ストレージからデータを保持する必要がある場合`Name`は、変更する前に必ずデータをバックアップしてください。
[更新ポリシー: このリスト値の設定では、コンピューティングフリートを停止するか、QueueUpdateStrategy が設定されている必要があります。既存の値を削除する場合は、コンピューティングフリートを停止する必要があります。](using-pcluster-update-cluster-v3.md#update-policy-update-cluster-v3)

`StorageType` **(必須)**、`String`)  
共有ストレージのタイプ。サポートされている値は、`Ebs`、`Efs`、`FsxLustre`、`FsxOntap`、および `FsxOpenZfs` です。  
詳細については、「[`FsxLustreSettings`](#SharedStorage-v3-FsxLustreSettings)」、「[`FsxOntapSettings`](#SharedStorage-v3-FsxOntapSettings)」、および「[`FsxOpenZfsSettings`](#SharedStorage-v3-FsxOpenZfsSettings)」を参照してください。  
スケジューラ AWS Batch として を使用する場合、FSx for Lustre はクラスターヘッドノードでのみ使用できます。
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

## `EbsSettings`
<a name="SharedStorage-v3-EbsSettings"></a>

**(オプション)** Amazon EBS ボリュームの設定。

```
EbsSettings:
  VolumeType: string
  Iops: integer
  Size: integer
  Encrypted: boolean
  KmsKeyId: string
  SnapshotId: string
  VolumeId: string
  Throughput: integer
  DeletionPolicy: string
  Raid:
    Type: string
    NumberOfVolumes: integer
```

[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

### `EbsSettings` のプロパティ
<a name="SharedStorage-v3-EbsSettings.properties"></a>

[DeletionPolicy](#yaml-SharedStorage-EbsSettings-DeletionPolicy) が `Delete` に設定されている場合、クラスターが削除されたり、クラスターの更新によってボリュームが削除されたりした場合、マネージドボリュームはそのデータと共に削除されます。

詳細については、「 AWS ParallelClusterの使用**」の「[共有ストレージ](shared-storage-quotas-integration-v3.md)」を参照してください。

`VolumeType` (**オプション**、`String`)  
[Amazon EBS ボリュームタイプ](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html)を指定します。サポートされている値は `gp2`、`gp3`、`io1`、`io2`、`sc1`、`st1` および `standard` です。デフォルト値は `gp3` です。  
詳細については、「Amazon EC2 ユーザーガイド」の「[Amazon EBS ボリュームの種類](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html)」を参照してください。  
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`Iops` (**オプション**、`Integer`)  
`io1`、`io2` および `gp3` タイプボリュームの IOPS の数を定義します。  
デフォルト値、対応値、`volume_iops` 対 `volume_size` の比率は、`VolumeType` と `Size` で異なります。    
`VolumeType` = `io1`  
デフォルト `Iops` = 100  
サポートする値 `Iops` = 100 — 64000 †  
最大 `volume_iops`/`volume_size` 比率 ＝ 50 IOPS/GiB。5000 IOPS には、少なくとも 100 GiB の `volume_size` が必要です。  
`VolumeType` = `io2`  
デフォルト `Iops` = 100  
サポートする値 `Iops` = 100 — 64000 (`io2` Block Express ボリュームの場合は 256000) †  
最大 `Iops`/`Size` 比率 ＝ 500 IOPS/GiB。5000 IOPS には、少なくとも 10 GiB の `Size` が必要です。  
`VolumeType` = `gp3`  
デフォルト `Iops` = 3000  
サポートされる値 `Iops` = 3000 — 16000  
最大 `Iops`/`Size` 比率 ＝ 500 IOPS/GiB。5000 IOPS には、少なくとも 10 GiB の `Size` が必要です。
† 最大 IOPS は、32,000 IOPS 以上でプロビジョニングされた [Nitro System で構築されたインスタンス](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#ec2-nitro-instances)にのみ保証されます。他のインスタンスは、最大 32,000 IOPS を保証します。[ボリュームを変更](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-modify-volume.html)しない限り、以前の `io1` ボリュームはパフォーマンスが完全にはならないことがあります。`io2`Block Express ボリュームは、`R5b` インスタンスタイプで最大 256000 までの `volume_iops` 値をサポートします。詳細については、「*Amazon EC2 ユーザーガイド*」の「[`io2` Block Express ボリューム](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-volume-types.html#io2-block-express)」を参照してください。  
[更新ポリシー: この設定は、更新中に変更できます。](using-pcluster-update-cluster-v3.md#update-policy-setting-supported-v3)

`Size` (**オプション**、`Integer`)  
ボリュームのサイズをギビバイト (GiB) で指定します。デフォルト値は 35 です。  
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`Encrypted` (**オプション**、`Boolean`)  
ボリュームを暗号化するかどうかを指定します。デフォルト値は `true` です。  
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`KmsKeyId` (**オプション**、`String`)  
暗号化に使用するカスタム AWS KMS キーを指定します。この設定は、`Encrypted` の設定を `true` にすることが必要です。  
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`SnapshotId` (**オプション**、`String`)  
ボリュームのソースとしてスナップショットを使用する場合は、Amazon EBS スナップショット ID を指定します。  
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`VolumeId` (**オプション**、`String`)  
Amazon EBS ボリューム ID を指定します。`EbsSettings` インスタンスに指定した場合、`MountDir` パラメータのみを指定することも可能です。  
`HeadNode` として同じアベイラビリティーゾーンにボリュームを作成する必要があります。  
 AWS ParallelCluster バージョン 3.4.0 に複数のアベイラビリティーゾーンが追加されました。
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`Throughput` (**オプション**、`Integer`)  
ボリュームにプロビジョニングするスループットを MiB/秒で表したもので、最大 1,000 MiB/秒です。  
この設定は、`VolumeType` が `gp3` の場合のみ有効です。サポートされている範囲は 125～1000 で、デフォルト値は 125 です。  
[更新ポリシー: この設定は、更新中に変更できます。](using-pcluster-update-cluster-v3.md#update-policy-setting-supported-v3)

`DeletionPolicy` (**オプション**、`String`)  
クラスターの削除またはボリュームの削除時にボリュームを保持、削除、またはスナップショットするかどうかを指定します。サポートされる値は `Delete`、`Retain` および `Snapshot` です。デフォルト値は `Delete` です。  
[DeletionPolicy](#yaml-SharedStorage-EbsSettings-DeletionPolicy) が `Delete` に設定されている場合、クラスターが削除されたり、クラスターの更新によってボリュームが削除されたりした場合、マネージドボリュームはそのデータと共に削除されます。  
詳細については、「[共有ストレージ](shared-storage-quotas-integration-v3.md)」を参照してください。  
[更新ポリシー: この設定は、更新中に変更できます。](using-pcluster-update-cluster-v3.md#update-policy-setting-supported-v3)  
`DeletionPolicy` は AWS ParallelCluster バージョン 3.2.0 以降でサポートされています。

### `Raid`
<a name="SharedStorage-v3-EbsSettings-Raid"></a>

**(オプション)** RAID ボリュームの設定を定義します。

```
Raid:
  Type: string
  NumberOfVolumes: integer
```

[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

#### `Raid` のプロパティ
<a name="SharedStorage-v3-EbsSettings-Raid.properties"></a>

`Type` **(必須)**、`String`)  
RAID 配列のタイプを定義します。サポートされている値は「0」(ストライピング) および「1」(ミラーリング) です。  
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`NumberOfVolumes` (**オプション**、`Integer`)  
RAID　配列の作成に使用する Amazon EBS ボリュームの数を定義します。設定可能な値の範囲は 2～5 です。デフォルト値 (`Raid`設定が定義されている場合) は 2 です。  
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

## `EfsSettings`
<a name="SharedStorage-v3-EfsSettings"></a>

**(オプション)** Amazon EFS ファイルシステムの設定です。

```
EfsSettings:
  Encrypted: boolean
  KmsKeyId: string
  EncryptionInTransit: boolean
  IamAuthorization: boolean
  PerformanceMode: string
  ThroughputMode: string
  ProvisionedThroughput: integer
  FileSystemId: string
  DeletionPolicy: string
  AccessPointId: string
```

[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

### `EfsSettings` のプロパティ
<a name="SharedStorage-v3-EfsSettings.properties"></a>

[DeletionPolicy](#yaml-SharedStorage-EfsSettings-DeletionPolicy) が `Delete` に設定されている場合、クラスターが削除されたり、クラスターの更新によってファイルシステムが削除されたりした場合、マネージドボリュームはそのデータと共に削除されます。

詳細については、「 AWS ParallelClusterの使用**」の「[共有ストレージ](shared-storage-quotas-integration-v3.md)」を参照してください。

`Encrypted` (**オプション**、`Boolean`)  
Amazon EFS ファイルシステムを暗号化するかどうかを指定します。デフォルト値は `false` です。  
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`KmsKeyId` (**オプション**、`String`)  
暗号化に使用するカスタム AWS KMS キーを指定します。この設定は、`Encrypted` の設定を `true` にすることが必要です。  
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`EncryptionInTransit` (**オプション**、`Boolean`)  
`true` に設定した場合、Amazon EFS ファイルシステムは Transport Layer Security (TLS) を使用してマウントされます。デフォルトで、これは `false` に設定されます。  
 AWS Batch がスケジューラとして使用されている場合、 `EncryptionInTransit`はサポートされていません。
 AWS ParallelCluster バージョン 3.4.0 以降、`EncryptionInTransit` が追加されます。
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`IamAuthorization` (**オプション**、`Boolean`)  
`IamAuthorization` バージョン 3.4.0 AWS ParallelCluster 以降で が追加されました。  
`true` に設定すると、Amazon EFS はシステムの IAM ID を使用して認証されます。デフォルトで、これは `false` に設定されます。  
`IamAuthorization` が `true` に設定されている場合は `EncryptionInTransit` も `true` に設定する必要があります。
 AWS Batch がスケジューラとして使用されている場合、 `IamAuthorization`はサポートされていません。
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`PerformanceMode` (**オプション**、`String`)  
Amazon EFS ファイルシステムのパフォーマンスモードを指定します。サポートされている値は`generalPurpose` および `maxIO` です。デフォルト値は `generalPurpose` です。詳細については、「Amazon Elastic File System ユーザーガイド**」の「[パフォーマンスモード](https://docs.aws.amazon.com/efs/latest/ug/performance.html#performancemodes)」を参照してください。  
ほとんどのファイルシステムに `generalPurpose` パフォーマンスモードをお勧めします。  
`maxIO` パフォーマンスモードを使用するファイルシステムでは、集計スループットと 1 秒あたりのオペレーション数をより高いレベルにスケーリングできます。ただし、ほとんどのファイルオペレーションでは、レイテンシーがわずかに長くなるというトレードオフがあります。  
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`ThroughputMode` (**オプション**、`String`)  
Amazon EFS ファイルシステムのスループットモードを指定します。サポートされている値は`bursting` および `provisioned` です。デフォルト値は `bursting` です。`provisioned` を使用する場合は、`ProvisionedThroughput` を指定する必要があります。  
[更新ポリシー: この設定は、更新中に変更できます。](using-pcluster-update-cluster-v3.md#update-policy-setting-supported-v3)

`ProvisionedThroughput` (`ThroughputMode` が `provisioned` または `Integer` の場合、**必須**)  
Amazon EFS ファイルシステムのプロビジョニングされたスループット (MiB/秒) を定義します (測定単位は MiB/秒)。これは、「Amazon EFS API Reference**」(Amazon EFS API リファレンス) の [ProvisionedThroughputInMibps](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-response-ProvisionedThroughputInMibps) パラメータに対応しています。  
このパラメータを使用する場合は、`ThroughputMode` を `provisioned` に設定する必要があります。  
対応する範囲は `1`～`1024` です。制限の引き上げをリクエストするには、 サポートにお問い合わせください。  
[更新ポリシー: この設定は、更新中に変更できます。](using-pcluster-update-cluster-v3.md#update-policy-setting-supported-v3)

`FileSystemId` (**オプション**、`String`)  
既存のファイルシステムの Amazon EFS ファイルシステム ID を定義します。  
クラスターが複数のアベイラビリティーゾーンにまたがるように設定されている場合、クラスターが使用するアベイラビリティーゾーンごとにファイルシステムのマウントターゲットを定義する必要があります。  
これが指定されている場合、`MountDir` のみ指定できます。それ以外の `EfsSettings` は指定できません。  

**このオプションを設定する場合、定義するファイルシステムについて次の条件に一致している必要があります。**
+ ファイルシステムには、クラスターのアベイラビリティーゾーンに既存のマウントターゲットがあり、`HeadNode` と `ComputeNodes` からのインバウンドおよびアウトバウンドの NFS トラフィックが許可されています。[Scheduling](Scheduling-v3.md)/[SlurmQueues](Scheduling-v3.md#Scheduling-v3-SlurmQueues)/[Networking](Scheduling-v3.md#Scheduling-v3-SlurmQueues-Networking)/[SubnetIds](Scheduling-v3.md#yaml-Scheduling-SlurmQueues-Networking-SubnetIds) で複数のアベイラビリティーゾーンが設定されます。

  

**クラスターとファイルシステムの間でトラフィックが許可されていることを確認するために、次のいずれかを実行できます。**
  + クラスターサブネットの CIDR またはプレフィックスリストとの間のトラフィックを許可するように、マウントターゲットのセキュリティグループを設定します。
**注記**  
AWS ParallelCluster は、ポートが開いていること、および CIDR またはプレフィックスリストが設定されていることを検証します。CIDR AWS ParallelCluster ブロックまたはプレフィックスリストの内容を検証しません。
  + [`SlurmQueues`](Scheduling-v3.md#Scheduling-v3-SlurmQueues)/[`Networking`](Scheduling-v3.md#Scheduling-v3-SlurmQueues-Networking)/[`SecurityGroups`](Scheduling-v3.md#yaml-Scheduling-SlurmQueues-Networking-SecurityGroups) と [`HeadNode`](HeadNode-v3.md)/[`Networking`](HeadNode-v3.md#HeadNode-v3-Networking)/[`SecurityGroups`](HeadNode-v3.md#yaml-HeadNode-Networking-SecurityGroups) を使用して、クラスターノードのカスタムセキュリティグループを設定します。カスタムセキュリティグループを設定して、クラスターとファイルシステムの間のトラフィックを許可する必要があります。
**注記**  
すべてのクラスターノードがカスタムセキュリティグループを使用している場合、 はポートが開いていること AWS ParallelCluster のみを検証します。送信元と送信先が正しく設定されていることは検証 AWS ParallelCluster しません。
EFS OneZone は、すべてのコンピューティングノードとヘッドノードが同じアベイラビリティーゾーンにある場合にのみサポートされます。EFS OneZone にはマウントターゲットを 1 つだけ設定できます。
 AWS ParallelCluster バージョン 3.4.0 では、複数のアベイラビリティーゾーンが追加されています。
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`DeletionPolicy` (**オプション**、`String`)  
ファイルシステムがクラスターから削除されるか、クラスターが削除されたときに、ファイルシステムを保持または削除するかを指定します。サポートされる値は `Delete` と `Retain` です。デフォルト値は `Delete` です。  
[DeletionPolicy](#yaml-SharedStorage-EfsSettings-DeletionPolicy) が `Delete` に設定されている場合、クラスターが削除されたり、クラスターの更新によってファイルシステムが削除されたりした場合、マネージドボリュームはそのデータと共に削除されます。  
詳細については、「[共有ストレージ](shared-storage-quotas-integration-v3.md)」を参照してください。  
[更新ポリシー: この設定は、更新中に変更できます。](using-pcluster-update-cluster-v3.md#update-policy-setting-supported-v3)  
`DeletionPolicy` は AWS ParallelCluster バージョン 3.3.0 以降でサポートされています。

`AccessPointId` (**オプション**、`String`)  
このオプションを指定すると、ファイルシステムのルートではなく、`access point ID` で定義したファイルシステムのエントリポイントがマウントされます。  
詳細については、「[共有ストレージ](shared-storage-quotas-integration-v3.md)」を参照してください。  
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

## `FsxLustreSettings`
<a name="SharedStorage-v3-FsxLustreSettings"></a>

**注記**  
`FsxLustre` が [`StorageType`](#yaml-SharedStorage-StorageType) に指定されている場合、`FsxLustreSettings` を定義する必要があります。

**(オプション)** FSx for Lustre ファイルシステムの設定。

```
FsxLustreSettings:
  StorageCapacity: integer
  DeploymentType: string
  ImportedFileChunkSize: integer
  DataCompressionType: string
  ExportPath: string
  ImportPath: string
  WeeklyMaintenanceStartTime: string
  AutomaticBackupRetentionDays: integer
  CopyTagsToBackups: boolean
  DailyAutomaticBackupStartTime: string
  PerUnitStorageThroughput: integer
  BackupId: string # BackupId cannot coexist with some of the fields
  KmsKeyId: string
  FileSystemId: string # FileSystemId cannot coexist with other fields
  AutoImportPolicy: string
  DriveCacheType: string
  StorageType: string
  DeletionPolicy: string
```

[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

**注記**  
 AWS Batch がスケジューラとして使用されている場合、FSx for Lustre はクラスターヘッドノードでのみ使用できます。

### `FsxLustreSettings` のプロパティ
<a name="SharedStorage-v3-FsxLustreSettings.properties"></a>

[DeletionPolicy](#yaml-SharedStorage-FsxLustreSettings-DeletionPolicy) が `Delete` に設定されている場合、クラスターが削除されたり、クラスターの更新によってファイルシステムが削除されたりした場合、マネージドボリュームはそのデータと共に削除されます。

詳細については、「[共有ストレージ](shared-storage-quotas-integration-v3.md)」を参照してください。

`StorageCapacity` **(必須)**、`Integer`)  
FSx for Lustre のストレージ容量を GiB 単位で設定します。`StorageCapacity` は、新しいファイルシステムを作成する場合に必要です。`BackupId` または `FileSystemId` が指定されている場合、`StorageCapacity` は含めてはいけません。  
+ `SCRATCH_2`、`PERSISTENT_1`、および `PERSISTENT_2` デプロイタイプの場合、有効な値は 1,200 GiB、2400 GiB、それ以降は 2,400 GiB の増分です。
+ `SCRATCH_1` デプロイタイプの場合、有効な値は 1,200 GiB、2,400 GiB、それ以降 3,600 GiB の増分です。
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`DeploymentType` (**オプション**、`String`)  
FSx for Lustre ファイルシステムのデプロイタイプを指定します。サポートされている値は `SCRATCH_1`、`SCRATCH_2`、`PERSISTENT_1`、`PERSISTENT_2` です。デフォルト値は `SCRATCH_2` です。  
一時的なストレージと短期間のデータ処理が必要な場合、`SCRATCH_1` および `SCRATCH_2` デプロイタイプを選択します。`SCRATCH_2` デプロイタイプでは、データの転送中の暗号化と `SCRATCH_1` よりも高いバーストスループットキャパシティが提供されます。  
長期ストレージとレイテンシーの影響を受けないスループット重視のワークロードには、`PERSISTENT_1`デプロイタイプを選択します。 は転送中のデータの暗号化`PERSISTENT_1`をサポートしています。FSx for Lustre が利用可能なすべての AWS リージョン で使用できます。  
長期ストレージ、および最高レベルの IOPS とスループットを必要とする、レイテンシーの影響を受けやすいワークロードの場合は、`PERSISTENT_2` デプロイタイプを選択します。`PERSISTENT_2` は SSD ストレージをサポートし、より高い `PerUnitStorageThroughput` (最大1,000 MB/s/TiB) を提供します。`PERSISTENT_2` は限られた数の AWS リージョンで使用可能です。デプロイタイプと`PERSISTENT_2`利用可能な AWS リージョン のリストの詳細については、「Amazon [FSx for Lustre ユーザーガイド」の「FSx for Lustre のファイルシステムデプロイオプション](https://docs.aws.amazon.com/fsx/latest/LustreGuide/using-fsx-lustre.html#lustre-deployment-types)」を参照してください。 * FSx *  
[この機能](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/data-protection.html)をサポートする Amazon EC2 インスタンスから `SCRATCH_2`、`PERSISTENT_1`、または `PERSISTENT_2` デプロイタイプのファイルシステムにアクセスするとき、転送中のデータの暗号化が自動的に有効になります。  
`SCRATCH_2`、`PERSISTENT_1`、および `PERSISTENT_2` デプロイタイプの転送中のデータの暗号化は、サポートされる AWS リージョンでサポートされるインスタンスタイプからアクセスした場合にサポートされます。詳細については、「Amazon FSx for Lustre ユーザーガイド**」の「[転送中のデータの暗号化](https://docs.aws.amazon.com/fsx/latest/LustreGuide/encryption-in-transit-fsxl.html)」を参照してください。  
 AWS ParallelCluster バージョン 3.2.0 で、`PERSISTENT_2` デプロイタイプのサポートが追加されました。
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`ImportedFileChunkSize` (**オプション**、`Integer`)  
データリポジトリからインポートされたファイルの場合、この値がストライプカウントと 1 つの物理ディスクに保存された各ファイルごとの最大データ量 (MiB 単位) を決定します。1 つのファイルにストライピングできるディスクの最大数は、ファイルシステムを構成するディスクの合計数によって制限されます。  
デフォルトのチャンクサイズは 1,024 MiB (1 GiB) であり、512,000 MiB (500 GiB) まで高くすることができます。Amazon S3 オブジェクトの最大サイズは 5 TB です。  
このパラメータは、 `PERSISTENT_2`デプロイタイプを使用するファイルシステムではサポートされていません。データリポジトリの関連付けを設定する方法については、「Amazon FSx for Lustre ユーザーガイド**」の「[S3 バケットにファイルシステムをリンクする](https://docs.aws.amazon.com/fsx/latest/LustreGuide/create-dra-linked-data-repo.html)」を参照してください。
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`DataCompressionType` (**オプション**、`String`)  
FSx for Lustre ファイルシステムのデータ圧縮構成を設定します。サポートされている値は `LZ4` です。`LZ4` は LZ4 アルゴリズムによるデータ圧縮がオンになっていることを示しています。`DataCompressionType` が指定されていない場合は、ファイルシステムの作成時にデータ圧縮がオフになります。  
詳細については、「[Lustre データ圧縮](https://docs.aws.amazon.com/fsx/latest/LustreGuide/data-compression.html)」を参照してください。  
[更新ポリシー: この設定は、更新中に変更できます。](using-pcluster-update-cluster-v3.md#update-policy-setting-supported-v3)

`ExportPath` (**オプション**、`String`)  
FSx for Lustre ファイルシステムのルートがエクスポートされる Amazon S3 のパス。この設定は、`ImportPath` パラメータ が設定されている場合にのみサポートされます。パスでは、`ImportPath` で指定されている同じ Amazon S3 バケットを使用する必要があります。FSx for Lustre ファイルシステムからエクスポートされる新しいデータおよび変更されたデータのオプションのプレフィックスを指定できます。`ExportPath` 値を指定しない場合、FSx for Lustre でデフォルトのエクスポートパス (`s3://amzn-s3-demo-bucket/FSxLustre[creation-timestamp]`) が設定されます。タイムスタンプは UTC 形式です (例えば、`s3://amzn-s3-demo-bucket/FSxLustre20181105T222312Z`)。  
Amazon S3 エクスポートバケットは、`ImportPath` で指定されたインポートバケットと同じである必要があります。`s3://amzn-s3-demo-bucket` など、バケット名のみを指定した場合、Amazon S3 バケットオブジェクト へのファイルシステムオブジェクトの 1 対 1 のマッピングを取得します。このマッピングは、Amazon S3 の入力データがエクスポートで上書きされることを意味します。`s3://amzn-s3-demo-bucket/[custom-optional-prefix]` など、エクスポートパスでカスタムプレフィックスを指定した場合、FSx for Lustre は、ファイルシステムの内容を Amazon S3 バケット内のそのエクスポートプレフィックスにエクスポートします。  
このパラメータは、 `PERSISTENT_2`デプロイタイプを使用するファイルシステムではサポートされていません。「Amazon FSx for Lustre ユーザーガイド**」の「[S3 バケットにファイルシステムをリンクする](https://docs.aws.amazon.com/fsx/latest/LustreGuide/create-dra-linked-data-repo.html)」で説明されているように、データリポジトリの関連付けを設定します。
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`ImportPath` (**オプション**、`String`)  
FSx for Lustre ファイルシステムのデータリポジトリとして使用している Amazon S3 バケットへのパス (オプションのプレフィックスを含む)。FSx for Lustre ファイルシステムのルートは、選択した Amazon S3 バケットのルートにマップされます。例は `s3://amzn-s3-demo-bucket/optional-prefix` です。Amazon S3 バケット名の後にプレフィックスを指定した場合、そのプレフィックスが付いたオブジェクトキーのみがファイルシステムにロードされます。  
このパラメータは、 `PERSISTENT_2`デプロイタイプを使用するファイルシステムではサポートされていません。「Amazon FSx for Lustre ユーザーガイド**」の「[S3 バケットにファイルシステムをリンクする](https://docs.aws.amazon.com/fsx/latest/LustreGuide/create-dra-linked-data-repo.html)」で説明されているように、データリポジトリの関連付けを設定します。
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`WeeklyMaintenanceStartTime` (**オプション**、`String`)  
週次メンテナンスを実行するための優先開始時間。UTC\$10 タイムゾーンの `"d:HH:MM"` の形式でフォーマットします。このフォーマットの場合、`d` は月曜日で始まり日曜日で終わる 1～7 の曜日の番号です。このフィールドには引用符が必要です。  
[更新ポリシー: この設定は、更新中に変更できます。](using-pcluster-update-cluster-v3.md#update-policy-setting-supported-v3)

`AutomaticBackupRetentionDays` (**オプション**、`Integer`)  
自動バックアップの保持日数です。この値を 0 に設定すると、自動バックアップが無効になります。サポートされる範囲は 0～90 です。デフォルトは 0 です。この設定は、`PERSISTENT_1` と `PERSISTENT_2` デプロイタイプでの使用でのみ有効です。詳細については、「Amazon FSx for Lustre ユーザーガイド**」の「[バックアップの使用](https://docs.aws.amazon.com/fsx/latest/LustreGuide/using-backups-fsx.html)」を参照してください。  
[更新ポリシー: この設定は、更新中に変更できます。](using-pcluster-update-cluster-v3.md#update-policy-setting-supported-v3)

`CopyTagsToBackups` (**オプション**、`Boolean`)  
`true` の場合、FSx for Lustre ファイルシステムのタグをバックアップにコピーする必要があります。この値のデフォルト値は `false` です。この値を `true` に設定すると、ファイルシステムのすべてのタグが、ユーザーがタグを指定しないすべての自動バックアップおよびユーザー始動型バックアップにコピーされます。この値が `true` で 1 つ以上のタグを指定すると、指定したタグのみがバックアップにコピーされます。ユーザー主導のバックアップの作成時に 1 つ以上のタグを指定した場合、この値に関係なく、ファイルシステムからタグはコピーされません。この設定は、`PERSISTENT_1` と `PERSISTENT_2` デプロイタイプでの使用でのみ有効です。  
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`DailyAutomaticBackupStartTime` (**オプション**、`String`)  
毎日繰り返される時刻 (形式 `HH:MM`)。`HH` はその日のゼロ詰めの時間 (00～23) です。`MM` はその時間のゼロ詰めの分 (00～59) です。例えば、`05:00` は毎日午前 5 時を指定します。この設定は、`PERSISTENT_1` と `PERSISTENT_2` デプロイタイプでの使用でのみ有効です。  
[更新ポリシー: この設定は、更新中に変更できます。](using-pcluster-update-cluster-v3.md#update-policy-setting-supported-v3)

`PerUnitStorageThroughput` (**`PERSISTENT_1` と `PERSISTENT_2` のデプロイタイプに必要**、`Integer`)  
1 テビバイト (TiB) のストレージごとの読み取りおよび書き込みスループットの量を MB/s/TiB 単位で表示します。ファイルシステムのスループット容量は、ファイルシステムのストレージ容量 (TiB) に `PerUnitStorageThroughput` (MB/s/TiB) を掛けて計算されます。2.4 TiB のファイルシステムの場合、50 MB/s/TiB の `PerUnitStorageThroughput` をプロビジョニングすると、ファイルシステムのスループットは 120 MB/s になります。プロビジョニングしたスループットに対して支払いが発生します。これは、[PerUnitStorageThroughput](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-filesystem-lustreconfiguration.html#cfn-fsx-filesystem-lustreconfiguration-perunitstoragethroughput) プロパティに対応しています。  
有効な値:  
+ PERSISTENT\$11 SSD ストレージ: 50、100、200 MB/s/TiB。
+ PERSISTENT\$11 HDD ストレージ: 12、40 MB/s/TiB。
+ PERSISTENT\$12 SSD ストレージ: 125、250、500、1,000 MB/s/TiB。
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`BackupId` (**オプション**、`String`)  
既存のバックアップから FSx for Lustre ファイルシステムを復元するために使用するバックアップの ID を指定します。`BackupId` を指定した場合は、`AutoImportPolicy`、`DeploymentType`、`ExportPath`、`KmsKeyId`、`ImportPath`、`ImportedFileChunkSize`、`StorageCapacity` および `PerUnitStorageThroughput` を指定してはいけません。これらの設定はバックアップから読み取られます。また、`AutoImportPolicy`、`ExportPath`、`ImportPath` および `ImportedFileChunkSize` の設定は指定できません。これは、[BackupId](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-fsx-filesystem.html#cfn-fsx-filesystem-backupid) プロパティに対応しています。  
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`KmsKeyId` (**オプション**、`String`)  
保管中の永続的な FSx for Lustre ファイルシステムの FSx for Lustre ファイルシステムのデータを暗号化するために使用される AWS Key Management Service (AWS KMS) キー ID の ID。指定しない場合は、FSx for Lustre のマネージドキーが使用されます。`SCRATCH_1` および `SCRATCH_2` の FSx for Lustre ファイルシステムは、FSx for Lustre が管理する鍵を用いて、静止状態で常に暗号化されています。詳細については、「AWS Key Management Service API リファレンス**」の「[暗号化](https://docs.aws.amazon.com//kms/latest/APIReference/API_Encrypt.html)」を参照してください。  
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`FileSystemId` (**オプション**、`String`)  
既存の FSx for Lustre ファイルシステムの ID を指定します。  
このオプションを指定すると、`FsxLustreSettings` の `MountDir` と `FileSystemId` の設定のみが使用されます。`FsxLustreSettings` のその他のすべての設定は無視されます。  
ス AWS Batch ケジューラを使用する場合、FSx for Lustre はヘッドノードでのみ使用できます。
ファイルシステムは、ポート 988、1021、1022、および 1023 経由のインバウンドおよびアウトバウンドの TCP トラフィックを許可するセキュリティグループに関連付けられている必要があります。
次のいずれかを実行して、クラスターとファイルシステムの間でトラフィックが許可されていることを確認してください。  
+ クラスターサブネットの CIDR またはプレフィックスリストとの間のトラフィックを許可するように、ファイルシステムのセキュリティグループを設定します。
**注記**  
AWS ParallelCluster は、ポートが開いていること、および CIDR またはプレフィックスリストが設定されていることを検証します。CIDR AWS ParallelCluster ブロックまたはプレフィックスリストの内容を検証しません。
+ [`SlurmQueues`](Scheduling-v3.md#Scheduling-v3-SlurmQueues)/[`Networking`](Scheduling-v3.md#Scheduling-v3-SlurmQueues-Networking)/[`SecurityGroups`](Scheduling-v3.md#yaml-Scheduling-SlurmQueues-Networking-SecurityGroups) と [`HeadNode`](HeadNode-v3.md)/[`Networking`](HeadNode-v3.md#HeadNode-v3-Networking)/[`SecurityGroups`](HeadNode-v3.md#yaml-HeadNode-Networking-SecurityGroups) を使用して、クラスターノードのカスタムセキュリティグループを設定します。カスタムセキュリティグループを設定して、クラスターとファイルシステムの間のトラフィックを許可する必要があります。
**注記**  
すべてのクラスターノードがカスタムセキュリティグループを使用している場合、 はポートが開いていること AWS ParallelCluster のみを検証します。送信元と送信先が正しく設定されていることは検証 AWS ParallelCluster しません。
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`AutoImportPolicy` (**オプション**、`String`)  
FSx for Lustre ファイルシステムを作成すると、既存の Amazon S3 オブジェクトがファイルとディレクトリのリストとして表示されます。このプロパティを使用して、リンクされた Amazon S3 バケットのオブジェクトを追加または変更したときに、FSx for Lustre がファイルとディレクトリのリストを最新の状態に保つ方法を選択します。`AutoImportPolicy` は、次の値を持つことができます。  
+  `NEW` - 自動インポートがオンになっています。FSx for Lustre は、リンクされた Amazon S3 バケットに追加された新しいオブジェクトのうち、現在 FSx for Lustre ファイルシステム内に存在しないオブジェクトのディレクトリリストを自動的にインポートします。
+  `NEW_CHANGED` - 自動インポートがオンになっています。このオプションの選択後は、Amazon S3 バケットに追加された新しいオブジェクトや Amazon S3 バケットで変更された既存のオブジェクトのファイルとディレクトリのリストが、FSx for Lustre によって自動的にインポートされます。
+  `NEW_CHANGED_DELETED` - 自動インポートがオンになっています。このオプションの選択後は、Amazon S3 バケットに追加された新しいオブジェクト、Amazon S3 バケットで変更された既存のオブジェクト、Amazon S3 バケットで削除されたオブジェクトのファイルとディレクトリのリストが、FSx for Lustre によって自動的にインポートされます。
**注記**  
 AWS ParallelCluster バージョン 3.1.1 で `NEW_CHANGED_DELETED` のサポートが追加されました。
`AutoImportPolicy` が指定されていない場合、自動インポートはオフになります。FSx for Lustre は、ファイルシステムの作成時に、リンクされた Amazon S3 バケットのファイルとディレクトリのリストのみを更新します。このオプションの選択後は、新しいオブジェクトや変更されたオブジェクトのファイルとディレクトリのリストは FSx for Lustre で更新されません。  
詳細については、「Amazon FSx for Lustre ユーザーガイド**」の「[S3 バケットから更新を自動的にインポートする](https://docs.aws.amazon.com/fsx/latest/LustreGuide/autoimport-data-repo.html)」を参照してください。  
このパラメータは、`PERSISTENT_2` デプロイタイプを使用するファイルシステムではサポートされていません。データリポジトリの関連付けを設定する方法については、「Amazon FSx for Lustre ユーザーガイド**」の「[S3 バケットにファイルシステムをリンクする](https://docs.aws.amazon.com/fsx/latest/LustreGuide/create-dra-linked-data-repo.html)」を参照してください。
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`DriveCacheType` (**オプション**、`String`)  
ファイルシステムに SSD ドライブキャッシュを搭載することを指定します。`StorageType` 設定が `HDD`、`DeploymentType` 設定が `PERSISTENT_1` に設定されている場合のみ設定可能です。これは、[DriveCacheType](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-filesystem-lustreconfiguration.html#cfn-fsx-filesystem-lustreconfiguration-drivecachetype) プロパティに対応しています。詳細については、「Amazon FSx for Lustre ユーザーガイド**」の「[FSx for Lustre デプロイオプション](https://docs.aws.amazon.com/fsx/latest/LustreGuide/using-fsx-lustre.html)」を参照してください。  
唯一の有効な値は `READ` です。SSD ドライブのキャッシュを無効にするには、`DriveCacheType` の設定を指定しないでください。  
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`StorageType` (**オプション**、`String`)  
作成する FSx for Lustre ファイルシステムのストレージタイプを設定します。有効な値は、`SSD` および `HDD` です。  
+ ソリッドステートドライブストレージを使用する場合は、`SSD` に設定します。
+ ハードディスクドライブのストレージを使用する場合は `HDD` に設定します。`HDD` は `PERSISTENT` のデプロイタイプでサポートされています。
デフォルト値は `SSD` です。詳細については、「Amazon FSx for Windows ユーザーガイド**」の「[ストレージタイプのオプション](https://docs.aws.amazon.com/fsx/latest/WindowsGuide/optimize-fsx-costs.html#storage-type-options)」および「Amazon FSx for Lustre ユーザーガイド**」の「[複数のストレージオプション](https://docs.aws.amazon.com/fsx/latest/LustreGuide/what-is.html#storage-options)」を参照してください。  
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`DeletionPolicy` (**オプション**、`String`)  
ファイルシステムがクラスターから削除されるか、クラスターが削除されたときに、ファイルシステムを保持または削除するかを指定します。サポートされる値は `Delete` と `Retain` です。デフォルト値は `Delete` です。  
[DeletionPolicy](#yaml-SharedStorage-FsxLustreSettings-DeletionPolicy) が `Delete` に設定されている場合、クラスターが削除されたり、クラスターの更新によってファイルシステムが削除されたりした場合、マネージドボリュームはそのデータと共に削除されます。  
詳細については、「[共有ストレージ](shared-storage-quotas-integration-v3.md)」を参照してください。  
[更新ポリシー: この設定は、更新中に変更できます。](using-pcluster-update-cluster-v3.md#update-policy-setting-supported-v3)  
`DeletionPolicy` は AWS ParallelCluster バージョン 3.3.0 以降でサポートされています。

`DataRepositoryAssociations` (**オプション**、`String`)  
DRA のリスト (ファイルシステムあたり最大 8)  
それぞれのデータリポジトリの関連付けには、一意の Amazon FSx ファイルシステムディレクトリと、一意の S3 バケットまたはプレフィックスが関連付けられている必要があります。  
DRA を使用すると同時に [ExportPath](#yaml-SharedStorage-FsxLustreSettings-ExportPath) と [ImportPath](#yaml-SharedStorage-FsxLustreSettings-ImportPath) を FsxLustreSettings で使用することはできません。  
[更新ポリシー: この設定は、更新中に変更できます。](using-pcluster-update-cluster-v3.md#update-policy-setting-supported-v3)

`Name` **(必須)**、`String`)  
DRA の名前。この名前は設定を更新するときに使用します。  
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`BatchImportMetaDataOnCreate` (**オプション**、`Boolean`)  
データリポジトリの関連付けが作成された後に、メタデータをインポートするインポートデータリポジトリタスクを実行する必要があるかどうかを示すブールフラグ。このフラグが `true` に設定されている場合、タスクは実行されます。  
デフォルト値: `false`  
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`DataRepositoryPath` **(必須)**、`String`)  
ファイルシステムにリンクされる Amazon S3 データリポジトリへのパス。パスには、次の S3 バケットまたは `s3://amzn-s3-demo-bucket/myPrefix/` 形式のプレフィックスを使用できます。このパスは、S3 データリポジトリのファイルのインポート先またはエクスポート先を指定します。  
他の DRA との重複は不可  
パターン: `^[^\u0000\u0085\u2028\u2029\r\n]{3,4357}$`  
最小: `3`  
最大: `4357`  
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`FileSystemPath` **(必須)**、`String`)  
Amazon FSx for Lustre ファイルシステム上のパスで、`DataRepositoryPath` により 1 対 1 でマッピングされる上位ディレクトリ (`/ns1/` など) またはサブディレクトリ (`/ns1/subdir/` など) を指します。名前の先頭のスラッシュは必須です。2 つのデータリポジトリの関連付けは、重複するファイルシステムパスを持つことはできません。例えば、データリポジトリがファイルシステムパス `/ns1/` に関連付けられている場合、ファイルシステムパス `/ns1/ns2` に別のデータリポジトリをリンクすることはできません。  
このパスは、ファイルシステム上でファイルをエクスポートまたはインポートする場所を指定します。このファイルシステムディレクトリは 1 つの Amazon S3 バケットにのみリンクでき、他の S3 バケットをディレクトリにリンクすることはできません。  
他の DRA との重複は不可  
 ファイルシステムパスとしてスラッシュ (`/`) のみを指定した場合、ファイルシステムにリンクできるデータリポジトリは 1 つだけです。「`/`」は、ファイルシステムに関連付けられた最初のデータリポジトリのファイルシステムパスとしてのみ指定できます。
パターン: `^[^\u0000\u0085\u2028\u2029\r\n]{1,4096}$`  
最小: `1`  
最大: `4096`  
[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

`ImportedFileChunkSize` (**オプション**、`Integer`)  
データリポジトリからインポートされたファイルの場合、この値がストライプカウントと 1 つの物理ディスクに保存されたファイルごとの最大データ量 (MiB 単位) を決定します。1 つのファイルにストライピングできるディスクの最大数は、ファイルシステムまたはキャッシュを構成するディスクの合計数によって制限されます。  
デフォルトのチャンクサイズは 1,024 MiB (1 GiB) であり、512,000 MiB (500 GiB) まで高くすることができます。Amazon S3 オブジェクトの最大サイズは 5 TB です。  
最小: `1`  
最大: `4096`  
[更新ポリシー: この設定は、更新中に変更できます。](using-pcluster-update-cluster-v3.md#update-policy-setting-supported-v3)

`AutoExportPolicy` (**オプション**、`Array of strings`)  
リストには、以下の値の 1 つ以上を含めることができます。  
+ `NEW` – 新しいファイルとディレクトリは、それらがファイルシステムに追加された時点で、自動的にデータリポジトリにエクスポートされます。
+ `CHANGED` – ファイルシステム上のファイルおよびディレクトリが変更された場合は、その内容が自動的にデータリポジトリにエクスポートされます。
+ `DELETED` – ファイルシステム上で削除されたファイルとディレクトリは、データリポジトリからも自動的に削除されます。
`AutoExportPolicy` の定義では、イベントタイプを任意に組み合わせて使用できます。  
最大: `3`  
[更新ポリシー: この設定は、更新中に変更できます。](using-pcluster-update-cluster-v3.md#update-policy-setting-supported-v3)

`AutoImportPolicy` (**オプション**、`Array of strings`)  
リストには、以下の値の 1 つ以上を含めることができます。  
+ `NEW` – Amazon FSx は、FSx ファイルシステムにリンクされた S3 バケットに追加済みで、現在ファイルシステム内に存在していない、ファイルのメタデータを自動的にインポートします。
+ `CHANGED` – データリポジトリ内でファイルが変更された際、Amazon FSx は、そのファイルのメタデータを自動的に更新し、ファイルシステム上に既に存在するファイルの内容を無効にします。
+ `DELETED` –ファイルシステム上のファイルに対応するファイルがデータリポジトリで削除された場合、 Amazon FSx はファイルシステム上のファイルも自動的に削除します。
`AutoImportPolicy` の定義では、イベントタイプを任意に組み合わせて使用できます。  
最大: `3`  
[更新ポリシー: この設定は、更新中に変更できます。](using-pcluster-update-cluster-v3.md#update-policy-setting-supported-v3)

## `FsxOntapSettings`
<a name="SharedStorage-v3-FsxOntapSettings"></a>

**注記**  
`FsxOntap` が [`StorageType`](#yaml-SharedStorage-StorageType) に指定されている場合、`FsxOntapSettings` を定義する必要があります。

**(オプション)** FSx for ONTAP ファイルシステムの設定。

```
FsxOntapSettings:
  VolumeId: string
```

### `FsxOntapSettings` のプロパティ
<a name="SharedStorage-v3-FsxOntapSettings.properties"></a>

`VolumeId` **(必須)**、`String`)  
既存の FSx for ONTAP システムのボリューム ID を指定します。

**注記**  
ス AWS Batch ケジューラを使用する場合、FSx for ONTAP はヘッドノードでのみ使用できます。
FSx for ONTAP のデプロイタイプが `Multi-AZ` の場合、ヘッドノードサブネットのルートテーブルが適切に設定されていることを確認してください。
FSx for ONTAP のサポートが AWS ParallelCluster バージョン 3.2.0 で追加されました。
ファイルシステムは、ポート 111、635、2049、および 4046 経由のインバウンドおよびアウトバウンドの TCP および UDP トラフィックを許可するセキュリティグループに関連付けられている必要があります。

次のいずれかのアクションを実行して、クラスターとファイルシステムの間でトラフィックが許可されていることを確認してください。
+ クラスターサブネットの CIDR またはプレフィックスリストとの間のトラフィックを許可するように、ファイルシステムのセキュリティグループを設定します。
**注記**  
AWS ParallelCluster は、ポートが開いていること、および CIDR またはプレフィックスリストが設定されていることを検証します。CIDR AWS ParallelCluster ブロックまたはプレフィックスリストの内容を検証しません。
+ [`SlurmQueues`](Scheduling-v3.md#Scheduling-v3-SlurmQueues)/[`Networking`](Scheduling-v3.md#Scheduling-v3-SlurmQueues-Networking)/[`SecurityGroups`](Scheduling-v3.md#yaml-Scheduling-SlurmQueues-Networking-SecurityGroups) と [`HeadNode`](HeadNode-v3.md)/[`Networking`](HeadNode-v3.md#HeadNode-v3-Networking)/[`SecurityGroups`](HeadNode-v3.md#yaml-HeadNode-Networking-SecurityGroups) を使用して、クラスターノードのカスタムセキュリティグループを設定します。カスタムセキュリティグループを設定して、クラスターとファイルシステムの間のトラフィックを許可する必要があります。
**注記**  
すべてのクラスターノードがカスタムセキュリティグループを使用している場合、 はポートが開いていること AWS ParallelCluster のみを検証します。送信元と送信先が正しく設定されていることは検証 AWS ParallelCluster しません。

[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

## `FsxOpenZfsSettings`
<a name="SharedStorage-v3-FsxOpenZfsSettings"></a>

**注記**  
`FsxOpenZfs` が [`StorageType`](#yaml-SharedStorage-StorageType) に指定されている場合、`FsxOpenZfsSettings` を定義する必要があります。

**(オプション)** FSx for OpenZFS ファイルシステムの設定。

```
FsxOpenZfsSettings:
  VolumeId: string
```

[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

### `FsxOpenZfsSettings` のプロパティ
<a name="SharedStorage-v3-FsxOpenZfsSettings.properties"></a>

`VolumeId` **(必須)**、`String`)  
既存の FSx for OpenZFS システムのボリューム ID を指定します。

**注記**  
ス AWS Batch ケジューラを使用する場合、FSx for OpenZFS はヘッドノードでのみ使用できます。
FSx for OpenZFS のサポートが AWS ParallelCluster バージョン 3.2.0 で追加されました。
ファイルシステムは、ポート 111、2049、20001、20002、および 20003 経由のインバウンドおよびアウトバウンドの TCP および UDP トラフィックを許可するセキュリティグループに関連付けられている必要があります。

次のいずれかを実行して、クラスターとファイルシステムの間でトラフィックが許可されていることを確認してください。
+ クラスターサブネットの CIDR またはプレフィックスリストとの間のトラフィックを許可するように、ファイルシステムのセキュリティグループを設定します。
**注記**  
AWS ParallelCluster は、ポートが開いていること、および CIDR またはプレフィックスリストが設定されていることを検証します。CIDR AWS ParallelCluster ブロックまたはプレフィックスリストの内容を検証しません。
+ [`SlurmQueues`](Scheduling-v3.md#Scheduling-v3-SlurmQueues)/[`Networking`](Scheduling-v3.md#Scheduling-v3-SlurmQueues-Networking)/[`SecurityGroups`](Scheduling-v3.md#yaml-Scheduling-SlurmQueues-Networking-SecurityGroups) と [`HeadNode`](HeadNode-v3.md)/[`Networking`](HeadNode-v3.md#HeadNode-v3-Networking)/[`SecurityGroups`](HeadNode-v3.md#yaml-HeadNode-Networking-SecurityGroups) を使用して、クラスターノードのカスタムセキュリティグループを設定します。カスタムセキュリティグループを設定して、クラスターとファイルシステムの間のトラフィックを許可する必要があります。
**注記**  
すべてのクラスターノードがカスタムセキュリティグループを使用している場合、 はポートが開いていること AWS ParallelCluster のみを検証します。送信元と送信先が正しく設定されていることは検証 AWS ParallelCluster しません。

[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

## `FileCacheSettings`
<a name="SharedStorage-v3-FsxFileCacheSettings"></a>

**注記**  
`FileCache` が [`StorageType`](#yaml-SharedStorage-StorageType) に指定されている場合、`FileCacheSettings` を定義する必要があります。

**(オプション)** ファイルキャッシュの設定。

```
FileCacheSettings:
  FileCacheId: string
```

[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)

### `FileCacheSettings` のプロパティ
<a name="SharedStorage-v3-FsxFileCacheSettings.properties"></a>

`FileCacheId` **(必須)**、`String`)  
既存のファイルキャッシュのファイルキャッシュ ID を指定します。

**注記**  
ファイルキャッシュはス AWS Batch ケジューラをサポートしていません。
ファイルキャッシュのサポートが AWS ParallelCluster バージョン 3.7.0 に追加されました。
ファイルシステムは、ポート 988 経由のインバウンドおよびアウトバウンドの TCP トラフィックを許可するセキュリティグループに関連付けられている必要があります。

次のいずれかを実行して、クラスターとファイルシステムの間でトラフィックが許可されていることを確認してください。
+ クラスターサブネットの CIDR またはプレフィックスリストとの間のトラフィックを許可するように、ファイルキャッシュのセキュリティグループを設定します。
**注記**  
AWS ParallelCluster は、ポートが開いていること、および CIDR またはプレフィックスリストが設定されていることを検証します。CIDR AWS ParallelCluster ブロックまたはプレフィックスリストの内容を検証しません。
+ [`SlurmQueues`](Scheduling-v3.md#Scheduling-v3-SlurmQueues)/[`Networking`](Scheduling-v3.md#Scheduling-v3-SlurmQueues-Networking)/[`SecurityGroups`](Scheduling-v3.md#yaml-Scheduling-SlurmQueues-Networking-SecurityGroups) と [`HeadNode`](HeadNode-v3.md)/[`Networking`](HeadNode-v3.md#HeadNode-v3-Networking)/[`SecurityGroups`](HeadNode-v3.md#yaml-HeadNode-Networking-SecurityGroups) を使用して、クラスターノードのカスタムセキュリティグループを設定します。カスタムセキュリティグループを設定して、クラスターとファイルシステムの間のトラフィックを許可する必要があります。
**注記**  
すべてのクラスターノードがカスタムセキュリティグループを使用している場合、 はポートが開いていること AWS ParallelCluster のみを検証します。送信元と送信先が正しく設定されていることは検証 AWS ParallelCluster しません。

[更新ポリシー: この設定が変更された場合、更新は許可されません。](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)