As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Seção `[ebs]`
Define as definições de configuração de volume do Amazon EBS para os volumes que são montados no nó de cabeçalho e compartilhados pelo NFS com os nós de computação.
Para saber como incluir volumes do Amazon EBS em sua definição de cluster, consulte `Seção `[cluster]`` / ``ebs_settings``.
Para usar um volume existente do Amazon EBS para armazenamento permanente de longo prazo que seja independente do ciclo de vida do cluster, especifique [`ebs_volume_id`](#ebs-volume-id).
Se você não especificar[`ebs_volume_id`](#ebs-volume-id), AWS ParallelCluster cria o volume do EBS a partir das `[ebs]` configurações ao criar o cluster e exclui o volume e os dados quando o cluster é excluído.
Para obter mais informações, consulte [Melhores práticas: mover um cluster para uma nova versão AWS ParallelCluster secundária ou de patch](best-practices.md#best-practices-cluster-upgrades).
O formato é`[ebs ebs-name]`. *ebs-name*deve começar com uma letra, conter no máximo 30 caracteres e conter somente letras, números, hífens (-) e sublinhados (\$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`
**(Obrigatório)** Especifica o caminho em que o volume compartilhado do Amazon EBS é montado.
Esse parâmetro é obrigatório ao usar vários volumes do Amazon EBS.
Ao usar um volume do Amazon EBS, essa opção substitui o [[`shared_dir`](cluster-definition.md#cluster-shared-dir) que está especificado na seção `[cluster]`.](cluster-definition.md) No exemplo a seguir, o volume é montado em `/vol1`.
```
shared_dir = vol1
```
[Política de atualização: se essa configuração for alterada, a atualização não será permitida.](using-pcluster-update.md#update-policy-fail)
## `ebs_kms_key_id`
**(Opcional)** Especifica uma AWS KMS chave personalizada a ser usada para criptografia.
Esse parâmetro deve ser usado em conjunto com `encrypted = true`. Também deve ter uma [`ec2_iam_role`](cluster-definition.md#ec2-iam-role) personalizada.
Para obter mais informações, consulte [Criptografia de disco com uma chave do KMS personalizada](tutorials_04_encrypted_kms_fs.md).
```
ebs_kms_key_id = xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
```
[Política de atualização: se essa configuração for alterada, a atualização não será permitida.](using-pcluster-update.md#update-policy-fail)
## `ebs_snapshot_id`
**(Opcional)** Define o ID do snapshot do Amazon EBS, caso esteja usando um snapshot como a origem do volume.
Não há valor padrão.
```
ebs_snapshot_id = snap-xxxxx
```
[Política de atualização: se essa configuração for alterada, a atualização não será permitida.](using-pcluster-update.md#update-policy-fail)
## `ebs_volume_id`
**(Opcional)** Define o ID do volume de um volume do Amazon EBS existente a ser anexado ao nó principal.
Não há valor padrão.
```
ebs_volume_id = vol-xxxxxx
```
[Política de atualização: se essa configuração for alterada, a atualização não será permitida.](using-pcluster-update.md#update-policy-fail)
## `encrypted`
**(Opcional)** Especifica se um volume do Amazon EBS é criptografado. Observação: *Não* use com snapshots.
O valor padrão é `false`.
```
encrypted = false
```
[Política de atualização: se essa configuração for alterada, a atualização não será permitida.](using-pcluster-update.md#update-policy-fail)
## `volume_iops`
**(Opcional)** Define o número de IOPS para os volumes do tipo `io1`, `io2`, e `gp3`.
O valor padrão, os valores suportados e a proporção do `volume_iops` para `volume_size` variam de acordo com [`volume_type`](raid-section.md#raid-volume-type) e [`volume_size`](#volume-size).
`volume_type` = `io1`
Padrão `volume_iops` = 100
Valores suportados `volume_iops` = 100–64000 †
Proporção máxima de `volume_iops` para `volume_size` = 50 IOPS para cada GiB. 5000 IOPS exigem um `volume_size` de pelo menos 100 GiB.
`volume_type` = `io2`
Padrão `volume_iops` = 100
Valores suportados `volume_iops` = 100–64000 (256000 para volumes do `io2` Block Express) †
Proporção máxima de `volume_iops` para `volume_size` = 500 IOPS para cada GiB. 5000 IOPS exigem um `volume_size` de pelo menos 10 GiB.
`volume_type` = `gp3`
Padrão `volume_iops` = 3000
Valores suportados `volume_iops` = 3000–16000
Proporção máxima de `volume_iops` para `volume_size` = 500 IOPS para cada GiB. 5000 IOPS exigem um `volume_size` de pelo menos 10 GiB.
```
volume_iops = 200
```
[Política de atualização: essa configuração pode ser alterada durante uma atualização.](using-pcluster-update.md#update-policy-setting-supported)
† O número máximo de IOPS é garantido somente em [instâncias criadas no Nitro System](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#ec2-nitro-instances) provisionadas com mais de 32.000 IOPS. Outras instâncias garantem até 32.000 IOPS. A menos que você [modifique o volume](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-modify-volume.html), os volumes de `io1` mais antigos podem não atingir o desempenho total. `io2` Os volumes do Block Express oferecem suporte a valores `volume_iops` de até 256.000. Para obter mais informações, consulte [Volumes do `io2` Block Express (em versão prévia)](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-volume-types.html#io2-block-express) no *Guia EC2 do usuário da Amazon*.
## `volume_size`
**(Opcional)** Especifica o tamanho do volume a ser criado em GiB (caso não esteja usando um snapshot).
O valor padrão e os valores suportados variam de acordo com o [`volume_type`](#volume-type).
`volume_type` = `standard`
Padrão `volume_size` = 20 GiB
Valores suportados `volume_size` = 1–1024 GiB
`volume_type` = `gp2`, `io1`, `io2`, e `gp3`
Padrão `volume_size` = 20 GiB
Valores suportados `volume_size` = 1–16384 GiB
`volume_type` = `sc1` e `st1`
Padrão `volume_size` = 500 GiB
Valores suportados `volume_size` = 500–16384 GiB
```
volume_size = 20
```
**nota**
Antes da AWS ParallelCluster versão 2.10.1, o valor padrão para todos os tipos de volume era de 20 GiB.
[Política de atualização: se essa configuração for alterada, a atualização não será permitida.](using-pcluster-update.md#update-policy-fail)
## `volume_throughput`
**(Opcional)** Define o throughput para tipos de volume `gp3`, em MiB/s.
O valor padrão é `125`.
Valores suportados `volume_throughput` = 125–1000 MiB/s
A proporção de `volume_throughput` para `volume_iops` não pode ser superior a 0,25. O throughput máximo de 1000 MiB/s exige que a configuração `volume_iops` seja de pelo menos 4000.
```
volume_throughput = 1000
```
**nota**
Support for `volume_throughput` adicionado na AWS ParallelCluster versão 2.10.1.
[Política de atualização: se essa configuração for alterada, a atualização não será permitida.](using-pcluster-update.md#update-policy-fail)
## `volume_type`
**(Opcional)** Especifica [o tipo de volume do Amazon EBS](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html) do volume que você deseja executar.
As opções válidas são os seguintes tipos de volume:
`gp2`, `gp3`
SSD de uso geral
`io1`, `io2`
Provisioned IOPS SSD
`st1`
HDD otimizado para throughput
`sc1`
Disco rígido frio
`standard`
Geração magnética anterior
Para obter mais informações, consulte os [tipos de volume do Amazon EBS](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html) no *Guia do EC2 usuário da Amazon*.
O valor padrão é `gp2`.
```
volume_type = io2
```
**nota**
Support `gp3` e `io2` foi adicionado na AWS ParallelCluster versão 2.10.1.
[Política de atualização: se essa configuração for alterada, a atualização não será permitida.](using-pcluster-update.md#update-policy-fail)