查看实例操作限制列表

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

1. 接口描述

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

本接口 (DescribeInstancesDeniedActions) 用于查询一个或多个实例的操作限制列表信息。

  • 可以根据实例ID来查询实例的详细信息。

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

接口更新时间：2025-08-20 00:38:45。

接口只验签名不鉴权。

2. 输入参数

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

参数名称 必选 允许NULL 类型 描述
Action 是 否 String 公共参数，本接口取值：DescribeInstancesDeniedActions
Version 是 否 String 公共参数，本接口取值：2017-03-12
Region 是 否 String 公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
InstanceIds 是 否 Array of String 按照一个或者多个实例ID查询。实例ID形如：ins-61dyt49hxxxx。（此参数的具体格式可参考API简介的id.N一节）。每次请求的实例的上限为100。参数不支持同时指定InstanceIds和Filters。
示例值： ["ins-61dyt49h"]

3. 输出参数

参数名称 类型 描述
InstanceDeniedActionSet Array of InstanceDeniedActions 实例操作限制列表
示例值：查看
RequestId String 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

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

错误码 描述
InvalidInstance.NotSupported 不被支持的实例。
InvalidInstanceId.Malformed 无效实例ID。指定的实例ID格式错误。例如实例ID长度错误ins-1122。
InvalidInstanceId.NotFound 没有找到相应实例。

5. 示例

示例1 查看实例操作限制列表

输入示例

https://cvm.cloudapi.com/?Action=DescribeInstancesDeniedActions
&InstanceIds.0=ins-a89sehbc
&InstanceIds.1=ins-dtqlp23o
&<公共请求参数>

输出示例

{
    "Response": {
        "InstanceDeniedActionSet": [
            {
                "InstanceId": "ins-a89sehbc",
                "DeniedActions": [
                    {
                        "Action": "StartInstances",
                        "Code": "InvalidInstanceState.Running",
                        "Message": "The request does not support the instance `ins-a89sehbc` which is in the state of `RUNNING`."
                    },
                    {
                        "Action": "CopyInstanceDisk",
                        "Code": "InvalidInstanceState.Running",
                        "Message": "The request does not support the instance `ins-a89sehbc` which is in the state of `RUNNING`."
                    },
                    {
                        "Action": "ModifyInstancesRenewFlag",
                        "Code": "InvalidInstanceChargeType.PostpaidByHour",
                        "Message": "The request does not support the instance `ins-a89sehbc` whoes charge type is `POSTPAID_BY_HOUR`."
                    },
                    {
                        "Action": "RenewInstances",
                        "Code": "InvalidInstanceChargeType.PostpaidByHour",
                        "Message": "The request does not support the instance `ins-a89sehbc` whoes charge type is `POSTPAID_BY_HOUR`."
                    },
                    {
                        "Action": "ModifyInstanceInternetChargeType",
                        "Code": "InvalidInstanceChargeType.PostpaidByHour",
                        "Message": "The request does not support the instance `ins-a89sehbc` whoes charge type is `POSTPAID_BY_HOUR`."
                    },
                    {
                        "Action": "ResizeInstanceDisks",
                        "Code": "InvalidDataDiskType.CloudBasic",
                        "Message": "The request does not support the instance `ins-a89sehbc` whoes data disk type is `CLOUD_BASIC`."
                    }
                ]
            },
            {
                "InstanceId": "ins-dtqlp23o",
                "DeniedActions": [
                    {
                        "Action": "StartInstances",
                        "Code": "InvalidInstanceState.Running",
                        "Message": "The request does not support the instance `ins-dtqlp23o` which is in the state of `RUNNING`."
                    },
                    {
                        "Action": "CopyInstanceDisk",
                        "Code": "InvalidInstanceState.Running",
                        "Message": "The request does not support the instance `ins-dtqlp23o` which is in the state of `RUNNING`."
                    },
                    {
                        "Action": "ModifyInstancesRenewFlag",
                        "Code": "InvalidInstanceChargeType.PostpaidByHour",
                        "Message": "The request does not support the instance `ins-dtqlp23o` whoes charge type is `POSTPAID_BY_HOUR`."
                    },
                    {
                        "Action": "RenewInstances",
                        "Code": "InvalidInstanceChargeType.PostpaidByHour",
                        "Message": "The request does not support the instance `ins-dtqlp23o` whoes charge type is `POSTPAID_BY_HOUR`."
                    },
                    {
                        "Action": "ModifyInstanceInternetChargeType",
                        "Code": "InvalidInstanceChargeType.PostpaidByHour",
                        "Message": "The request does not support the instance `ins-dtqlp23o` whoes charge type is `POSTPAID_BY_HOUR`."
                    },
                    {
                        "Action": "ResizeInstanceDisks",
                        "Code": "InvalidDataDiskType.CloudBasic",
                        "Message": "The request does not support the instance `ins-dtqlp23o` whoes data disk type is `CLOUD_BASIC`."
                    },
                    {
                        "Action": "CreateImage",
                        "Code": "InvalidInstanceHypervisor.Xen",
                        "Message": "The request does not support the instance `ins-dtqlp23o` whoes hypervisor type is `xen`."
                    }
                ]
            }
        ],
        "RequestId": "390ebf79-71f1-4955-b305-3b7f7a9292e1"
    }
}