DescribeNetworkInterfaces - ENS - Centro de documentación de Alibaba Cloud

Consulta una lista de interfaces de red elásticas (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

ens:DescribeNetworkInterfaces

list

*Todos los recursos.

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
NetworkInterfaceId	string	No	El ID de las interfaces de red elásticas (ENI).	eni-58z57orgmt6d1****
InstanceId	string	No	El ID de la instancia.	i-5t7z99n32gplriv
NetworkId	string	No	El ID de la red.	n-2zeuphj08tt7q3brd****
VSwitchId	string	No	El ID del vSwitch.	vsw-12345
EnsRegionId	string	No	El ID de la región donde reside la instancia.	cn-tianjin-cmcc
SecurityGroupId	string	No	El ID del grupo de seguridad al que pertenece la ENI secundaria. Especifique este parámetro si desea consultar la información de las ENI secundarias por ID de grupo de seguridad.	sg-5p1fg655nh68xyz9i***
PrimaryIpAddress	string	No	La dirección IP principal de las interfaces de red elásticas (ENI).	10.XXX.XXX.5
Type	string	No	El tipo de las interfaces de red elásticas (ENI). Valores válidos: Primary: controlador de interfaz de red (NIC) principal. Secondary: controlador de interfaz de red (NIC) secundario. Valor predeterminado: vacío, lo que indica que se consultan todos los tipos. Valores válidos: Secondary : ENI secundaria. Primary : ENI principal.	Secondary
NetworkInterfaceName	string	No	El nombre de las interfaces de red elásticas (ENI).	test-01
Status	string	No	El estado de las interfaces de red elásticas (ENI). Valores válidos: Available: disponible. Attaching: asociando. InUse: en uso. Detaching: desasociando. Deleting: la operación de eliminación está en curso. Valor predeterminado: vacío, lo que indica que se consultan todos los estados.	Available
PageNumber	string	No	El número de página de la lista de estados de instancias. Las páginas comienzan desde 1. Valor predeterminado: 1.	1
PageSize	string	No	El número de entradas por página para las consultas de paginación. Valor máximo: 100. Valor predeterminado: 50.	50
Ipv6Address	array	No	Las direcciones IPv6 de las interfaces de red elásticas (ENI). N indica la configuración para varias direcciones IPv6. Valores válidos de N: 1 a 100.
	string	No	La dirección IPv6 de las interfaces de red elásticas (ENI).	2605:340:cdb1:XXXX:XXXX:XXXX:XXXX:e2d6
EnsRegionIds	array	No	Los ID de las zonas perimetrales de ENS. N indica el número de secuencia del ID de zona perimetral. Valores válidos de N: 1 a 100.
	string	No	El ID de la zona perimetral de ENS.	cn-fuzhou-1
NetworkInterfaceIds	array	No	La lista de ID de las interfaces de red elásticas (ENI). N indica la configuración para varios ID de interfaces de red elásticas (ENI). Valores válidos de N: 1 a 100.
	string	No	El ID de las interfaces de red elásticas (ENI).	eni-5****

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	El conjunto de información de las interfaces de red elásticas (ENI).
NetworkInterfaceSets	object
NetworkInterfaceSet	array<object>	El conjunto de información de las interfaces de red elásticas (ENI).
	array<object>	El conjunto de información de las interfaces de red elásticas (ENI).
CreationTime	string	La hora de creación. La hora se muestra en UTC y sigue el estándar ISO 8601 en el formato yyyy-MM-ddThh:mmZ.	2022-02-22T03:53:25Z
EnsRegionId	string	El ID de la zona perimetral de ENS.	id-jakarta-1
InstanceId	string	El ID de la instancia a la que están asociadas las interfaces de red elásticas (ENI).	i-5siavnr3
MacAddress	string	La dirección MAC de las interfaces de red elásticas (ENI).	00:16:XXX:XXX:60:0a
NetworkInterfaceId	string	El ID de las interfaces de red elásticas (ENI).	eni-uf686a5
PrimaryIp	string	La dirección IP privada principal.	10.XXX.XXX.25
PrimaryIpType	string	El tipo de la dirección IP principal. Valores válidos: Public: dirección IP pública. Private: dirección de red privada.	Private
Status	string	El estado de la interfaz de red elástica. Valores válidos: Available: la ENI está disponible. Attaching: la ENI se está asociando. InUse: la ENI está asociada. Detaching: la ENI se está desasociando. Deleting: la ENI se está eliminando.	InUse
NetworkId	string	El ID de la red.	n-5w0qd03adw****
VSwitchId	string	El ID del vSwitch.	vsw-5rqswx1trlsj9
PrivateIpSets	object
PrivateIpSet	array<object>	El conjunto de direcciones IP privadas.
	object	El conjunto de direcciones IP privadas.
PrivateIpAddress	string	La dirección IP privada.	192.XXX.XXX.130
Primary	boolean	Especifica si la dirección IP es la dirección IP privada principal. Valores válidos: true: la dirección IP es la dirección IP privada principal. false: la dirección IP es una dirección IP privada secundaria.	true
PrivateIpStatus	string	El estado de la dirección IP privada. Valores válidos: Available: la dirección IP está disponible. Creating: la dirección IP se está creando. Deleting: la dirección IP se está eliminando.	Available
NetworkInterfaceName	string	El nombre de las interfaces de red elásticas (ENI).	primaryTest
Description	string	La descripción de las interfaces de red elásticas (ENI).	test-description
SecurityGroupIds	object
SecurityGroup	array	El ID del grupo de seguridad.
	string	El ID del grupo de seguridad.	sg-5p1bozeiw711a1***
Type	string	El tipo de las interfaces de red elásticas (ENI). Valores válidos: Primary: controlador de interfaz de red (NIC) principal. Secondary: controlador de interfaz de red (NIC) secundario.	Primary
Ipv6Sets	object
Ipv6Set	array<object>	El conjunto de direcciones IPv6 asignadas a las interfaces de red elásticas (ENI).
	object	El conjunto de direcciones IPv6 asignadas a las interfaces de red elásticas (ENI).
Ipv6Address	string	La dirección IPv6 asignada a las interfaces de red elásticas (ENI).	2605:340:cdb1:XXXX:XXXX:XXXX:XXXX:e2d6
VmncLearn	boolean	Especifica si la función de aprendizaje de VMNC está habilitada.
PageNumber	integer	El número de página de la lista de estados de instancias. Las páginas comienzan desde 1. Valor predeterminado: 1.	1
PageSize	integer	El número de entradas por página para las consultas de paginación. Valor máximo: 50. Valor predeterminado: 10.	50
TotalCount	integer	El número total de entradas.	49
RequestId	string	El ID de la solicitud.	708AF9CE-FF92-5DF9-93F8-B7754AB1061A

Ejemplos

Respuesta exitosa

JSON Formato

{
  "NetworkInterfaceSets": {
    "NetworkInterfaceSet": [
      {
        "CreationTime": "2022-02-22T03:53:25Z",
        "EnsRegionId": "id-jakarta-1",
        "InstanceId": "i-5siavnr3",
        "MacAddress": "00:16:XXX:XXX:60:0a",
        "NetworkInterfaceId": "eni-uf686a5",
        "PrimaryIp": "10.XXX.XXX.25",
        "PrimaryIpType": "Private",
        "Status": "InUse",
        "NetworkId": "n-5w0qd03adw****",
        "VSwitchId": "vsw-5rqswx1trlsj9",
        "PrivateIpSets": {
          "PrivateIpSet": [
            {
              "PrivateIpAddress": "192.XXX.XXX.130",
              "Primary": true,
              "PrivateIpStatus": "Available"
            }
          ]
        },
        "NetworkInterfaceName": "primaryTest",
        "Description": "test-description",
        "SecurityGroupIds": {
          "SecurityGroup": [
            "sg-5p1bozeiw711a1***"
          ]
        },
        "Type": "Primary",
        "Ipv6Sets": {
          "Ipv6Set": [
            {
              "Ipv6Address": "2605:340:cdb1:XXXX:XXXX:XXXX:XXXX:e2d6"
            }
          ]
        },
        "VmncLearn": false
      }
    ]
  },
  "PageNumber": 1,
  "PageSize": 50,
  "TotalCount": 49,
  "RequestId": "708AF9CE-FF92-5DF9-93F8-B7754AB1061A"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	Missing%s	You must specify the parameter %s.
400	Invalid%s	The specified parameter %s is invalid.
400	ens.interface.error	Failed to call API.	Se produjo una excepción durante la llamada a la API.
400	NoPermission	Permission denied.
400	InvalidParameter.%s	The specified field %s invalid. Please check it again.

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.