Secrets CLI Command Reference

Every dcloud secrets command. The shape is dcloud <service> <resource> <verb>; every command also takes the global flags (--json, --profile, --dry-run, …).

dcloud secrets secrets

Values encrypted at rest under a CMK

  • listList secrets without their values
  • getDescribe one secret without its value
  • flowShow where a secret comes from and every consumer it goes to, with last reads
  • app-flowList every secret an app uses, where each comes from and the version it last read
  • get-valueReveal the decrypted value of a secret
  • createCreate a secret encrypted under a CMK — from a value, or synced from a source reference
  • syncRefresh a synced secret from its source now
  • rotateStore a new value as the current version
  • list-versionsList stored versions of a secret
  • rollbackPromote a retired version back to current
  • list-grantsList which consumers may read a secret
  • grantGrant a consumer access to a secret
  • revoke-grantRevoke a consumer grant
  • access-logShow who has actually read a secret value
  • updateChange a secret’s description, group or rotation interval (never its value)
  • deleteDelete a secret
  • bulk-moveMove secrets to a group (null: Ungrouped), answered per secret
  • bulk-grantGrant one consumer access to many secrets, answered per secret
  • bulk-revokeRevoke one consumer’s grant on many secrets, answered per secret
  • bulk-deleteDelete many secrets and every version of them, answered per secret

dcloud secrets groups

Where secrets are filed: paths like dialog/auth, up to three segments

  • listThe group tree with how many secrets each group holds

dcloud secrets sources

External secret managers (1Password) whose references become synced secrets

  • providersList the providers a source can be, and their reference syntax
  • listList connected sources with sync status (never the credential)
  • createConnect a source — the credential is verified, then stored as a secret
  • updateRename the source, replace the credential or change the refresh interval
  • testCheck the stored credential still works
  • syncRefresh every secret synced from this source now
  • checkCheck which references resolve — ok/error per reference, never a value
  • deleteDisconnect a source (refused while secrets still sync from it)

dcloud secrets environments

Environments (dev, staging, prod …): the same secret name once per environment

  • listList environments in promotion order, with their secret and app counts
  • createAdd an environment
  • updateRename an environment, move it in the promotion order or change its colour
  • deleteDelete an environment (refused while it holds secrets or apps)
  • diffCompare two environments by name: present where, and equal or not
  • promoteCopy a secret into another environment (or its source reference, if synced)
  • promote-manyPromote many secrets into one environment; `dryRun` returns the plan first
  • matrixEvery secret name × Default and each environment: what each environment resolves it to
  • set-app-environmentSet which environment an app’s secret names resolve in (null: shared only)

Generated from the API description, the same one the API checks requests against and the CLI is built from.