更新时间：2026-04-03 GMT+08:00
查询回收站配置 - ShowRecycleBin
功能介绍
查询回收站配置。
接口约束
该功能当前仅上线如下区域：华北-北京四、华北-乌兰察布一、华东-上海一、华南-广州、华南-广州-友好用户环境、西南-贵阳一、亚太-新加坡。
调试
您可以在API Explorer中调试该接口。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
| 授权项 | 访问级别 | 资源类型（*为必须） | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
| ecs:recycleBin:get | read | - | - | - | - |
请求消息
无
响应消息
响应参数如表2所示。
| 参数 | 参数类型 | 描述 |
|---|---|---|
| project_id | String | 参数解释： 项目ID。 取值范围： 不涉及 |
| switch | String | 参数解释： 回收站配置开关。 取值范围： 不涉及 |
| policy | Object | 参数解释： 回收站策略，详情请参见表3 policy参数信息。 取值范围： 不涉及 |
请求示例
查询回收站配置。
GET https://{endpoint}/v1/{project_id}/recycle-bin 响应示例
{
"project_id": "74d4d6ac2da84aa5bdc6fed4efc20413",
"switch": "off",
"policy": {
"recycle_threshold_day": 8,
"retention_hour": 8
}
} 返回值
请参考通用请求返回值。
错误码
请参考错误码。
父主题： 回收站管理
