查询快照操作掩码

最近更新时间: 2026-09-17 00:00:49

1. 接口描述

接口请求域名： cbs.api3.fincloud.tencent.cn。

本接口（DescribeSnapshotsDeniedActions）用于查询快照的操作掩码。

根据入参SnapshotIds提供的快照ID，返回对应快照的操作掩码。

默认接口请求频率限制：20次/秒。

接口更新时间：2022-01-07 11:49:00。

接口只验签名不鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：DescribeSnapshotsDeniedActions
Version	是	否	String	公共参数，本接口取值：2017-03-12
Region	是	否	String	公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
SnapshotIds	是	否	Array of String	快照ID列表示例值： snap-j1ytqcd7

3. 输出参数

参数名称	类型	描述
SnapshotDeniedActionSet	Array of SnapshotDeniedAction	查询快照的操作掩码集合示例值：查看
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码	描述
MissingParameter	参数缺失。请求没有带必选参数。
InvalidParameter	参数错误

5. 示例

示例1 查询指定快照的操作掩码

输入示例

https://cbs.api3.fincloud.tencent.cn/?Action=DescribeSnapshotsDeniedActions
&SnapshotIds.0=snap-cgrmci8t
&SnapshotIds.1=snap-124p95lf
&<公共请求参数>

输出示例

{
    "Response": {
        "RequestId": "e2260c53-a7ef-4be0-9da5-775700039d1f",
        "SnapshotDeniedActionSet": [
            {
                "SnapshotId": "snap-124p95lf",
                "DeniedActions": [
                    {
                        "Action": "CreateDisks",
                        "Message": "非待回收的数据盘快照才能直接创建云盘",
                        "Code": "InvalidSnapshot.NotSupported"
                    },
                    {
                        "Action": "ModifyShareSnapPermission.SHARE",
                        "Message": "加密快照和镜像快照不能共享",
                        "Code": "InvalidSnapshot.NotSupported"
                    },
                    {
                        "Action": "BindImageSnap",
                        "Message": "系统盘的快照才能创建自定义镜像",
                        "Code": "InvalidSnapshot.NotSupported"
                    },
                    {
                        "Action": "CopySnapshotCrossRegions",
                        "Message": "非待回收的apollo架构的快照才能跨地域复制",
                        "Code": "InvalidSnapshot.NotSupported"
                    },
                    {
                        "Action": "ApplySnapshot",
                        "Message": "共享快照或者快照对应的盘的子机正在运行，不支持回滚",
                        "Code": "InvalidSnapshot.NotSupported"
                    },
                    {
                        "Action": "ModifySnapshotAttribute",
                        "Message": "非待回收的快照才能改名",
                        "Code": "InvalidSnapshot.NotSupported"
                    }
                ]
            },
            {
                "SnapshotId": "snap-cgrmci8t",
                "DeniedActions": [
                    {
                        "Action": "ModifyShareSnapPermission.SHARE",
                        "Message": "加密快照和镜像快照不能共享",
                        "Code": "UnsupportedOperation.SnapshotHasBindedImage"
                    },
                    {
                        "Action": "DeleteSnapshots",
                        "Message": "共享快照，镜像快照不支持直接删除",
                        "Code": "UnsupportedOperation.SnapshotHasBindedImage"
                    },
                    {
                        "Action": "ApplySnapshot",
                        "Message": "共享快照或者快照对应的盘的子机正在运行，不支持回滚",
                        "Code": "InvalidDisk.NotSupported"
                    }
                ]
            }
        ]
    }
}