- tocdepth
2
Управление каталогами
Каталоги позволяют группировать проекты и формировать группы под определенные задачи.
Примечание
Добавлять новые каталоги и управлять созданными может только администратор организации.
Список операций
Добавить новый каталог
Каталог используется для группировки проектов облака.
Чтобы создать каталог, выполните следующие действия:
Перейдите в раздел Администрирование, на вкладку Каталоги и проекты.
Нажмите Создать каталог.
Укажите название каталога.
Нажмите Создать.
Выполните запрос для проверки organization-unit
curl -X GET "https://iam.api.cloud.ru/api/v1/organization-unit?customer_ids=158a64c8-3567-41fe-b2b7-43ad1f176057" -H "accept: application/json" -H "Authorization: Bearer $TOKEN"
Отобразится список каталогов, которые принадлежат
customer_id.Выполните запрос для создания каталога
curl -X POST "https://iam.api.cloud.ru/api/v1/organization-unit" -H "accept: application/json" -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" -d "{ \"customer_id\": \"158a64c8-3567-41fe-b2b7-43ad1f176057\", \"name\": \"Департамент\"}"
В теле запроса укажите следующие параметры:
customer_id— идентификатор пользователя;name— наименование каталога;description— описание каталога.
{ "customer_id": "158a64c8-3567-41fe-b2b7-43ad1f176057", "name": "Новый каталог", "description": "Описание нового каталога" }
Изменить данные каталога
Перейдите в раздел Администрирование, на вкладку Каталоги и проекты.
В строке с каталогом нажмите
и выберите Редактировать.Измените название каталога.
Нажмите Сохранить.
Выполните запрос для изменения параметров каталога
curl -X PATCH "https://iam.api.cloud.ru/api/v1/organization-unit/id" -H "Authorization: Bearer $TOKEN"
В теле запроса измените следующие параметры:
name— название каталога;description— описание каталога.
{ "name": "Обновленный каталог через API", "description": "Описание обновленного каталога через API" }
Удалить каталог
Примечание
Если у этого каталога есть проекты, то удалить каталог нельзя.
При удалении каталога будут безвозвратно удалены все ресурсы, которые находятся внутри каталога, а также все доступы на него.
Перейдите в раздел Администрирование, на вкладку Каталоги и проекты.
Нажмите на название каталога, в котором хотите удалить проект.
В строке с каталогом нажмите
и выберите Удалить.
Выполните запрос
curl -X DELETE "https://iam.api.cloud.ru/api/v1/organization-unit/id" -H "Authorization: Bearer $TOKEN"
Где:
id— идентификатор каталога.
Посмотреть список каталогов
Перейдите в раздел Администрирование, на вкладку Каталоги и проекты.
Откроется список каталогов.
Выполните запрос для проверки organization-unit
curl -X GET "https://iam.api.cloud.ru/api/v1/organization-unit?customer_ids=158a64c8-3567-41fe-b2b7-43ad1f176057" -H "accept: application/json" -H "Authorization: Bearer $TOKEN"
В теле запроса передайте следующие параметры:
customer_ids— идентификатор пользователя;page_filter.limit— фильтр пагинации позволяет задавать количество объектов на странице;page_filter.page— фильтр пагинации позволяет задавать номер страницы для отображения;organization_unit_ids— идентификатор каталога.
Отобразится список каталогов, которые принадлежат
customer_id.
для Dev & Test