Получить информацию о правах доступа группы в очереди

Запрос позволяет просмотреть права группы в очереди.

GET

https://api.tracker.yandex.net/v3/queues/<id_очереди>/permissions/groups/<id_группы>

Чтобы настроить доступы к очереди при помощи API, используйте запрос Выдать права доступа к очереди.

Формат запроса

Перед выполнением запроса получите доступ к API.

Для получения информации о правах используйте HTTP-запрос с методом GET.

GET v3/queues/<id_очереди>/permissions/groups/<id_группы>
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>

Заголовки

Host: адрес узла, предоставляющего API.
Authorization: токен для авторизации в одном из форматов:
- OAuth <OAuth-токен> при авторизации по протоколу OAuth 2.0. Читать подробнее
- Bearer <IAM-токен> при авторизации с помощью IAM-токена — если к Трекеру привязана организация Yandex Cloud Organization. Читать подробнее
X-Org-ID или X-Cloud-Org-ID: идентификатор организации.
- Используйте заголовок X-Org-ID, если к Трекеру привязана организация Яндекс 360 для бизнеса.
- Используйте заголовок X-Cloud-Org-ID, если к Трекеру привязана организация Yandex Cloud Organization.
Чтобы узнать идентификатор организации, перейдите на страницу Администрирование → Организации и скопируйте значение поля идентификатор.

Ресурс

Параметр	Описание	Тип данных
<id_очереди>	Идентификатор или ключ очереди. Ключ очереди чувствителен к регистру символов	Строка или число
<идентификатор_группы>	Уникальный идентификатор группы в организации	Число

Формат ответа

Запрос выполнен успешно

Запрос выполнен с ошибкой

В случае успешного выполнения запроса API возвращает ответ с кодом 200 OK.

{
    "group": {
        "self": "https://api.tracker.yandex.net/v3/groups/5",
        "id": "5",
        "display": "All users"
    },
    "permissions": {
        "CREATE": {
            "groups": [
                {
                    "self": "https://api.tracker.yandex.net/v3/groups/5",
                    "id": "5",
                    "display": "All users"
                }
            ]
        },
        ...
    },
    "components": [
        {
            "self": "https://api.tracker.yandex.net/v3/components/1",
            "id": "1",
            "display": "Component 1"
        },
        {...}
    ]
}

Параметры ответа

Параметр	Описание	Тип данных
group	Объект с информацией о группе, для которой выполняется запрос прав	Объект
permissions	Массив объектов с информацией о доступах группы в очереди. Возможные значения: `GRANT`— Настройки очереди; `CREATE`— Создание задач; `READ`— Просмотр задач; `WRITE`— Редактирование задач; `DENY`— доступ запрещен	Массив объектов
groups	Объект с информацией о группе	Объект
components	Массив объектов с информацией о компонентах, к которым у группы есть доступ	Массив объектов

Поля объектов group и groups

Параметр	Описание	Тип данных
self	Адрес ресурса API, который содержит информацию о группе	Строка
id	Идентификатор группы	Строка
display	Отображаемое название группы	Строка

Поля объекта components

Параметр	Описание	Тип данных
self	Адрес ресурса API, который содержит информацию о компоненте	Строка
id	Идентификатор компонента	Строка
display	Отображаемое название компонента	Строка

Если запрос не был успешно обработан, API возвращает ответ с кодом ошибки:

401: Пользователь не авторизован. Проверьте, были ли выполнены действия, описанные в разделе Доступ к API.

403: У вас не хватает прав на выполнение этого действия. Наличие прав можно перепроверить в интерфейсе Трекера — для выполнения действия при помощи API и через интерфейс требуются одинаковые права.

404: Запрошенный объект не был найден. Возможно, вы указали неверное значение идентификатора или ключа объекта.

Была ли статья полезна?

Получить права доступа пользователя в очереди

Создать автодействие