

# Obter o status de uma solicitação de instância spot
<a name="spot-request-status"></a>

Para ajudar você a acompanhar suas solicitações de instância spot e planejar o uso de instâncias spot, use o status de solicitação fornecido pelo Amazon EC2. Por exemplo, um status de solicitação informa o motivo por que sua solicitação spot ainda não foi atendida ou lista as restrições que estão impedindo o atendimento de sua solicitação spot.

Em cada etapa do processo — também denominado *ciclo de vida* da solicitação spot — eventos específicos determinam estados sucessivos de solicitação.

A ilustração a seguir mostra como as solicitações de instância spot funcionam. Observe que o tipo de solicitação (única ou persistente) determina se a solicitação será reaberta ou quando o Amazon EC2 interromper uma instância spot, ou você parar uma instância spot. Se a requisição for persistente, ela será aberta novamente depois que a instância spot for interrompida. Se a solicitação for persistente e você parar a instância spot, a solicitação só será reaberta depois que você reiniciar a instância spot.

![\[Como as requisições de instância spot funcionam.\]](http://docs.aws.amazon.com/pt_br/AWSEC2/latest/UserGuide/images/spot_lifecycle.png)


**Topics**
+ [Obter informações do status da solicitação](#get-spot-instance-request-status)
+ [Códigos de status das solicitações spot](#spot-instance-request-status-understand)
+ [Evento de atendimento de solicitação de instância spot do EC2](#spot-request-fulfillment-event)
+ [Mudanças de estado para uma solicitação spot](spot-instances-request-status-lifecycle.md)

## Obter informações do status da solicitação
<a name="get-spot-instance-request-status"></a>

É possível obter informações de status para sua solicitação de instância spot.

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

**Para obter informações de status da solicitação**

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, escolha **Spot Requests (Solicitações spot)** e selecione a solicitação spot.

1. Para verificar o status, na guia **Descrição**, marque o campo **Status** .

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

**Para obter informações de status da solicitação**  
Use o seguinte comando [describe-spot-instance-requests](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-spot-instance-requests.html).

```
aws ec2 describe-spot-instance-requests --spot-instance-request-ids sir-0e54a519c9EXAMPLE
```

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

**Para obter informações de status da solicitação**  
Use o cmdlet [Get-EC2SpotInstanceRequest](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2SpotInstanceRequest.html).

```
Get-EC2SpotInstanceRequest -SpotInstanceRequestId sir-0e54a519c9EXAMPLE
```

------

## Códigos de status das solicitações spot
<a name="spot-instance-request-status-understand"></a>

As informações de status da solicitação spot são compostas de um código de status da solicitação, o tempo de atualização e uma mensagem de status. Juntas, essas informações ajudam a determinar a disposição de sua solicitação spot.

Veja a seguir os códigos de status de solicitação spot:

`az-group-constraint`  
O Amazon EC2 não pode executar todas as instâncias que você solicitou na mesma zona de disponibilidade.

`bad-parameters`  
Um ou mais parâmetros para sua solicitação spot são inválidos (por exemplo, a AMI que você especificou não existe). A mensagem de status de solicitação indica qual parâmetro é inválido.

`canceled-before-fulfillment`  
O usuário cancelou a solicitação spot antes de ser atendida.

`capacity-not-available`  
Não há capacidade suficiente disponível para as instâncias solicitadas.

`constraint-not-fulfillable`  
A solicitação spot não pode ser atendida porque uma ou mais restrições são inválidas (por exemplo, a zona de disponibilidade não existe). A mensagem de status de solicitação indica qual restrição é inválida.

`fulfilled`  
A solicitação spot é `active` e Amazon EC2 está executando seu Instâncias spot.

`instance-stopped-by-price`  
Sua instância foi interrompida porque o preço spot excedeu seu preço máximo.

`instance-stopped-by-user`  
A instância foi interrompida porque um usuário interrompeu a instância ou executou o comando de desligamento a partir da instância.

`instance-stopped-no-capacity`  
Sua instância foi interrompida devido às necessidades de gerenciamento de capacidade do EC2.

`instance-terminated-by-price`  
Sua instância foi encerrada porque o preço spot excedeu seu preço máximo. Se sua solicitação for uma sugestão de preço persistente, o processo será reiniciado, portanto, sua solicitação está com a avaliação pendente.

`instance-terminated-by-schedule`  
Sua instância spot foi encerrada no final da duração prevista.

`instance-terminated-by-service`  
A instância foi encerrada em um estado interrompido.

`instance-terminated-by-user` ou `spot-instance-terminated-by-user`  
Você encerrou uma instância spot que tinha sido atendida, portanto, o estado da solicitação é `closed` (a menos que se trate de uma requisição persistente) e o estado da instância é `terminated` .

`instance-terminated-launch-group-constraint`  
Uma ou mais instâncias no grupo de execução foram encerradas, portanto, a restrição do grupo de execução deixou de ser atendida.

`instance-terminated-no-capacity`  
Sua instância foi encerrada devido aos processos padrão de gerenciamento de capacidade.

`launch-group-constraint`  
O Amazon EC2 não pode executar todas as instâncias que você solicitou ao mesmo tempo. Todas as instâncias em um grupo de execução são iniciadas e encerradas juntas.

`limit-exceeded`  
O limite no número de volumes EBS ou de armazenamento de volume total foi excedido. Para obter mais informações, consulte [Quotas for Amazon EBS](https://docs.aws.amazon.com/ebs/latest/userguide/ebs-resource-quotas.html) no *Guia do usuário do Amazon EBS*.

`marked-for-stop`  
A instância spot é marcada para interrupção.

`marked-for-termination`  
A instância spot é marcada para encerramento.

`not-scheduled-yet`  
A solicitação spot não é avaliada até a data programada.

`pending-evaluation`  
Após criar uma solicitação de instância spot, ela entrará no estado `pending-evaluation` enquanto o sistema avalia os parâmetros da solicitação.

`pending-fulfillment`  
O Amazon EC2 está tentando provisionar as Instâncias spot.

`placement-group-constraint`  
A solicitação spot ainda não pode ser atendida porque uma instância spot não pode ser adicionada ao grupo de posicionamento no momento.

`price-too-low`  
A solicitação ainda não pode ser atendida porque seu preço máximo está abaixo do preço spot. Nesse caso, nenhuma instância é executada e sua solicitação permanece `open`.

`request-canceled-and-instance-running`  
Você cancelou a solicitação spot enquanto as Instâncias spot ainda estão em execução. A solicitação é `cancelled`, mas instâncias permanecem `running`.

`schedule-expired`  
A solicitação spot expirou porque não foi atendida antes da data especificada.

`system-error`  
Houve um erro de sistema inesperado. Se esse for um problema recorrente, entre em contato com o AWS Support para obter assistência.

## Evento de atendimento de solicitação de instância spot do EC2
<a name="spot-request-fulfillment-event"></a>

Quando uma solicitação de instância spot é atendida, o Amazon EC2 envia um evento de atendimento de solicitação de instância spot do EC2 ao Amazon EventBridge. É possível criar uma regra para realizar uma ação sempre que esse evento ocorrer, como invocar uma função Lambda ou notificar um tópico do Amazon SNS.

A seguir estão dados de exemplo para esse evento.

```
{
    "version": "0",
    "id": "01234567-1234-0123-1234-012345678901",
    "detail-type": "EC2 Spot Instance Request Fulfillment",
    "source": "aws.ec2",
    "account": "123456789012",
    "time": "yyyy-mm-ddThh:mm:ssZ",
    "region": "us-east-2",
    "resources": ["arn:aws:ec2:us-east-2:123456789012:instance/i-1234567890abcdef0"],
    "detail": {
        "spot-instance-request-id": "sir-0e54a519c9EXAMPLE",
        "instance-id": "i-1234567890abcdef0"
    }
}
```

Para saber mais, consulte o [Guia do Usuário do Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/).