调用 DescribeLockedSnapshots 查询快照锁定信息 - 云服务器 ECS -Alibaba Cloud - 云服务器 ECS

查询快照的锁定信息。例如快照锁定状态、锁定配置等。

调试

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

调试

授权信息

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

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ecs:DescribeLockedSnapshots

list

Snapshot

acs:ecs:{#regionId}:{#accountId}:snapshot/*

Snapshot

acs:ecs:{#regionId}:{#accountId}:snapshot/{#SnapshotId}

无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。	cn-hangzhou
SnapshotIds	array	否	快照 ID 数组。数组长度：1~100。
	string	否	快照 ID。	s-bp67acfmxazb4p****
LockStatus	string	否	锁定状态。取值范围： compliance-cooloff：快照以合规模式锁定，但仍处于冷静期内。快照无法被删除，但具备相应 RAM 权限的用户可以解锁快照、延长或缩短冷静期、延长或缩短锁定时长。 compliance：快照以合规模式锁定，且冷静期已结束。快照无法被解锁或删除，但具备相应 RAM 权限的用户可以延长锁定时长。 expired：快照曾被锁定，但锁定时长已结束，锁定已过期。快照当前未锁定，可以被删除。	compliance-cooloff
NextToken	string	否	查询凭证（Token），取值为上一次 API 调用返回的`NextToken`参数值。	caeba0bbb2be03f84eb48b699f0a****
MaxResults	integer	否	分页查询时每页行数。最大值为 100。默认值：当不设置值或设置的值小于 10 时，默认值为 10。当设置的值大于 100 时，默认值为 100。	10
DryRun	boolean	否	是否只预检此次请求。取值范围： true：发送检查请求，不会实际执行。检查项包括是否填写了必需参数、请求格式、业务限制等。如果检查不通过，则返回对应错误。如果检查通过，则返回错误码 DryRunOperation。 false（默认）：发送正常请求，通过检查后直接执行请求。	false

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
NextToken	string	本次调用返回的查询凭证值。	caeba0bbb2be03f84eb48b699f0a****
LockedSnapshotsInfo	array<object>	锁定快照信息集合。
	object	锁定快照信息。
SnapshotId	string	快照 ID。	s-bp67acfmxazb4p****
LockMode	string	锁定模式。可能值： compliance：以合规模式锁定快照。以合规模式锁定的快照无法被任何用户解锁，只有在锁定时长到期后才能被删除。用户不能缩短锁定时长，但具备相应 RAM 权限的用户可以随时延长锁定时长。以合规模式锁定快照时，可以选择性地指定冷静期。	compliance
LockStatus	string	锁定状态。可能值： compliance-cooloff：快照以合规模式锁定，但仍处于冷静期内。快照无法被删除，但具备相应 RAM 权限的用户可以解锁快照、延长或缩短冷静期、延长或缩短锁定时长。 compliance：快照以合规模式锁定，且冷静期已结束。快照无法被解锁或删除，但具备相应 RAM 权限的用户可以延长锁定时长。 expired：快照曾被锁定，但锁定时长已结束，锁定已过期。快照当前未锁定，可以被删除。	compliance-cooloff
LockCreationTime	string	锁定时间。按照 ISO 8601 标准表示，并使用 UTC + 0 时间，格式为 yyyy-MM-ddTHH:mm:ssZ。	2025-10-15T10:00:00Z
CoolOffPeriod	integer	合规模式冷静期。单位：小时。	3
CoolOffPeriodExpiredTime	string	合规模式冷静期结束时间。按照 ISO 8601 标准表示，并使用 UTC + 0 时间，格式为 yyyy-MM-ddTHH:mm:ssZ。	2025-10-15T13:00:00Z
LockDuration	integer	锁定时长。锁定时长结束后快照锁定会自动过期。单位：天。	1
LockDurationStartTime	string	锁定时长开始时间。按照 ISO 8601 标准表示，并使用 UTC + 0 时间，格式为 yyyy-MM-ddTHH:mm:ssZ。如果锁定处于 progressing 状态的快照，锁定时长将在快照进入 accomplished 状态后才开始计算。	2025-10-15T10:00:00Z
LockExpiredTime	string	锁定过期时间。按照 ISO 8601 标准表示，并使用 UTC + 0 时间，格式为 yyyy-MM-ddTHH:mm:ssZ。	2025-10-16T10:00:00Z

示例

正常返回示例

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "NextToken": "caeba0bbb2be03f84eb48b699f0a****",
  "LockedSnapshotsInfo": [
    {
      "SnapshotId": "s-bp67acfmxazb4p****",
      "LockMode": "compliance",
      "LockStatus": "compliance-cooloff",
      "LockCreationTime": "2025-10-15T10:00:00Z",
      "CoolOffPeriod": 3,
      "CoolOffPeriodExpiredTime": "2025-10-15T13:00:00Z",
      "LockDuration": 1,
      "LockDurationStartTime": "2025-10-15T10:00:00Z",
      "LockExpiredTime": "2025-10-16T10:00:00Z"
    }
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidLockStatus.Malformed	The specified parameter LockStatus is invalid. Please check the valid range for this parameter.	指定的参数 LockStatus 无效，请检查该参数的取值范围。
404	InvalidSnapshotLock.NotFound	The specified snapshot(s) %s is(are) not locked.	指定的快照未被锁定。

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

变更历史

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