重置实例密码

接口说明


重置实例密码(支持批量)。支持不同可用区的实例批量改密。

注意事项:

  1. 最多支持10台实例重置密码。

  2. 为保证您重置密码成功,请保证实例内部qemu-guest-agent正常运行。(移动云公共镜像内置qemu-guest-agent保证实例的重置密码,监控等功能正常使用,如为自定义镜像,请您确保qemu-guest-agent已安装并正常启用,安装qemu-guest-agent)。

  3. password参数:采用RSA对明文加密,公钥内容详见接口说明,用户可用该公钥自行加密明文得到密文。明文8-16位字符,同时包括数字、大小写字母和特殊字符,其中不能出现3个及以上连续或重复的数字,如123、111等以及特殊字符最多不能超过3个,且需要在“~ @ # $ % * _ - + = , . ? [ ] { }”范围内。不建议使用包含姓名、电话、出生日期、账号名、系统名以及公司名的密码;不建议使用包含连续的字母、键位或重复的字母、字符的密码,比如abc、asd、@#$、AAA、###等。

  4. 公钥内容:

-----BEGIN PUBLIC KEY----- 	
MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC/VpRysi0bPRLS7sbgQDJHo1MAt9/bK +nwK5Pe3z0/O4cH5I/8kFNYy4yFsLMM+zyFvVw9C4wzjHaRcmEuF3ziJMC9PD5ufUWgfO5nSGgZW1cmgjqnhcWJ3i+Azj72RnhKQRCn9DgJduEC9MiKfbyTICGd6FXf9cxb21nkxI7vtwIDAQAB 
-----END PUBLIC KEY-----

推荐使用API Explorer调试

API Explorer支持接口在线可视化调用,同时自动生成动态代码示例,搭配OpenAPI SDK无需计算签名实现接口快速集成。

URL

POST https://ecloud.10086.cn/api/openapi-instance/v4/batch-update-password

请求参数

Body

参数名称
类型
必填
描述
batchUpdatePasswordReq
BatchUpdatePasswordReq
是

batchUpdatePasswordReq

instanceIds
<string> array
是

实例ID数组,可通过查询实例状态列表接口获取。

customUserName
string
否

指定要修改的用户名。为空时,Linux默认修改root用户密码;Windows默认administrator用户密码。

password
string
是

实例密码(采用RSA对明文加密,公钥内容详见接口说明,用户可用该公钥自行加密明文得到密文。明文8-16位字符,同时包括数字、大小写字母和特殊字符,其中不能出现3个及以上连续或重复的数字,如123、111等,以及特殊字符最多不能超过3个,且需要在“~ @ # $ % * _ - + = , . ? [ ] { }”范围内。(password和keypairName仅能填写一个 )不建议使用包含姓名、电话、出生日期、账号名、系统名以及公司名的密码;不建议使用包含连续的字母、键位或重复的字母、字符的密码,比如abc、asd、@#$、AAA、###等。

请求示例

POST https://ecloud.10086.cn/api/openapi-instance/v4/batch-update-password
{
	"instanceIds":[
		"000037f9-2bda-420f-b0e9-bf5514a5762d",
		"00014ed8-7e91-42c3-8b6d-8878720431a9"
	],
	"password":"srzE9jsTwO044EAhipn2gS1fZ9W/5Boi3fb0JME1j3gdFSKZ9u5pPCifzb/9mXQdpnasy/JKV70h5m7fSnLYtF33CMw0n9kqONNlIELUBurfoI9Wtyf0eKFmnDAxqV8UO4T2/BdO1WeF4Um9d9fyBe1OqFCczl15Jfaj9/GI9c="
}

返回参数

返回码:200
OK
参数名称
类型
描述
body
BatchAction«InstanceActionResult»

请求成功时返回的数据。

instanceBatchResult
<InstanceActionResult> array

实例批量操作结果集。

instanceOrderAndOrderExtInfos
<InstanceOrderAndOrderExtInfo> array

批量操作涉及订单返回信息。

orderExts
<OrderExt> array

订单项ID数组。

orderExtType
string

订单类型。vm(实例),highPerformance(高性能型系统盘),performanceOptimization(性能优化型系统盘)。

subOrderId
string

订单项ID。

orderId
string

订单ID。

instanceId
string

实例ID。

result
boolean

操作是否下发成功。

message
string

操作结果信息,失败时返回错误信息,成功时返回空字符串。

errorCode
string

统一错误码。

errorMessage
string

页面国际化错误提示。

errorParams
<string> array

统一错误码的自定义参数。

requestId
string

每个请求的序列号。

state
enum(OK,ERROR,EXCEPTION,ALARM,FORBIDDEN)

返回状态码。返回正常:OK,返回错误:ERROR,返回异常:EXCEPTION,需要告警实现的:ALARM,禁止访问:FORBIDDEN。

返回示例

返回码:200
OK
{
	"body":{
		"instanceBatchResult":[
			{
				"instanceId":"000037f9-2bda-420f-b0e9-bf5514a5762d",
				"result":true,
				"message":""
			},
			{
				"instanceId":"00014ed8-7e91-42c3-8b6d-8878720431a9",
				"result":true,
				"message":""
			}
		]
	},
	"requestId":"req-Id-bb15dfdf-f7eb-4303-895a-cfffb13269d5",
	"state":"OK"
}
本文档内容整理自移动云官方帮助中心(查看原文),仅供参考。