修改实例规格信息 - ResizeInstance
功能介绍
修改设备接入实例的规格。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,需具备如下身份策略权限。
授权项
访问级别
资源类型(*为必须)
条件键
别名
依赖的授权项
iotda:instance:update
Write
instance *
-
g:EnterpriseProjectId
-
g:ResourceTag/<tag-key>
-
-
-
-
iotda:AllowPublicAccess
-
iotda:AllowPublicForwarding
-
iotda:DomainConfiguration
-
URI
POST /v5/iot/{project_id}/iotda-instances/{instance_id}/resize
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数说明:项目ID。获取方法请参见 获取项目ID。 |
|
instance_id |
是 |
String |
参数说明:实例ID。 取值范围:长度不超过36,由小写字母[a-f]、数字、连接符(-)的组成。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
flavor |
是 |
Flavor object |
参数说明:设备接入实例的规格参数。 |
|
is_auto_pay |
否 |
Boolean |
参数说明:修改包年/包月实例的规格时可指定,表示是否自动从客户的账户中支付,此字段不影响自动续订的支付方式。 取值范围:true - 自动支付,从账户余额自动扣费; false - 默认值,只提交订单不支付。 |
|
delay |
否 |
Boolean |
参数说明:是否延时变更设备实例的计费信息。约束:如需延时变更,需要先设置实例的变更时间窗。 取值范围:
|
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
order_id |
String |
参数说明:订单号,修改包年包月实例时返回该参数,修改按需实例时返回为空。 |
请求示例
修改标准版实例规格,修改后的规格为标准版中频单元,单元个数为2。
POST https://{endpoint}/v5/iot/{project_id}/iotda-instances/{instance_id}/resize
{
"flavor" : {
"type" : "iotda.standard.s2",
"size" : 2
}
}
响应示例
状态码:200
OK
{
"order_id" : "CS22121614500ABCD"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
错误码
请参见错误码。