StartInstance_云服务器 ECS_API文档-阿里云OpenAPI开发者门户

接口说明

该接口为异步接口，实例的启动不是立即完成的，成功调用后，实例会先进入启动中（Starting）状态，你可以调用 DescribeInstanceStatus 查看实例状态，当返回的状态为Running时代表启动成功。

使用须知

被安全锁定的实例不能通过调用该接口启动。更多信息，请参见资源安全锁定对调用 API 的影响。
ECS 实例状态必须为已停止（Stopped）。
节省停机模式下可能会因为库存不足导致启动失败。

流控信息

请求速率为500/60(s)。更多流控信息，请前往配额中心查看

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

ecs:StartInstance	Update	Instance acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}	无	无

请求参数

字段名称	字段详情
InstanceIdstring	指定启动的实例 ID。示例值:i-bp67acfmxazb4p****参考取值来源: RunInstances StopInstances CreateInstance StartInstances RebootInstances DescribeInstances ModifyManagedInstance RenewReservedInstances DetachInstanceRamRole AttachInstanceRamRole DeregisterManagedInstance PurchaseReservedInstancesOffering
InitLocalDiskboolean	当本地盘出现故障时，可通过此参数指定启动实例时，是否将实例恢复到最初的健康状态。适用于实例规格族 d1、i1 或者 i2 等包含本地盘的实例。取值范围：展开详情示例值:true
DryRunboolean	是否只预检查此次请求。取值范围：展开详情示例值:true

返回参数

字段名称	字段详情
RequestIdstring	请求 ID。示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

返回示例

错误返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

400	LackResource	There's no enough resource on the specified capacity reservation.	诊断
400	InvalidDedicatedHost.NotEnoughResource	The specified dedicated host has not enough resource due to host affinity.	诊断
400	InvalidInstance.NotFoundSystemDisk	The specified instance does not have system disk.	诊断
400	Invalid.PrivatePoolOptions.NoStock	The PrivatePool has been used up.	诊断
403	InvalidParameter.KMSKeyId.NotFound	The specified KMSKeyId does not exist.	诊断
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.	诊断
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	诊断
403	InsufficientBalance	Your account does not have enough balance.	诊断
403	DiskError	IncorrectDiskStatus.	诊断
403	InstanceExpired	The postPaid instance has been expired.Please ensure your account have enough balance.	诊断
403	InstanceNotReady	The specified instance is not ready for use.	诊断
403	DiskInArrears	The specified operation is denied as your disk has expired.	诊断
403	OperationDenied.NoStock	The requested resource is sold out in the specified zone; try other types of resources or other regions and zones.	诊断
403	OperationDenied.SpotPriceLowerThanPublicPrice	The spot instance price is lower than public price.	诊断
403	InvalidParameter.KMSKeyId.CMKUnauthorized	The CMK needs to be added ECS tag.	诊断
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.	诊断
403	InvalidParameter.KMSKeyId.KMSUnauthorized	ECS service have no right to access your KMS.	诊断
403	QuotaExceed.ElasticQuota	No additional quota is available for the specified ECS instance type.	诊断
403	OperationDenied.HostRepairing	The specified operation is denied as the host of ECS instance is being repaired.	诊断
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	诊断
404	InvalidCapacityReservationId.NotFound	The specified capacity reservation does not exist.	诊断
500	InstanceNotReady	The specified instance is not ready for use.	诊断
500	InternalError	The request processing has failed due to some unknown error.	诊断
503	ServiceUnavailable	The request has failed due to a temporary failure of the server.	诊断

变更历史

	变更时间	变更内容概要	操作
	2023-07-17	删除返回参数
	2021-06-08	变更错误码403

1
2
10 条/页