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 `[ebs]`
Define la configuración de volumen de Amazon EBS para los volúmenes que están montados en el nodo principal y se comparten a los nodos de computación a través de NFS.
Para obtener información sobre cómo incluir volúmenes Amazon EBS en la definición de su clúster, consulte `Sección de `[cluster]`` / ``ebs_settings``.
Si desea utilizar un volumen Amazon EBS existente para un almacenamiento permanente a largo plazo que sea independiente del ciclo de vida del clúster, especifique [`ebs_volume_id`](#ebs-volume-id).
Si no lo especifica[`ebs_volume_id`](#ebs-volume-id), AWS ParallelCluster crea el volumen de EBS a partir de la `[ebs]` configuración al crear el clúster y elimina el volumen 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. `[ebs ebs-name]` *ebs-name*debe empezar por una letra, no contener más de 30 caracteres y contener únicamente letras, números, guiones (-) y guiones bajos (\$1).
```
[ebs custom1]
shared_dir = vol1
ebs_snapshot_id = snap-xxxxx
volume_type = io1
volume_iops = 200
...
[ebs custom2]
shared_dir = vol2
...
...
```
**Topics**
+ [
## `shared_dir`
](#ebs-shared-dir)
+ [
## `ebs_kms_key_id`
](#ebs-kms-key-id)
+ [
## `ebs_snapshot_id`
](#ebs-snapshot-id)
+ [
## `ebs_volume_id`
](#ebs-volume-id)
+ [
## `encrypted`
](#encrypted)
+ [
## `volume_iops`
](#volume-iops)
+ [
## `volume_size`
](#volume-size)
+ [
## `volume_throughput`
](#volume-throughput)
+ [
## `volume_type`
](#volume-type)
## `shared_dir`
**(Obligatorio)** Especifica la ruta donde se monta el volumen de Amazon EBS compartido.
Este parámetro es obligatorio cuando se usan varios volúmenes de Amazon EBS.
Cuando se utiliza un volumen de Amazon EBS, esta opción sobrescribe el [`shared_dir`](cluster-definition.md#cluster-shared-dir) que se especifica en la [sección `[cluster]`](cluster-definition.md). En el siguiente ejemplo, el volumen se monta en `/vol1`.
```
shared_dir = vol1
```
[Política de actualización: si se cambia esta configuración, no se permite la actualización.](using-pcluster-update.md#update-policy-fail)
## `ebs_kms_key_id`
**(Opcional)** Especifica una AWS KMS clave personalizada que se utilizará para el cifrado.
Este parámetro se debe usar junto con la opción `encrypted = true`. También debe tener un [`ec2_iam_role`](cluster-definition.md#ec2-iam-role) personalizado.
Para obtener más información, consulte [Cifrado de disco con una clave KMS personalizada](tutorials_04_encrypted_kms_fs.md).
```
ebs_kms_key_id = xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
```
[Política de actualización: si se cambia esta configuración, no se permite la actualización.](using-pcluster-update.md#update-policy-fail)
## `ebs_snapshot_id`
**(Opcional)** Define el ID de instantánea de Amazon EBS si utiliza una instantánea como origen del volumen.
No hay valor predeterminado.
```
ebs_snapshot_id = snap-xxxxx
```
[Política de actualización: si se cambia esta configuración, no se permite la actualización.](using-pcluster-update.md#update-policy-fail)
## `ebs_volume_id`
**(Opcional)** Define el ID de un volumen de Amazon EBS existente para adjuntarlo al nodo principal.
No hay valor predeterminado.
```
ebs_volume_id = vol-xxxxxx
```
[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)** Especifica si el volumen de Amazon EBS está cifrado. Nota: *No* debe usarse con instantáneas.
El valor predeterminado es `false`.
```
encrypted = false
```
[Política de actualización: si se cambia esta configuración, no se permite la actualización.](using-pcluster-update.md#update-policy-fail)
## `volume_iops`
**(Opcional)** Define el número de IOPS para volúmenes de tipo `io1`, `io2` y `gp3`.
El valor predeterminado, los valores admitidos y la proporción de datos `volume_iops` a `volume_size` varía entre [`volume_type`](raid-section.md#raid-volume-type) y [`volume_size`](#volume-size).
`volume_type` = `io1`
`volume_iops` predeterminado = 100
Valores admitidos `volume_iops` = 100–64 000 †
Relación máxima `volume_iops` a `volume_size` = 50 IOPS por cada GiB. 5000 IOPS requieren un `volume_size` de al menos 100 GiB.
`volume_type` = `io2`
`volume_iops` predeterminado = 100
Valores admitidos `volume_iops` = 100–64 000 (256 000 para los volúmenes de `io2` Block Express) †
Relación máxima `volume_iops` a `volume_size` = 500 IOPS por cada GiB. 5000 IOPS requieren un `volume_size` de al menos 10 GiB.
`volume_type` = `gp3`
`volume_iops` predeterminado = 3000
Valores admitidos `volume_iops` = 3000–16 000
Relación máxima `volume_iops` a `volume_size` = 500 IOPS por cada GiB. 5000 IOPS requieren un `volume_size` de al menos 10 GiB.
```
volume_iops = 200
```
[Política de actualización: esta configuración se puede cambiar durante una actualización.](using-pcluster-update.md#update-policy-setting-supported)
† Las IOPS máximas solo se garantizan en [las instancias creadas en el sistema Nitro](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#ec2-nitro-instances) aprovisionadas con más de 32 000 IOPS. Otras instancias garantizan hasta 32,000 IOPS. Es posible que los volúmenes [ más antiguos no alcancen el rendimiento máximo a menos que ](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-modify-volume.html)modifique el volumen`io1`. `io2` Los volúmenes de Block Express admiten valores de `volume_iops` de hasta 256 000. Para obtener más información, consulta [`io2`Block Express volume (en versión preliminar)](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-volume-types.html#io2-block-express) en la *Guía del EC2 usuario de Amazon*.
## `volume_size`
**(Opcional)** Especifica el tamaño del volumen que se va a crear, en GiB (si no se utiliza una instantánea).
El valor predeterminado y los valores admitidos varía en [`volume_type`](#volume-type).
`volume_type` = `standard`
Predeterminado `volume_size` = 20 GiB
Valores admitidos `volume_size` = 1–1024 GiB
`volume_type` = `gp2`, `io1`, `io2` y `gp3`
Predeterminado `volume_size` = 20 GiB
Valores admitidos `volume_size` = 1–16 384 GiB
`volume_type` = `sc1` y `st1`
Predeterminado `volume_size` = 500 GiB
Valores admitidos `volume_size` = 500–16 384 GiB
```
volume_size = 20
```
**nota**
Antes de AWS ParallelCluster la versión 2.10.1, el valor predeterminado para todos los tipos de volumen era de 20 GiB.
[Política de actualización: si se cambia esta configuración, no se permite la actualización.](using-pcluster-update.md#update-policy-fail)
## `volume_throughput`
**(Opcional)** Define el rendimiento de los tipos de volumen `gp3`, en MiB/s.
El valor predeterminado es `125`.
Valores admitidos `volume_throughput` = 125–1000 MiB/s
La relación entre `volume_throughput` y `volume_iops` no puede ser superior a 0,25. El rendimiento máximo de 1000 MiB/s requiere que la configuración de `volume_iops` sea de al menos 4000.
```
volume_throughput = 1000
```
**nota**
El soporte para `volume_throughput` se agregó en la AWS ParallelCluster versión 2.10.1.
[Política de actualización: si se cambia esta configuración, no se permite la actualización.](using-pcluster-update.md#update-policy-fail)
## `volume_type`
**(Opcional)** Especifica el [tipo de volumen de Amazon EBS](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html) del volumen que desea lanzar.
Las opciones de volumen válidas son las siguientes:
`gp2`, `gp3`
General Purpose SSD
`io1`, `io2`
Provisioned IOPS SSD
`st1`
HDD con rendimiento optimizado
`sc1`
HDD en frío
`standard`
Magnéticos de generaciones anteriores
Para obtener más información, consulte los [tipos de volumen de Amazon EBS](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html) en la *Guía del EC2 usuario de Amazon*.
El valor predeterminado es `gp2`.
```
volume_type = io2
```
**nota**
Support `gp3` y `io2` se agregó en la AWS ParallelCluster versión 2.10.1.
[Política de actualización: si se cambia esta configuración, no se permite la actualización.](using-pcluster-update.md#update-policy-fail)