Todos los productos
Search
Centro de documentos

:DescribeNetworkInterfaceAttribute

Última actualización: Sep 02, 2026

Consulta los detalles de una elastic network interface (ENI).

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que llame a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDKs.

Parámetros de solicitud

Parámetro

Tipo

Obligatorio

Ejemplo

Descripción

Action String Sí DescribeNetworkInterfaceAttribute

La operación que desea ejecutar. Establezca el valor en DescribeNetworkInterfaceAttribute.

RegionId String Sí cn-hangzhou

El ID de región de la ENI. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.

Tag.N.Key String No TestKey
Nota Este parámetro no está disponible públicamente.
Tag.N.Value String No TestValue
Nota Este parámetro no está disponible públicamente.
NetworkInterfaceId String Sí eni-bp67acfmxazb4p****

El ID de la ENI.

Attribute String No test

El atributo de la ENI.

Parámetros de respuesta

Parámetro

Tipo

Ejemplo

Descripción

CreationTime String 2019-12-25T12:31:31Z

La hora en que se creó la ENI.

VpcId String vpc-bp67acfmxazb4p****

El ID de la virtual private cloud (VPC) a la que pertenece la ENI.

Type String Secondary

El tipo de la ENI. Valores válidos:

  • Primary
  • Secondary
Status String Available

El estado de la ENI. Valores válidos:

  • Available: La ENI no está asociada a ninguna instancia.
  • Attaching: La ENI se está asociando a una instancia.
  • InUse: La ENI está asociada a una instancia.
  • Detaching: La ENI se está desasociando de una instancia.
  • Deleting: La ENI se está eliminando.

Este parámetro está vacío de forma predeterminada, lo que indica que se consultan las ENI en todos los estados.

NetworkInterfaceTrafficMode String Standard

El modo de comunicación de la ENI. Valores válidos:

  • Standard: utiliza el modo de comunicación TCP.
  • HighPerformance: utiliza el modo de comunicación de acceso remoto directo a memoria (RDMA) con Elastic RDMA Interface (ERI) habilitado.
Nota El parámetro solo puede tener el valor HighPerformance cuando la ENI está asociada a una instancia c7re optimizada para RDMA ubicada en Beijing Zone K.
NetworkInterfaceName String my-eni-name

El nombre de la ENI.

MacAddress String 00:16:3e:12:**:**

La dirección de control de acceso a medios (MAC) de la ENI.

QueuePairNumber Integer 22
Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.
NetworkInterfaceId String eni-bp125p95hhdhn3ot****

El ID de la ENI.

ServiceID Long 12,345,678,910

El ID del distribuidor al que pertenece la ENI.

InstanceId String i-bp1e2l6djkndyuli****

El ID de la instancia a la que está asociada la ENI.

Nota Si otros servicios de Alibaba Cloud gestionan y controlan la ENI, no se devuelve ningún ID de instancia.
OwnerId String 123456****

El ID de la cuenta a la que pertenece la ENI.

ServiceManaged Boolean true

Indica si el usuario de la ENI es un servicio de Alibaba Cloud o un distribuidor.

VSwitchId String vsw-bp1s5fnvk4gn2tws0****

El ID del vSwitch al que está conectada la ENI.

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

El ID de la solicitud.

Description String testDescription

La descripción de la ENI.

ResourceGroupId String rg-bp67acfmxazb4p****

El ID del resource group al que pertenece la instancia asociada. Si se especifica este parámetro para consultar recursos, se devuelven hasta 1,000 recursos pertenecientes al resource group especificado.

Nota Los recursos del resource group predeterminado se muestran en la respuesta independientemente de cómo se configure este parámetro.
ZoneId String cn-hangzhou-g

El ID de zona de la ENI.

PrivateIpAddress String 10.1.**.**

La dirección IP privada de la ENI.

QueueNumber Integer 8

El número de colas compatibles con la ENI.

  • Para una ENI primaria: Se devuelve el número predeterminado de colas que el tipo de instancia admite para la ENI.
  • Para una ENI secundaria:
    • Si la ENI está en estado InUse, ocurren las siguientes situaciones:
      • Si no se modificó el número de colas compatibles con la ENI, se devuelve el número predeterminado de colas que el tipo de instancia admite para la ENI.
      • Si se modificó el número de colas compatibles con la ENI, se devuelve el nuevo número de colas.
    • Si la ENI está en estado Available, ocurren las siguientes situaciones:
      • Si no se modificó el número de colas compatibles con la ENI, el valor devuelto está vacío.
      • Si se modificó el número de colas compatibles con la ENI, se devuelve el nuevo número de colas.
SecurityGroupIds Array of String sg-bp18kz60mefsicfg****

Los IDs de los security groups a los que pertenece la ENI.

AssociatedPublicIp Object

La elastic IP address (EIP) asociada a la dirección IP privada secundaria de la ENI.

