[comment]: # ({53d969c5-f9e8f670})
# userdirectory.get

[comment]: # ({/53d969c5-f9e8f670})

[comment]: # ({f09e8f55-b5ff62ed})
### Apraksts

`integer/array userdirectory.get(object parameters)`

Metode ļauj izgūt lietotāju direktorijus atbilstoši norādītajiem parametriem.

::: noteclassic
Šī metode ir pieejama tikai *Super admin* lietotāju tipiem.
:::

[comment]: # ({/f09e8f55-b5ff62ed})

[comment]: # ({31957bd5-d99c84a0})
### Parametri

`(object)` Parametri, kas definē vēlamo izvadi.

Metode atbalsta šādus parametrus.

|Parameter|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|userdirectoryids|ID/array|Atgriezt tikai lietotāju direktorijas ar norādītajiem ID.|
|selectUsrgrps|query|Atgriezt `usrgrps` īpašību ar [lietotāju grupām](/manual/api/reference/usergroup/object), kas saistītas ar lietotāju direktoriju.<br><br>Atbalsta `count`.|
|selectProvisionMedia|query|Atgriezt `provision_media` īpašību ar [multivides tipu kartējumiem](/manual/api/reference/userdirectory/object#media-type-mappings), kas saistīti ar lietotāju direktoriju.|
|selectProvisionGroups|query|Atgriezt `provision_groups` īpašību ar [nodrošināšanas grupu kartējumiem](/manual/api/reference/userdirectory/object#provisioning-groups-mappings), kas saistīti ar lietotāju direktoriju.|
|sortfield|string/array|Kārtot rezultātu pēc norādītajām īpašībām.<br><br>Iespējamās vērtības: `name`.|
|filter|object|Atgriezt tikai tos rezultātus, kas precīzi atbilst norādītajam filtram.<br><br>Pieņem objektu, kur atslēgas ir īpašību nosaukumi, bet vērtības ir vai nu viena vērtība, vai vērtību masīvs.<br><br>Atbalsta īpašības: `userdirectoryid`, `idp_type`, `provision_status`.|
|search|object|Atgriezt rezultātus, kas atbilst norādītajam paraugam (nav reģistrjutīgs).<br><br>Pieņem objektu, kur atslēgas ir īpašību nosaukumi, bet vērtības ir virknes, kuras meklēt. Ja papildu opcijas nav norādītas, tiks veikta `LIKE "%…%"` meklēšana.<br><br>Atbalstītās īpašības: `name`, `description`.<br><br>SAML tipa lietotāju direktorijai abām īpašībām `name` un `description` būs tukša vērtība. Abas īpašības var mainīt ar `userdirectory.update` darbību.|
|countOutput|boolean|Šie parametri ir aprakstīti [atsauces komentāros](/manual/api/reference_commentary#common-get-method-parameters).|
|excludeSearch|boolean|^|
|limit|integer|^|
|output|query|^|
|preservekeys|boolean|^|
|searchByAny|boolean|^|
|searchWildcardsEnabled|boolean|^|
|sortorder|string/array|^|
|startSearch|boolean|^|

[comment]: # ({/31957bd5-d99c84a0})

[comment]: # ({7223bab1-a18ff82b})
### Atgrieztās vērtības

`(integer/array)` Atgriež vienu no šiem:

-   objektu masīvu;
-   izgūto objektu skaitu, ja ir izmantots parametrs `countOutput`.

[comment]: # ({/7223bab1-a18ff82b})

[comment]: # ({b41637d2-ba1c8d4c})
### Piemēri

[comment]: # ({/b41637d2-ba1c8d4c})

[comment]: # ({dee71092-6acef378})
##### Lietotāju direktoriju izgūšana

Izgūstiet visas lietotāju direktorijas ar papildu īpašībām, kas parāda multivides tipu kartējumus un nodrošināšanas grupu kartējumus, kuri saistīti ar katru lietotāju direktoriju.

[Pieprasījums](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "userdirectory.get",
    "params": {
        "output": "extend",
        "selectProvisionMedia": "extend",
        "selectProvisionGroups": "extend"
    },
    "id": 1
}
```

Atbilde:

```json
{
    "jsonrpc": "2.0",
    "result": [
       {
            "userdirectoryid": "1",
            "idp_type": "2",
            "name": "",
            "provision_status": "1",
            "description": "",
            "group_name": "groups",
            "user_username": "",
            "user_lastname": "",
            "idp_entityid": "http://example.com/simplesaml/saml2/idp/metadata.php",
            "sso_url": "http://example.com/simplesaml/saml2/idp/SSOService.php",
            "slo_url": "",
            "username_attribute": "uid",
            "sp_entityid": "zabbix",
            "nameid_format": "",
            "sign_messages": "0",
            "sign_assertions": "0",
            "sign_authn_requests": "0",
            "sign_logout_requests": "0",
            "sign_logout_responses": "0",
            "encrypt_nameid": "0",
            "encrypt_assertions": "0",
            "scim_status": "1",
            "provision_media": [
                {
                    "userdirectory_mediaid": "1",
                    "name": "example.com",
                    "mediatypeid": "1",
                    "attribute": "user@example.com",
                    "active": "0",
                    "severity": "63",
                    "period": "1-7,00:00-24:00"
                }
            ],
            "provision_groups": [
                {
                    "name": "*",
                    "roleid": "1",
                    "user_groups": [
                        {
                            "usrgrpid": "13"
                        }
                    ]
                }
            ]
        },
        {
            "userdirectoryid": "2",
            "idp_type": "1",
            "name": "AD serveris",
            "provision_status": "1",
            "description": "",
            "host": "host.example.com",
            "port": "389",
            "base_dn": "DC=zbx,DC=local",
            "search_attribute": "sAMAccountName",
            "bind_dn": "CN=Admin,OU=Users,OU=Zabbix,DC=zbx,DC=local",
            "start_tls": "0",
            "search_filter": "",
            "group_basedn": "OU=Zabbix,DC=zbx,DC=local",
            "group_name": "CN",
            "group_member": "member",
            "group_filter": "(%{groupattr}=CN=%{ref},OU=Users,OU=Zabbix,DC=zbx,DC=local)",
            "group_membership": "",
            "user_username": "givenName",
            "user_lastname": "sn",
            "user_ref_attr": "CN",
            "provision_media": [
                {
                    "userdirectory_mediaid": "2",
                    "name": "example.com",
                    "mediatypeid": "1",
                    "attribute": "user@example.com",
                    "active": "0",
                    "severity": "63",
                    "period": "1-7,00:00-24:00"
                }
            ],
            "provision_groups": [
                {
                    "name": "*",
                    "roleid": "4",
                    "user_groups": [
                        {
                            "usrgrpid": "8"
                        }
                    ]
                },
                {
                    "name": "Zabbix administratori",
                    "roleid": "2",
                    "user_groups": [
                        {
                            "usrgrpid": "7"
                        },
                        {
                            "usrgrpid": "8"
                        }
                    ]
                }
            ]
        },
        {
            "userdirectoryid": "3",
            "idp_type": "1",
            "name": "LDAP API serveris #1",
            "provision_status": "0",
            "description": "",
            "host": "ldap://local.ldap",
            "port": "389",
            "base_dn": "ou=Users,dc=example,dc=org",
            "search_attribute": "uid",
            "bind_dn": "cn=ldap_search,dc=example,dc=org",
            "start_tls": "1",
            "search_filter": "",
            "group_basedn": "",
            "group_name": "",
            "group_member": "",
            "group_filter": "",
            "group_membership": "",
            "user_username": "",
            "user_lastname": "",
            "user_ref_attr": "",
            "provision_media": [],
            "provision_groups": []
        }
    ],
    "id": 1
}
```

[comment]: # ({/dee71092-6acef378})

[comment]: # ({860ec55f-5f3bc200})
### Skatiet arī

-   [Lietotāju grupa](/manual/api/reference/usergroup/object#user)

[comment]: # ({/860ec55f-5f3bc200})

[comment]: # ({901c82dd-392498dd})
### Avots

CUserDirectory::get() failā *ui/include/classes/api/services/CUserDirectory.php*.

[comment]: # ({/901c82dd-392498dd})