DescribeNetworkInterfaceAttribute - Elastic Compute Service - Centro de documentación de Alibaba Cloud

Consulta los detalles de una interfaz de red elástica (ENI) mediante el ID de la ENI.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

ecs:DescribeNetworkInterfaceAttribute

get

*NetworkInterface.

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de la región del controlador de interfaz de red (NIC). Puede llamar a DescribeRegions para consultar la lista más reciente de regiones.	cn-hangzhou
Tag	array<object>	No	Nota Este parámetro no está disponible para su uso.
	object	No	Nota Este parámetro no está disponible para su uso.
Key	string	No	Nota Este parámetro no está disponible para su uso.	ClaveDePrueba
Value	string	No	Nota Este parámetro no está disponible para su uso.	ValorDePrueba
NetworkInterfaceId	string	Sí	El ID del controlador de interfaz de red (NIC).	eni-bp67acfmxazb4p****
Attribute	string	No	La propiedad de la interfaz de red elástica (ENI). Valores válidos: attachment: consulta la información de conexión de los controladores de interfaz de red (NIC) miembros de un controlador de interfaz de red (NIC) troncal. Este parámetro está en vista previa por invitación y no está disponible para su uso. connectionTrackingConfiguration: consulta la configuración de seguimiento de conexiones de red. Valor predeterminado: vacío.	attachment

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	La colección de información de ENI.
CreationTime	string	La hora en que se creó la interfaz de red (NIC). La hora está en formato ISO 8601 y se muestra en UTC.	2019-12-25T12:31:31Z
VpcId	string	El ID de la VPC a la que pertenece la interfaz de red (NIC).	vpc-bp67acfmxazb4p****
Type	string	El tipo de interfaz de red elástica (ENI). Valores válidos: Primary: interfaz de red (NIC) principal. Secondary: interfaz de red elástica (ENI) secundaria.	Secondary
Status	string	El estado de la interfaz de red (NIC). Valores válidos: Available: activo. Attaching: se está asociando. InUse: en uso. Detaching: se está desasociando. Deleting: se está eliminando. Valor predeterminado: vacío, lo que indica que se consultan las interfaces de red (NIC) en todos los estados.	Available
NetworkInterfaceTrafficMode	string	El modo de comunicación de la interfaz de red (NIC). Valores válidos: Standard: se utiliza el modo de comunicación TCP. HighPerformance: la interfaz RDMA elástica (ERI) está habilitada y se utiliza el modo de comunicación RDMA. Nota El valor del parámetro HighPerformance solo es compatible con la familia de instancias mejoradas para RDMA c7re.	Standard
NetworkInterfaceName	string	El nombre de la interfaz de red (NIC).	my-eni-name
MacAddress	string	La dirección MAC de la interfaz de red (NIC).	00:16:3e:12::
QueuePairNumber	integer	Nota Este parámetro se encuentra en versión preliminar por invitación y no está disponible públicamente.	22
NetworkInterfaceId	string	El ID del controlador de interfaz de red (NIC).	eni-bp125p95hhdhn3ot****
ServiceID	integer	El ID del operador de red virtual (VNO) asociado con la interfaz de red (NIC).	12345678910
InstanceId	string	El ID de la instancia a la que está asociada la interfaz de red (NIC). Nota Las interfaces de red (NIC) que son administradas y controladas por otros servicios de Alibaba Cloud no devuelven ID de instancia.	i-bp1e2l6djkndyuli****
OwnerId	string	El ID de la cuenta propietaria de la interfaz de red (NIC).	123456****
ServiceManaged	boolean	Indica si el usuario de la interfaz de red (NIC) es un servicio de Alibaba Cloud o un VNO.	true
VSwitchId	string	El ID del vSwitch al que pertenece la interfaz de red (NIC).	vsw-bp1s5fnvk4gn2tws0****
RequestId	string	El ID de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
Description	string	La descripción de la interfaz de red (NIC).	testDescription
ResourceGroupId	string	El ID del grupo de recursos al que pertenece la instancia. Cuando se utiliza este parámetro para filtrar recursos, la cantidad de recursos no puede superar los 1000. Nota No se admite el filtrado por el grupo de recursos predeterminado.	rg-bp67acfmxazb4p****
ZoneId	string	El ID de la zona.	cn-hangzhou-g
PrivateIpAddress	string	La dirección IP privada de la interfaz de red (NIC).	10.1..
QueueNumber	integer	El número de colas para la interfaz de red elástica (ENI). Si la ENI es una interfaz de red (NIC) principal: se devuelve el número predeterminado de colas para la NIC principal que admite el tipo de instancia. Si la ENI es una ENI secundaria: Si la ENI secundaria está en estado InUse: Si no se ha modificado el número de colas para la ENI secundaria, se devuelve el número predeterminado de colas para la ENI secundaria que admite el tipo de instancia. Si se ha modificado el número de colas para la ENI secundaria, se devuelve el número de colas modificado. Si la ENI secundaria está en estado activo (Available): Si no se ha modificado el número de colas para la ENI secundaria, se devuelve un valor vacío. Si se ha modificado el número de colas para la ENI secundaria, se devuelve el número de colas modificado.	8
SecurityGroupIds	object
SecurityGroupId	array	La colección de grupos de seguridad a los que pertenece la interfaz de red (NIC).
	string	El grupo de seguridad al que pertenece la interfaz de red (NIC).	sg-bp18kz60mefsicfg****