PublicIpAddress String 116.62.**.**

La EIP de la ENI.

AllocationId String null

El ID de la EIP.

Attachment Object
Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.
DeviceIndex Integer hide
Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.
InstanceId String hide
Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.
TrunkNetworkInterfaceId String hide
Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.
MemberNetworkInterfaceIds Array of String hide
Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.
NetworkCardIndex Integer 0

El índice de la tarjeta de red.

  • Si la ENI está en estado Available o si no se especificó un índice de tarjeta de red al asociar la ENI, este parámetro está vacío.
  • Si la ENI está en estado InUse y se especificó un índice de tarjeta de red al asociar la ENI, se devuelve el índice de tarjeta de red especificado como valor de este parámetro.
PrivateIpSets Array of PrivateIpSet

Las direcciones IP privadas.

PrivateIpSet
PrivateIpAddress String 172.17.**.**

La dirección IP privada de la ENI.

Primary Boolean true

Indica si la dirección IP es la dirección IP privada primaria. Valores válidos:

  • true: la dirección IP privada primaria
  • false: una dirección IP privada secundaria
AssociatedPublicIp Object

Detalles sobre la EIP asociada a la dirección IP privada secundaria de la ENI.

PublicIpAddress String 116.62.**.**

La EIP.

AllocationId String null
Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.
Ipv6Sets Array of Ipv6Set

Las direcciones IPv6 de la ENI.

Ipv6Set
Ipv6Address String 2001:db8:1234:1a00::****

La dirección IPv6 asignada a la ENI.

Ipv4PrefixSets Array of Ipv4PrefixSet

Los prefijos IPv4 de la ENI.

Ipv4PrefixSet
Ipv4Prefix String 192.168.**.0/28

El prefijo IPv4 asignado a la ENI.

Ipv6PrefixSets Array of Ipv6PrefixSet

Los prefijos IPv6 de la ENI.

Ipv6PrefixSet
Ipv6Prefix String 2001:db8:1234:1a00:****::/80

El prefijo IPv6 asignado a la ENI.

Tags Array of Tag

Las etiquetas de la ENI.

Tag
TagValue String TestValue

El valor de la etiqueta de la ENI.

TagKey String TestKey

La clave de la etiqueta de la ENI.

BondInterfaceSpecification Object
Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.
BondMode String null
Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.
SlaveInterfaceSpecification Array of SlaveInterfaceSpecificationSet
Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.
SlaveInterfaceSpecificationSet
SlaveNetworkInterfaceId String null
Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.
WorkState String null
Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.
BondNetworkInterfaceId String null
Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.
SlaveInterfaceSpecification Object
Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.
SlaveNetworkInterfaceId String null
Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.
WorkState String null
Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.
BondNetworkInterfaceId String null
Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.
DeleteOnRelease Boolean true

Indica si se debe conservar la ENI cuando se libera la instancia asociada. Valores válidos:

  • true
  • false

Ejemplos

Solicitudes de ejemplo

http(s)://ecs.aliyuncs.com/?Action=DescribeNetworkInterfaceAttribute
&RegionId=cn-hangzhou
&NetworkInterfaceId=eni-bp67acfmxazb4p****
&Attribute=test
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeNetworkInterfaceAttributeResponse>
    <CreationTime>2019-12-25T12:31:31Z</CreationTime>
    <VpcId>vpc-bp67acfmxazb4p****</VpcId>
    <Type>Secondary</Type>
    <Status>Available</Status>
    <NetworkInterfaceTrafficMode>Standard</NetworkInterfaceTrafficMode>
    <NetworkInterfaceName>my-eni-name</NetworkInterfaceName>
    <MacAddress>00:16:3e:12:**:**</MacAddress>
    <QueuePairNumber>22</QueuePairNumber>
    <NetworkInterfaceId>eni-bp125p95hhdhn3ot****</NetworkInterfaceId>
    <ServiceID>12345678910</ServiceID>
    <InstanceId>i-bp1e2l6djkndyuli****</InstanceId>
    <OwnerId>123456****</OwnerId>
    <ServiceManaged>true</ServiceManaged>
    <VSwitchId>vsw-bp1s5fnvk4gn2tws0****</VSwitchId>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
    <Description>testDescription</Description>
    <ResourceGroupId>rg-bp67acfmxazb4p****</ResourceGroupId>
    <ZoneId>cn-hangzhou-g</ZoneId>
    <PrivateIpAddress>10.1.**.**</PrivateIpAddress>
    <QueueNumber>8</QueueNumber>
    <SecurityGroupIds>sg-bp18kz60mefsicfg****</SecurityGroupIds>
    <AssociatedPublicIp>
        <PublicIpAddress>116.62.**.**</PublicIpAddress>
        <AllocationId>null</AllocationId>
    </AssociatedPublicIp>
    <Attachment>
        <InstanceId>hide</InstanceId>
        <TrunkNetworkInterfaceId>hide</TrunkNetworkInterfaceId>
        <MemberNetworkInterfaceIds>hide</MemberNetworkInterfaceIds>
        <NetworkCardIndex>0</NetworkCardIndex>
    </Attachment>
    <PrivateIpSets>
        <PrivateIpAddress>172.17.**.**</PrivateIpAddress>
        <Primary>true</Primary>
        <AssociatedPublicIp>
            <PublicIpAddress>116.62.**.**</PublicIpAddress>
            <AllocationId>null</AllocationId>
        </AssociatedPublicIp>
    </PrivateIpSets>
    <Ipv6Sets>
        <Ipv6Address>2001:db8:1234:1a00::****</Ipv6Address>
    </Ipv6Sets>
    <Ipv4PrefixSets>
        <Ipv4Prefix>192.168.**.0/28</Ipv4Prefix>
    </Ipv4PrefixSets>
    <Ipv6PrefixSets>
        <Ipv6Prefix>2001:db8:1234:1a00:****::/80</Ipv6Prefix>
    </Ipv6PrefixSets>
    <Tags>
        <TagValue>TestValue</TagValue>
        <TagKey>TestKey</TagKey>
    </Tags>
    <BondInterfaceSpecification>
        <BondMode>null</BondMode>
        <SlaveInterfaceSpecification>
            <SlaveNetworkInterfaceId>null</SlaveNetworkInterfaceId>
            <WorkState>null</WorkState>
            <BondNetworkInterfaceId>null</BondNetworkInterfaceId>
        </SlaveInterfaceSpecification>
    </BondInterfaceSpecification>
    <SlaveInterfaceSpecification>
        <SlaveNetworkInterfaceId>null</SlaveNetworkInterfaceId>
        <WorkState>null</WorkState>
        <BondNetworkInterfaceId>null</BondNetworkInterfaceId>
        <DeleteOnRelease>true</DeleteOnRelease>
    </SlaveInterfaceSpecification>
</DescribeNetworkInterfaceAttributeResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "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" : [ "sg-bp18kz60mefsicfg****" ],
  "AssociatedPublicIp" : {
    "PublicIpAddress" : "116.62.**.**",
    "AllocationId" : "null"
  },
  "Attachment" : {
    "InstanceId" : "hide",
    "TrunkNetworkInterfaceId" : "hide",
    "MemberNetworkInterfaceIds" : [ "hide" ],
    "NetworkCardIndex" : 0
  },
  "PrivateIpSets" : [ {
    "PrivateIpAddress" : "172.17.**.**",
    "Primary" : true,
    "AssociatedPublicIp" : {
      "PublicIpAddress" : "116.62.**.**",
      "AllocationId" : "null"
    }
  } ],
  "Ipv6Sets" : [ {
    "Ipv6Address" : "2001:db8:1234:1a00::****"
  } ],
  "Ipv4PrefixSets" : [ {
    "Ipv4Prefix" : "192.168.**.0/28"
  } ],
  "Ipv6PrefixSets" : [ {
    "Ipv6Prefix" : "2001:db8:1234:1a00:****::/80"
  } ],
  "Tags" : [ {
    "TagValue" : "TestValue",
    "TagKey" : "TestKey"
  } ],
  "BondInterfaceSpecification" : {
    "BondMode" : "null",
    "SlaveInterfaceSpecification" : [ {
      "SlaveNetworkInterfaceId" : "null",
      "WorkState" : "null",
      "BondNetworkInterfaceId" : "null"
    } ]
  },
  "SlaveInterfaceSpecification" : {
    "SlaveNetworkInterfaceId" : "null",
    "WorkState" : "null",
    "BondNetworkInterfaceId" : "null",
    "DeleteOnRelease" : "true"
  }
}

Códigos de error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

400

MissingParameter

%s

No se especificó un parámetro obligatorio.

400

UnsupportedParameter

%s

Un parámetro especificado no es compatible.

400

InvalidParameter

%s

Valor de parámetro no válido.

400

InvalidInstanceID.Malformed

%s

Formato de InstanceId no válido.

400

Forbidden.RegionId

%s

El servicio no está disponible en la región por el momento.

400

InvalidRegionId.MalFormed

The specified parameter RegionId is not valid.

Valor de RegionId no válido.

403

InvalidUserType.NotSupported

%s

La cuenta no admite esta operación.

403

Abs.InvalidAccount.NotFound

%s

No se encontró su cuenta de Alibaba Cloud o su par de AccessKey ha caducado.

403

Forbidden.NotSupportRAM

%s

Los usuarios de Resource Access Management (RAM) no tienen permisos para ejecutar esta operación.

403

Forbidden.SubUser

%s

No tiene acceso al recurso. Póngase en contacto con el propietario de la cuenta de Alibaba Cloud.

404

InvalidEniId.NotFound

%s

No se encontró el ID de la ENI.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.