全部产品
Search

搜索本产品

    云服务器 ECS：DescribeSnapshotsUsage - 查询快照数量和容量

    文档中心

    云服务器 ECS：DescribeSnapshotsUsage - 查询快照数量和容量

    更新时间：Aug 28, 2026

    查询您在一个地域下的快照数量以及快照容量。

    接口说明

    接口说明

    如果您想知道当前地域下每块磁盘的快照使用情况，推荐使用 DescribeSnapshotLinks 查询快照链。

    调试

    您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

    调试

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。

    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

      • 对于必选的资源类型，用前面加 * 表示。

      • 对于不支持资源级授权的操作，用全部资源表示。

    • 条件关键字：是指云产品自身定义的条件关键字。

    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    ecs:DescribeSnapshotsUsage

    get

    *全部资源

    *

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    RegionId

    string

    是

    快照所属的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

    cn-hangzhou

    返回参数

    名称

    类型

    描述

    示例值

    object

    SnapshotSize

    integer

    当前地域下已产生的快照容量，单位 Byte。

    122
    RequestId

    string

    请求 ID。

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
    SnapshotCount

    integer

    当前地域下的快照总数。

    5

    示例

    正常返回示例

    JSON格式

    {
  "SnapshotSize": 122,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "SnapshotCount": 5
}

    异常返回示例

    JSON格式

    {
	"SnapshotCount": "5",
	"SnapshotSize": "122",
	"RequestId": "ACD9BBB0-A9D1-46D7-9630-B7A69889E110"
}

    错误码

    HTTP status code

    错误码

    错误信息

    描述
    403 InvalidParam.RegionId The specified region is not exist. 指定的地域不存在，请检查该参数是否正确。

    访问错误中心查看更多错误码。

    变更历史

    更多信息，参考变更详情。