AssociatedPublicIp	object	La dirección IP elástica (EIP) asociada con la dirección IP privada secundaria de la interfaz de red (NIC).
PublicIpAddress	string	La dirección EIP.	116.62..
AllocationId	string	El ID de la EIP.	null
Attachment	object	Nota Este parámetro se encuentra en versión preliminar por invitación y no está disponible públicamente.
DeviceIndex	integer	Nota Este parámetro se encuentra en versión preliminar por invitación y no está disponible públicamente.	hide
InstanceId	string	Nota Este parámetro se encuentra en versión preliminar por invitación y no está disponible públicamente.	hide
TrunkNetworkInterfaceId	string	Nota Este parámetro se encuentra en versión preliminar por invitación y no está disponible públicamente.	hide
MemberNetworkInterfaceIds	object
MemberNetworkInterfaceId	array	Nota Este parámetro se encuentra en versión preliminar por invitación y no está disponible públicamente.
	string	Nota Este parámetro se encuentra en versión preliminar por invitación y no está disponible públicamente.	hide
NetworkCardIndex	integer	El índice de la tarjeta de red a la que está asociada la ENI. Si la ENI está en estado Available o no se especificó el índice durante la asociación, no se devuelve este valor. Si la ENI está en estado InUse y se especificó el índice durante la asociación, este valor indica el índice de la tarjeta de red a la que está asociada la ENI.	0
PrivateIpSets	object
PrivateIpSet	array<object>	La colección de información de direcciones IP privadas para la interfaz de red (NIC).
	array<object>	La información de la dirección IP privada de la interfaz de red (NIC).
PrivateIpAddress	string	La dirección IP privada de la interfaz de red (NIC).	172.17..
Primary	boolean	Indica si la dirección IP es la dirección IP privada principal. Valores válidos: true: dirección IP privada principal. false: dirección IP privada secundaria.	true
AssociatedPublicIp	object	La dirección IP elástica (EIP) asociada con la dirección IP privada secundaria de la interfaz de red (NIC).
PublicIpAddress	string	La dirección EIP.	116.62..
AllocationId	string	Nota Este parámetro se encuentra en versión preliminar por invitación y no está disponible públicamente.	null
Ipv6Sets	object
Ipv6Set	array<object>	La lista de direcciones IPv6 asignadas a la interfaz de red (NIC).
	object	La dirección IPv6 asignada a la interfaz de red (NIC).
Ipv6Address	string	La dirección IPv6 asignada a la interfaz de red (NIC).	2001:db8:1234:1a00::****
Primary	boolean
Ipv4PrefixSets	object
Ipv4PrefixSet	array<object>	La colección de prefijos IPv4 asignados a la interfaz de red (NIC).
	object	El prefijo IPv4 asignado a la ENI.
Ipv4Prefix	string	El prefijo IPv4 asignado al controlador de interfaz de red (NIC).	192.168.**.0/28
Ipv6PrefixSets	object
Ipv6PrefixSet	array<object>	La colección de prefijos IPv6 asignados a la interfaz de red (NIC).
	object
Ipv6Prefix	string	El prefijo IPv6 asignado al controlador de interfaz de red (NIC).	2001:db8:1234:1a00:****::/80
Tags	object
Tag	array<object>	La colección de etiquetas para la interfaz de red (NIC).
	object	La información de la etiqueta de la interfaz de red (NIC).
TagValue	string	El valor de la etiqueta.	ValorDePrueba
TagKey	string	La clave de la etiqueta.	ClaveDePrueba
BondInterfaceSpecification	object	Nota Este parámetro se encuentra en versión preliminar por invitación y no está disponible públicamente.
BondMode	string	Nota Este parámetro se encuentra en versión preliminar por invitación y no está disponible públicamente.	null
SlaveInterfaceSpecification	object
SlaveInterfaceSpecificationSet	array<object>	Nota Este parámetro se encuentra en versión preliminar por invitación y no está disponible públicamente.
	object	Nota Este parámetro se encuentra en versión preliminar por invitación y no está disponible públicamente.
