调用ReportInstancesStatus反馈ECS实例异常问题-云服务器 ECS-阿里云-阿里云帮助中心

调用ReportInstancesStatus反馈一台或者多台ECS实例的异常问题。您可以反馈多台ECS实例发生的相同问题，也可以反馈一台ECS实例的多块磁盘发生的相同问题。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
ecs:ReportInstancesStatus	get	*Instance `acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}`	无	无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	实例所在地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。	cn-hangzhou
Reason	string	否	异常问题对 ECS 实例造成的影响。取值范围： instance-hang：ECS 实例不可用，或无法连接。 instance-stuck-in-status：ECS 实例长时间停留在某一个状态，如 Starting 或 Stopping 状态。 abnormal-network：ECS 实例发生网络异常。 abnormal-local-disk：ECS 实例挂载的本地盘出现异常。 abnormal-cloud-disk：ECS 实例挂载的云盘或共享块存储出现异常。 others：其他异常类型。当以上影响类型不符合条件时，您可以设置`Reason=others`并在`Description`中描述更多信息。	abnormal-local-disk
Description	string	是	异常问题的详细描述。	本地盘不可用，挂载点拒绝访问，无法加载文件。
StartTime	string	否	实例异常问题开始时间。按照 ISO8601 标准表示，并需要使用 UTC +0 时间，格式为 yyyy-MM-ddTHH:mm:ssZ。	2017-11-30T06:32:31Z
EndTime	string	否	实例异常问题结束时间。按照 ISO8601 标准表示，并需要使用 UTC +0 时间，格式为 yyyy-MM-ddTHH:mm:ssZ。	2017-11-31T06:32:31Z
IssueCategory	string	否	异常问题的类别。该参数仅适用于弹性裸金属服务器实例。取值范围： hardware-cpu-error：CPU 故障 hardware-motherboard-error：主板故障 hardware-mem-error：内存故障 hardware-power-error：电源故障 hardware-disk-error：磁盘故障 hardware-networkcard-error：网卡故障 hardware-raidcard-error：SAS/RAID 卡故障 hardware-fan-error：风扇故障 others：其他	hardware-cpu-error
InstanceId	array	是	ECS 实例 ID 列表。最多可输入 100 个实例 ID。
	string	是	ECS 实例 ID。	i-bp165p6xk2tmdhj0****
DiskId	array	否	发生相同异常问题的磁盘 ID 列表。可输入最多 100 个磁盘 ID。如果您使用的是弹性裸金属服务器实例，请填写磁盘设备对应的 SN 列表。说明当参数`Reason`值为`abnormal-local-disk`或`abnormal-cloud-disk`，或者参数`IssueCategory`值为`hardware-disk-error`时，该参数为必填参数。
	string	否	磁盘 ID。	d-bp1aeljlfad7x6u1****
Device	array	否	发生相同异常问题的磁盘的挂载的设备名列表。可输入最多 100 个设备名。如果您使用的是弹性裸金属服务器实例，请填写磁盘设备对应 SLOT 槽位信息列表。说明对于弹性裸金属服务器实例，当参数`Reason`值为`abnormal-local-disk`或`abnormal-cloud-disk`，或者参数`IssueCategory`值为`hardware-disk-error`时，该参数为必填参数。
	string	否	设备名。	/dev/xvdb

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

示例

正常返回示例

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

错误码

HTTP status code	错误码	错误信息	描述
403	InvalidParameter	%s	无效的参数。
403	InstanceIdLimitExceeded	%s	指定的 InstanceId 个数不能超过 100 个。
403	DiskIdLimitExceeded	%s	指定的 DiskId 个数不能超过 100 个。
403	InvalidInstanceId.NotFound	%s	指定的实例不存在，请确认参数 InstanceId 是否正确。
404	MissingParameter	%s	缺失参数，请检查参数是否完整。

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作
2025-03-20	OpenAPI 描述信息更新、OpenAPI 错误码发生变更	查看变更详情