Lists the status of push upgrade requests for a given package.
Description for package push-upgrade list
Shows the details of each request to create a push upgrade in the Dev Hub org.
All filter parameters are applied using the AND logical operator (not OR).
To get information about a specific request, run “sf package pushupgrade report” and supply the request ID.
Aliases for package push-upgrade list
force:package:push-upgrade:list
Flags
Flag Name (Long)
Flag Name (Short)
Description
‑‑api‑version
N/A
Type: Value
Override the api version used for api requests made by this command
‑‑flags‑dir
N/A
Type: Value
Import flag values from a directory.
‑‑json
N/A
Type: Boolean
Format output as json.
‑‑package
‑p
Type: Value Required
Package ID (starts with 033) of the package that you want push upgrade information for.
‑‑scheduled‑last‑days
‑l
Type: Value
Number of days in the past for which to display the list of push upgrade requests that were scheduled. Used to filter the list output to only recently scheduled push upgrades.
‑‑show‑push‑migrations‑only
N/A
Type: Boolean
Display only push upgrade requests for package migrations.
‑‑status
‑s
Type: Value Valid Values:Created, Cancelled, Pending, In Progress, Failed, Succeeded
Status used to filter the list output Valid values are: Created, Canceled, Pending, In Progress, Failed, or Succeeded
‑‑target‑dev‑hub
‑v
Type: Value Required
Username or alias of the Dev Hub org. Not required if the target-dev-hub configuration variable is already set.
Examples for package push-upgrade list
List all package push upgrade requests in the specified Dev Hub org:
1sf package push-upgrade list --package 033xyz --target-dev-hub myHub
List all package push upgrade requests in the specified Dev Hub org scheduled in the last 30 days:
1sf package push-upgrade list --package 033xyz --scheduled-last-days 30 --target-dev-hub myHub
List all package push upgrade with a status Succeeded:
1sf package push-upgrade list --package 033xyz –-status Succeeded
List all package push upgrade with a status Failed:
1sf package push-upgrade list --package 033xyz –-status Failed
j