Heroku CLI Data Maintenance Plugin

• Heroku CLI Data Maintenance Plugin
• Usage
• Commands

Usage

$ heroku plugins:install data-maintenance
$ heroku COMMAND
running command...
$ heroku (-v|--version|version)
@heroku-cli/plugin-data-maintenance/0.2.2 darwin-x64 node-v14.9.0
$ heroku --help [COMMAND]
USAGE
  $ heroku COMMAND
...

Commands

• heroku data:maintenances
• heroku data:maintenances:history ADDON
• heroku data:maintenances:info ADDON
• heroku data:maintenances:run ADDON
• heroku data:maintenances:schedule ADDON
• heroku data:maintenances:wait ADDON
• heroku data:maintenances:window ADDON
• heroku data:maintenances:window:update ADDON DAY_OF_WEEK TIME_OF_DAY

heroku data:maintenances

list maintenances for an app's data addons

USAGE
  $ heroku data:maintenances -a <value> [-j] [-r <value>] [--columns <value> | -x] [--sort <value>] [--filter <value>]
    [--output csv|json|yaml |  | [--csv | --no-truncate]] [--no-header | ]

FLAGS
  -a, --app=<value>      (required) app to list addon maintenances for
  -j, --json             output result in json
  -r, --remote=<value>   git remote of app to use
  -x, --extended         show extra columns
      --columns=<value>  only show provided columns (comma-separated)
      --csv              output is csv format [alias: --output=csv]
      --filter=<value>   filter property by partial string matching, ex: name=foo
      --no-header        hide table header from output
      --no-truncate      do not truncate output to fit screen
      --output=<option>  output in a more machine friendly format
                         <options: csv|json|yaml>
      --sort=<value>     property to sort by (prepend '-' for descending)

DESCRIPTION
  list maintenances for an app's data addons

EXAMPLES
  $ heroku data:maintenances --app production-app

  $ heroku data:maintenances --app production-app --json

See code: src/commands/data/maintenances/index.ts

heroku data:maintenances:history ADDON

show details of the most recent maintenances for an addon

USAGE
  $ heroku data:maintenances:history ADDON [-a <value>] [-r <value>] [-n <value>] [-j] [--columns <value> | -x] [--sort
    <value>] [--filter <value>] [--output csv|json|yaml |  | [--csv | --no-truncate]] [--no-header | ]

ARGUMENTS
  ADDON  data addon

FLAGS
  -a, --app=<value>      app to run command against
  -j, --json             show result formatted in json
  -n, --num=<value>      [default: 5] number of maintenances to show (maxmimum is 20)
  -r, --remote=<value>   git remote of app to use
  -x, --extended         show extra columns
      --columns=<value>  only show provided columns (comma-separated)
      --csv              output is csv format [alias: --output=csv]
      --filter=<value>   filter property by partial string matching, ex: name=foo
      --no-header        hide table header from output
      --no-truncate      do not truncate output to fit screen
      --output=<option>  output in a more machine friendly format
                         <options: csv|json|yaml>
      --sort=<value>     property to sort by (prepend '-' for descending)

DESCRIPTION
  show details of the most recent maintenances for an addon

EXAMPLES
  $ heroku data:maintenances:history postgresql-sinuous-92834

  $ heroku data:maintenances:history postgresql-sinuous-92834 --num 10

  $ heroku data:maintenances:history postgresql-sinuous-92834 --json

  $ heroku data:maintenances:history DATABASE --app production-app

See code: src/commands/data/maintenances/history.ts

heroku data:maintenances:info ADDON

display details of the most recent maintenance for an addon

USAGE
  $ heroku data:maintenances:info ADDON [-a <value>] [-r <value>] [-j]

ARGUMENTS
  ADDON  data addon to show maintenance for

FLAGS
  -a, --app=<value>     app to list addon maintenances for
  -j, --json            output result in json
  -r, --remote=<value>  git remote of app to use

DESCRIPTION
  display details of the most recent maintenance for an addon

EXAMPLES
  $ heroku data:maintenances:info postgresql-sinuous-83720

  $ heroku data:maintenances:info postgresql-sinuous-83720 --json

  $ heroku data:maintenances:info DATABASE --app test-app

See code: src/commands/data/maintenances/info.ts

heroku data:maintenances:run ADDON

