Управление версиями секретов

Получить список версий

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите Secret Manager.
Нажмите на имя нужного секрета.

Откроется страница с информацией о секрете, где будет блок Версии секрета.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Получите идентификатор секрета:
bash
```
1
mws secretmanager secret list
```

Получите список версий:

1
mws secretmanager secret-version list --name <идентификатор секрета>

1
+------------------------+--------------+----------------------+--------+
2
|          NAME          | DISPLAY NAME |        CREATED       | ACTIVE |
3
+------------------------+--------------+----------------------+--------+
4
| <идентификатор версии> |              | 2025-10-24T07:56:20Z | true   |
5
+------------------------+--------------+----------------------+--------+

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Получите идентификатор секрета:

1
curl -X GET https://secretmanager.mwsapis.ru/secretmanager/v1/projects/<имя проекта>/secrets \
2
-H "Authorization: Bearer <IAM-токен>" \
3
-H "Content-Type: application/json"

Получите список версий:
bash
```
1
curl -X GET https://secretmanager.mwsapis.ru/secretmanager/v1/projects/<имя проекта>/secrets/<идентификатор секрета>/secretVersions \
2
-H "Authorization: Bearer <IAM-токен>" \
3
-H "Content-Type: application/json"
```
Если запрос был успешно принят, вы получите ответ с кодом 200 OK. В ответе будет выведен список версий секретов с детализацией параметров.

Получить информацию о версии

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите Secret Manager.
Нажмите на имя нужного секрета.

Откроется страница с информацией о секрете. В блоке Версии секрета отображаются все версии секрета и информация о них.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Получите идентификатор секрета:
bash
```
1
mws secretmanager secret list
```

Получите идентификатор версии секрета:

1
mws secretmanager secret-version list --name <идентификатор секрета>

Получите информацию о версии:

1
mws secretmanager secret-version get <идентификатор версии> --name <идентификатор секрета>

1
kind: secretmanager/v1/secretVersion
2
metadata:
3
    id: secretmanager/projects/fedor/secrets/test4/secretVersions/1
4
    name: test4
5
    createTime: "2025-10-24T07:11:07Z"
6
    updateTime: "2025-10-24T07:11:07Z"
7
    etag: 2065351137bf447faade2caaae049495
8
spec:
9
    active: true
10
    data: {}
11
status:
12
    ready:
13
        state: OK
14
    active: true

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Получите идентификатор секрета:

1
curl -X GET https://secretmanager.mwsapis.ru/secretmanager/v1/projects/<имя проекта>/secrets \
2
-H "Authorization: Bearer <IAM-токен>" \
3
-H "Content-Type: application/json"

Получите идентификатор версии секрета:

1
curl -X GET https://secretmanager.mwsapis.ru/secretmanager/v1/projects/<имя проекта>/secrets/<идентификатор секрета>/secretVersions \
2
-H "Authorization: Bearer <IAM-токен>" \
3
-H "Content-Type: application/json"

Получите информацию о версии:

1
curl -X GET https://secretmanager.mwsapis.ru/secretmanager/v1/projects/<имя проекта>/secrets/<идентификатор секрета>/secretVersions/<идентификатор версии> \
2
-H "Authorization: Bearer <IAM-токен>" \
3
-H "Content-Type: application/json"

Если запрос был успешно принят, вы получите ответ с кодом 200 OK. В ответе будет выведена подробная информация о секрете.

Получить содержимое версии

Если версия секрета деактивирована, получить ее содержимое невозможно.

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите Secret Manager.
Нажмите на имя нужного секрета.
В блоке Версии секрета нажмите на нужную версию секрета.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Выполните запрос:
bash
```
1
mws secretmanager secret-version get-data <идентификатор версии> --name <идентификатор секрета>
```
Чтобы получить содержимое текущей версии секрета, выполните запрос:
bash
```
1
mws secretmanager secret-version get-data current --name <идентификатор секрета>
```
В выводе команды будет содержимое секрета.

Если в качестве значения секрета используется файл, то вы получите данные в кодировке Base64.

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.
Выполните запрос:
bash
```
1
curl -X GET https://secretmanager.mwsapis.ru/secretmanager/v1/projects/<имя проекта>/secrets/<идентификатор секрета>/secretVersion/<идентификатор версии>:getData \
2
-H "Authorization: Bearer <IAM-токен>" \
3
-H "Content-Type: application/json"
```
Если запрос был успешно принят, вы получите ответ с кодом 200 OK. В ответе будет содержимое секрета.