SlaveNetworkInterfaceId	string	Nota Este parámetro se encuentra en versión preliminar por invitación y no está disponible públicamente.	null
WorkState	string	Nota Este parámetro se encuentra en versión preliminar por invitación y no está disponible públicamente.	null
BondNetworkInterfaceId	string	Nota Este parámetro se encuentra en versión preliminar por invitación y no está disponible públicamente.	null
SlaveInterfaceSpecification	object	Nota Este parámetro se encuentra en versión preliminar por invitación y no está disponible públicamente.
SlaveNetworkInterfaceId	string	Nota Este parámetro se encuentra en versión preliminar por invitación y no está disponible públicamente.	null
WorkState	string	Nota Este parámetro se encuentra en versión preliminar por invitación y no está disponible públicamente.	null
BondNetworkInterfaceId	string	Nota Este parámetro se encuentra en versión preliminar por invitación y no está disponible públicamente.	null
DeleteOnRelease	boolean	Indica si la ENI se conserva cuando se libera la instancia asociada. Valores válidos: true: la ENI no se conserva. false: la ENI se conserva.	true
TcpOptionAddressEnabled	string	Nota Este parámetro se encuentra en versión preliminar por invitación y no está disponible públicamente.	null
NetworkInterfaceTrafficConfig	object	Los parámetros de tráfico del controlador de interfaz de red (NIC).
NetworkInterfaceTrafficMode	string	El modo de comunicación del controlador de interfaz de red (NIC).	HighPerformance
QueueNumber	integer	El número de colas para el controlador de interfaz de red (NIC).	8
QueuePairNumber	integer	El número de pares de colas RDMA.	8
ConnectionTrackingConfiguration	object	El conjunto de información de configuración del seguimiento de conexiones de red. Antes de utilizar este parámetro, consulte Gestión del tiempo de espera de conexión. Nota Este parámetro solo se devuelve cuando el parámetro de entrada Attribute se establece en connectionTrackingConfiguration.
TcpEstablishedTimeout	integer	El período de tiempo de espera para las conexiones TCP en estado ESTABLISHED. Unidad: segundos. Valores válidos: [30, 60, 80, 100, 200, 300, 500, 700, 910].	910
TcpClosedAndTimeWaitTimeout	integer	El período de tiempo de espera para las conexiones TCP en los estados TIME_WAIT y CLOSED. Unidad: segundos. Valores válidos: un número entero del 3 al 15. Nota Si su instancia de ECS se utiliza con NLB o CLB, el período de tiempo de espera predeterminado para las conexiones en estado TIME_WAIT es de 15 segundos.	3
UdpTimeout	integer	El período de tiempo de espera para los flujos UDP. Unidad: segundos. Valores válidos: [10, 20, 30, 60, 80, 100]. Nota Si su instancia de ECS se utiliza con NLB o CLB, el valor predeterminado es de 100 segundos.	30
SourceDestCheck	boolean	Este parámetro no está disponible públicamente.	false
EnhancedNetwork	object	Este parámetro no está disponible públicamente.
EnableSriov	boolean	Este parámetro no está disponible públicamente.	false
EnableRss	boolean	Nota Este parámetro no está disponible para su uso.	true
VirtualFunctionTotalQueueNumber	integer
VirtualFunctionQuantity	integer
EnableExpress	boolean
QoSConfig	object	La configuración del límite de tasa de QoS.
EnableQoS	boolean	Indica si está habilitado el límite de tasa de QoS.
QoS	object	La configuración del límite de tasa de QoS.
BandwidthTx	integer	El límite máximo de ancho de banda interno de salida.	50000
BandwidthRx	integer	El límite máximo de ancho de banda interno de entrada.	50000
PpsTx	integer	La tasa de reenvío de paquetes de la red interna de salida.	50000
PpsRx	integer	La tasa de reenvío de paquetes de la red interna de entrada.	50000
ConcurrentConnections	integer	El número máximo de sesiones.	50000

Ejemplos

Respuesta exitosa

JSON Formato

{
  "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": "ValorDePrueba",
        "TagKey": "ClaveDePrueba"
      }
    ]
  },
  "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
    }
  }
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	MissingParameter	%s	Falta un parámetro obligatorio.
400	UnsupportedParameter	%s	El parámetro especificado no es compatible. Verifique si el parámetro es correcto.
400	InvalidParameter	%s	Los parámetros de la solicitud actual no son válidos. Inténtelo de nuevo.
400	InvalidInstanceID.Malformed	%s
400	Forbidden.RegionId	%s	El servicio no está disponible actualmente en esta región.
400	InvalidRegionId.MalFormed	The specified parameter RegionId is not valid.	El RegionId especificado no es válido.
403	InvalidUserType.NotSupported	%s	El tipo de usuario no es válido.
403	Abs.InvalidAccount.NotFound	%s	No se encontró la cuenta o la AccessKey ha caducado.
403	Forbidden.NotSupportRAM	%s	Los usuarios de Resource Access Management (RAM) no tienen permitido ejecutar esta operación.
403	Forbidden.SubUser	%s	Su usuario RAM actual no tiene el permiso para realizar operaciones en este recurso.
403	InvalidParameter	%s
404	InvalidEniId.NotFound	%s

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.