Actualización de datos (update)

Descripción general

update modifica los valores de los registros de Passwork (contraseña, nombre, campos personalizados) según los parámetros proporcionados.

Casos de uso

1. Actualización de campos individuales — cambiar contraseña, nombre, login, URL, descripción, etiquetas o campos personalizados por separado
2. Limpieza de valores de campos — establecer campos como vacíos pasando una cadena vacía
3. Actualizaciones masivas — cambiar múltiples campos con un solo comando
4. Actualización de campos personalizados — añadir/cambiar campos personalizados para elementos y accesos directos

Identificación de elementos

Parámetro	Descripción
--password-id	ID del elemento (item)
--shortcut-id	ID del acceso directo (shortcut)

Parámetros de actualización

Parámetro	Descripción
--name	Nuevo nombre del elemento. Un valor vacío devolverá un error
--password	Nuevo valor de la contraseña
--login	Nuevo valor del login
--url	Nueva dirección URL
--description	Nuevo valor de la nota
--tags	Lista de etiquetas separadas por comas. Una cadena vacía borra las etiquetas
--custom-{name}	Establecer un campo personalizado por nombre, por ejemplo, --custom-API_KEY "..."

Sintaxis

shell

passwork-cli update --password-id <id> [field-changes]

Uso básico

Especifique --password-id o --shortcut-id para identificar el objeto a actualizar.

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"

Uso de variables de entorno

Puede exportar los datos de Passwork como variables de entorno:

shell

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

# Then update without specifying credentials
passwork-cli update \
  --password-id "68793e13dfc88d879e0f2e39" \
  --password "new-password"

Esto es útil para scripts de automatización y pipelines de CI/CD, donde las credenciales pueden almacenarse de forma segura como variables de entorno.

Actualización de campos estándar

Campos estándar: nombre, contraseña, login, URL, descripción y etiquetas.

shell

# Update password
passwork-cli update --password-id "68793e13dfc88d879e0f2e39" --password "new-password"

# Update login
passwork-cli update --password-id "68793e13dfc88d879e0f2e39" --login "new-login"

# Update name
passwork-cli update --password-id "68793e13dfc88d879e0f2e39" --name "New Item Name"

# Update URL
passwork-cli update --password-id "68793e13dfc88d879e0f2e39" --url "https://example.com"

# Update description
passwork-cli update --password-id "68793e13dfc88d879e0f2e39" --description "Updated description"

# Update tags (comma-separated)
passwork-cli update --password-id "68793e13dfc88d879e0f2e39" --tags "tag1,tag2,tag3"

# Clear field (set to empty)
passwork-cli update --password-id "68793e13dfc88d879e0f2e39" --description ""

Actualización de campos personalizados

Se actualiza utilizando la sintaxis --custom-*, donde * es el nombre del campo personalizado.

shell

# Update custom field API_KEY
passwork-cli update \
  --password-id "68793e13dfc88d879e0f2e39" \
  --custom-API_KEY "new-api-key-value"

# Clear custom field
passwork-cli update \
  --password-id "68793e13dfc88d879e0f2e39" \
  --custom-API_KEY ""

Actualizaciones masivas

Actualice múltiples campos con un solo comando.

shell

# Update login and password together
passwork-cli update \
  --password-id "68793e13dfc88d879e0f2e39" \
  --login "new-login" \
  --password "new-password"

# Update multiple fields including custom field
passwork-cli update \
  --password-id "68793e13dfc88d879e0f2e39" \
  --password "new-password" \
  --description "Updated description" \
  --tags "production,database,api" \
  --custom-API_KEY "new-api-key-value"

# Full update with all fields
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"

Trabajo con accesos directos

Parámetros similares funcionan para accesos directos a través de --shortcut-id.

shell

# Update shortcut fields
passwork-cli update \
  --shortcut-id "68d6c94bec3a3fe41209546e" \
  --password "shortcut-password" \
  --login "shortcut-login"

# Update shortcut with multiple fields
passwork-cli update \
  --shortcut-id "68d6c94bec3a3fe41209546e" \
  --name "Update name" \
  --description "Updated shortcut" \
  --tags "shortcut,updated" \
  --custom-API_KEY "shortcut-api-key"

Cómo funciona

1. CLI se conecta al servidor de Passwork utilizando las credenciales proporcionadas
2. Obtiene un elemento o acceso directo por ID
3. Descifra los datos utilizando la clave maestra (si se utiliza cifrado del lado del cliente)
4. Aplica nuevos valores a los campos especificados
5. Las cadenas vacías ("") borran los campos correspondientes
6. Los campos personalizados se cambian mediante la sintaxis --custom-*
7. Las etiquetas se aceptan como una lista separada por comas y reemplazan las existentes
8. El objeto actualizado se guarda en Passwork