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

接口说明

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

使用须知

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

流控信息

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

授权信息

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

具体说明如下：展开详情

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

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

请求参数

字段名称	字段详情
DryRunboolean	是否只预检此次请求。取值范围：展开详情示例值:false
RegionIdstring	实例所在的地域。您可以调用 DescribeRegions 查看最新的阿里云地域列表。示例值:cn-hangzhou参考取值来源: DescribeRegions
BatchOptimizationstring	设置批量操作模式。取值范围：展开详情示例值:AllTogether
InstanceIdarray<string>	实例 ID 数组。数组长度：1~100。示例值:i-bp67acfmxazb4p****子级条数 <= 100

返回参数

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

返回示例

错误码

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

全局错误码

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

400	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be added ECS tag	诊断
400	InvalidParameter.KMSKeyId.KMSUnauthorized	ECS service account have no right to access your KMS.	诊断
400	DRYRUN.SUCCESS	This request is a dryrun request with successful result.	诊断
400	Invalid.PrivatePoolOptions.NoStock	The PrivatePool has been used up.	诊断
403	InvalidInstanceId.NotFound	InstanceId should not be null.	诊断
403	InvalidParameter.TooManyInstanceIds	Instance ids cannot be more than 100.	诊断
403	Abs.InvalidInstanceIds.MalFormed	The specified instanceIds is not valid.	诊断
403	InstanceExpired	%s	诊断
403	InstanceLockedForSecurity	%s	诊断
403	InstanceExpiredOrInArrears	%s	诊断
403	IncorrectInstanceStatus	%s	诊断
403	InvalidInstance.NotFoundSystemDisk	%s	诊断
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	InsufficientBalance	Your account does not have enough balance.	诊断
403	InstanceNotReady	The specified instance is not ready for use.	诊断
403	OperationDenied.HostRepairing	%s	诊断
404	InvalidInstanceId.NotFound	%s	诊断
404	InvalidInstanceIds.NotFound	The specified InstanceIds does not exist.	诊断
409	InvalidOperation.Conflict	Request was denied due to conflict with a previous request, please try again later.	诊断
500	InternalError	The request processing has failed due to some unknown error.	诊断

变更历史

	变更时间	变更内容概要	操作
	2021-05-19	变更错误码403