云服务器内容精选

  • URI GET https://{Endpoint}/v3.1/{project_id}/recycle-instances 表1 参数说明 参数 是否必选 参数类型 描述 project_id 是 String 参数解释: 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 只能由英文字母、数字组成,且长度为32个字符。 默认取值: 不涉及。 instance_name 否 String 实例名称。 offset 否 Integer 索引位置,偏移量。从第一条数据偏移offset条数据后开始查询,默认为0(偏移0条数据,表示从第一条数据开始查询),必须为数字,不能为负数。例如:该参数指定为0,limit指定为10,则只展示第1-10条数据。 limit 否 Integer 查询记录数。默认为50,不能为负数,最小值为1,最大值为50。例如该参数设定为10,则查询结果最多只显示10条记录。
  • 响应示例 { "total_count" : 2, "instances" : [ { "id" : "21f20e55999947a9938ad0453b757e72in14", "name" : "gaussdbv5_CCv20_bms_default_1_20220827012852", "ha_mode" : "Ha", "engine_name" : "gaussdbv5", "engine_version" : "V2.0-2.3.0", "pay_model" : 0, "created_at" : "2022-08-09T09:26:44.000+08:00", "deleted_at" : "2022-08-09T09:26:44.000+08:00", "volume_type" : "localssd", "volume_size" : "", "data_vip" : "25.213.0.41 / 25.213.0.188 / 25.213.0.101 / 25.213.0.82", "enterprise_project_id" : 0, "enterprise_project_name" : null, "backup_level" : null, "recycle_backup_id" : "00b755ed678e41d18c74b28e2ad41bdcbr14", "recycle_status" : "Active", "mode" : "enterprise" }, { "id" : "a9df5b52b32e4571b1b6425a78a32956in14", "name" : "ecs-lxy-backup-3", "ha_mode" : "Ha", "engine_name" : "gaussdbv5", "engine_version" : "V2.0-2.3.0", "pay_model" : 0, "created_at" : "2022-08-09T09:26:44.000+08:00", "deleted_at" : "2022-08-09T09:26:44.000+08:00", "volume_type" : "ultrahigh", "volume_size" : "", "data_vip" : "173.202.10.246 / 173.202.10.205 / 173.202.10.175", "enterprise_project_id" : 0, "enterprise_project_name" : null, "backup_level" : null, "recycle_backup_id" : "ef393704ef0045d1b6226b6f2cdc48a7br14", "recycle_status" : "Active", "mode" : "enterprise" } ] }
  • 响应参数 表2 参数说明 参数 参数类型 描述 total_count Integer 总记录数。 instances Array of objects 回收站所有的实例信息,具体参数请参考表3。 表3 instances字段数据结构说明 参数 参数类型 描述 id String 实例ID。 name String 实例名称。 ha_mode String 部署形态。 枚举值: Ha:主备版。 Independent:独立部署。 Combined:混合部署。 engine_name String 引擎名称。 engine_version String 引擎版本号。 pay_model String 计费模式。 0:按需计费。 1:包年包月。 created_at String 创建时间,格式为“yyyy-mm-ddThh:mm:ssZ”。 其中,T指某个时间的开始;Z指时区偏移量,例如北京时间偏移显示为+0800。 deleted_at String 删除时间,格式为“yyyy-mm-ddThh:mm:ssZ”。 其中,T指某个时间的开始;Z指时区偏移量,例如北京时间偏移显示为+0800。 volume_type String 磁盘类型。 枚举值: high:高IO。 ultrahigh:超高IO。 essd:急速型SSD。 volume_size String 磁盘大小。 data_vip String 数据vip。 enterprise_project_id String 企业项目ID,"0"代表默认的企业项目。 enterprise_project_name String 企业项目名称。 backup_level String 备份级别。 recycle_backup_id String 备份ID。(指删除实例时产生备份信息中的备份ID)。 recycle_status String 回收站备份状态。 枚举值: Running:运行中。 Active:有效。 mode String 产品类型。 枚举值: basic:基础版。 standard:标准版。 enterprise:企业版。
  • 请求示例 批量还原回收站 /v5/trashes [ { "id" : "cn-north-7_5a775fdcb14f4431b6c0015618140bc3_go_4", "format" : "go", "uri" : "cn-north-7_5a775fdcb14f4431b6c0015618140bc3_go_4/", "status" : "active" }, { "id" : "cn-north-7_5a775fdcb14f4431b6c0015618140bc3_maven_2_23", "format" : "maven2", "uri" : "cn-north-7_5a775fdcb14f4431b6c0015618140bc3_maven_2_23/", "status" : "active" } ]
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 status String 参数解释: 请求成功、失败状态。 取值范围: success: 请求成功。 error:请求失败。 trace_id String 参数解释: 请求id,当前请求唯一标识。 取值范围: 数字及中划线(-)组成的字符串。 result Object 参数解释: 请求返回结果,接口不同,返回不同。 取值范围: 根据不同接口有不同范围。
  • 请求参数 表1 请求Body参数 参数 是否必选 参数类型 描述 [数组元素] 是 Array of IDETrashArtifactModel objects 参数 表2 IDETrashArtifactModel 参数 是否必选 参数类型 描述 id 否 String 仓库id format 否 String 类型 status 否 String 当前仓库状态 uri 否 String 待还原的文件路径
  • 请求消息 表2 参数说明 名称 是否必选 参数类型 说明 recycle_policy 是 Object 每个元素都是与回收站相关信息。 每个元素结构请参见表3。 表3 recycle_policy元素说明 名称 是否必选 参数类型 说明 retention_period_in_days 否 String 保留时间,设置已删除实例保留天数,支持整数,可设置范围为1~7天。 当“retention_period_in_days”为空,保留时间默认是7天。
  • 使用须知 回收站策略机制默认开启,且不可关闭,默认保留天数为7天,该功能免费。 如果用户同时删除100个实例,且回收站内存放有之前删除的实例,那么这100个实例可以被删除成功,但是只有部分实例能进入回收站。回收站只允许加入100个实例,超过该配额的实例将无法添加至回收站中。 修改回收站保留天数,仅对修改后新进入回收站的实例生效,对于修改前已经存在的实例,仍保持原来的回收策略,请您谨慎操作。 节点脱节状态下无法做回收备份。
  • 约束与限制 对于 IAM 用户,如要使用回收站功能,需要具有如下IAM权限: 查询回收站:ecs:recycleBin:get 更新回收站(开启或关闭操作):ecs:recycleBin:update 更新回收站策略:ecs:recycleBin:updatePolicy 您可以通过IAM用户对应的账号为IAM用户授予上述权限,详细操作,请参见E CS 自定义策略。 在以下场景中,删除或退订的ECS不支持放入回收站。 账号处于欠费、受限或冻结的异常状态。 ECS处于“故障”状态。 ECS距离创建时间的天数小于配置的回收站策略天数。 ECS处于保留期。 ECS保留期到期后被系统释放。 已设置“定时删除时间”的ECS不支持放入回收站。 竞价计费型ECS,释放时不放入回收站。 回收站对ECS的资源配额约束: ECS进入回收站后,会占用ECS的资源配额。 专属主机上的ECS进入回收站后,会占用专属主机上的资源配额。 当ECS配额不足时,请及时对回收站中的ECS进行清理。 当ECS作为高阶服务的计算资源使用时,如果满足回收站条件,ECS会进入回收站。这可能会导致高阶服务清理资源失败,请清理回收站中的ECS后,再进行重试。
  • 绑定资源处理策略 删除或退订ECS时,如果满足回收站策略,ECS会进入回收站,其绑定资源的处理策略如下所示: 绑定的弹性公网IP的处理策略如表2所示。 表2 绑定的弹性公网IP的处理策略 实例计费模式 操作 是否进入回收站 恢复云服务器时处理结果 销毁云服务器时处理结果 按需计费 删除云服务器时,勾选“释放弹性云服务器绑定的弹性公网IP地址”。 否 已删除,不可恢复 已删除 删除云服务器时,不勾选“释放弹性云服务器绑定的弹性公网IP地址”。 否 已解绑,不可恢复 已解绑,不会删除 包年/包月 退订云服务器时,退订弹性公网IP。 否 已删除,不可恢复 已删除 退订云服务器时,不退订弹性公网IP。 否 已解绑,不可恢复 已解绑,不会删除 绑定的云硬盘的处理策略如表3所示。 表3 绑定的云硬盘的处理策略 实例计费模式 绑定资源的类型 操作 是否进入回收站 恢复云服务器时处理结果 销毁云服务器时处理结果 按需计费 系统盘 删除云服务器时,勾选“删除弹性云服务器挂载的数据盘”。 是 同步恢复 同步删除 删除云服务器时,不勾选“删除弹性云服务器挂载的数据盘”。 是 同步恢复 同步删除 数据盘(独享) 删除云服务器时,勾选“删除弹性云服务器挂载的数据盘”。 是 同步恢复 同步删除 删除云服务器时,不勾选“删除弹性云服务器挂载的数据盘”。 否 未手动卸载,则保持与云服务器的挂载关系 已卸载,不会删除 数据盘(共享) 删除云服务器时,勾选“删除弹性云服务器挂载的数据盘”。 否(共享盘挂载多个云服务器) 未手动卸载,则保持与云服务器的挂载关系 已卸载,不会删除 是(共享盘仅挂载一个云服务器) 同步恢复 同步删除 删除云服务器时,不勾选“删除弹性云服务器挂载的数据盘”。 否 未手动卸载,则保持与云服务器的挂载关系 已卸载,不会删除 包年/包月 系统盘 退订云服务器。 是 同步恢复 同步删除 数据盘(独享) 退订云服务器,该云服务器挂载了同一订单的独享数据盘。 是 同步恢复 同步删除 退订云服务器,该云服务器挂载了不同订单的独享数据盘。 否 未手动卸载,则保持与云服务器的挂载关系 已卸载,不会删除 数据盘(共享) 退订云服务器,该云服务器挂载了共享数据盘。 否 未手动卸载,则保持与云服务器的挂载关系 已卸载,不会删除 绑定的弹性网卡的处理策略如表4所示。 表4 绑定的弹性网卡的处理策略 绑定资源的类型 操作 是否进入回收站 恢复云服务器时处理结果 销毁云服务器时处理结果 主网卡 删除或退订云服务器。 否 保持与云服务器的绑定关系 同步删除 扩展网卡 删除或退订云服务器。 否 未手动解绑,则保持与云服务器的绑定关系 若手动解绑,删除云服务器时不会删除 若没有手动解绑,则同步删除
  • 计费说明 按需计费或包年/包月ECS进入回收站后,均转为按需计费。ECS进入回收站后关机,其计费原则如下(详细计费标准,请参见计费模式概述): 普通实例关机后,基础资源(包括vCPU、内存、镜像)不计费。 特殊实例(含本地盘的实例、含FPGA卡的实例或裸金属实例)关机后,基础资源(包括vCPU、内存、镜像)仍然正常计费。 ECS的绑定资源(如云硬盘、弹性公网IP),遵循对应资源的计费原则。 已在回收站中的ECS,当账户欠费时会进入宽限期、保留期,受宽限期和保留期的影响,在未达到自定义保存时长时,ECS也可能会被系统提前删除。了解宽限期保留期的具体时长请参见宽限期保留期。 回收站中的ECS恢复后均遵循按需计费模式。若要使用包年/包月,您可以将ECS按需计费变更为包年/包月,具体方法请参见按需转包年/包月。
  • URI URI格式 GET https://{Endpoint}/v3/{project_id}/recycle-policy URI样例 https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3/0611f1bd8b00d5d32f17c017f15b599f/recycle-policy 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 租户在某一region下的project ID。 获取方法请参见获取项目ID/名称。
  • URI URI格式 PUT https://{Endpoint}/v3/{project_id}/recycle-policy URI样例 https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3/0611f1bd8b00d5d32f17c017f15b599f/recycle-policy 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 租户在某一region下的project ID。 获取方法请参见获取项目ID。