GET

/#Action=ReportInstanceStatus

http://ec2.{region}.amazonaws.com/#Action=ReportInstanceStatus

Submits feedback about the status of an instance. The instance must be in the <code>running</code> state. If your experience with the instance differs from the instance status returned by <a>DescribeInstanceStatus</a>, use <a>ReportInstanceStatus</a> to report your experience with the instance. Amazon EC2 collects this information to improve the accuracy of status checks. Use of this action does not change the value returned by <a>DescribeInstanceStatus</a>.

Access Token Required: API Key

Query Params

Descriptionstring

Descriptive text about the health state of your instance.

DryRunboolean

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is <code>DryRunOperation</code>. Otherwise, it is <code>UnauthorizedOperation</code>.

EndTimestring

The time at which the reported instance health state ended.

InstanceIdarrayrequired

The instances.

ReasonCodearrayrequired

The reason codes that describe the health state of your instance. <ul> <li> <code>instance-stuck-in-state</code>: My instance is stuck in a state. </li> <li> <code>unresponsive</code>: My instance is unresponsive. </li> <li> <code>not-accepting-credentials</code>: My instance is not accepting my credentials. </li> <li> <code>password-not-available</code>: A password is not available for my instance. </li> <li> <code>performance-network</code>: My instance is experiencing performance problems that I believe are network related. </li> <li> <code>performance-instance-store</code>: My instance is experiencing performance problems that I believe are related to the instance stores. </li> <li> <code>performance-ebs-volume</code>: My instance is experiencing performance problems that I believe are related to an EBS volume. </li> <li> <code>performance-other</code>: My instance is experiencing performance problems. </li> <li> <code>other</code>: [explain using the description parameter] </li> </ul>

StartTimestring

The time at which the reported instance health state began.

Statusstringrequired

The status of all instances listed.

Allowed:

Actionstringrequired

Allowed:

Versionstringrequired

Allowed:

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request GET \
2     --url 'http://ec2.{region}.amazonaws.com/#Action=ReportInstanceStatus' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}