---
title: "Create Instance Signal"
method: POST
path: "/aws/ec2/instance/signal"
tags: ["Elastigroup AWS"]
---

# Create Instance Signal

`POST /aws/ec2/instance/signal`

The instance signal API is used for notifying Spot about the instance state, so Spot can act accordingly. Supported signals are - INSTANCE_READY – Whenever this signal is sent, Spot will register the instance to the ELB INSTANCE_READY_TO_SHUTDOWN – Whenever this signal is sent, Spot will terminate the instance after it was marked for termination. Important - You need to define the expected signals for your Elastigroup in the group configuration.

## Query parameters

- `accountId` string

## Request body

- object
  - `instanceId` string — The instance ID the signal refers to.
  - `signal` string — The specific signal you want to trigger. Valid Values - INSTANCE_READY, INSTANCE_READY_TO_SHUTDOWN

## Response `200`

Create Instance Signal Response

- object
  - `request` object — Original request properties
    - `id` string — Unique ID associated with this request
    - `url` string — The URL that was used for the request
    - `method` string — The HTTP **METHOD** used for the request
    - `timestamp` string — When the request was received by Spot
  - `response` object — Response package that includes, status, type and any relevant data.
    - `status` object
      - `code` integer — HTTP status code assigned to this response
      - `message` string — HTTP status message for the respective status code
      - `kind` string — The data type of each item in the response
      - `items` object
        - `instanceId` string — The instance ID the signal refers to.
        - `instanceLaunchedAt` string — The time the instance was launched (returned only for signals of type INSTANCE_READY).
        - `instanceDetachedAt` string — The time the instance was detached (returned only for signals of type INSTANCE_READY_TO_SHUTDOWN).
        - `type` string — The type of signal sent in the request.
        - `signalExpiresAt` string — The time at which the signal expires.
        - `message` string — An optional message that may contain additional information.
      - `count` integer

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/spot/apis/spot-by-flexera-api.md) · [All operations](https://skmtc.net/spot/apis/spot-by-flexera-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spot/spot-by-flexera-api/revisions/72813baf8d47/schema)