prefect flow-run
Interact with flow runs.
prefect flow-run inspect
View details about a flow run.
Arguments
Arguments
[required]
prefect flow-run ls
View recent flow runs or flow runs for specific flows.Arguments:flow_name: Name of the flowlimit: Maximum number of flow runs to list. Defaults to 15.state: Name of the flow run’s state. Can be provided multiple times. Options are ‘SCHEDULED’, ‘PENDING’, ‘RUNNING’, ‘COMPLETED’, ‘FAILED’, ‘CRASHED’, ‘CANCELLING’, ‘CANCELLED’, ‘PAUSED’, ‘SUSPENDED’, ‘AWAITINGRETRY’, ‘RETRYING’, and ‘LATE’.state_type: Type of the flow run’s state. Can be provided multiple times. Options are ‘SCHEDULED’, ‘PENDING’, ‘RUNNING’, ‘COMPLETED’, ‘FAILED’, ‘CRASHED’, ‘CANCELLING’, ‘CANCELLED’, ‘CRASHED’, and ‘PAUSED’.Examples:$ prefect flow-runs ls —state Running$ prefect flow-runs ls —state Running —state late$ prefect flow-runs ls —state-type RUNNING$ prefect flow-runs ls —state-type RUNNING —state-type FAILED
prefect flow-run delete
Delete a flow run by ID.
Arguments
Arguments
[required]
prefect flow-run cancel
Cancel a flow run by ID.
Arguments
Arguments
[required]
prefect flow-run retry
Retry a failed or completed flow run.The flow run can be specified by either its UUID or its name. If multiple
flow runs have the same name, you must use the UUID to disambiguate.If the flow run has an associated deployment, it will be scheduled for retry
and a worker will pick it up. If there is no deployment, you must provide
an —entrypoint to the flow code, and the flow will execute locally.
Examples:
$ prefect flow-run retry abc123-def456-7890-…
$ prefect flow-run retry my-flow-run-name
$ prefect flow-run retry abc123 —entrypoint ./flows/my_flow.py:my_flow
Arguments
Arguments
The flow run ID (UUID) or name to retry. [required]
Options
Options
--entrypoint
The path to a file containing the flow to run, and the name of the flow function, in the format
path/to/file.py:flow_function_name. Required if the flow run does not have an associated deployment.prefect flow-run logs
View logs for a flow run.
Arguments
Arguments
[required]
prefect flow-run execute
Arguments
Arguments
ID of the flow run to execute