- tocdepth
2
Управление проектами
Проекты позволяют распределять облачные ресурсы между проектными задачами и командами. В каждом проекте можно подключать только нужные платформы и сервисы.
Примечание
Добавлять новые проекты может только администратор организации. Управлять ресурсами и пользователями внутри проекта может назначенный администратор проекта.
Список операций
Добавить новый каталог
Каталог используется для группировки проектов облака.
Чтобы создать каталог, выполните следующие действия:
Перейдите в раздел Администрирование, на вкладку Каталоги и проекты.
Нажмите Создать каталог.
Укажите название каталога.
Нажмите Создать.
Добавить новый проект
Перейдите в раздел Администрирование, на вкладку Каталоги и проекты.
Нажмите на название каталога, в котором хотите создать проект.
Нажмите Создать проект.
Укажите название проекта и каталог для него.
Нажмите Создать.
Либо создайте проект через список проектов:
В верхней панели меню раскройте список всех проектов.
Нажмите Создать проект под списком проектов.
Укажите название проекта и выберите каталог для него.
Нажмите Создать.
Проект появится в списке всех проектов. Теперь вы можете перейти в него, подключить нужные сервисы и добавить пользователей.
Выполните запрос для проверки projects
curl -X GET "https://https://iam.api.cloud.ru/api/v1/projects?customer_ids=158a64c8-3567-41fe-b2b7-43ad1f176057&organization_unit_ids=a7bdc4ab-5edd-4034-bdaa-ac814e3c1049" -H "accept: application/json" -H "Authorization: Bearer $TOKEN"
Отобразится список проектов, которые принадлежат указанному каталогу.
Выполните запрос для задания проекта:
curl -X POST "https://https://iam.api.cloud.ru/api/v1/projects" -H "accept: application/json" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d "{ \"organization_unit_id\": \"73bca50a-708e-40fb-99dc-\", \"name\": \"Каталог\"}"
В теле запроса укажите:
name— наименование проекта;description— описание проекта;organization_unit_id— идентификатор каталога.
{ "name": "Новый проект", "description": "Описание нового проекта", "organization_unit_id": "73bca50a-708e-40fb-99dc-" }
Скопировать ID проекта
ID проекта может пригодиться вам при обращениях в поддержку или при работе с API Cloud.ru.
Чтобы скопировать ID проекта:
В верхней панели меню раскройте список всех проектов.
В строке с проектом нажмите
и выберите Скопировать ID проекта.ID будет скопирован в буфер обмена.
Просмотреть и скопировать ID любого проекта можно также в разделе Администрирование, на вкладке Каталоги и проекты.
См.также
Изменить данные проекта
Перейдите в раздел Администрирование, на вкладку Каталоги и проекты.
Нажмите на название каталога, в котором хотите изменить проект.
В строке с проектом нажмите
и выберите Редактировать.Измените данные проекта.
Нажмите Сохранить.
Либо измените проект через список проектов:
В верхней панели меню раскройте список всех проектов.
Найдите нужный проект.
Наведите на проект и нажмите
.Отредактируйте данные проекта и нажмите Сохранить.
Выполните запрос для изменения параметров проекта
curl -X PATCH "https://https://iam.api.cloud.ru/api/v1/projects/id" -H "Authorization: Bearer $TOKEN"
В теле запроса измените:
name— название проекта;description— описание проекта;organization_unit_id— идентификатор каталога.
{ "name": "Обновленный проект", "description": "Описание обновленного проекта", "organization_unit_id": "73bca50a-708e-40fb-99dc-" }
Удалить проект
Внимание
При удалении проекта все пользователи будут удалены из него, а подключенные сервисы и их ресурсы — остановлены. Восстановить проект после удаления нельзя.
Перейдите в раздел Администрирование, на вкладку Каталоги и проекты.
Нажмите на название каталога, в котором хотите удалить проект.
В строке с проектом нажмите
и выберите Удалить.
Либо удалите проект через список проектов:
В верхней панели меню раскройте список всех проектов.
Найдите нужный проект.
Наведите на проект и нажмите
.Нажмите Удалить проект.
Подтвердите удаление.
Выполните запрос
curl -X DELETE "https://https://iam.api.cloud.ru/api/v1/projects/id" -H "Authorization: Bearer $TOKEN"
Где:
id— идентификатор проекта.
Посмотреть список проектов
Перейдите в раздел Администрирование, на вкладку Каталоги и проекты.
Нажмите на название каталога.
Откроется список проектов.
Выполните запрос для проверки projects
curl -X GET "https://https://iam.api.cloud.ru/api/v1/projects?customer_ids=158a64c8-3567-41fe-b2b7-43ad1f176057&organization_unit_ids=a7bdc4ab-5edd-4034-bdaa-ac814e3c1049" -H "accept: application/json" -H "Authorization: Bearer $TOKEN"
В теле запроса передайте следующие параметры:
status— статус проекта;page_filter.limit— фильтр пагинации позволяет задавать количество объектов на странице;page_filter.page— фильтр пагинации позволяет задавать номер страницы для отображения;project_ids— идентификатор проекта;customer_ids— идентификатор пользователя;organization_unit_ids— идентификатор каталога.
Отобразится список проектов, которые принадлежат указанному organization-unit.
Проверить доступ к проекту
curl --location 'https://iam.api.cloud.ru/api/v1/projects/<projectId>/users?limit=100' \
--header 'accept: application/json' \
--header 'Authorization: Bearer ey***Ag'
Где:
projectId— Идентификатор проекта.email— Электронная почта пользователя. Поиск может выполняеться по частичному совпадению.username— Имя пользователя. Поиск может выполняеться по частичному совпадению.limit— Количество записей на странице:Если указан 0, будут выведены все записи, удовлетворяющие запросу.
Если параметр пустой, будет выведено по 1 000 записей на страницу.
before— Курсор для получения предыдущей страницы пользователей.after— Курсор для получения следующей страницы пользователей.
Пример ответа
{ "users": [ { "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx", "email": "ivanovivan@gmail.com", "user_name": "ivanovivan@gmail.com" }, { "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx", "email": "ivanovivan@gmail.com", "user_name": "ivanovivan@gmail.com" } ], "limit": 100, "cursor": { "before": "", "after": "" } }
для Dev & Test