Esta página fue traducida automáticamente. Si detectas un error, selecciónalo y presiona Ctrl+Enter para informarlo a los editores.

Objeto de interfaz de equipo

Los siguientes objetos están directamente relacionados con la API hostinterface.

Interfaz de host

El objeto de interfaz de host tiene las siguientes propiedades.

Tenga en cuenta que las propiedades ip y dns son obligatorias para las operaciones de creación. Si no desea usar DNS, establézcalo como una cadena vacía.

Propiedad Tipo Descripción
interfaceid ID ID de la interfaz.

Comportamiento de la propiedad:
- solo lectura
- obligatorio para operaciones de actualización
available entero Disponibilidad de la interfaz de host.

Valores posibles:
0 - (por defecto) desconocido;
1 - disponible;
2 - no disponible.

Comportamiento de la propiedad:
- solo lectura
hostid ID ID del host al que pertenece la interfaz.

Comportamiento de la propiedad:
- constante
- obligatorio para operaciones de creación
type entero Tipo de interfaz.

Valores posibles:
1 - Agente;
2 - SNMP;
3 - IPMI;
4 - JMX.

Comportamiento de la propiedad:
- obligatorio para operaciones de creación
ip cadena Dirección IP utilizada por la interfaz.

Puede estar vacía si la conexión se realiza mediante DNS.

Comportamiento de la propiedad:
- obligatorio para operaciones de creación
dns cadena Nombre DNS utilizado por la interfaz.

Puede estar vacío si la conexión se realiza mediante IP.

Comportamiento de la propiedad:
- obligatorio para operaciones de creación
port cadena Número de puerto utilizado por la interfaz.
Puede contener macros de usuario.

Comportamiento de la propiedad:
- obligatorio para operaciones de creación
useip entero Indica si la conexión debe realizarse mediante IP.

Valores posibles:
0 - conectar usando el nombre DNS del host;
1 - conectar usando la dirección IP del host.

Comportamiento de la propiedad:
- obligatorio para operaciones de creación
main entero Indica si la interfaz se utiliza como predeterminada en el host. Solo una interfaz de un tipo determinado puede establecerse como predeterminada en un host.

Valores posibles:
0 - no predeterminada;
1 - predeterminada.

Comportamiento de la propiedad:
- obligatorio para operaciones de creación
details objeto Objeto detalles adicional para la interfaz.

Comportamiento de la propiedad:
- obligatorio si type se establece en "SNMP"
disable_until marca de tiempo La siguiente hora de sondeo de una interfaz de host no disponible.

Comportamiento de la propiedad:
- solo lectura
error cadena Texto de error si la interfaz de host no está disponible.

Comportamiento de la propiedad:
- solo lectura
errors_from marca de tiempo Hora en que la interfaz de host dejó de estar disponible.

Comportamiento de la propiedad:
- solo lectura

Detalles

El objeto details tiene las siguientes propiedades.

Propiedad Tipo Descripción
version entero Versión de la interfaz SNMP.

Valores posibles:
1 - SNMPv1;
2 - SNMPv2c;
3 - SNMPv3.

Comportamiento de la propiedad:
- requerido
bulk entero Indica si se deben usar solicitudes SNMP bulk.

Valores posibles:
0 - no usar solicitudes bulk;
1 - (por defecto) - usar solicitudes bulk.
community cadena Comunidad SNMP. Se utiliza solo en las interfaces SNMPv1 y SNMPv2.

Comportamiento de la propiedad:
- requerido si version está establecido en "SNMPv1" o "SNMPv2c"
max_repetitions entero Valor máximo de repetición para solicitudes SNMP bulk nativas (GetBulkRequest-PDUs).
Se utiliza solo para los elementos discovery[] y walk[] en SNMPv2 y v3.

Por defecto: 10.
securityname cadena Nombre de seguridad SNMPv3. Se utiliza solo en las interfaces SNMPv3.
securitylevel entero Nivel de seguridad SNMPv3. Se utiliza solo en las interfaces SNMPv3.

Valores posibles:
0 - (por defecto) - noAuthNoPriv;
1 - authNoPriv;
2 - authPriv.
authpassphrase cadena Frase de autenticación SNMPv3. Se utiliza solo en las interfaces SNMPv3.
privpassphrase cadena Frase de privacidad SNMPv3. Se utiliza solo en las interfaces SNMPv3.
authprotocol entero Protocolo de autenticación SNMPv3. Se utiliza solo en las interfaces SNMPv3.

Valores posibles:
0 - (por defecto) - MD5;
1 - SHA1;
2 - SHA224;
3 - SHA256;
4 - SHA384;
5 - SHA512.
privprotocol entero Protocolo de privacidad SNMPv3. Se utiliza solo en las interfaces SNMPv3.

Valores posibles:
0 - (por defecto) - DES;
1 - AES128;
2 - AES192;
3 - AES256;
4 - AES192C;
5 - AES256C.
contextname cadena Nombre de contexto SNMPv3. Se utiliza solo en las interfaces SNMPv3.