ReportInstancesStatus -

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter	Type	Required	Example	Description
Action	String	Yes	ReportInstancesStatus	The operation that you want to perform. Set the value to ReportInstancesStatus.
RegionId	String	Yes	cn-hangzhou	The region ID of the ECS instance. You can call the DescribeRegions operation to query the most recent region list.
Reason	String	No	abnormal-local-disk	The impact of the exception on the instance. Valid values: instance-hang: The instance is unavailable or cannot be connected. instance-stuck-in-status: The instance is stuck in a state such as Starting or Stopping. abnormal-network: The instance has a network exception. abnormal-local-disk: A local disk attached to the instance has an exception. abnormal-cloud-disk: A disk or a Shared Block Storage device attached to the instance has an exception. others: other exception types. If the impact is not of the preceding types, you can set `Reason` to others and specify the `Description` parameter.
Description	String	Yes	The local disk is unavailable, the mount point is inaccessible, or files cannot be loaded.	The detailed description of the exception.
StartTime	String	No	2017-11-30T06:32:31Z	The start time of the instance exception. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
EndTime	String	No	2017-11-31T06:32:31Z	The end time of the instance exception. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
IssueCategory	String	No	hardware-cpu-error	The category of the exception. This parameter is applicable only to ECS bare metal instances. Valid values: hardware-cpu-error: CPU failure hardware-motherboard-error: motherboard failure hardware-mem-error: memory failure hardware-power-error: power failure hardware-disk-error: disk failure hardware-networkcard-error: network card failure hardware-raidcard-error: serial attached SCSI (SAS) or redundant arrays of independent disks (RAID) card failure hardware-raidcard-error: fan failure others: others
InstanceId.N	String	No	i-bp165p6xk2tmdhj0****	The ID of the ECS instance.
DiskId.N	String	No	d-bp1aeljlfad7x6u1****	The ID of the disk.
Device.N	String	No	/dev/xvdb	The device name.

Response parameters

Parameter	Type	Example	Description
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	The ID of the request.

Examples

Sample requests

https://ecs.aliyuncs.com/?Action=ReportInstancesStatus
&InstanceId.1=i-bp165p6xk2tmdhj0****
&Reason=abnormal-local-disk
&DiskId.1=d-bp1aeljlfad7x6u1****
&RegionId=cn-hangzhou
&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<ReportInstancesStatusResponse>
  <RequestId>4DD56CA6-6D75-4D33-BE34-E4A44EBE1C3D</RequestId>
</ReportInstancesStatusResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "4DD56CA6-6D75-4D33-BE34-E4A44EBE1C3D"
}

Error codes

HTTP status code	Error code	Error message	Description
403	InvalidParameter	%s	Invalid parameter value.
403	InstanceIdLimitExceeded	%s	More than 100 instance IDs are specified.
403	DiskIdLimitExceeded	%s	More than 100 disk IDs are specified.
403	InvalidInstanceId.NotFound	%s	The specified instance is not found. Check whether the specified instance ID is valid.
404	MissingParameter	%s	A required parameter is not specified.

For a list of error codes, see Service error codes.