Опубликовано:
GitHub добавила в REST API поиск центра затрат для ресурса
В GitHub REST API появился метод, который находит центр затрат для пользователя, организации, репозитория или команды предприятия без перебора всех центров.
GitHub добавила в REST API метод, который показывает, к какому центру затрат относится пользователь, организация, репозиторий или команда предприятия. Раньше, чтобы это выяснить, приходилось перебирать все центры затрат и проверять их ресурсы по очереди. Ответ нового метода содержит ID и название центра затрат.
Центры затрат помогают распределять расходы на GitHub между подразделениями: к ним привязывают пользователей, организации и репозитории, чтобы видеть, какая команда сколько тратит на платформе. Новый запрос принимает тип и имя ресурса и возвращает нужную привязку. Если ресурс не входит ни в один центр затрат, массив memberships в ответе останется пустым.
Доступ к методу зависит от роли. Владельцы предприятия, биллинг-менеджеры и GitHub Apps с правом чтения биллинга предприятия могут искать любой ресурс в пределах предприятия. Владельцам организаций и пользователям с кастомными ролями, где есть такое же право, доступны только те ресурсы и центры затрат, которые они и так видят.
Как отправить запрос, описано в документации REST API в разделе Get cost center membership for a resource. Новый метод дополняет существующую работу с центрами затрат через API и не требует ручного просмотра списка центров.