Obtener configuración de Active Directory

Versión del producto: 10.11

Último modificado: 31 julio 2024

Obtiene la configuración de múltiples ADs.

Nota

En caso de que NAKIVO Backup & Replication se haya instalado en modo multiinquilino, el uso de la API sólo es posible para el inquilino principal.

Punto final

https://<Director_IP_address>:4443/c/router

Punto final inquilino

Para los inquilinos del producto multi-tenant el punto final debe ser:

https://<Dirección_IP_director>:4443/t/<tenant_UUID>/c/router

Ejemplo de solicitud

rizo

Copiar

{
  "action": "ADDomainManagement",
  "method": "getListADDomains",
  "data": [
    {
      "filter": {
        "start": 0,
        "count": 20,
        "useUnlimitedCount": false,
        "sort": "name",
        "sortAsc": true,
        "sorts": null,
        "sortsAsc": null,
        "criteria": [
          {
            "type": "OR",
            "name": null,
            "value": null,
            "values": null,
            "criteria": [
              {
                "type": "EQ",
                "name": "STATE",
                "value": "ENABLED",
                "values": null,
                "criteria": null
              },
              {
                "type": "EQ",
                "name": "STATE",
                "value": "DISABLED",
                "values": null,
                "criteria": null
              }
            ]
          }
        ]
      }
    }
  ],
  "type": "rpc",
  "tid": 1
}

Campos de solicitud

Campo	Tipo	Valor(es)
`action`	string	`ADDomainManagement`
`method`	string	`getListADDomains`
`data`	null
`type`	string	`rpc`
`tid`	integer	`1`

Filtrar

Campo	Valor	Descripción
`start`	int	Un ID de inicio de los dominios AD a devolver
`count`	int	Número de dominios AD a devolver
`useUnlimitedCount`	boolean	Si se va a utilizar un recuento ilimitado, entonces `%s` `dfsdf` `%2870%lkjlkj%`, `false` en caso contrario
`sort`	string	Parámetro de dominio AD que debe ordenarse con
`sortAsc`	boolean	`true` si el orden es ascendente
`criteria`	array	Filtrar criterios. Véanse las filas siguientes
`type`	string	Tipo de criterio
`name`	string	Nombre del criterio
`type`	string	Tipo de criterio. `EQ` significa el operador relacional de igualdad
`value`	string	Valor del criterio
`values`	string	Valores del criterio

Muestra de respuesta

rizo

Copiar

{
  "action": "ADDomainManagement",
  "method": "getListADDomains",
  "tid": "1",
  "type": "rpc",
  "message": null,
  "where": null,
  "cause": null,
  "data": {
    "children": [{
      "id": 5,
      "domainName": "adtestvn.local",
      "preferredDc": "10.30.30.1",
      "username": "administrator",
      "password": null,
      "integratedGroups": "users,domain users",
      "refreshInMinutes": 60,
      "useLdaps": false,
      "changeExistingPreferredDc": true,
      "locked": false,
      "lockReasons": [],
      "disabled": false,
      "connected": true,
      "alertErrorCode": null,
      "alertTitle": null,
      "alertDescription": null
    }],
    "totalCount": 2}
}

Datos

Campo	Valor	Descripción
`domainName`	string	Dominio AD
`preferredDc`	string	DC/Host preferido (opcional)
`username`	string	Nombre de usuario
`password`	string	Contraseña
`integratedGroups`	string	Lista de grupos integrados
`refreshInMinutes`	número	Número de minutos en los que el sistema obtendrá datos de AD
`useLdaps`	boolean	Si se van a utilizar LDAP al conectarse al Directorio Activo, entonces `%s` `dfsdf` `%2870%lkjlkj%`, `false` de lo contrario
`changeExistingPreferredDc`	boolean	Permite eliminar los datos antiguos de la configuración existente. Sólo es relevante si cambia el valor de "DC preferido" pero conserva el valor en "nombre de dominio".
`locked`	boolean	Comprueba si el elemento está bloqueado por alguna tarea
`lockReasons`	boolean	Motivos por los que el elemento está bloqueado por alguna tarea
`disabled`	boolean	Si el dominio AD está desactivado, entonces `%s` `dfsdf` `%2870%lkjlkj%`, `false` de lo contrario
`connected`	boolean	Si puede conectarse al dominio AD, entonces `%s` `dfsdf` `%2870%lkjlkj%`, `false` de lo contrario
`alertErrorCode`	null
`alertTitle`	null
`alertDescription`	null
`totalCount`	número	Número de dominios AD devueltos