

# Configurar instâncias de desempenho expansível
<a name="burstable-performance-instances-how-to"></a>

As etapas para a execução, monitoramento e modificação de instâncias de desempenho expansível (instâncias T) são semelhantes. A principal diferença é a especificação de crédito padrão na execução.

Cada família de instâncias T vem com a seguinte *especificação de crédito padrão*:
+ As instâncias T4g, T3a e T3 são iniciadas como `unlimited`
+ Instâncias T3 em um host dedicado são iniciadas como `standard`
+ As instâncias T2 são executadas como `standard`

É possível [alterar a especificação de crédito padrão](#burstable-performance-instance-set-default-credit-specification-for-account) para a conta.

**Topics**
+ [Configurar a especificação de crédito ao iniciar](#launch-burstable-performance-instances)
+ [Configurar um grupo do Auto Scaling para definir a especificação de crédito como unlimited](#burstable-performance-instances-auto-scaling-grp)
+ [Gerenciar a especificação de crédito de uma instância de desempenho expansível](#modify-burstable-performance-instances)
+ [Gerenciar a especificação de crédito padrão para uma conta](#burstable-performance-instance-set-default-credit-specification-for-account)

## Configurar a especificação de crédito ao iniciar
<a name="launch-burstable-performance-instances"></a>

É possível iniciar suas instâncias T com uma especificação de crédito de `unlimited` ou `standard`.

Os procedimentos a seguir descrevem como usar o console do EC2 ou a AWS CLI. Para obter informações sobre o uso de um grupo do Auto Scaling, consulte [Configurar um grupo do Auto Scaling para definir a especificação de crédito como unlimited](#burstable-performance-instances-auto-scaling-grp).

------
#### [ Console ]

**Para configurar a especificação de crédito de uma instância ao iniciar**

1. Siga o procedimento para [iniciar uma instância](ec2-launch-instance-wizard.md).

1. Em **Instance type** (Tipo de instância), selecione um tipo de instância T.

1. Expanda **Advanced details** (Detalhes avançados). Em **Especificação de crédito**, selecione uma especificação de crédito.

1. No painel **Resumo**, analise a configuração da instância e selecione **Iniciar instância**.

------
#### [ AWS CLI ]

**Para definir a especificação de crédito de uma instância ao iniciar**  
Use o comando [run-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/run-instances.html) com a opção `--credit-specification`.

```
--credit-specification CpuCredits=unlimited
```

------
#### [ PowerShell ]

**Para definir a especificação de crédito de uma instância ao iniciar**  
Use o cmdlet [New-EC2Instance](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2Instance.html) com o parâmetro `-CreditSpecification_CpuCredit`.

```
-CreditSpecification_CpuCredit unlimited
```

------

## Configurar um grupo do Auto Scaling para definir a especificação de crédito como unlimited
<a name="burstable-performance-instances-auto-scaling-grp"></a>

Quando as instâncias T são executadas ou iniciadas, elas precisam de créditos de CPU para uma boa experiência de bootstrapping. Se você usar um grupo do Auto Scaling para executar suas instâncias, recomendamos configurar suas instâncias como `unlimited`. Caso faça isso, as instâncias usam créditos excedentes quando são automaticamente iniciadas ou reiniciadas pelo grupo do Auto Scaling. O uso de créditos excedentes impede restrições de performance.

### Criar um modelo de execução
<a name="burstable-performance-instances-asg-launch-template"></a>

Use um *modelo de execução* para executar instâncias como `unlimited` em um grupo do Auto Scaling. Uma configuração de execução não oferece suporte à execução de instâncias como `unlimited`.

------
#### [ Console ]

**Para criar um modelo de execução que defina a especificação de crédito**

1. Siga o procedimento [Criar um modelo de execução usando configurações avançadas](https://docs.aws.amazon.com/autoscaling/ec2/userguide/advanced-settings-for-your-launch-template.html) no *Guia do usuário do Amazon EC2 Auto Scaling*.

1. Em **Launch template contents (Conteúdo do modelo de execução)**, para **Instance type (Tipo de instância)**, escolha um tamanho de instância.

1. Para iniciar instâncias como `unlimited` em um grupo do Auto Scaling, em **Advanced details (Detalhes avançados)**, para **Credit specification (Especificação de crédito)**, escolha **Unlimited (Ilimitado)**.

1. Ao terminar de definir os parâmetros do modelo de execução, escolha **Create launch template (Criar modelo de execução)**.

------
#### [ AWS CLI ]

**Para criar um modelo de execução que defina a especificação de crédito**  
Use o comando [create-launch-template](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-launch-template.html).

```
aws ec2 create-launch-template \
    --launch-template-name my-launch-template \
    --version-description FirstVersion \
    --launch-template-data CreditSpecification={CpuCredits=unlimited}
```

------
#### [ PowerShell ]

**Para criar um modelo de execução que defina a especificação de crédito**  
Use o cmdlet [New-EC2LaunchTemplate](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2LaunchTemplate.html). Defina a especificação de crédito para os dados do modelo de execução conforme descrito a seguir.

```
$creditSpec = New-Object Amazon.EC2.Model.CreditSpecificationRequest
$creditSpec.CpuCredits = "unlimited"
$launchTemplateData = New-Object Amazon.EC2.Model.RequestLaunchTemplateData
$launchTemplateData.CreditSpecification = $creditSpec
```

------

### Associar um grupo de Auto Scaling a um modelo de execução
<a name="burstable-performance-instances-create-asg-with-launch-template"></a>

Para associar o modelo de execução a um grupo do Auto Scaling, crie o grupo do Auto Scaling usando o modelo de execução ou adicione o modelo de execução a um grupo do Auto Scaling existente.

------
#### [ Console ]

**Para criar um grupo do Auto Scaling usando um modelo de inicialização**

1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. Na barra de navegação na parte superior da tela, selecione a mesma região usada ao criar o modelo de execução.

1. No painel de navegação, escolha **Auto Scaling Groups**, **Criar grupo do Auto Scaling**.

1. Escolha **Launch Template (Modelo de execução)**, selecione seu modelo de execução e, seguida, **Next Step (Próxima etapa)**.

1. Preencha os campos para o grupo do Auto Scaling. Quando você terminar de revisar as definições de configuração na **Review page (Página de revisão)**, selecione **Create Auto Scaling group (Criar grupo do Auto Scaling)**. Para obter mais informações, consulte [Criação de um grupo do Auto Scaling usando um modelo de execução](https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-asg-launch-template.html) no *Guia do usuário do Amazon EC2 Auto Scaling*.

**Para adicionar um modelo de inicialização a um grupo do Auto Scaling existente**

1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. Na barra de navegação na parte superior da tela, selecione a mesma região usada ao criar o modelo de execução.

1. No painel de navegação, escolha ** Groups Auto Scaling**.

1. Na lista de grupos do Auto Scaling, selecione um grupo do Auto Scaling, **Actions (Ações)** e **Edit (Editar)**.

1. Na guia **Details (Detalhes)**, em **Launch Template (Modelo de execução)**, selecione um modelo de execução e, em seguida, selecione **Save (Salvar)**.

------
#### [ AWS CLI ]

**Para criar um grupo do Auto Scaling usando um modelo de inicialização**  
Use o comando [create-auto-scaling-group](https://docs.aws.amazon.com/cli/latest/reference/autoscaling/create-auto-scaling-group.html) e especifique o parâmetro `--launch-template`.

**Para adicionar um modelo de inicialização a um grupo do Auto Scaling existente**  
Use o comando [update-auto-scaling-group](https://docs.aws.amazon.com/cli/latest/reference/autoscaling/update-auto-scaling-group.html) e especifique o parâmetro `--launch-template`. 

------
#### [ PowerShell ]

**Para criar um grupo do Auto Scaling usando um modelo de inicialização**  
Use o cmdlet [New-ASAutoScalingGroup](https://docs.aws.amazon.com/powershell/latest/reference/items/New-ASAutoScalingGroup.html) e especifique o parâmetro `-LaunchTemplate_LaunchTemplateId` ou `-LaunchTemplate_LaunchTemplateName`.

**Para adicionar um modelo de inicialização a um grupo do Auto Scaling existente**  
Use o cmdlet [Update-ASAutoScalingGroup](https://docs.aws.amazon.com/powershell/latest/reference/items/Update-ASAutoScalingGroup.html) e especifique o parâmetro `-LaunchTemplate_LaunchTemplateId` ou `-LaunchTemplate_LaunchTemplateName`.

------

## Gerenciar a especificação de crédito de uma instância de desempenho expansível
<a name="modify-burstable-performance-instances"></a>

É possível alterar a qualquer momento entre `unlimited` e `standard` a especificação de crédito de uma instância T interrompida ou em execução.

Observe que, no modo `unlimited`, uma instância pode gastar créditos excedentes, o que pode gerar uma cobrança adicional. Para obter mais informações, consulte [Os créditos excedentes podem gerar cobranças](burstable-performance-instances-unlimited-mode-concepts.md#unlimited-mode-surplus-credits).

------
#### [ Console ]

**Para gerenciar a especificação de crédito de uma instância**

1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. No painel de navegação à esquerda, selecione **Instâncias**.

1. (Opcional) Selecione uma instância. Na guia **Detalhes**, vá para **Especificação de crédito**. O valor é `unlimited` ou `standard`.

1. (Opcional) Para modificar a especificação de crédito para várias instâncias ao mesmo tempo, selecione todas elas.

1. Escolha **Actions (Ações)**, **Instance settings (Configurações de instância)**, **Change credit specification (Alterar especificação de crédito)**. Essa opção só será ativada se você tiver selecionado uma instância T.

1. Para o **Modo ilimitado**, marque ou desmarque a caixa de seleção ao lado de cada ID de instância.

------
#### [ AWS CLI ]

**Para obter a especificação de crédito de uma instância**  
Use o comando [describe-instance-credit-specifications](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-credit-specifications.html). Se você não especificar um ID de instância, todas as instâncias com a especificação de crédito `unlimited` serão retornadas. A saída também incluiria instâncias que foram previamente configuradas com a especificação de crédito `unlimited`. Por exemplo, se você redimensionar uma instância T3 para uma instância M4, enquanto a mesma estiver configurada como `unlimited`, o Amazon EC2 retornará a instância M4.

```
aws ec2 describe-instance-credit-specifications \
    --instance-id i-1234567890abcdef0 \
    --query InstanceCreditSpecifications[].CpuCredits \
    --output text
```

O seguinte é um exemplo de saída.

```
unlimited
```

**Para definir a especificação de crédito de uma instância**  
Use o comando [modify-instance-credit-specification](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-credit-specification.html).

```
aws ec2 modify-instance-credit-specification \
    --region us-east-1 \
    --instance-credit-specification "InstanceId=i-1234567890abcdef0,CpuCredits=unlimited"
```

------
#### [ PowerShell ]

**Para obter a especificação de crédito de uma instância**  
Use o cmdlet [Get-EC2CreditSpecification](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2CreditSpecification.html).

```
(Get-EC2CreditSpecification `
    -InstanceId i-1234567890abcdef0).CpuCredits
```

O seguinte é um exemplo de saída.

```
unlimited
```

**Para definir a especificação de crédito de uma instância**  
Use o cmdlet [Edit-EC2InstanceCreditSpecification](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceCreditSpecification.html).

```
Edit-EC2InstanceCreditSpecification `
    -Region us-east-1 `
    -InstanceCreditSpecification @({InstanceId="i-1234567890abcdef0" CpuCredits="unlimited"})
```

------

## Gerenciar a especificação de crédito padrão para uma conta
<a name="burstable-performance-instance-set-default-credit-specification-for-account"></a>

Cada família de instâncias T vem com uma [especificação de crédito padrão](#default-credit-spec). É possível alterar a especificação de crédito padrão por família de instâncias T no nível da conta por região da AWS. Os valores válidos para a especificação de crédito padrão são `unlimited` e `standard`.

Se você usar o assistente de inicialização de instância no console do EC2 para iniciar instâncias, o valor selecionado para a especificação de crédito substituirá a especificação de crédito padrão no nível da conta. Se você usar a AWS CLI para executar instâncias, todas as novas instâncias T na conta serão executadas usando a opção de crédito padrão. A especificação de crédito para instâncias existentes em execução ou interrompidas não é afetada.

**Consideração**  
A especificação de crédito padrão para uma família de instâncias pode ser modificada apenas uma vez em um período contínuo de 5 minutos e até quatro vezes em um período contínuo de 24 horas.

------
#### [ Console ]

**Para gerenciar a especificação de crédito padrão**

1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. Para alterar a Região da AWS, use o seletor de regiões no canto superior direito da página.

1. No painel de navegação, escolha **Painel**.

1. No cartão **Atributos da conta**, em **Configurações**, escolha **Especificação de crédito padrão**.

1. Escolha **Gerenciar**.

1. Para cada família de instâncias, escolha **Unlimited** (Ilimitado) ou **Standard** (Padrão) e, em seguida, escolha **Update** (Atualizar).

------
#### [ AWS CLI ]

**Para obter a especificação de crédito padrão**  
Use o comando [get-default-credit-specification](https://docs.aws.amazon.com/cli/latest/reference/ec2/get-default-credit-specification.html).

```
aws ec2 get-default-credit-specification \
    --region us-east-1 \
    --instance-family t2 \
    --query InstanceFamilyCreditSpecifications[].CpuCredits \
    --output text
```

O seguinte é um exemplo de saída.

```
standard
```

**Para definir a especificação de crédito padrão**  
Use o comando [modify-default-credit-specification](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-default-credit-specification.html). O exemplo a seguir define o valor como `unlimited`.

```
aws ec2 modify-default-credit-specification \
    --region us-east-1 \
    --instance-family t2 \
    --cpu-credits unlimited
```

------
#### [ PowerShell ]

**Para obter a especificação de crédito padrão**  
Use o cmdlet [Get-EC2DefaultCreditSpecification](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2DefaultCreditSpecification.html).

```
(Get-EC2DefaultCreditSpecification `
    -Region us-east-1 `
    -InstanceFamily t2).CpuCredits
```

O seguinte é um exemplo de saída.

```
standard
```

**Para definir a especificação de crédito padrão**  
Use o cmdlet [Edit-EC2DefaultCreditSpecification](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2DefaultCreditSpecification.html). O exemplo a seguir define o valor como `unlimited`.

```
Edit-EC2DefaultCreditSpecification `
    -Region us-east-1 `
    -InstanceFamily t2 `
    -CpuCredit unlimited
```

------