DescribeNetworkInterfaceAttribute - Elastic Compute Service - Centre de documentation Alibaba Cloud

Consulte les détails d'une interface réseau élastique (ENI) en spécifiant l'identifiant de l'ENI.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

ecs:DescribeNetworkInterfaceAttribute

get

*NetworkInterface

acs:ecs:{#regionId}:{#accountId}:eni/{#eniId}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région du contrôleur d'interface réseau (NIC). Vous pouvez appeler DescribeRegions pour obtenir la liste des régions la plus récente.	cn-hangzhou
Tag	array<object>	Non	Remarque Ce paramètre n'est pas encore disponible.
	object	Non	Remarque Ce paramètre n'est pas encore disponible.
Key	string	Non	Remarque Ce paramètre n'est pas encore disponible.	CléTest
Value	string	Non	Remarque Ce paramètre n'est pas encore disponible.	ValeurTest
NetworkInterfaceId	string	Oui	L'identifiant du contrôleur d'interface réseau (NIC).	eni-bp67acfmxazb4p****
Attribute	string	Non	L'attribut du contrôleur d'interface réseau (NIC). Valeurs valides :	attachment

Éléments de réponse

Élément	Type	Description	Exemple
	object	La collection d'informations sur l'ENI.
CreationTime	string	L'heure à laquelle l'interface réseau a été créée.	2019-12-25T12:31:31Z
VpcId	string	L'identifiant du VPC auquel l'interface réseau appartient.	vpc-bp67acfmxazb4p****
Type	string	Le type de l'interface réseau. Valeurs valides :	Secondary
Status	string	L'état de l'interface réseau. Valeurs valides :	Available
NetworkInterfaceTrafficMode	string	Le mode de communication de l'interface réseau. Valeurs valides :	Standard
NetworkInterfaceName	string	Le nom de l'interface réseau.	my-eni-name
MacAddress	string	L'adresse MAC de l'interface réseau.	00:16:3e:12::
QueuePairNumber	integer	Remarque Ce paramètre est en avant-première sur invitation et n'est pas disponible publiquement.	22
NetworkInterfaceId	string	L'identifiant du contrôleur d'interface réseau (NIC).	eni-bp125p95hhdhn3ot****
ServiceID	integer	L'identifiant de l'opérateur de réseau virtuel (VNO) auquel l'interface réseau appartient.	12345678910
InstanceId	string	L'identifiant de l'instance à laquelle l'interface réseau est attachée.	i-bp1e2l6djkndyuli****
OwnerId	string	L'identifiant du compte propriétaire de l'interface réseau.	123456****
ServiceManaged	boolean	Indique si l'utilisateur de l'interface réseau est un service Alibaba Cloud ou un VNO.	true
VSwitchId	string	L'identifiant du vSwitch auquel l'interface réseau appartient.	vsw-bp1s5fnvk4gn2tws0****
RequestId	string	L'identifiant de la requête.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
Description	string	La description de l'interface réseau.	testDescription
ResourceGroupId	string	L'identifiant du groupe de ressources auquel l'instance appartient. Lorsque vous utilisez ce paramètre pour filtrer les ressources, le nombre de ressources ne peut pas dépasser 1 000.	rg-bp67acfmxazb4p****
ZoneId	string	L'identifiant de la zone.	cn-hangzhou-g
PrivateIpAddress	string	L'adresse IP privée de l'interface réseau.	10.1..
QueueNumber	integer	Le nombre de files d'attente prises en charge par l'interface réseau.	8
SecurityGroupIds	object
SecurityGroupId	array	La collection des groupes de sécurité auxquels l'interface réseau appartient.
	string	Le groupe de sécurité auquel l'interface réseau appartient.	sg-bp18kz60mefsicfg****
AssociatedPublicIp	object	L'adresse IP élastique (EIP) associée à l'adresse IP privée secondaire de l'interface réseau.
PublicIpAddress	string	L'adresse EIP.	116.62..
AllocationId	string	L'identifiant de l'EIP.	null
Attachment	object	Remarque Ce paramètre est en avant-première sur invitation et n'est pas disponible publiquement.
DeviceIndex	integer	Remarque Ce paramètre est en avant-première sur invitation et n'est pas disponible publiquement.	hide
InstanceId	string	Remarque Ce paramètre est en avant-première sur invitation et n'est pas disponible publiquement.	hide
TrunkNetworkInterfaceId	string	Remarque Ce paramètre est en avant-première sur invitation et n'est pas disponible publiquement.	hide
MemberNetworkInterfaceIds	object
MemberNetworkInterfaceId	array	Remarque This parameter is in invitational preview and is not publicly available.
	string	Remarque This parameter is in invitational preview and is not publicly available.	hide
NetworkCardIndex	integer	L'index de la carte réseau à laquelle l'ENI est attachée.	0
PrivateIpSets	object
PrivateIpSet	array<object>	La collection d'informations sur les adresses IP privées de l'interface réseau.
	array<object>	Les informations sur l'adresse IP privée de l'interface réseau.
PrivateIpAddress	string	The private network IP address of the network interface controller (NIC).	172.17..
Primary	boolean	Indicates whether the IP address is the primary private IP address. Valid values:	true
AssociatedPublicIp	object	The Elastic IP Address (EIP) associated with the secondary private IP address of the network interface controller (NIC).
PublicIpAddress	string	The EIP address.	116.62..
AllocationId	string	Remarque This parameter is in invitational preview and is not publicly available.	null
Ipv6Sets	object
Ipv6Set	array<object>	La liste des adresses IPv6 allouées à l'interface réseau.
	object	L'adresse IPv6 allouée à l'interface réseau.
Ipv6Address	string	The IPv6 address assigned to the network interface controller (NIC).	2001:db8:1234:1a00::****
Primary	boolean
Ipv4PrefixSets	object
Ipv4PrefixSet	array<object>	La collection des préfixes IPv4 alloués à l'interface réseau.
	object	Le préfixe IPv4 attribué à l'ENI.
Ipv4Prefix	string	The IPv4 prefix allocated to the network interface controller (NIC).	192.168.**.0/28
Ipv6PrefixSets	object
Ipv6PrefixSet	array<object>	La collection des préfixes IPv6 alloués à l'interface réseau.
	object
Ipv6Prefix	string	The IPv6 prefix allocated to the network interface controller (NIC).	2001:db8:1234:1a00:****::/80
Tags	object
Tag	array<object>	La collection des balises de l'interface réseau.
	object	Les informations de balise de l'interface réseau.
TagValue	string	The tag value.	TestValue
TagKey	string	The tag key.	TestKey
BondInterfaceSpecification	object	Remarque Ce paramètre est en avant-première sur invitation et n'est pas disponible publiquement.
BondMode	string	Remarque Ce paramètre est en avant-première sur invitation et n'est pas disponible publiquement.	null
SlaveInterfaceSpecification	object
SlaveInterfaceSpecificationSet	array<object>	Remarque This parameter is in invitational preview and is not publicly available.
	object	Remarque This parameter is in invitational preview and is not publicly available.
SlaveNetworkInterfaceId	string	Remarque This parameter is in invitational preview and is not publicly available.	null
WorkState	string	Remarque This parameter is in invitational preview and is not publicly available.	null
BondNetworkInterfaceId	string	Remarque This parameter is in invitational preview and is not publicly available.	null
SlaveInterfaceSpecification	object	Remarque Ce paramètre est en avant-première sur invitation et n'est pas disponible publiquement.
SlaveNetworkInterfaceId	string	Remarque Ce paramètre est en avant-première sur invitation et n'est pas disponible publiquement.	null
WorkState	string	Remarque Ce paramètre est en avant-première sur invitation et n'est pas disponible publiquement.	null
BondNetworkInterfaceId	string	Remarque Ce paramètre est en avant-première sur invitation et n'est pas disponible publiquement.	null
DeleteOnRelease	boolean	Indique si l'ENI est conservée lorsque l'instance associée est libérée. Valeurs valides :	true
TcpOptionAddressEnabled	string	Remarque Ce paramètre est en avant-première sur invitation et n'est pas disponible publiquement.	null
NetworkInterfaceTrafficConfig	object	Les paramètres de trafic du contrôleur d'interface réseau (NIC).
NetworkInterfaceTrafficMode	string	Le mode de communication du contrôleur d'interface réseau (NIC).	HighPerformance
QueueNumber	integer	Le nombre de files d'attente prises en charge par l'interface réseau.	8
QueuePairNumber	integer	Le nombre de files d'attente prises en charge par l'interface réseau RDMA.	8
ConnectionTrackingConfiguration	object	La collection d'informations de configuration du suivi de connectivité réseau.
TcpEstablishedTimeout	integer	Le délai d'expiration pour les connexions TCP établies. Unité : secondes. Valeurs valides : [30, 60, 80, 100, 200, 300, 500, 700, 910].	910
TcpClosedAndTimeWaitTimeout	integer	Le délai d'expiration pour les connexions TCP à l'état TIME_WAIT ou CLOSED. Unité : secondes. Valeurs valides : un entier de 3 à 15.	3
UdpTimeout	integer	Le délai d'expiration pour les flux UDP. Unité : secondes. Valeurs valides : [10, 20, 30, 60, 80, 100].	30
SourceDestCheck	boolean	Ce paramètre n'est pas disponible publiquement.	false
EnhancedNetwork	object	Ce paramètre n'est pas disponible publiquement.
EnableSriov	boolean	Ce paramètre n'est pas disponible publiquement.	false
EnableRss	boolean	Remarque Ce paramètre n'est pas encore disponible.	true
VirtualFunctionTotalQueueNumber	integer
VirtualFunctionQuantity	integer
EnableExpress	boolean
QoSConfig	object	Les paramètres de limitation de débit QoS.
EnableQoS	boolean	Indique si la limitation de débit QoS est activée.
QoS	object	Les paramètres de limitation de débit QoS.
BandwidthTx	integer	The maximum outbound internal bandwidth limit.	50000
BandwidthRx	integer	The maximum inbound internal bandwidth limit.	50000
PpsTx	integer	The outbound internal network packet forwarding rate.	50000
PpsRx	integer	The inbound internal network packet forwarding rate.	50000
ConcurrentConnections	integer	The maximum number of sessions.	50000

Exemples

JSON format

{
  "CreationTime": "2019-12-25T12:31:31Z",
  "VpcId": "vpc-bp67acfmxazb4p****",
  "Type": "Secondary",
  "Status": "Available",
  "NetworkInterfaceTrafficMode": "Standard",
  "NetworkInterfaceName": "my-eni-name",
  "MacAddress": "00:16:3e:12:**:**",
  "QueuePairNumber": 22,
  "NetworkInterfaceId": "eni-bp125p95hhdhn3ot****",
  "ServiceID": 12345678910,
  "InstanceId": "i-bp1e2l6djkndyuli****",
  "OwnerId": "123456****",
  "ServiceManaged": true,
  "VSwitchId": "vsw-bp1s5fnvk4gn2tws0****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "Description": "testDescription",
  "ResourceGroupId": "rg-bp67acfmxazb4p****",
  "ZoneId": "cn-hangzhou-g",
  "PrivateIpAddress": "10.1.**.**",
  "QueueNumber": 8,
  "SecurityGroupIds": {
    "SecurityGroupId": [
      "sg-bp18kz60mefsicfg****"
    ]
  },
  "AssociatedPublicIp": {
    "PublicIpAddress": "116.62.**.**",
    "AllocationId": "null"
  },
  "Attachment": {
    "DeviceIndex": 0,
    "InstanceId": "hide",
    "TrunkNetworkInterfaceId": "hide",
    "MemberNetworkInterfaceIds": {
      "MemberNetworkInterfaceId": [
        "hide"
      ]
    },
    "NetworkCardIndex": 0
  },
  "PrivateIpSets": {
    "PrivateIpSet": [
      {
        "PrivateIpAddress": "172.17.**.**",
        "Primary": true,
        "AssociatedPublicIp": {
          "PublicIpAddress": "116.62.**.**",
          "AllocationId": "null"
        }
      }
    ]
  },
  "Ipv6Sets": {
    "Ipv6Set": [
      {
        "Ipv6Address": "2001:db8:1234:1a00::****",
        "Primary": false
      }
    ]
  },
  "Ipv4PrefixSets": {
    "Ipv4PrefixSet": [
      {
        "Ipv4Prefix": "192.168.**.0/28"
      }
    ]
  },
  "Ipv6PrefixSets": {
    "Ipv6PrefixSet": [
      {
        "Ipv6Prefix": "2001:db8:1234:1a00:****::/80"
      }
    ]
  },
  "Tags": {
    "Tag": [
      {
        "TagValue": "TestValue",
        "TagKey": "TestKey"
      }
    ]
  },
  "BondInterfaceSpecification": {
    "BondMode": "null",
    "SlaveInterfaceSpecification": {
      "SlaveInterfaceSpecificationSet": [
        {
          "SlaveNetworkInterfaceId": "null",
          "WorkState": "null",
          "BondNetworkInterfaceId": "null"
        }
      ]
    }
  },
  "SlaveInterfaceSpecification": {
    "SlaveNetworkInterfaceId": "null",
    "WorkState": "null",
    "BondNetworkInterfaceId": "null"
  },
  "DeleteOnRelease": true,
  "TcpOptionAddressEnabled": "null",
  "NetworkInterfaceTrafficConfig": {
    "NetworkInterfaceTrafficMode": "HighPerformance",
    "QueueNumber": 8,
    "QueuePairNumber": 8
  },
  "ConnectionTrackingConfiguration": {
    "TcpEstablishedTimeout": 910,
    "TcpClosedAndTimeWaitTimeout": 3,
    "UdpTimeout": 30
  },
  "SourceDestCheck": false,
  "EnhancedNetwork": {
    "EnableSriov": false,
    "EnableRss": true,
    "VirtualFunctionTotalQueueNumber": 0,
    "VirtualFunctionQuantity": 0,
    "EnableExpress": false
  },
  "QoSConfig": {
    "EnableQoS": false,
    "QoS": {
      "BandwidthTx": 50000,
      "BandwidthRx": 50000,
      "PpsTx": 50000,
      "PpsRx": 50000,
      "ConcurrentConnections": 50000
    }
  }
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur
400	MissingParameter	%s
400	UnsupportedParameter	%s
400	InvalidParameter	%s
400	InvalidInstanceID.Malformed	%s
400	Forbidden.RegionId	%s
400	InvalidRegionId.MalFormed	The specified parameter RegionId is not valid.
403	InvalidUserType.NotSupported	%s
403	Abs.InvalidAccount.NotFound	%s
403	Forbidden.NotSupportRAM	%s
403	Forbidden.SubUser	%s
403	InvalidParameter	%s
404	InvalidEniId.NotFound	%s

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.