Skip to content

EC2  >  Operations  >  report_instance_status

report_instance_status

Operation

report_instance_status async

report_instance_status(input: ReportInstanceStatusInput, plugins: list[Plugin] | None = None) -> ReportInstanceStatusOutput

Submits feedback about the status of an instance. The instance must be in the running state. If your experience with the instance differs from the instance status returned by DescribeInstanceStatus, use ReportInstanceStatus 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 DescribeInstanceStatus.

Parameters:

Name Type Description Default
input ReportInstanceStatusInput

An instance of ReportInstanceStatusInput.

required
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None

Returns:

Type Description
ReportInstanceStatusOutput

An instance of ReportInstanceStatusOutput.

Input

ReportInstanceStatusInput dataclass

Bases: _SerdeShape

Dataclass for ReportInstanceStatusInput structure.

Attributes

description class-attribute instance-attribute
description: str | None = ...

Descriptive text about the health state of your instance.

dry_run class-attribute instance-attribute
dry_run: bool | None = ...

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

end_time class-attribute instance-attribute
end_time: datetime | None = ...

The time at which the reported instance health state ended.

instances class-attribute instance-attribute
instances: list[str] | None = ...

The instances.

reason_codes class-attribute instance-attribute
reason_codes: list[str] | None = ...

The reason codes that describe the health state of your instance.

  • 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 that I believe are network related.

  • performance-instance-store: My instance is experiencing performance problems that I believe are related to the instance stores.

  • performance-ebs-volume: My instance is experiencing performance problems that I believe are related to an EBS volume.

  • performance-other: My instance is experiencing performance problems.

  • other: [explain using the description parameter]

start_time class-attribute instance-attribute
start_time: datetime | None = ...

The time at which the reported instance health state began.

status class-attribute instance-attribute
status: str | None = ...

The status of all instances listed.

Output

ReportInstanceStatusOutput dataclass

Bases: _SerdeShape

Dataclass for ReportInstanceStatusOutput structure.

Attributes

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.