triggers a scheduled maintenance for a data add-on

USAGE
  $ heroku data:maintenances:run ADDON [-a <value>] [-r <value>] [-w] [-c <value>]

ARGUMENTS
  ADDON  data addon

FLAGS
  -a, --app=<value>      app to run command against
  -c, --confirm=<value>  confirms running maintenance without entering application maintenance mode the app name matches
  -r, --remote=<value>   git remote of app to use
  -w, --wait             wait for maintenance to complete before exiting

DESCRIPTION
  triggers a scheduled maintenance for a data add-on

EXAMPLES
  $ heroku data:maintenances:run postgresql-sinuous-92834

  $ heroku data:maintenances:run postgresql-sinuous-92834 --confirm production-app

  $ heroku data:maintenances:run postgresql-sinuous-92834 --wait

  $ heroku data:maintenances:run DATABASE --app production-app

See code: src/commands/data/maintenances/run.ts

heroku data:maintenances:schedule ADDON

schedule or re-schedule maintenance for an add-on

USAGE
  $ heroku data:maintenances:schedule ADDON [-a <value>] [-r <value>] [--weeks <value> | --week <value>]

ARGUMENTS
  ADDON  addon to schedule or re-schedule maintenance for

FLAGS
  -a, --app=<value>     app to run command against
  -r, --remote=<value>  git remote of app to use
      --week=<value>    desired week to run maintenance in
      --weeks=<value>   [default: 2] the number of weeks to delay maintenance for

DESCRIPTION
  schedule or re-schedule maintenance for an add-on

EXAMPLES
  $ heroku data:maintenances:schedule postgresql-sinuous-83910

  $ heroku data:maintenances:schedule postgresql-sinuous-83910 --weeks 3

  $ heroku data:maintenances:schedule postgresql-sinuous-83910 --weeks -2

  $ heroku data:maintenances:schedule postgresql-sinuous-83910 --week 2020-02-23

  $ heroku data:maintenances:schedule HEROKU_POSTGRESQL_RED --app test-app

See code: src/commands/data/maintenances/schedule.ts

heroku data:maintenances:wait ADDON

blocks until the maintenance process has completed

USAGE
  $ heroku data:maintenances:wait ADDON [-a <value>] [-r <value>]

ARGUMENTS
  ADDON  data addon

FLAGS
  -a, --app=<value>     app to run command against
  -r, --remote=<value>  git remote of app to use

DESCRIPTION
  blocks until the maintenance process has completed

EXAMPLES
  $ heroku data:maintenances:wait postgresql-sinuous-83720

  $ heroku data:maintenances:wait DATABASE --app production-app

See code: src/commands/data/maintenances/wait.ts

heroku data:maintenances:window ADDON

describe the maintenance window on an add-on

USAGE
  $ heroku data:maintenances:window ADDON [-a <value>] [-r <value>] [-j]

ARGUMENTS
  ADDON  addon to show window for

FLAGS
  -a, --app=<value>     app to run command against
  -j, --json            output result in json
  -r, --remote=<value>  git remote of app to use

DESCRIPTION
  describe the maintenance window on an add-on

EXAMPLES
  $ heroku data:maintenances:window postgresql-sinuous-92834

  $ heroku data:maintenances:window DATABASE --app production-app

See code: src/commands/data/maintenances/window.ts

heroku data:maintenances:window:update ADDON DAY_OF_WEEK TIME_OF_DAY

update maintenance window on an add-on

USAGE
  $ heroku data:maintenances:window:update ADDON DAY_OF_WEEK TIME_OF_DAY [-a <value>] [-r <value>] [-j]

ARGUMENTS
  ADDON        addon to change window for
  DAY_OF_WEEK  UTC maintenance window day of the week
  TIME_OF_DAY  UTC maintenance window time of day

FLAGS
  -a, --app=<value>     app to run command against
  -j, --json            output result in json
  -r, --remote=<value>  git remote of app to use

DESCRIPTION
  update maintenance window on an add-on

EXAMPLES
  $ heroku data:maintenances:window postgresql-sinuous-92834 sunday 13:30

  $ heroku data:maintenances:window postgresql-sinuous-92834 sunday 1:30PM

  $ heroku data:maintenances:window DATABASE sunday 1:30PM --app production-app

See code: src/commands/data/maintenances/window/update.ts