Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Sección de `[efs]`
Define los ajustes de configuración del Amazon EFS que se ha montado en los nodos principal y de computación. Para obtener más información, consulte [CreateFileSystem](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html)la *referencia de la API de Amazon EFS*.
Para obtener información sobre cómo incluir los sistemas de archivos Amazon EFS en la definición de su clúster, consulte `Sección de `[cluster]`` / ``efs_settings``.
Si desea utilizar un sistema de archivos Amazon EFS existente para un almacenamiento permanente a largo plazo que sea independiente del ciclo de vida del clúster, especifique [`efs_fs_id`](#efs-efs-fs-id).
Si no lo especifica[`efs_fs_id`](#efs-efs-fs-id), AWS ParallelCluster crea el sistema de archivos Amazon EFS a partir de la `[efs]` configuración al crear el clúster y elimina el sistema de archivos y los datos cuando se elimina el clúster.
Para obtener más información, consulte [Prácticas recomendadas: mover un clúster a una nueva versión AWS ParallelCluster secundaria o a una versión de parche](best-practices.md#best-practices-cluster-upgrades).
El formato es`[efs efs-name]`. *efs-name*debe empezar por una letra, no contener más de 30 caracteres y contener únicamente letras, números, guiones (-) y guiones bajos (\$1).
```
[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`
**(Opcional)** Define el ID del sistema de archivos de Amazon EFS para un sistema de archivos ya existente.
Al especificar esta opción, anula las demás opciones de Amazon EFS salvo [`shared_dir`](cluster-definition.md#cluster-shared-dir).
Si establece esta opción, solo admite los sistemas de archivos siguientes:
+ Sistemas de archivos que no cuentan con un destino de montaje en la zona de disponibilidad de la pila.
+ Que cuentan con un destino de montaje ya existente en la zona de disponibilidad de la pila, con tráfico NFS de entrada y salida permitido desde `0.0.0.0/0`.
La comprobación de estado para validar [`efs_fs_id`](#efs-efs-fs-id) requiere que el rol de IAM tenga los siguientes permisos:
+ `elasticfilesystem:DescribeMountTargets`
+ `elasticfilesystem:DescribeMountTargetSecurityGroups`
+ `ec2:DescribeSubnets`
+ `ec2:DescribeSecurityGroups`
+ `ec2:DescribeNetworkInterfaceAttribute`
Para evitar errores, debe añadir los permisos siguientes a su rol de IAM o establecer `sanity_check = false`.
**importante**
Cuando se establece un objetivo de montaje que permite el tráfico NFS entrante y saliente`0.0.0.0/0`, se expone el sistema de archivos a las solicitudes de montaje de NFS procedentes de cualquier parte de la zona de disponibilidad del objetivo de montaje. AWS no recomienda crear un objetivo de montaje en la zona de disponibilidad de la pila. En su lugar, dejemos que nos AWS encarguemos de este paso. Si debe tener un destino de montaje en la zona de disponibilidad de la pila, considere la posibilidad de usar un grupo de seguridad personalizado proporcionando una opción [`vpc_security_group_id`](vpc-section.md#vpc-security-group-id) en la [sección `[vpc]`](vpc-section.md). A continuación, añada dicho grupo de seguridad al destino de montaje y desactive `sanity_check` para crear el clúster.
No hay valor predeterminado.
```
efs_fs_id = fs-12345
```
[Política de actualización: si se cambia esta configuración, no se permite la actualización.](using-pcluster-update.md#update-policy-fail)
## `efs_kms_key_id`
**(Opcional)** Identifica la AWS Key Management Service (AWS KMS) clave administrada por el cliente que se utilizará para proteger el sistema de archivos cifrados. Si se ha configurado esta opción, el ajuste [`encrypted`](#efs-encrypted) debe establecerse en `true`. Esto corresponde al [KmsKeyId](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-request-KmsKeyId)parámetro de la *referencia de la API de Amazon EFS*.
No hay valor predeterminado.
```
efs_kms_key_id = 1234abcd-12ab-34cd-56ef-1234567890ab
```
[Política de actualización: si se cambia esta configuración, no se permite la actualización.](using-pcluster-update.md#update-policy-fail)
## `encrypted`
**(Opcional)** Indica si el sistema de archivos está cifrado. Esto corresponde al parámetro [Encrypted](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-request-Encrypted) de la *Referencia de la API de Amazon EFS*.
El valor predeterminado es `false`.
```
encrypted = true
```
[Política de actualización: si se cambia esta configuración, no se permite la actualización.](using-pcluster-update.md#update-policy-fail)
## `performance_mode`
**(Opcional)** Define el modo de rendimiento del sistema de archivos. Esto corresponde al [PerformanceMode](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-request-PerformanceMode)parámetro de la *referencia de la API de Amazon EFS*.
Las opciones válidas son las siguientes:
+ `generalPurpose`
+ `maxIO`
Ambos valores distinguen entre mayúsculas y minúsculas.
Recomendamos el modo de rendimiento `generalPurpose` para la mayoría de sistemas de archivos.
Los sistemas de archivos que usan el modo de rendimiento de `maxIO` pueden escalar a mayores niveles de rendimiento de agregación y operaciones por segundo. Sin embargo, hay una compensación de latencias ligeramente más altas para la mayoría de las operaciones de archivos.
Este parámetro no se puede cambiar después de que se haya creado el sistema de archivos.
El valor predeterminado es `generalPurpose`.
```
performance_mode = generalPurpose
```
[Política de actualización: si se cambia esta configuración, no se permite la actualización.](using-pcluster-update.md#update-policy-fail)
## `provisioned_throughput`
**(Opcional)** Define el rendimiento aprovisionado del sistema de archivos, medido en MiB/s. Esto corresponde al [ProvisionedThroughputInMibps](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-response-ProvisionedThroughputInMibps)parámetro de la *referencia de la API de Amazon EFS*.
Si usa este parámetro, debe establecer [`throughput_mode`](#efs-throughput-mode) en `provisioned`.
La cuota de rendimiento es de `1024` MiB/s. Para solicitar un aumento de cuota, póngase en contacto con Soporte.
El valor mínimo es `0.0` MiB/s.
```
provisioned_throughput = 1024
```
[Política de actualización: esta configuración se puede cambiar durante una actualización.](using-pcluster-update.md#update-policy-setting-supported)
## `shared_dir`
**(Obligatorio)** Define el punto de montaje de Amazon EFS en los nodos principal y de computación.
Este parámetro es obligatorio. La sección de Amazon EFS solo se usa si se especifica [`shared_dir`](cluster-definition.md#cluster-shared-dir).
No utilice `NONE` o `/NONE` como directorio compartido.
En el siguiente ejemplo se monta Amazon EFS en `/efs`.
```
shared_dir = efs
```
[Política de actualización: si se cambia esta configuración, no se permite la actualización.](using-pcluster-update.md#update-policy-fail)
## `throughput_mode`
**(Opcional)** Define el modo de rendimiento del sistema de archivos. Esto corresponde al [ThroughputMode](https://docs.aws.amazon.com/efs/latest/ug/API_CreateFileSystem.html#efs-CreateFileSystem-request-ThroughputMode)parámetro de la *referencia de la API de Amazon EFS*.
Las opciones válidas son las siguientes:
+ `bursting`
+ `provisioned`
El valor predeterminado es `bursting`.
```
throughput_mode = provisioned
```
[Política de actualización: esta configuración se puede cambiar durante una actualización.](using-pcluster-update.md#update-policy-setting-supported)