Todos os produtos
Search
Central de documentação

:DescribeNetworkInterfaceAttribute

Última atualização: Jul 03, 2026

Consulta os detalhes de uma elastic network interface (ENI).

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action String Sim DescribeNetworkInterfaceAttribute

A operação a ser executada. Defina o valor como DescribeNetworkInterfaceAttribute.

RegionId String Sim cn-hangzhou

O ID da região da ENI. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.

Tag.N.Key String Não TestKey
Nota Este parâmetro não está disponível publicamente.
Tag.N.Value String Não TestValue
Nota Este parâmetro não está disponível publicamente.
NetworkInterfaceId String Sim eni-bp67acfmxazb4p****

O ID da ENI.

Attribute String Não test

O atributo da ENI.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

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

O horário de criação da ENI.

VpcId String vpc-bp67acfmxazb4p****

O ID da virtual private cloud (VPC) à qual a ENI pertence.

Type String Secondary

O tipo da ENI. Valores válidos:

  • Primary
  • Secondary
Status String Available

O estado da ENI. Valores válidos:

  • Available: A ENI não está associada a nenhuma instância.
  • Attaching: A ENI está sendo associada a uma instância.
  • InUse: A ENI está associada a uma instância.
  • Detaching: A ENI está sendo desassociada de uma instância.
  • Deleting: A ENI está sendo excluída.

Por padrão, este parâmetro fica vazio, o que indica que ENIs em todos os estados são consultadas.

NetworkInterfaceTrafficMode String Standard

O modo de comunicação da ENI. Valores válidos:

  • Standard: utiliza o modo de comunicação TCP.
  • HighPerformance: utiliza o modo de comunicação remote direct memory access (RDMA) com a Elastic RDMA Interface (ERI) ativada.
Nota O parâmetro só pode ter o valor HighPerformance quando a ENI estiver associada a uma instância c7re aprimorada para RDMA residente na Zona K de Pequim.
NetworkInterfaceName String my-eni-name

O nome da ENI.

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

O endereço media access control (MAC) da ENI.

QueuePairNumber Integer 22
Nota Este parâmetro está em visualização por convite e não está disponível publicamente.
NetworkInterfaceId String eni-bp125p95hhdhn3ot****

O ID da ENI.

ServiceID Long 12345678910

O ID do distribuidor ao qual a ENI pertence.

InstanceId String i-bp1e2l6djkndyuli****

O ID da instância à qual a ENI está associada.

Nota Se outros serviços da Alibaba Cloud gerenciarem e controlarem a ENI, nenhum ID de instância será retornado.
OwnerId String 123456****

O ID da conta à qual a ENI pertence.

ServiceManaged Boolean true

Indica se o usuário da ENI é um serviço da Alibaba Cloud ou um distribuidor.

VSwitchId String vsw-bp1s5fnvk4gn2tws0****

O ID do vSwitch ao qual a ENI está conectada.

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

O ID da solicitação.

Description String testDescription

A descrição da ENI.

ResourceGroupId String rg-bp67acfmxazb4p****

O ID do grupo de recursos ao qual a instância associada pertence. Se este parâmetro for especificado para consultar recursos, até 1.000 recursos pertencentes ao grupo de recursos especificado serão retornados.

Nota Os recursos no grupo de recursos padrão aparecem na resposta independentemente de como este parâmetro esteja configurado.
ZoneId String cn-hangzhou-g

O ID da zona da ENI.

PrivateIpAddress String 10.1.**.**

O endereço IP privado da ENI.

QueueNumber Integer 8

O número de filas suportadas pela ENI.

  • Para uma ENI primária: Retorna o número padrão de filas que o tipo de instância suporta para a ENI.
  • Para uma ENI secundária:
    • Se a ENI estiver no estado InUse, ocorrem as seguintes situações:
      • Caso o número de filas suportadas pela ENI não tenha sido modificado, retorna o número padrão de filas que o tipo de instância suporta para a ENI.
      • Caso o número de filas suportadas pela ENI tenha sido modificado, retorna o novo número de filas.
    • Se a ENI estiver no estado Available, ocorrem as seguintes situações:
      • Caso o número de filas suportadas pela ENI não tenha sido modificado, o valor retornado fica vazio.
      • Caso o número de filas suportadas pela ENI tenha sido modificado, retorna o novo número de filas.
SecurityGroupIds Array of String sg-bp18kz60mefsicfg****

Os IDs dos grupos de segurança aos quais a ENI pertence.

AssociatedPublicIp Object

O elastic IP address (EIP) associado ao endereço IP privado secundário da ENI.

PublicIpAddress String 116.62.**.**

O EIP da ENI.

AllocationId String null

O ID do EIP.

