# Активные регистрации SIP-устройств

Данный объект отображает статистику по регистрациям учетных записей SIP и предоставляет возможность удалить (сбросить) определенную регистрацию.

### Метод active

Отображает учетные записи SIP, которые в данный момент зарегистрированы в запрашиваемом КД.

![](/files/-MILEgS2voBqY2YSB5Z9)

| **Название**    | **Описание**                                                                                                                                                                                                                              |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Название Домена | <p>Домен, в котором будет выполнен запрос.</p><p>Применяется если произведен вход в Мастер-Домен, а сбросить регистрацию надо в каком-то дочернем КД.</p><p>Либо если вход в КД, а получить данные надо по одному из его дочерних КД.</p> |

Основные поля в ответе:

•             **username** - имя пользователя учетной записи SIP

•             **addr** - IP-адрес SIP-клиента, если SIP-клиент за NAT, то отображается локальный внутренний адрес.

•             **expires** - время до момента перерегистрации

•             **path.domain** - IP-адрес SG

•             **path.port** - порт назначения, который использует SG для приема пакетов

•             **path.proto** - внутренний транспортный протокол между SG и B2BUA, всегда = TCP

•             **path.user** - внутренний идентификатор учетной записи SIP

•             **port** - исходящий порт, с которого SIP-клиент отправляет пакеты

•             **proto** - транспортный протокол, используемый между SIP-клиентом и SG

### Метод unregistered

Позволяет отобразить все незарегистрированные учетные записи по КД.

Если в запросе не указан desttd, то domain = домен,в котором делается запрос. Если desttd указан, то значение подставляется в поле domain

![](/files/-MILEwHqvSyGy76msQHM)

| **Название**    | **Описание**                                                                                                                      |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| Название Домена | Домен, в котором будет выполнен запрос. Применяется если вход в Мастер-Домен, а сбросить регистрацию надо в каком-то дочернем КД. |

Основные поля в ответе:

* **sipusers: username** - имя пользователя учетной записи, которая в данный момент не зарегистрирована в КД.

### Метод count

Отображает количество всех зарегистрированных учетных записей у запрашиваемого КД и всех его дочерних доменов.

![](/files/-MILF7rxOSyTfs2AzSpm)

| **Название**    | **Описание**                                                                                                                      |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| Название Домена | Домен, в котором будет выполнен запрос. Применяется если вход в Мастер-Домен, а сбросить регистрацию надо в каком-то дочернем КД. |

Основные поля в ответе:

* **total** - общее количество зарегистрированных учетных записей SIP
* **domains** - распределение регистраций по доменам

### Метод delete

Позволяет удалить все регистрации конкретной учетной записи SIP user\@domain или определенные регистрации пользователя udp:192.168.10.18:5062 у user\@domain

Если в запросе не указан desttd, то domain = домен,в котором делается запрос.\
Если desttd указан, то значение подставляется в поле domain

![](/files/-MILFMhFKRk4kI7QBOT-)

| **Название**    | **Описание**                                                                                                                                                                                      |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Название Домена | <p>Домен, в котором будет выполнен запрос.<br>Применяется если произведен вход в Мастер-Домен, а сбросить регистрацию надо в каком-то дочернем КД.</p>                                            |
| SIP Login       | Имя пользователя учетной записи SIP, у которой необходимо сбросить регистрацию                                                                                                                    |
| Контакты        | Указывается в формате proto:IP:Port если надо сбросить определенную регистрацию (-ии) у пользователя. Возможно указать несколько через запятую. Пример, udp:192.168.1.1:5060,tcp:192.168.2.2:5060 |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.axatel.by/administrirovanie-telefonnoi-stancii/pr-monitoring/aktivnye-registracii-sip-ustroistv.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.