Если в качестве значения секрета используется файл, то вы получите данные в кодировке Base64.

Создать версию

Невозможно создать две идентичных версии секрета подряд: текущая и предыдущая версии должны различаться. Если вы создаете новую версию, она автоматически становится текущей.

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите Secret Manager.
Нажмите на имя нужного секрета.
В блоке Версии секрета нажмите кнопку Создать.
Задайте содержимое секрета:
- Ключ — ключ предназначен для идентификации секрета и не является конфиденциальной информацией.
- (опционально) Значение — конфиденциальные данные. Введите вручную или загрузите файл в кодировке Base64.
(опционально) Добавьте дополнительные пары «ключ-значение».
Нажмите кнопку Создать.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Получите идентификатор секрета:
bash
```
1
mws secretmanager secret list
```
Создайте версию секрета:
bash
```
1
mws secretmanager secret add-secret-version <идентификатор секрета> \
2
  --data '{"<ключ 1>": "<значение 1>", "<ключ 2>": "<значение 2>"}'
```
Важно
Если в качестве значения секрета вы хотите передать файл, приведите его к кодировке Base64.

В случае успешного выполнения команды в ответе будут выведены обновленные параметры секрета.

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Получите идентификатор секрета:

1
curl -X GET https://secretmanager.mwsapis.ru/secretmanager/v1/projects/<имя проекта>/secrets \
2
-H "Authorization: Bearer <IAM-токен>" \
3
-H "Content-Type: application/json"

Создайте версию секрета:

1
curl -X POST "https://secretmanager.mwsapis.ru/secretmanager/v1/projects/<имя проекта>/secrets/<идентификатор секрета>:addSecretVersion" \
2
    -H "Authorization: Bearer <IAM-токен>" \
3
    -H "Content-Type: application/json" \
4
    -d '{
5
        "data": {
6
                "<ключ 1>": "<значение 1>",
7
                "<ключ 2>": "<значение 2>"
8
                }
9
        }'

Если запрос был успешно принят, вы получите ответ с кодом 200 OK. В ответе будет выведена обновленная информация о секрете.

Создать версию на основе существующей

С помощью этой инструкции вы создадите новую версию секрета, содержимое которой будет идентично содержимому выбранной версии. Ключи и значения подставятся автоматически, при необходимости их можно отредактировать.

Веб-консоль

В веб-консоли выберите нужный проект.
В списке сервисов выберите Secret Manager.
Нажмите на имя нужного секрета.
В блоке Версии секрета нажмите на значок ... для нужной версии и выберите Создать версию на основе этой.
Подтвердите операцию.

Активировать и деактивировать версию

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите Secret Manager.
Нажмите на имя нужного секрета.
В блоке Версии секрета нажмите на значок ... для нужной версии и выберите Активировать или Деактивировать.
Подтвердите операцию.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Получите идентификатор секрета:
bash
```
1
mws secretmanager secret list
```

Получите идентификатор версии секрета:

1
mws secretmanager secret-version list --name <идентификатор секрета>

Выполните запрос:

Чтобы деактивировать версию:

1
mws secretmanager secret-version update <идентификатор версии> \
2
  --name <идентификатор секрета> \
3
  --active=false

Чтобы активировать версию:

1
mws secretmanager secret-version update <идентификатор версии> \
2
  --name <идентификатор секрета> \
3
  --active

В случае успешного выполнения команды в ответе будут выведены обновленные параметры версии.

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Получите идентификатор секрета:

1
curl -X GET https://secretmanager.mwsapis.ru/secretmanager/v1/projects/<имя проекта>/secrets \
2
-H "Authorization: Bearer <IAM-токен>" \
3
-H "Content-Type: application/json"

Получите идентификатор версии секрета:

1
curl -X GET https://secretmanager.mwsapis.ru/secretmanager/v1/projects/<имя проекта>/secrets/<идентификатор секрета>/secretVersions \
2
-H "Authorization: Bearer <IAM-токен>" \
3
-H "Content-Type: application/json"

Выполните запрос:

Чтобы деактивировать версию:

1
curl -X GET https://secretmanager.mwsapis.ru/secretmanager/v1/projects/<имя проекта>/secrets/<идентификатор секрета>/secretVersion/<идентификатор версии>?updateOnly=true \
2
    -H "Authorization: Bearer <IAM-токен>" \
3
    -H "Content-Type: application/json" \
4
    -d '{
5
    "spec": {
6
        "active": false
7
        }
8
    }'

Чтобы активировать версию:

1
curl -X GET https://secretmanager.mwsapis.ru/secretmanager/v1/projects/<имя проекта>/secrets/<идентификатор секрета>/secretVersion/<идентификатор версии>?updateOnly=true \
2
    -H "Authorization: Bearer <IAM-токен>" \
3
    -H "Content-Type: application/json" \
4
    -d '{
5
    "spec": {
6
        "active": true
7
        }
8
    }'

Если запрос был успешно принят, вы получите ответ с кодом 200 OK. В ответе будет выведена обновленная информация о статусе версии секрета.

Сделать версию текущей

Если версия деактивирована, сделать ее текущей невозможно.

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите Secret Manager.
Нажмите на имя нужного секрета.
В блоке Версии секрета нажмите на значок ... для нужной версии и выберите Сделать версию текущей.
Подтвердите операцию.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Получите идентификатор секрета:
bash
```
1
mws secretmanager secret list
```

Получите идентификатор версии секрета:

1
mws secretmanager secret-version list --name <идентификатор секрета>

Выполните команду:
bash
```
1
mws secretmanager secret update <идентификатор секрета> \
2
  --current-secret-version <идентификатор версии секрета>
```
В случае успешного выполнения команды в ответе будут выведены обновленные параметры секрета.

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Получите идентификатор секрета:

1
curl -X GET https://secretmanager.mwsapis.ru/secretmanager/v1/projects/<имя проекта>/secrets \
2
-H "Authorization: Bearer <IAM-токен>" \
3
-H "Content-Type: application/json"

Получите идентификатор версии секрета:

1
curl -X GET https://secretmanager.mwsapis.ru/secretmanager/v1/projects/<имя проекта>/secrets/<идентификатор секрета>/secretVersions \
2
-H "Authorization: Bearer <IAM-токен>" \
3
-H "Content-Type: application/json"

Сделайте версию текущей:

1
curl -X POST "https://secretmanager.mwsapis.ru/secretmanager/v1/projects/<имя проекта>/secrets/<идентификатор секрета>" \
2
    -H "Authorization: Bearer <IAM-токен>" \
3
    -H "Content-Type: application/json" \
4
    -d '{
5
    "spec": {
6
        "currentSecretVersion": "<идентификатор версии секрета>"
7
        }
8
    }'

В случае успешного выполнения команды в ответе будут выведены обновленные параметры секрета.

Удалить версию

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите Secret Manager.
Нажмите на имя нужного секрета.
В блоке Версии секрета нажмите на значок ... для удаляемой версии и выберите Удалить.
Подтвердите удаление.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Получите идентификатор секрета:
bash
```
1
mws secretmanager secret list
```

Получите идентификатор версии секрета:

1
mws secretmanager secret-version list --name <идентификатор секрета>

Удалите версию:
bash
```
1
mws secretmanager secret-version delete <идентификатор версии> --name <идентификатор секрета>
```
В случае успешного удаления на экран будет выведен ответ success.

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Получите идентификатор секрета:

1
curl -X GET https://secretmanager.mwsapis.ru/secretmanager/v1/projects/<имя проекта>/secrets \
2
-H "Authorization: Bearer <IAM-токен>" \
3
-H "Content-Type: application/json"

Получите идентификатор версии секрета:

1
curl -X GET https://secretmanager.mwsapis.ru/secretmanager/v1/projects/<имя проекта>/secrets/<идентификатор секрета>/secretVersions \
2
-H "Authorization: Bearer <IAM-токен>" \
3
-H "Content-Type: application/json"

Удалите версию:

1
curl -X DELETE "https://secretmanager.mwsapis.ru/secretmanager/v1/projects/<имя проекта>/secrets/<идентификатор секрета>/secretVersions/<идентификатор версии>" \
2
    -H "Authorization: Bearer <IAM-токен>" \
3
    -H "Content-Type: application/json"

В случае успешного выполнения вывод команды будет пустым.