Attachment Object
Nota Este parâmetro está em visualização por convite e não está disponível publicamente.
DeviceIndex Integer hide
Nota Este parâmetro está em visualização por convite e não está disponível publicamente.
InstanceId String hide
Nota Este parâmetro está em visualização por convite e não está disponível publicamente.
TrunkNetworkInterfaceId String hide
Nota Este parâmetro está em visualização por convite e não está disponível publicamente.
MemberNetworkInterfaceIds Array of String hide
Nota Este parâmetro está em visualização por convite e não está disponível publicamente.
NetworkCardIndex Integer 0

O índice da placa de rede.

  • Se a ENI estiver no estado Available ou se nenhum índice de placa de rede tiver sido especificado durante a associação da ENI, este parâmetro ficará vazio.
  • Se a ENI estiver no estado InUse e um índice de placa de rede tiver sido especificado durante a associação da ENI, o índice especificado será retornado como valor deste parâmetro.
PrivateIpSets Array of PrivateIpSet

Os endereços IP privados.

PrivateIpSet
PrivateIpAddress String 172.17.**.**

O endereço IP privado da ENI.

Primary Boolean true

Indica se o endereço IP é o endereço IP privado primário. Valores válidos:

  • true: o endereço IP privado primário
  • false: um endereço IP privado secundário
AssociatedPublicIp Object

Detalhes sobre o EIP associado ao endereço IP privado secundário da ENI.

PublicIpAddress String 116.62.**.**

O EIP.

AllocationId String null
Nota Este parâmetro está em visualização por convite e não está disponível publicamente.
Ipv6Sets Array of Ipv6Set

Os endereços IPv6 da ENI.

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

O endereço IPv6 atribuído à ENI.

Ipv4PrefixSets Array of Ipv4PrefixSet

Os prefixos IPv4 da ENI.

Ipv4PrefixSet
Ipv4Prefix String 192.168.**.0/28

O prefixo IPv4 atribuído à ENI.

Ipv6PrefixSets Array of Ipv6PrefixSet

Os prefixos IPv6 da ENI.

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

O prefixo IPv6 atribuído à ENI.

Tags Array of Tag

As tags da ENI.

Tag
TagValue String TestValue

O valor da tag da ENI.

TagKey String TestKey

A chave da tag da ENI.

BondInterfaceSpecification Object
Nota Este parâmetro está em visualização por convite e não está disponível publicamente.
BondMode String null
Nota Este parâmetro está em visualização por convite e não está disponível publicamente.
SlaveInterfaceSpecification Array of SlaveInterfaceSpecificationSet
Nota Este parâmetro está em visualização por convite e não está disponível publicamente.
SlaveInterfaceSpecificationSet
SlaveNetworkInterfaceId String null
Nota Este parâmetro está em visualização por convite e não está disponível publicamente.
WorkState String null
Nota Este parâmetro está em visualização por convite e não está disponível publicamente.
BondNetworkInterfaceId String null
Nota Este parâmetro está em visualização por convite e não está disponível publicamente.
SlaveInterfaceSpecification Object
Nota Este parâmetro está em visualização por convite e não está disponível publicamente.
SlaveNetworkInterfaceId String null
Nota Este parâmetro está em visualização por convite e não está disponível publicamente.
WorkState String null
Nota Este parâmetro está em visualização por convite e não está disponível publicamente.
BondNetworkInterfaceId String null
Nota Este parâmetro está em visualização por convite e não está disponível publicamente.
DeleteOnRelease Boolean true

Indica se a ENI deve ser mantida quando a instância associada for liberada. Valores válidos:

  • true
  • false

Exemplos

Exemplos de solicitações

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

Exemplos de respostas de sucesso

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 erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400

MissingParameter

%s

Um parâmetro obrigatório não foi especificado.

400

UnsupportedParameter

%s

Um parâmetro especificado não é suportado.

400

InvalidParameter

%s

Valor de parâmetro inválido.

400

InvalidInstanceID.Malformed

%s

Formato de InstanceId inválido.

400

Forbidden.RegionId

%s

O serviço está indisponível na região no momento.

400

InvalidRegionId.MalFormed

The specified parameter RegionId is not valid.

Valor de RegionId inválido.

403

InvalidUserType.NotSupported

%s

A conta não suporta esta operação.

403

Abs.InvalidAccount.NotFound

%s

Sua conta Alibaba Cloud não foi encontrada ou seu par AccessKey expirou.

403

Forbidden.NotSupportRAM

%s

Usuários do Resource Access Management (RAM) não têm permissão para executar esta operação.

403

Forbidden.SubUser

%s

Você não tem acesso ao recurso. Entre em contato com o proprietário da conta Alibaba Cloud.

404

InvalidEniId.NotFound

%s

O ID da ENI não foi encontrado.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.