更新时间：2026-08-17 GMT+08:00

修改实例规格信息 - ResizeInstance

功能介绍

修改设备接入实例的规格。

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。

如果使用身份策略授权，需具备如下身份策略权限。

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
iotda:instance:update	Write	instance *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	-	-
iotda:instance:update	Write	-	iotda:AllowPublicAccess iotda:AllowPublicForwarding iotda:DomainConfiguration	-	-

URI

POST /v5/iot/{project_id}/iotda-instances/{instance_id}/resize

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数说明：项目ID。获取方法请参见获取项目ID。
instance_id	是	String	参数说明：实例ID。取值范围：长度不超过36，由小写字母[a-f]、数字、连接符（-）的组成。

请求参数

表2 请求Body参数
参数	是否必选	参数类型	描述
flavor	是	Flavor object	参数说明：设备接入实例的规格参数。
is_auto_pay	否	Boolean	参数说明：修改包年/包月实例的规格时可指定，表示是否自动从客户的账户中支付，此字段不影响自动续订的支付方式。取值范围：true - 自动支付，从账户余额自动扣费; false - 默认值，只提交订单不支付。支付参考支付包年/包月产品订单
delay	否	Boolean	参数说明：是否延时变更设备实例的计费信息。约束：如需延时变更，需要先设置实例的变更时间窗。取值范围： true：延迟变更，规格变更任务将在指定的变更时间窗内执行。 false：立即变更，规格变更任务将立即执行。

表3 Flavor
参数	是否必选	参数类型	描述
type	是	String	参数说明：待创建设备接入实例的规格名称。详情请参见产品规格说明中的规格编码。
size	否	Integer	参数说明：待创建设备接入标准版实例的单元数量，企业版不支持该参数。详情请参见产品规格说明。当instance_type是standard时，该参数必填。

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
order_id	String	参数说明：订单号。修改包年包月实例时返回该参数，修改按需实例时返回为空。查看订单详情请参考查询订单详情

请求示例

修改标准版实例规格，修改后的规格为标准版中频单元，单元个数为2。

POST https://{endpoint}/v5/iot/{project_id}/iotda-instances/{instance_id}/resize

{
  "flavor" : {
    "type" : "iotda.standard.s2",
    "size" : 2
  }
}

修改企业版实例规格，修改后的规格为企业版2000tps, 10万设备。

POST https://{endpoint}/v5/iot/{project_id}/iotda-instances/{instance_id}/resize

{
  "flavor" : {
    "type" : "iotda.enterprise.2000tps.10wonlinedevice"
  }
}

响应示例

状态码：200

{
  "order_id" : "CS22121614500ABCD"
}

状态码

状态码	描述
200	OK
400	Bad Request
401	Unauthorized
403	Forbidden

错误码

请参见错误码。

父主题：实例管理