AWS Documentation » Amazon EC2 » API Reference » Actions » ReportInstanceStatus	« Previous Next »
	Did this page help you? Yes \| No \| Tell us about it...

ReportInstanceStatus

Description

Use this action to submit feedback about an instance's status. This action works only for instances that are in the running state. If your experience with the instance differs from the instance status returned by the DescribeInstanceStatus action, use ReportInstanceStatus to report your experience with the instance. Amazon EC2 collects this information to improve the accuracy of status checks.

Note

Use of this action does not change the value returned by DescribeInstanceStatus.

To report an instance's status, specify an instance ID with the InstanceId.n parameter and a reason code with the ReasonCode.n parameter that applies to that instance. The following table contains descriptions of all available reason codes.

instance-stuck-in-state: My instance is stuck in a state.
unresponsive: My instance is unresponsive.
not-accepting-credentials: My instance is not accepting my credentials.
password-not-available: A password is not available for my instance.
performance-network: My instance is experiencing performance problems which I believe are network related.
performance-instance-store: My instance is experiencing performance problems which I believe are related to the instance stores.
performance-ebs-volume: My instance is experiencing performance problems which I believe are related to an EBS volume.
performance-other: My instance is experiencing performance problems.
other: Other, explained in the submitted description parameter.

Request Parameters

InstanceId.n

One or more instance IDs.

Type: String

Required: Yes

Status

The status of all instances listed in the InstanceId.n parameter.

Type: String

Valid values: ok | impaired

Required: Yes

StartTime

The time at which the reported instance health state began.

Type: DateTime

Required: No

EndTime

The time at which the reported instance health state ended.

Type: DateTime

Required: No

ReasonCode.n

A reason code that describes a specific instance's health state. Each code you supply corresponds to an instance ID that you supply with the InstanceId.n parameter. See the Description section for descriptions of each reason code.

Type: String

Required: Yes

Description

Descriptive text about the instance health state.

Type: String

Default: None

Required: No

Response Elements

The following elements are returned in a ReportInstanceStatusResponse element.

requestId

The ID of the request.

Type: xsd:string

return

Returns true if the request succeeds. Otherwise, returns an error.

Type: xsd:boolean

Examples

Example Request

This example reports instance health state for two instances.

https://ec2.amazonaws.com/?Action=ReportInstanceStatus
&Status=impaired
&InstanceId.0=i-9440effb
&InstanceId.1=i-0cf27c63
&Version=2013-02-01
&AuthParams

Example Request

This example reports instance health state for two instances with reason codes.

https://ec2.amazonaws.com/?Action=ReportInstanceStatus
&Description=Description+of+my+issue.
&Status=impaired
&InstanceId.0=i-9440effb
&InstanceId.1=i-0cf27c63
&ReasonCode.0=instance-performance-network
&ReasonCode.1=instance-performance-disk
&Version=2013-02-01
&AuthParams

Example Response

<ReportInstanceStatusResponse xmlns="http://ec2.amazonaws.com/doc/2013-02-01/">
   <requestId>b8131cff-dfbd-4277-bafe-be006fd0c4da</requestId>
   <return>true</return>
</ReportInstanceStatusResponse>

Document Conventions	« Previous Next »
Terms of Use	Did this page help you? Yes \| No \| Tell us about it...