You need to enable JavaScript to run this app.
导航

DescribeDnatEntries

最近更新时间2024.01.11 10:24:32

首次发布时间2022.11.03 08:29:57

调用 DescribeDnatEntries 接口,查询满足指定条件的DNAT规则。

调用说明

  • 传入多个请求参数,按照传入的参数进行查询,返回符合所有条件的DNAT规则,若没有符合条件的DNAT规则,则返回空值。
  • 若请求参数非必选参数均未传入,则按照当前登录账号查询,返回当前账号下的所有DNAT规则。

请求参数

参数名称
类型
是否必选
示例值
描述
ActionStringDescribeDnatEntries要执行的操作,取值:DescribeDnatEntries。
VersionString2020-04-01API的版本信息,当前版本为:2020-04-01。

NatGatewayId

String

ngw-2feq5xhimd88w59gp686****

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

DnatEntryIds.N

String

DnatEntryIds.1=dnat-342abc3bc3****&DnatEntryIds.2=dnat-342abc3bc4****

DNAT规则的ID。

  • 参数 - N:表示SNAT规则ID的序号,单次调用数量上限20个ID。
  • 多个ID之间请使用&分隔。
DnatEntryNameStringdnat-01DNAT规则的名称。

Protocol

String

tcp

协议类型。

  • tcp:转发TCP协议的报文。
  • udp:转发UDP协议的报文。
InternalIpString192.XX.XX.88向公网提供服务的云服务器实例的私网IP。
InternalPortString12云服务器实例向公网提供服务的端口或端口段。

ExternalIp

String

12.XX.XX.34

NAT网关已绑定的公网IP。
您可以调用 DescribeEipAddresses 接口,查询公网IP的地址。

ExternalPortString34接收来自公网的请求的端口或端口段。
PageNumberInteger1列表的页码,默认值为1。
PageSizeInteger20每页的行数,最大值为100,默认值为20。

返回数据

参数名称
类型
示例值
描述
RequestIdString2021062415303301022514515207C4****请求ID。
TotalCountInteger33符合条件的DNAT规则总数。
PageNumberInteger1当前分页的页码。
PageSizeInteger20当前分页的行数。
DnatEntriesArray of struct-DNAT的详细信息。具体请参见下表“DnatEntries结构”。

DnatEntries结构

参数名称
类型
示例值
描述
NatGatewayIdStringngw-2feq5xhimd88w59gp686****DNAT规则所属NAT网关的ID。
DnatEntryIdStringdnat-342abc3bc3****DNAT规则的ID。
DnatEntryNameStringdnat-01DNAT规则的名称。
ProtocolStringtcp协议类型。
InternalIpString192.XX.XX.88向公网提供服务的云服务器实例的私网IP。
InternalPortString12云服务器实例向公网提供服务的端口或端口段。
ExternalIpString12.XX.XX.34NAT网关已绑定的公网IP。
ExternalPortString34接收来自公网的请求的端口或端口段。

Status

String

Available

DNAT规则的状态。

  • Creating:创建中。
  • Deleting:删除中。
  • Available:可用。

请求示例

GET /?Action=DescribeDnatEntries&Version=2020-04-01&NatGatewayId=ngw-2feq5xhimd88w59gp686****&ExternalIp=12.XX.XX.34  HTTP/1.1
Host: open.volcengineapi.com
ServiceName: natgateway
Region: cn-beijing

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2021062415303301022514515207C4****",
        "Action": "DescribeDnatEntries",
        "Version": "2020-04-01",
        "Service": "natgateway",
        "Region": "cn-beijing"
    },
    "Result":{
        "RequestId": "2021062415303301022514515207C4****",
        "TotalCount": 1,
        "PageNumber": 1,
        "PageSize": 20,
        "DnatEntries": [
            {
                "NatGatewayId": "ngw-2feq5xhimd88w59gp686****",
                "DnatEntryId": "dnat-342abc3bc3****",
                "DnatEntryName": "dnat-01",
                "Protocol": "tcp",
                "InternalIp": "192.XX.XX.88",
                "InternalPort": "12",
                "ExternalIp": "12.XX.XX.34",
                "ExternalPort": "34",
                "Status": "Available"
            }
        ]   
    }
}

错误码

公共错误码,请参见 公共错误码 。

HttpCode
错误码
错误信息
描述
400InvalidPage.MalformedThe specified page is malformed.指定的分页参数不合法。
400LimitExceeded.DnatEntryIdYou've reached the limit on the number of DNAT entry IDs that you can describe.已达到可查询的DNAT规则ID数量上限。