GetNetworkInterface-阿里云帮助中心

Queries information about an LNI.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

eflo:GetNetworkInterface

get

*NetworkInterface

acs:eflo:{#regionId}:{#accountId}:NetworkInterface/{#NetworkInterfaceId}

None

Request parameters

Parameter	Type	Required	Description	Example
RegionId	string	Yes	The region ID.	cn-wulanchabu
SubnetId	string	No	Subnet of Lingjun	subnet-f3zfzmnc
NetworkInterfaceId	string	Yes	Lingjun network interface controller ID	lni-bp18exxqa2rvfn45e5pz

Response elements

Element	Type	Description	Example
	object	AjaxResult
Code	integer	The response status code.	0
Message	string	The error message. (If the instance is in the Exception state, the exception cause is prompted.)	success
RequestId	string	Request ID of the current request	A88DFED5-24B7-5A3E-87DE-380BF06F3C90
Content	object	The response data. (If a resource has dependent resources, the existing dependent resources are returned.)
TenantId	string	The ID of the tenant.	1655449505171
RegionId	string	The region ID.	cn-wulanchabu
NetworkInterfaceId	string	Lingjun network interface controller ID	lni-f8z4scmfh0u4ewv6vdd8
NodeId	string	The ID of the host.	masterintranett2fdth5fkoocg
VpdBaseInfo	object	Basic information of Lingjun network segment (VPD)
VpdId	string	The ID of the VPD instance.	vpd-ppdunxzc
VpdName	string	The name of the VPD instance.	vpd-1
Cidr	string	The network segment of the Lingjun subnet. The network segment of the subnet must be a proper subset of the network segment of Lingjun to which it belongs, and the mask must be between 16 bits and 29 bits, which can provide 8 to 65536 addresses. For example, the CIDR block of the Lingjun CIDR block is 192.168.0.0/16, and the CIDR blocks of the subnets under the Lingjun CIDR block are 192.168.0.0/17 to 192.168.0.0/29. The first and last three IP addresses of each subnet segment are reserved by the system. For example, the CIDR blocks of the subnet are 192.168.1.0/24,192.168.1.0, 192.168.1.253, 192.168.1.254, and 192.168.1.255. For more information about CIDR blocks, see the What is CIDR? section in the "Network FAQ" topic. This parameter is left empty by default.	172.18.0.0/24
CreateTime	string	The time when the data address was created.	1678273219000
ZoneId	string	The zone ID.	cn-wulanchabu-b
SubnetBaseInfo	object	Lingjun subnet (Subnet) basic information
SubnetId	string	The ID of the Subnet instance.	subnet-urb01blo
SubnetName	string	The name of the Subnet instance.	subnet-1
Cidr	string	Network address segment	116.233.21.57/32
CreateTime	string	The time when the data address was created.	1678273219000
Ip	string	The IP address of the BE cluster.	203.107.****
ServiceMac	string	Service network interface controller address	01-00-5e-00-00-16
PrivateIpAddressMacGroup	array<object>	Secondary Private IP&MAC Address Collection
	object	Secondary Private IP&MAC Address
IpName	string	IP unique identifier	sip-1asjd3xg
PrivateIpAddress	string	Secondary private IP address	172.23.161.57
IpAddressMac	string	Secondary private MAC address	01-00-5e-00-00-16
Status	string	The state of the rule.	Available
Description	string	The instance description.	test测试
Message	string	The error message. (If the instance is in the Exception state, the exception cause is prompted.)	success
Ethernet	array	Port
	string	Connection information	eth0 eth1
Status	string	The status of the intervention entry. Valid value:	Available
Gateway	string	Gateway	172.24.20.254
CreateTime	string	The time when the data address was created.	1678273219000
Quota	integer	network interface controller private secondary IP limit	0
NcType	string	NC Type Valid value: CUSTOM_LNI_INTEGRATION: two-network one-in-one architecture Lingjun hosting network interface controller. CPU: CPU machine. ELASTIC_6.2: Machine GPU: GPU machine. DEFAULT: the old CPU machine. CUSTOM_LNI: two network separation architecture Lingjun hosting network interface controller. Valid values: CUSTOM_LNI_INTEGRATION : CPU : ELASTIC_6.2 : GPU : DEFAULT : CUSTOM_LNI :	DEFAULT
NetworkInterfaceName	string	ENI Name	bond0
ResourceGroupId	string	Resource group instance ID	rg-acfmv2m2w43japa
Tags	array<object>	The details of the resource tags.
	object	The information about the tag.
TagKey	string	The tag key.	key-test
TagValue	string	The tag value.	value-test
AccessDeniedDetail	string	The details about the access denial.	None

Examples

Success response

JSON format

{
  "Code": 0,
  "Message": "success",
  "RequestId": "A88DFED5-24B7-5A3E-87DE-380BF06F3C90",
  "Content": {
    "TenantId": "1655449505171",
    "RegionId": "cn-wulanchabu",
    "NetworkInterfaceId": "lni-f8z4scmfh0u4ewv6vdd8",
    "NodeId": "masterintranett2fdth5fkoocg",
    "VpdBaseInfo": {
      "VpdId": "vpd-ppdunxzc",
      "VpdName": "vpd-1",
      "Cidr": "172.18.0.0/24",
      "CreateTime": "1678273219000"
    },
    "ZoneId": "cn-wulanchabu-b",
    "SubnetBaseInfo": {
      "SubnetId": "subnet-urb01blo",
      "SubnetName": "subnet-1",
      "Cidr": "116.233.21.57/32",
      "CreateTime": "1678273219000"
    },
    "Ip": "203.107.****",
    "ServiceMac": "01-00-5e-00-00-16",
    "PrivateIpAddressMacGroup": [
      {
        "IpName": "sip-1asjd3xg",
        "PrivateIpAddress": "172.23.161.57",
        "IpAddressMac": "01-00-5e-00-00-16",
        "Status": "Available",
        "Description": "test测试",
        "Message": "success"
      }
    ],
    "Ethernet": [
      "eth0 eth1"
    ],
    "Status": "Available",
    "Gateway": "172.24.20.254",
    "CreateTime": "1678273219000",
    "Quota": 0,
    "NcType": "DEFAULT",
    "NetworkInterfaceName": "bond0",
    "ResourceGroupId": "rg-acfmv2m2w43japa",
    "Tags": [
      {
        "TagKey": "key-test",
        "TagValue": "value-test"
      }
    ]
  },
  "AccessDeniedDetail": "None"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.