Хостинг /v2/
- Список SSH-ключей
- Загрузка нового SSH-ключа в контейнер
- Загрузка существующего SSH-ключа в контейнер
- Удаление SSH-ключа из контейнера
Список SSH-ключей
URL: /api/v2/hosting/containers/{id}/ssh/
Метод: GET
Результат: JSON
ВНИМАНИЕ! Данный метод выводит ключи только для указанного контейнера.
Также есть метод, позволяющий получить список всех ssh-ключей пользователя.
Он размещен в разделе SSH-ключи
Параметры запроса
Обязательные параметры:
id
:int
– ID контейнера
Коды ответов
Код | Описание |
---|---|
200 | Успешный запрос |
404 | Контейнер не найден |
Возвращаемое значение
entities
– Список ssh-ключейid
:int
– Идентификатор ключа.name
:str
– Имя ключа.key
:str
– Публичный ключ в формате OpenSSH.created
:datetime
– Дата создания ключа.updated
:datetime
– Дата изменения ключа.fingerprint
:str
– Отпечаток SSH-ключа.
Пример запроса
curl --request GET 'https://api-ms.netangels.ru/api/v2/hosting/containers/{id}/ssh/' \
--header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"
Загрузка нового SSH-ключа в контейнер
URL: /api/v2/hosting/containers/{id}/ssh/create/
Метод: POST
Результат: JSON
Параметры запроса
Обязательные параметры:
id
:int
– ID контейнера
Параметры тела запроса
Обязательные параметры:
key
:str
– SSH-ключ
Необязательные параметры:
name
:str
– Имя SSH-ключа
Коды ответов
Код | Описание |
---|---|
200 | Успешный запрос |
400 | Неправильный или уже существующий SSH ключ |
404 | Контейнер не найден |
Возвращаемое значение
SSH-ключ
id
:int
– Идентификатор ключа.name
:str
– Имя ключа.key
:str
– Публичный ключ в формате OpenSSH.created
:datetime
– Дата создания ключа.updated
:datetime
– Дата изменения ключа.fingerprint
:str
– Отпечаток SSH-ключа.
Пример запроса
curl --request POST 'https://api-ms.netangels.ru/api/v2/hosting/containers/{id}/ssh/create/' \
--header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY" \
--header "Content-Type: application/json" \
--data '{
"key": "ssh-rsa Hridf9...jstJFHE user@laptop",
"name": "рабочий ПК"
}'
Загрузка существующего SSH-ключа в контейнер
URL: /api/v2/hosting/containers/{id}/ssh/upload/
Метод: POST
Результат: JSON
Параметры запроса
Обязательные параметры:
id
:int
– ID контейнера
Параметры тела запроса
Обязательные параметры:
key_id
:int
– Идентификатор SSH-ключа
Коды ответов
Код | Описание |
---|---|
200 | Успешный запрос |
404 | Не найден SSH ключ |
400 | Данные в запросе имеют неверный формат или отсутствуют обязательные параметры |
Возвращаемое значение
SSH-ключ
id
:int
– Идентификатор ключа.name
:str
– Имя ключа.key
:str
– Публичный ключ в формате OpenSSH.created
:datetime
– Дата создания ключа.updated
:datetime
– Дата изменения ключа.fingerprint
:str
– Отпечаток SSH-ключа.
Пример запроса
curl --request POST 'https://api-ms.netangels.ru/api/v2/hosting/containers/{id}/ssh/upload/' \
--header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY" \
--header "Content-Type: application/json" \
--data '{
"key_id": 12
}'
Удаление SSH-ключа из контейнера
URL: /api/v2/hosting/containers/{id}/ssh/{key_id}/
Метод: DELETE
Результат: JSON
Параметры запроса
Обязательные параметры:
id
:int
– ID контейнераkey_id
:int
– ID SSH-ключ
Коды ответов
Код | Описание |
---|---|
200 | Успешный запрос |
404 | Ключ или контейнер не найден |
Возвращаемое значение
SSH-ключ
id
:int
– Идентификатор ключа.name
:str
– Имя ключа.key
:str
– Публичный ключ в формате OpenSSH.created
:datetime
– Дата создания ключа.updated
:datetime
– Дата изменения ключа.fingerprint
:str
– Отпечаток SSH-ключа.
Пример запроса
curl --request DELETE 'https://api-ms.netangels.ru/api/v2/hosting/containers/{id}/ssh/{key_id}/' \
--header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"