updateInstanceTemplate

描述

修改实例模板属性。

详细操作说明请参考帮助文档：修改实例模板

接口说明

• 名称、描述、实例模板配置信息至少要传一项。

• 若实例模板已绑定高可用组，则不支持更改VPC。

请求方式

PATCH

请求地址

https://vm.jdcloud-api.com/v1/regions/{regionId}/instanceTemplates/{instanceTemplateId}

名称	类型	是否必需	默认值	描述
regionId	String	True		地域ID。
instanceTemplateId	String	True		实例模板ID。

请求参数

名称	类型	是否必需	默认值	描述
name	String	False		实例模板的名称，参考 公共参数规范。
description	String	False		实例模板的描述，参考 公共参数规范。
instanceTemplateData	UpdateInstanceTemplateSpec	False		实例模板配置信息。

UpdateInstanceTemplateSpec

名称	类型	是否必需	默认值	描述
instanceType	String	False		实例规格，可查询 DescribeInstanceTypes 接口获得指定地域或可用区的规格信息。
imageId	String	False		镜像ID，可查询 DescribeImages 接口获得指定地域的镜像信息。
password	String	False		实例密码。可用于SSH登录和VNC登录。长度为8~30个字符，必须同时包含大、小写英文字母、数字和特殊符号中的三类字符。特殊符号包括：()`~!@#$%^&*_-+=|{}[ ]:";'<>,.?/，更多密码输入要求请参见 公共参数规范。 如指定密钥且 passwordAuth 设置为 true，则密码不会生成注入，否则即使不指定密码系统也将默认自动生成随机密码，并以短信和邮件通知。
keyNames	String[ ]	False		密钥对名称。仅Linux系统下该参数生效，当前仅支持输入单个密钥。如指定了该参数则覆盖原有参数。
metadata	Metadata[ ]	False		用户自定义元数据。以key-value键值对形式指定，可在实例系统内通过元数据服务查询获取。最多支持20对键值对，且key不超过256字符，value不超过16KB，不区分大小写。 注意：key以连字符(-)结尾，表示要删除该key。
userdata	Userdata[ ]	False		自定义脚本。目前仅支持启动脚本，即 launch-script，须 base64 编码且编码前数据长度不能超过16KB。 linux系统 ：支持 bash 和 python，编码前须分别以 #!/bin/bash 和 #!/usr/bin/env python 作为内容首行。 Windows系统 ：支持 bat 和 powershell，编码前须分别以 <cmd></cmd>和<powershell></powershell> 作为内容首、尾行。
elasticIp	InstanceTemplateElasticIpSpec	False		主网卡主IP关联的弹性公网IP配置。如指定了该参数则覆盖原有参数。
primaryNetworkInterface	InstanceTemplateNetworkInterfaceAttachmentSpec	False		主网卡配置。如指定了该参数则覆盖原有参数。
systemDisk	InstanceTemplateDiskAttachmentSpec	False		系统盘配置。如指定了该参数则覆盖原有参数。
dataDisks	InstanceTemplateDiskAttachmentSpec[ ]	False		数据盘配置。单实例最多可挂载云硬盘（系统盘+数据盘）的数量受实例规格的限制。如指定了该参数则覆盖原有参数。
chargeOnStopped	String	False		停机不计费模式。该参数仅对按配置计费且系统盘为云硬盘的实例生效，并且不是专有宿主机中的实例。配置停机不计费且停机后，实例部分将停止计费，且释放实例自身包含的资源（CPU/内存/GPU/本地数据盘）。 可选值： keepCharging（默认值）：停机后保持计费，不释放资源。 stopCharging：停机后停止计费，释放实例资源。
autoImagePolicyId	String	False		自动任务策略ID，传"NoPolicy"则会清空实例模板配置的自动任务策略。
passWordAuth	String	False		是否允许SSH密码登录。 yes：允许SSH密码登录。 no：禁止SSH密码登录。 仅在指定密钥时此参数有效，指定此参数后密码即使输入也将被忽略，同时会在系统内禁用SSH密码登录。
imageInherit	String	False		是否使用镜像中的登录凭证，不再指定密码或密钥。 yes：使用镜像登录凭证。 no（默认值）：不使用镜像登录凭证。 仅使用私有或共享镜像时此参数有效。若指定imageInherit=yes则指定的密码或密钥将无效。
noPassword	Boolean	False		传 true 则会清空实例模板配置的密码。
noElasticIp	Boolean	False		传 true 则会清空实例模板配置的公网IP。

InstanceTemplateDiskAttachmentSpec

名称	类型	是否必需	默认值	描述
diskCategory	String	False		磁盘类型。 系统盘 ：此参数无须指定，其类型取决于镜像类型。 数据盘 ：数据盘仅支持云硬盘cloud。
autoDelete	Boolean	False		是否随实例一起删除，即删除实例时是否自动删除此磁盘。此参数仅对按配置计费的非多点挂载云硬盘生效。 true：随实例删除。 false（默认值）：不随实例删除。
cloudDiskSpec	InstanceTemplateDiskSpec	False		磁盘详细配置。此参数仅针对云硬盘，本地系统盘无须指定且指定无效。
deviceName	String	False		磁盘逻辑挂载点。 系统盘 ：此参数无须指定且指定无效，默认为vda。 数据盘 ：取值范围：[vdb~vdbm]。
noDevice	Boolean	False		排除设备，使用此参数 noDevice 配合 deviceName 一起使用。 创建实例模板的场景下：使用此参数可以排除镜像中的数据盘。 示例：如果镜像中除系统盘还包含一块或多块数据盘，期望仅使用镜像中的部分磁盘，配置deviceName=vdb、noDevice=true，则表示在使用实例模板创建实例时，忽略镜像中数据盘vdb配置，不创建磁盘。

InstanceTemplateDiskSpec

名称	类型	是否必需	默认值	描述
diskType	String	False		云硬盘类型。各类型介绍请参见云硬盘类型。 可选值： ssd.gp1：通用型SSD ssd.io1：性能型SSD hdd.std1：容量型HDD
diskSizeGB	Integer	False		云硬盘容量，单位为 GiB，步长10GiB。 取值范围： 系统盘：[40,500]GiB，且不能小于镜像系统盘容量 数据盘：[20,16000]GiB，如指定snapshotId创建云硬盘则不能小于快照容量。
snapshotId	String	False		创建云硬盘的快照ID。
policyId	String	False		云硬盘自动快照策略ID。
encrypt	Boolean	False		云硬盘是否加密。 可选值： true：加密 false（默认值）：不加密
iops	Integer	False		云硬盘的最大iops。

InstanceTemplateNetworkInterfaceAttachmentSpec

名称	类型	是否必需	默认值	描述
deviceIndex	Integer	False		网卡设备Index。创建实例时此参数无须指定且指定无效。 对于主网卡默认Index为1。
autoDelete	Boolean	False		是否随实例一起删除。 true：随实例删除。 false：不随实例删除。 主网卡此属性默认为true
networkInterface	InstanceTemplateNetworkInterfaceSpec	True		网卡设备详细配置。

InstanceTemplateNetworkInterfaceSpec

名称	类型	是否必需	默认值	描述
subnetId	String	True		子网ID。
securityGroups	String[ ]	False		安全组ID列表。
sanityCheck	Integer	False		参数已弃用，指定无效。
ipv6AddressCount	Integer	False		自动分配的ipv6地址数量，取值范围[0,1]，默认为0。

InstanceTemplateElasticIpSpec

名称	类型	是否必需	默认值	描述
bandwidthMbps	Integer	True		弹性公网IP的带宽上限，单位：Mbps。 取值范围为：[1-200]。
provider	String	False		弹性公网IP线路。中心可用区目前仅提供BGP类型IP。
chargeMode	String	True		弹性公网IP计费模式。可选值： bandwith：按带宽计费。 flow：按流量计费。 若指定chargeSpec=bandwith则弹性公网IP计费类型同实例（包年包月或按配置）。边缘可用区目前仅支持flow计费模式。

Userdata

名称	类型	是否必需	默认值	描述
key	String	False		脚本类型，当前仅支持输入 launch-script，即启动脚本。
value	String	False		脚本内容，须 Base64 编码，且编码前长度不能超过16KB。

Metadata

名称	类型	是否必需	默认值	描述
key	String	False		key，字符长度不超过256，支持全字符。不能以连字符(-)结尾，否则此key不生效。
value	String	False		value，字符长度不超过16KB，支持全字符。

返回参数

名称	类型	描述

返回码

HTTP状态码	错误码	描述	错误解析
400	INVALID_ARGUMENT	Parameter name and description missing	未指定任何可修改的属性。
404	NOT_FOUND	Instance Template 'xx' not found	实例模板不存在。
500	INTERNAL	Internal server error	系统内部错误，请稍后重试。如果多次尝试失败，请提交工单。
500	UNKNOWN	Unknown server error	服务暂时不可用，请稍后重试。如果多次尝试失败，请提交工单。

请求示例

PATCH

/v1/regions/cn-north-1/instanceTemplates/it-u3o8\*\*\*\*yy
{
"name" : "test2",
"description" : "test"
}  

返回示例

{
    "requestId": "a0633f72670e59f8c6db36b1ee257011"
}