

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# `[efs]` Abschnitt


Definiert die Konfigurationseinstellungen für das Amazon EFS, das auf den Kopf- und Rechenknoten installiert ist. Weitere Informationen finden Sie [CreateFileSystem](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html)in der *Amazon EFS API-Referenz*.

Informationen zum Einbeziehen von Amazon EFS-Dateisystemen in Ihre Cluster-Definition finden Sie unter``[cluster]` Abschnitt`/``efs_settings``.

Um ein vorhandenes Amazon EFS-Dateisystem für dauerhaften Langzeitspeicher zu verwenden, der unabhängig vom Cluster-Lebenszyklus ist, geben Sie an[`efs_fs_id`](#efs-efs-fs-id).

Wenn Sie nichts angeben[`efs_fs_id`](#efs-efs-fs-id), AWS ParallelCluster erstellt das Amazon EFS-Dateisystem anhand der `[efs]` Einstellungen beim Erstellen des Clusters und löscht das Dateisystem und die Daten, wenn der Cluster gelöscht wird.

Weitere Informationen finden Sie unter [Bewährte Methoden: Umstellung eines Clusters auf eine neue AWS ParallelCluster Minor- oder Patch-Version](best-practices.md#best-practices-cluster-upgrades).

Das Format ist`[efs efs-name]`. *efs-name*muss mit einem Buchstaben beginnen, nicht mehr als 30 Zeichen enthalten und darf nur Buchstaben, Zahlen, Bindestriche (-) und Unterstriche (\$1) enthalten.

```
[efs customfs]
shared_dir = efs
encrypted = false
performance_mode = generalPurpose
```

**Topics**
+ [

## `efs_fs_id`
](#efs-efs-fs-id)
+ [

## `efs_kms_key_id`
](#efs-efs-kms-key-id)
+ [

## `encrypted`
](#efs-encrypted)
+ [

## `performance_mode`
](#efs-performance-mode)
+ [

## `provisioned_throughput`
](#efs-provisioned-throughput)
+ [

## `shared_dir`
](#efs-shared-dir)
+ [

## `throughput_mode`
](#efs-throughput-mode)

## `efs_fs_id`


**(Optional)** Definiert die Amazon EFS-Dateisystem-ID für ein vorhandenes Dateisystem.

Wenn Sie diese Option angeben, werden alle anderen Amazon EFS-Optionen außer für [`shared_dir`](cluster-definition.md#cluster-shared-dir) ungültig erklärt.

Wenn Sie diese Option festlegen, unterstützt sie nur die folgenden Arten von Dateisystemen:
+ Dateisysteme, die kein Mount-Ziel in der Availability Zone des Stacks haben.
+ Dateisysteme, die über ein vorhandenes Mount-Ziel in der Availability Zone des Stacks verfügen, von dem sowohl eingehender als auch ausgehender NFS-Verkehr zugelassen ist. `0.0.0.0/0`

Die Integritätsprüfung für die Validierung von [`efs_fs_id`](#efs-efs-fs-id) erfordert, dass die IAM-Rolle über die folgenden Berechtigungen verfügt:
+ `elasticfilesystem:DescribeMountTargets`
+ `elasticfilesystem:DescribeMountTargetSecurityGroups`
+ `ec2:DescribeSubnets`
+ `ec2:DescribeSecurityGroups`
+ `ec2:DescribeNetworkInterfaceAttribute`

Fügen Sie diese Berechtigungen Ihrer IAM-Rolle hinzu oder legen Sie `sanity_check = false` fest, um Fehler zu vermeiden.

**Wichtig**  
Wenn Sie ein Mount-Ziel festlegen, von dem ein- und ausgehender NFS-Verkehr zugelassen ist`0.0.0.0/0`, wird das Dateisystem NFS-Mount-Anfragen von überall in der Availability Zone des Mount-Ziels ausgesetzt. AWS empfiehlt nicht, ein Mount-Ziel in der Availability Zone des Stacks zu erstellen. Lassen Sie uns stattdessen diesen Schritt AWS erledigen. Wenn Sie ein Mount-Ziel in der Availability Zone des Stacks haben möchten, sollten Sie die Verwendung einer benutzerdefinierten Sicherheitsgruppe in Betracht ziehen, indem Sie im [`[vpc]`Abschnitt eine [`vpc_security_group_id`](vpc-section.md#vpc-security-group-id) Option angeben](vpc-section.md). Fügen Sie dann diese Sicherheitsgruppe dem Mount-Ziel hinzu und schalten Sie `sanity_check` sie aus, um den Cluster zu erstellen.

Es ist kein Standardwert vorhanden.

```
efs_fs_id = fs-12345
```

[Aktualisierungsrichtlinie: Wenn diese Einstellung geändert wird, ist das Update nicht zulässig.](using-pcluster-update.md#update-policy-fail)

## `efs_kms_key_id`


**(Optional)** Identifiziert den AWS Key Management Service (AWS KMS) vom Kunden verwalteten Schlüssel, der zum Schutz des verschlüsselten Dateisystems verwendet werden soll. Wenn dies festgelegt ist , muss [`encrypted`](#efs-encrypted)auf `true` eingestellt sein. Dies entspricht dem [KmsKeyId](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-request-KmsKeyId)Parameter in der *Amazon EFS API-Referenz*.

Es ist kein Standardwert vorhanden.

```
efs_kms_key_id = 1234abcd-12ab-34cd-56ef-1234567890ab
```

[Aktualisierungsrichtlinie: Wenn diese Einstellung geändert wird, ist das Update nicht zulässig.](using-pcluster-update.md#update-policy-fail)

## `encrypted`


**(Optional)** Gibt an, ob das Dateisystem verschlüsselt ist. Dies entspricht dem Parameter [Encrypted](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-request-Encrypted) in der *Amazon EFS API-Referenz*.

Der Standardwert ist `false`.

```
encrypted = true
```

[Aktualisierungsrichtlinie: Wenn diese Einstellung geändert wird, ist das Update nicht zulässig.](using-pcluster-update.md#update-policy-fail)

## `performance_mode`


**(Optional)** Definiert den Leistungsmodus des Dateisystems. Dies entspricht dem [PerformanceMode](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-request-PerformanceMode)Parameter in der *Amazon EFS API-Referenz*.

Gültige Optionen sind die folgenden Werte:
+ `generalPurpose`
+ `maxIO`

 Bei beiden Werten wird zwischen Groß- und Kleinschreibung unterschieden.

Wir empfehlen den `generalPurpose`-Leistungsmodus für die meisten Dateisysteme.

Dateisysteme, die den `maxIO`-Leistungsmodus verwenden, können auf einen höheren Gesamtdurchsatz und mehr Vorgänge pro Sekunde skalieren. Bei den meisten Dateioperationen gibt es jedoch einen Kompromiss zwischen etwas höheren Latenzen.

Nachdem das Dateisystem erstellt wurde, kann dieser Parameter nicht mehr geändert werden.

Der Standardwert ist `generalPurpose`.

```
performance_mode = generalPurpose
```

[Aktualisierungsrichtlinie: Wenn diese Einstellung geändert wird, ist das Update nicht zulässig.](using-pcluster-update.md#update-policy-fail)

## `provisioned_throughput`


**(Optional)** Definiert den bereitgestellten Durchsatz des Dateisystems, gemessen in MiB/s. Dies entspricht dem [ProvisionedThroughputInMibps](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-response-ProvisionedThroughputInMibps)Parameter in der *Amazon EFS API-Referenz*.

Wenn Sie diesen Parameter verwenden, müssen Sie [`throughput_mode`](#efs-throughput-mode) auf `provisioned` einstellen.

Die Quote für den Durchsatz beträgt `1024` MiB/s. Um eine Kontingenterhöhung anzufordern, wenn Sie sich an Support.

Der minimale Wert beträgt `0.0` MiB/s.

```
provisioned_throughput = 1024
```

[Richtlinie aktualisieren: Diese Einstellung kann während eines Updates geändert werden.](using-pcluster-update.md#update-policy-setting-supported)

## `shared_dir`


**(Erforderlich)** Definiert den Amazon EFS-Bereitstellungspunkt auf den Kopf- und Rechenknoten.

Dieser Parameter muss angegeben werden. Der Amazon EFS-Abschnitt wird nur verwendet, wenn er angegeben [`shared_dir`](cluster-definition.md#cluster-shared-dir) ist.

Verwenden Sie `NONE` oder nicht `/NONE` als gemeinsam genutztes Verzeichnis.

Im folgenden Beispiel wird Amazon EFS unter `/efs` bereitgestellt.

```
shared_dir = efs
```

[Aktualisierungsrichtlinie: Wenn diese Einstellung geändert wird, ist das Update nicht zulässig.](using-pcluster-update.md#update-policy-fail)

## `throughput_mode`


**(Optional)** Definiert den Durchsatzmodus des Dateisystems. Dies entspricht dem [ThroughputMode](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-request-ThroughputMode)Parameter in der *Amazon EFS API-Referenz*.

Gültige Optionen sind die folgenden Werte:
+ `bursting`
+ `provisioned`

Der Standardwert ist `bursting`.

```
throughput_mode = provisioned
```

[Richtlinie aktualisieren: Diese Einstellung kann während eines Updates geändert werden.](using-pcluster-update.md#update-policy-setting-supported)