开发者社区 问答 正文

StartInstance



描述


启动一个指定的实例。

  • 接口调用成功后实例进入 Starting 状态。
  • 实例状态必须为 Stopped,才可以调用该接口。
  • 被安全控制在实例的 OperationLocks 中标记了 "LockReason" : "security" 的锁定状态时,不能启动实例。


请求参数


名称类型是否必须描述
ActionString系统规定参数,取值:StartInstance
InstanceIdString指定启动的实例 ID
InitLocalDiskBoolean适用于 D1/I1/I2 等包含本地盘的实例规格。当本地磁盘出现故障时,可通过此参数指定启动实例时,是否将实例恢复到最初的健康状态。取值范围:
  • true:将实例恢复到最初的健康状态。实例原有本地磁盘中的数据将会丢失。
  • false:不做任何处理,维持现状。


返回参数


全是公共返回参数,详见 公共返回参数

错误码


错误代码描述Http状态码语义
InvalidInstanceId.NotFoundThe specified InstanceId does not exist.404指定的 InstanceId 不存在
IncorrectInstanceStatusThe current status of the resource does not support this operation.403该资源目前的状态不支持此操作
InstanceLockedForSecurityThe specified operation is denied as your instance is locked for security reasons.403该资源目前被安全锁定被拒绝操作
InsufficientBalanceYour account does not have enough balance.403实例欠费,拒绝启动
InternalErrorThe request processing has failed due to some unknown error.500内部错误
InstanceNotReadyThe specified instance is not ready for use500指定的 Instance 还没有创建完
DiskErrorIncorrectDiskStatus.403不正常的磁盘状态
InstanceExpiredPrePaid instances has been expired.403实例到期或者欠费(是指该实例是包年包月或者按量欠费的情况)


示例



请求示例


https://ecs.aliyuncs.com/?Action=StartInstance
&InstanceId=i-instance1
&<公共请求参数>
返回示例

XML格式
<StartInstanceResponse>
    <RequestId>C0003E8B-B930-4F59-ADC0-0E209A9012A8</RequestId>
</StartInstanceResponse>
JSON格式
{
    "RequestId": "C0003E8B-B930-4F59-ADC0-0E209A9012A8"
}


展开
收起
boxti 2017-10-19 13:59:38 1884 分享
分享
版权
举报
阿里云 AI 助理回答

您描述的是阿里云ECS(Elastic Compute Service,弹性计算服务)中启动一个指定实例的API操作。这个操作是通过调用阿里云开放API来实现的,具体接口为StartInstance。下面是对该操作更详细的说明:

请求目的

此API请求主要用于将一个已停止(Stopped)状态的ECS实例启动起来,使其进入运行状态(Starting)。这对于需要动态管理资源或进行故障恢复的场景非常有用。

请求参数

  • Action: 必须参数,固定值StartInstance,表示要执行的操作类型。
  • InstanceId: 必须参数,类型为String,表示要启动的ECS实例的唯一标识ID。
  • InitLocalDisk(可选): 类型为Boolean,仅适用于包含本地盘(如D1/I1/I2等实例规格)的ECS实例。当实例的本地磁盘出现故障时,此参数用于指示在启动实例时是否恢复到初始健康状态。选择true会丢失原有数据;选择false则保留现状不做处理。

返回参数

返回参数均为公共返回参数,包括但不限于RequestId(请求ID)、Success(操作是否成功)等,具体细节可以通过查阅阿里云API文档中的“公共返回参数”部分获得。

错误码

列举了一些可能遇到的错误代码及其含义,例如: - InvalidInstanceId.NotFound: 指定的InstanceId不存在。 - IncorrectInstanceStatus: 实例当前状态不支持启动操作。 - InstanceLockedForSecurity: 实例因安全原因被锁定,无法操作。 - InsufficientBalance: 账户余额不足,无法启动实例。 - 其他错误码还包括内部错误、实例未准备好、磁盘状态错误、预付费实例已过期等情况。

示例请求

提供了一个调用示例,展示了如何构造URL来发起StartInstance请求:

https://ecs.aliyuncs.com/?Action=StartInstance

实际使用时,除了Action外,还需要添加InstanceId以及其他可能的参数,并且推荐使用POST方法提交请求体,以确保安全性与参数传递的完整性。

请注意,调用阿里云API通常需要进行身份验证,包括设置AccessKeyId、Signature等头部信息,这些内容在正式调用时必须根据阿里云API调用规范准备齐全。更多关于API调用的详情和示例,可以参考阿里云ECS API文档。您也可以通过ECS一键诊断全面排查并修复ECS问题。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答
AI助理

你好,我是AI助理

可以解答问题、推荐解决方案等