VK Private Cloud logo
Помощь
Обновлена 17 июля 2026 г. в 15:55

Управление пространствами имён Marketplace

Создание тестового пространства имён

Чтобы в Marketplace создать тестовое пространство имён, выполните запрос с параметрами из таблицы 1.

Таблица 1 — Параметры запроса на создание тестового пространства имён

Параметр

Значение

Метод запроса

POST

Путь запроса

https://<CLOUD_HOST>/marketplace/api/catalog/v1/catalog/space

где <CLOUD_HOST> — доменное имя Платформы

Content-Type

application/json

Тело запроса (--data)

Задайте параметры:

  • name — название тестового пространства имён.
  • type — тип пространства. Укажите test_ns

Authorization

<JWT_TOKEN> — JWT-токен администратора Платформы (подробнее — в разделе Авторизация в Marketplace под учётной записью администратора Платформы)

Пример запроса на создание тестового пространства имён
$ curl -v -X POST https://<CLOUD_HOST>/marketplace/api/catalog/v1/catalog/space \-H "Content-Type: application/json" \-H 'Authorization: Bearer <JWT_TOKEN>' \--data '{  "name": "vk_test_ns",  "type": "test_ns"  }'

HTTP-коды ответа приведены в таблице 2.

Таблица 2 — HTTP-коды ответа

Код

Описание

201

Тестовое пространство имён создано

404, 422

Ошибка выполнения запроса

Создание открытого пространства имён

Чтобы в Marketplace создать открытое пространство имён, выполните запрос с параметрами из таблицы 3.

Таблица 3 — Параметры запроса на создание открытого пространства имён

Параметр

Значение

Метод запроса

POST

Путь запроса

https://<CLOUD_HOST>/marketplace/api/catalog/v1/catalog/space

где <CLOUD_HOST> — доменное имя Платформы

Content-Type

application/json

Тело запроса (--data)

Задайте параметры:

  • name — название открытого пространства имён.
  • type — тип пространства. Укажите prod_ns

Authorization

<JWT_TOKEN> — JWT-токен администратора Платформы (подробнее — в разделе Авторизация в Marketplace под учётной записью администратора Платформы)

Пример запроса на создание открытого пространства имён
$ curl -v -X POST https://<CLOUD_HOST>/marketplace/api/catalog/v1/catalog/space \-H "Content-Type: application/json" \-H 'Authorization: Bearer <JWT_TOKEN>' \--data '{  "name": "vkcs_ru",  "type": "prod_ns"  }'

HTTP-коды ответа приведены в таблице 4.

Таблица 4 — HTTP-коды ответа

Код

Описание

201

Открытое пространство имён создано

404, 422

Ошибка выполнения запроса

Добавление пользователя Платформы в тестовые и открытые пространства имён

Пользователь, добавленный в тестовое пространство имён, сможет тестировать сервис в Marketplace до его публикации.

Чтобы добавить пользователя Платформы в тестовое или открытое пространство имён Marketplace, выполните запрос с параметрами из таблицы 5.

Таблица 5 — Параметры запроса на добавление пользователя в пространства имён

Параметр

Значение

Метод запроса

POST

Путь запроса

https://<CLOUD_HOST>/marketplace/api/um/v1/user/add_spaces

где <CLOUD_HOST> — доменное имя Платформы

Content-Type

application/json

Тело запроса (--data)

Задайте параметры:

  • email — email пользователя.
  • spaces — список тестовых и открытых пространств имён Marketplace

Authorization

<JWT_TOKEN> — JWT-токен администратора Платформы (подробнее — в разделе Авторизация в Marketplace под учётной записью администратора Платформы)

Пример запроса на добавление пользователя в пространства имён
$ curl -v -X POST https://<CLOUD_HOST>/marketplace/api/um/v1/user/add_spaces \-H "Content-Type: application/json" \-H 'Authorization: Bearer <JWT_TOKEN>' \--data '{  "email": "user@example.ru",  "spaces": [    "vk_test_ns",    "vkcs_ru",    "vk_prod_ns"  ]  }'

HTTP-коды ответа приведены в таблице 6.

Таблица 6 — HTTP-коды ответа

Код

Описание

200

Пользователь добавлен в пространства имён Marketplace

422

Ошибка выполнения запроса

Удаление пользователя Платформы из тестовых и открытых пространств имён

Чтобы удалить пользователя Платформы из тестового или открытого пространства имён Marketplace, выполните запрос с параметрами из таблицы 7.

Таблица 7 — Параметры запроса на удаление пользователя из пространств имён

Параметр

Значение

Метод запроса

POST

Путь запроса

https://<CLOUD_HOST>/marketplace/api/um/v1/user/delete_spaces

где <CLOUD_HOST> — доменное имя Платформы

Content-Type

application/json

Тело запроса (--data)

Задайте параметры:

  • email — email пользователя.
  • spaces — список тестовых и открытых пространств имён Marketplace

Authorization

<JWT_TOKEN> — JWT-токен администратора Платформы (подробнее — в разделе Авторизация в Marketplace под учётной записью администратора Платформы)

Пример запроса на удаление пользователя из пространств имён
$ curl -v -X POST https://<CLOUD_HOST>/marketplace/api/um/v1/user/delete_spaces \-H "Content-Type: application/json" \-H 'Authorization: Bearer <JWT_TOKEN>' \--data '{  "email": "user@example.ru",  "spaces": [    "vk_test_ns",    "vkcs_ru",    "vk_prod_ns"  ]  }'

HTTP-коды ответа приведены в таблице 8.

Таблица 8 — HTTP-коды ответа

Код

Описание

200

Пользователь удалён из пространств имён Marketplace

422

Ошибка выполнения запроса