Consulta los detalles de una elastic network interface (ENI).
Depuración
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:
|
| Status | String | Available | El estado de la ENI. Valores válidos:
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:
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.
|
| 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.
|
| 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:
|
| 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:
|
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.