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

DescribeNetworkInterfaceAttributes

最近更新时间2024.01.10 10:41:29

首次发布时间2021.07.29 14:11:54

调用 DescribeNetworkInterfaceAttributes 接口,查看指定网卡的详情。

调试

请求参数

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

NetworkInterfaceId

String

eni-bp1fgnh68xyz9****

网卡的ID。
您可以调用 DescribeNetworkInterfaces 接口,查询网卡的ID。

返回数据

参数名称
类型
示例值
描述
RequestIdString2021062415303301022514515207C4****请求ID。
CreatedAtString2021-04-09T08:36:47+08:00创建网卡的时间。
UpdatedAtString2021-04-09T10:20:41+08:00更新网卡的时间。
AccountIdString2010****网卡所属账户的ID。
ProjectNameStringdefault网卡所属项目的名称。
DescriptionStringTestDescription网卡描述信息。
NetworkInterfaceIdStringeni-bpacfmxazb4p****网卡的ID。
NetworkInterfaceNameStringeniTestName网卡名称。
VpcIdStringvpc-bpacfmxazb4p****网卡所属的VPC的ID。
VpcNameStringvpc-name网卡所属VPC的名称。
ZoneIdStringcn-****网卡所属可用区的ID。
SubnetIdStringsubnet-128fhnvjjgg****网卡所属的子网。
MacAddressStringXX.XX.XX.XX.XX.XX网卡的Mac地址。
DeviceIdStringi-hjkib****9网卡挂载的实例的ID。如果网卡未挂载或参数ServiceManaged的值为true,则DeviceId返回值均为空。
TypeStringsecondary网卡的类型。
  • primary:主网卡
  • secondary:辅助网卡
  • PrimaryIpAddressString192.XX.XX.10网卡的主私网IPv4地址。
    StatusStringInUse网卡的绑定状态。
  • Creating:创建中
  • Available:未挂载
  • Attaching:挂载中
  • InUse:已挂载
  • Detaching:卸载中
  • Deleting:删除中
  • SecurityGroupIdsArray["sg-3ztdcid****90cjtjb","sg-3tc0zdiz****qctbdej"]网卡关联的安全组ID。

    PortSecurityEnabled

    Boolean

    true

    是否为网卡开启源/目的地址检查。开启后,系统会自动阻止源地址或目的地址不是当前网卡的流量。

    • true:是。
    • false:否。
    AssociatedElasticIpStruct-网卡主私网IPv4关联的公网IP的信息,具体请见下表“ AssociatedElasticIp结构 ”。
    AttachmentStruct-是否随云服务器实例删除。具体请见下表“Attachment结构”。

    ServiceManaged

    Boolean

    false

    是否为火山引擎官方服务网卡。即创建中转路由器、私网连接、NAT网关、VPN连接、负载均衡等服务时,系统自动创建的一张网卡,为相应的后台服务提供私有网络。

    • true:是。
    • false:否。
    PrivateIpSetsArray of Struct-网卡的辅助私网IPv4地址列表。具体请参见下表“PrivateIpSet结构”。
    IPv6SetsArray["2408::153:3921:XX:XX:7b12:1c5f", "2408:4008:2cf:XX:XX:dd1e:2a22:5ddf"]网卡的私网IPv6地址。
    TagsArray of Struct-网卡的标签信息。具体请参见下表“Tag结构”。

    PrivateIpSet结构

    参数名称
    类型
    示例值
    描述
    PrivateIpAddressString192.XX.XX.10网卡的私网IP地址。
    AssociatedElasticIpStruct-网卡辅助私网IPv4地址关联的公网IP。具体请见下表“AssociatedElasticIp结构”。

    Primary

    Boolean

    true

    是否为主私网IPv4地址。

    • true:主私网IPv4地址
    • false:辅助私网IPv4地址

    AssociatedElasticIp结构

    参数名称
    类型
    示例值
    描述
    AllocationIdStringeip-3tc6w4446mctiq****公网IP的ID。
    EipAddressString101.XX.XX.199公网IP的IP地址。

    Attachment结构

    参数名称
    类型
    示例值
    描述

    DeleteOnTermination

    Boolean

    false

    是否开启随云服务器实例删除。

    • true:开启。
    • false:关闭。
    InstanceIdStringi-wijfn35c****云服务器实例的ID。

    Tag结构

    参数名称
    类型
    示例值
    描述
    KeyStringk1标签的标签键。
    ValueStringv1标签的标签值。

    请求示例

    GET /?Action=DescribeNetworkInterfaceAttributes&Version=2020-04-01&NetworkInterfaceId=eni-bp1fgnh68xyz9**** HTTP/1.1
    Host: open.volcengineapi.com
    Service: vpc
    Region: cn-beijing
    

    返回示例

    {
        "ResponseMetadata": {
            "RequestId": "2021062415303301022514515207C4****",
            "Action": "DescribeNetworkInterfaceAttributes",
            "Version": "2020-04-01",
            "Service": "vpc",
            "Region": "cn-beijing"
        },
        "Result": {
            "RequestId": "2021062415303301022514515207C4****",
            "CreatedAt": "2021-07-23T17:49:21+08:00",
            "UpdatedAt": "2021-07-23T17:49:24+08:00",
            "AccountId": "210000****",
            "ProjectName": "default",
            "Status": "InUse",
            "Description": "",
            "NetworkInterfaceId": "eni-2ff3dn0hbrfuo5oxruuqp****",
            "NetworkInterfaceName": "wsh-test-eni-1",
            "VpcId": "vpc-3tj9fo0uqy3vj0x2****",
            "VpcName": "test",
            "ZoneId": "cn-****",
            "SubnetId": "subnet-3tj9fva4dm3vj0x2****",
            "MacAddress": "00:16:3e:XX:XX:61",
            "DeviceId": "i-3tkkmwa1t63vj0x0****",
            "Type": "primary",
            "PrimaryIpAddress": "172.XX.XX.183",
            "AssociatedElasticIp": {
                "AllocationId": "eip-3tczde6w4449q06m****",
                "EipAddress": "101.XX.XX.199"
            },
            "Attachment": {
                "DeleteOnTermination": false,
                "InstanceId": "i-wijfn35c****"
            },
            "PortSecurityEnabled": false,
            "ServiceManaged": false,
            "SecurityGroupIds": [
                "sg-3tj9fo0uqy3vj0x2****"
            ],
            "PrivateIpSets": [
                {
                    "PrivateIpAddress": "10.XX.XX.245",
                    "AssociatedElasticIp": {
                             "EipAddress": "101.XX.XX.199",
                             "AllocationId": "eip-3tczde6w4449q06m****"
                         },
                     "Primary": true
                 }
            ],
            "IPv6Sets": [
                "2408::153:3921:XX:XX:7b12:1c5f",
                "2408:4008:2cf:XX:XX:dd1e:2a22:5ddf"
            ],
            "Tags": [ 
                { 
                    "Key":"k1", 
                    "Value":"v1" 
                }, 
                { 
                    "Key":"k2", 
                    "Value":"" 
                } 
            ]
        }
    }
    

    错误码

    当前API无错误码,更多错误码请参见公共错误码