补充参数

docs/image/images.yaml

@@ -3,6 +3,7 @@ get:
   parameters:
     - $ref: '/parameters/common.yaml#offset'
     - $ref: '/parameters/common.yaml#limit'
+    - $ref: '/parameters/common.yaml#pending_delete'
     - $ref: '/parameters/image.yaml#is_public'
     - $ref: '/parameters/image.yaml#owner'
     - $ref: '/parameters/image.yaml#name'

docs/instance/instance.yaml

@@ -2,6 +2,7 @@ get:
   summary: 获取指定实例详情信息
   parameters: 
     - $ref: '/parameters/instance.yaml#instanceId'
+    - $ref: '/parameters/common.yaml#pending_delete'
   responses:
     200:
       description: 实例信息
@@ -29,9 +30,10 @@ delete:
   summary: 删除指定实例
   parameters: 
     - $ref: '/parameters/instance.yaml#instanceId'
+    - $ref: '/parameters/common.yaml#override_pending_delete'
   responses:
     200:
-      description: 被删除实例的信息
+      description: 被删除实例的信息,删除前确保已解除删除保护,第一次删除时会先进入回收站(可恢复),第二次删除会真正释放资源
       schema:
         $ref: '/schemas/instance.yaml#InstanceResponse'
   tags:

docs/instance/instances.yaml

@@ -12,6 +12,7 @@ get:
     - $ref: '/parameters/common.yaml#network'
     - $ref: '/parameters/common.yaml#vpc'
     - $ref: '/parameters/common.yaml#region'
+    - $ref: '/parameters/common.yaml#pending_delete'
 
     - $ref: '/parameters/instance.yaml#host'
     - $ref: '/parameters/instance.yaml#with_eip'

docs/parameters/common.yaml

@@ -66,3 +66,15 @@ cloudregion:
   in: query
   type: string
   description: 根据区域过滤列表
+pending_delete:
+  name: pending_delete
+  in: query
+  type: string
+  default: true
+  enum: [true,false,all]
+  description: 默认不显示回收站资源，true则只显示回收站资源，all则显示所有资源，含不再回收站和在回收站的资源支持实例,磁盘,镜像过滤
+override_pending_delete:
+  name: override_pending_delete
+  in: query
+  type: boolean
+  description: 从回收站删除资源时需要指定此参数为true, 回收站资源到期会自动释放。到期清理时间由服务参数PendingDeleteExpireSeconds确定。默认是259200秒（3天）