`prefect.cli.flow_run`

Flow run command — native cyclopts implementation. Interact with flow runs.

Functions

`inspect`

inspect(id: UUID)

View details about a flow run.

`ls`

ls()

View recent flow runs or flow runs for specific flows. 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

`delete`

delete(id: UUID)

Delete a flow run by ID.

`cancel`

cancel(id: UUID)

Cancel a flow run by ID.

`retry`

retry(id_or_name: str)

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

`logs`

logs(id: UUID)

View logs for a flow run.

`watch`

watch(id: UUID)

Watch a flow run until it reaches a terminal state.

`execute`

execute(id: Optional[UUID] = None)

Execute a flow run by ID.

​prefect.cli.flow_run

​Functions

​inspect

​ls

​delete

​cancel

​retry

​logs

​watch

​execute