Обновление данных (update)

Описание

update изменяет значения записей Пассворк (пароль, имя, пользовательские поля) согласно переданным параметрам.

Варианты использования

1. Обновление отдельных полей — изменить пароль, имя, логин, URL, описание, теги или пользовательские поля по отдельности
2. Очистка значений полей — установить поля в пустые, передав пустую строку
3. Массовое обновление — изменить несколько полей одной командой
4. Обновление пользовательских полей — добавить/изменить пользовательские поля у элементов и ярлыков

Идентификация записи

Параметр	Описание
--password-id	ID элемента (item)
--shortcut-id	ID ярлыка (shortcut)

Параметры изменения

Параметр	Описание
--name	Новое имя записи. Пустое значение вернёт ошибку
--password	Новое значение пароля
--login	Новое значение логина
--url	Новый URL-адрес
--description	Новое значение заметки
--tags	Список тегов через запятую. Пустая строка очищает теги
--custom-{name}	Установить пользовательское поле по имени, например --custom-API_KEY "..."

Синтаксис

shell

passwork-cli update --password-id <id> [поля-изменения]

Базовое использование

Указать либо --password-id, либо --shortcut-id для идентификации обновляемого объекта.

shell

passwork-cli update \
  --host "https://passwork.example.com" \
  --token "your_access_token" \
  --master-key "your_master_key" \
  --password-id "68793e13dfc88d879e0f2e39" \
  --password "new-password-value"

Использование переменных окружения

Можно экспортировать данные Пассворка в качестве переменных окружения:

shell

export PASSWORK_HOST="https://passwork.example.com"
export PASSWORK_TOKEN="your_access_token"
export PASSWORK_MASTER_KEY="your_master_key"

# Затем обновить без указания учетных данных
passwork-cli update \
  --password-id "68793e13dfc88d879e0f2e39" \
  --password "new-password"

Это полезно для скриптов автоматизаций и CI/CD пайплайнов, где учетные данные могут быть безопасно сохранены в качестве переменных окружения.

Обновление стандартных полей

Стандартные поля: имя, пароль, логин, URL, описание и теги.

shell

# Обновить пароль
passwork-cli update --password-id "68793e13dfc88d879e0f2e39" --password "new-password"

# Обновить логин
passwork-cli update --password-id "68793e13dfc88d879e0f2e39" --login "new-login"

# Обновить имя
passwork-cli update --password-id "68793e13dfc88d879e0f2e39" --name "New Item Name"

# Обновить URL
passwork-cli update --password-id "68793e13dfc88d879e0f2e39" --url "https://example.com"

# Обновить описание
passwork-cli update --password-id "68793e13dfc88d879e0f2e39" --description "Updated description"

# Обновить теги (через запятую)
passwork-cli update --password-id "68793e13dfc88d879e0f2e39" --tags "tag1,tag2,tag3"

# Очистить поле (установить в пустое)
passwork-cli update --password-id "68793e13dfc88d879e0f2e39" --description ""

Обновление пользовательских полей

Обновляются с помощью синтаксиса --custom-*, где * — имя пользовательского поля.

shell

# Обновить пользовательское поле API_KEY
passwork-cli update \
  --password-id "68793e13dfc88d879e0f2e39" \
  --custom-API_KEY "new-api-key-value"

# Очистить пользовательское поле
passwork-cli update \
  --password-id "68793e13dfc88d879e0f2e39" \
  --custom-API_KEY ""

Массовое обновление

Обновить несколько полей одной командой.

shell

# Обновить логин и пароль вместе
passwork-cli update \
  --password-id "68793e13dfc88d879e0f2e39" \
  --login "new-login" \
  --password "new-password"

# Обновить несколько полей, включая пользовательское поле
passwork-cli update \
  --password-id "68793e13dfc88d879e0f2e39" \
  --password "new-password" \
  --description "Updated description" \
  --tags "production,database,api" \
  --custom-API_KEY "new-api-key-value"

# Полное обновление со всеми полями
passwork-cli update \
  --password-id "68793e13dfc88d879e0f2e39" \
  --name "UpdateName" \
  --login "UpdateLogin" \
  --password "UpdatePassword" \
  --description "UpdateDescription" \
  --tags "update,all,tags" \
  --url "https://update.url" \
  --custom-API_KEY "update_api_key"

Работа с ярлыками

Аналогичные параметры работают и для ярлыков через --shortcut-id.

shell

# Обновить поля ярлыка
passwork-cli update \
  --shortcut-id "68d6c94bec3a3fe41209546e" \
  --password "shortcut-password" \
  --login "shortcut-login"

# Обновить ярлык с несколькими полями
passwork-cli update \
  --shortcut-id "68d6c94bec3a3fe41209546e" \
  --name "Update name" \
  --description "Updated shortcut" \
  --tags "shortcut,updated" \
  --custom-API_KEY "shortcut-api-key"

Описание работы

1. CLI подключается к серверу Пассворк, используя предоставленные учетные данные
2. Получает элемент или ярлык по ID
3. Расшифровывает данные с использованием мастер-ключа (если используется клиентское шифрование)
4. Применяет новые значения к указанным полям
5. Пустые строки ("") очищают соответствующие поля
6. Пользовательские поля изменяются через синтаксис --custom-*
7. Теги принимаются как список через запятую и заменяют существующие
8. Обновлённый объект сохраняется в Пассворк