文档中心

NAT网关

IP限速

DescribeNatIpLimitRules - 查询带宽限速规则

调用DescribeNatIpLimitRules接口，查询NAT网关的带宽限速规则。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：DescribeNatIpLimitRules

要执行的操作，取值：DescribeNatIpLimitRules。

Version string 必选示例值：2020-04-01

API的版本，取值：2020-04-01。

LimitRuleIds.N string[] 可选示例值：iplimit-93**

限速规则ID。

NatGatewayId string 必选示例值：ngw-2feq5xhimd88w59gp686****

NAT网关的ID。

您可以调用 DescribeNatGateways 接口，查询NAT网关的ID。

PageNumber integer 可选示例值：1

列表的页码，默认值为1。

PageSize integer 可选示例值：20

分页查询时每页的行数，取值：1 ~ 100，默认值为20。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

NatIpLimitRules object[] 示例值：-

限速规则的详细信息。

LimitRuleId string 示例值：iplimit-****

限速规则的ID。

NatGatewayId string 示例值：ngw-2feq5xhimd88w59gp686****

NAT网关的ID。

InternalIp string 示例值：192.XX.XX.1

限速IP地址。

OutboundMbpsLimit string 示例值：10

出方向带宽限速值，单位：Mbps。返回“0”表示不限速。

InboundMbpsLimit string 示例值：10

入方向带宽限速值，单位：Mbps。返回“0”表示不限速。

PageNumber integer 示例值：1

当前分页的页码。

RequestId string 示例值：2021062415303301022514515207C4****

请求ID。

PageSize integer 示例值：20

当前分页的行数。

TotalCount integer 示例值：33

符合条件的限速规则总数。

请求示例

GET /?Action=DescribeNatIpLimitRules&Version=2020-04-01&NatGatewayId=ngw-2feq5xhimd88w59gp686****  HTTP/1.1​
Host: natgateway.cn-beijing.volcengineapi.com​
ServiceName: natgateway​
Region: cn-beijing​
​
​

返回示例

{​
    "ResponseMetadata": {​
        "RequestId": "2021062415303301022514515207C4****",​
        "Action": "DescribeNatIpLimitRules",​
        "Version": "2020-04-01",​
        "Service": "natgateway",​
        "Region": "cn-beijing"​
    },​
    "Result":{​
        "RequestId": "2021062415303301022514515207C4****",​
        "TotalCount": 1,​
        "PageNumber": 1,​
        "PageSize": 20,​
        "NatBandwidthLimitRule": [​
            {​
                "NatGatewayId": "ngw-2feq5xhimd88w59gp686****",​
                "LimitRuleId": "iplimit-****",​
                "InternalIp": "192.XX.XX.1",​
                "OutboundMbpsLimit": 10,​
                "InboundMbpsLimit": 10,​
                "CreateTime": "2021-03-30T19:59:27+08:00",​
                "UpdateTime": "2025-03-30T16:59:27+08:00"​
            }​
        ]   ​
    }​
}​

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	MissingParameter	The request is missing a required parameter.	该请求缺少必要参数。
400	LimitExceeded.LimitRuleId	You've reached the limit on the number of LimitRule IDs that you can describe.	已达到可查询的限速规则ID数量上限。
500	InternalError	An internal error has occurred.	发生内部错误。

最近更新时间：2026.03.27 17:44:42

这个页面对您有帮助吗？

有用

无用