全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

修改实例属性信息

请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见公共请求参数
参数名称
类型
必填
描述
Action String
公共参数,本接口取值:ModifyInstanceAttribute。
Version String
公共参数,本接口取值:2016-03-04。
InstanceId String

待修改属性的实例ID 标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

示例值:98284100-f6d1-4bbf-886a-1b0765024738
InstanceName String

实例名称,修改实例名称不需要关闭实例。 最短2字符,最长64字符,支持中英文

示例值:abc
InstancePassword String

实例开机密码
最短8字符,最长32字符,必须包含大小写英文字符和数字,支持其他可见字符

示例值:1qaQ!abc
HostName String

操作系统内部的计算机名 字符长度为[2, 64],不支持点号(.),每段允许字母(不限制大小写)、数字和短横线(-)组成

示例值:jinshanyun
RestartMode String

重启模式描述,注:若已选择请求参数InstancePassword,则RestartMode不可缺省

示例值:Restart/ForceRestart

返回参数

参数名称
类型
描述
RequestId String

请求ID

示例值:-
Return Boolean

修改实例属性信息成功与否

示例值:true(成功)/false(失败)

请求示例

curl -X GET|POST
'http://kec.api.ksyun.com/?Action=ModifyInstanceAttribute&Version=2016-03-04'
-H 'authorization: xxx, SignedHeaders=content-type;host;x-amz-date, Signature=xxx'
-H 'cache-control: no-cache'
-H 'content-type: application/x-www-form-urlencoded'
-H 'host: kec.api.ksyun.com'
-H 'x-amz-date: 20170720T022802Z'
-d 'InstanceId=xxx&InstanceName=xxx&InstancePassword=xxx&HostName=xxx&RestartMode=xxx'

返回示例

JSON格式

{
"RequestId":"7a6fa859-85e6-40ba-95d2-69deb5e43b6a",
"Return":true
}

错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见公共错误码

错误码
错误信息
Http状态码
描述
InstancePassWordOrHostNameSettingNotSupportThe instance do not support modifying the hostName and passWord.400当前实例不支持修改主机名称和密码。
MissingParameterOne of InstancePassword or InstanceName parameters must be supplied.400“实例名称”或者“实例密码”参数两者必须输入一个
InstancePasswordInvalidParameterValueAn invalid or out-of-range value was supplied for the "InstancePassword" parameter.400“实例密码”参数的取值无效或者超出有效范围
InstanceIdInvalidInstance Resource id is invalid400实例资源ID无效
UserDataInvalidParameterValueAn invalid or out-of-range value was supplied for the "UserData" parameter.400“用户自定义数据”参数的取值无效或者超出有效范围
ConflictingParameterOnly One of InstancePassword or InstanceName parameters should be supplied.400“实例名称”或者“实例密码”参数两者只能输入一个
InvalidStatus.InstanceStatusThe specified instance status is not support this operation ,expect status is running or shutted.400指定的实例状态不支持此操作,期望的操作状态是Running或者Stopped。
InstanceIdRequiredInstanceId is required400InstanceId必传
ImageTypeNotSupportedModifyPassWordThe ImageType for this instance not supported400该镜像类型暂不支持修改密码操作
RestartModeInvalidThe specified restartmode is invalid.400指定的重启模式无效。
InstanceNameInvalidParameterValueAn invalid or out-of-range value was supplied for the "InstanceName" parameter.400“实例名称”参数的取值无效或者超出有效范围
OperationNotAllowedForOtherLineThe operation is not allowed for otherLine.400非主机业务线实例,不允许在主机控制台做此操作
InternalError400 BAD_REQUEST : : {"code":400,"message":"get yaml from etcd error:[key-value not in etcd]","data":null}400
纯净模式常规模式

纯净模式

点击可全屏预览文档内容