Skip to main content

prefect deployment

Manage deployments.

prefect deployment schedule

Manage deployment schedules.

prefect deployment schedule create

Create a schedule for a given deployment.

Arguments

string
required

Options

An interval to schedule on, specified in seconds
The anchor date for an interval schedule
Deployment schedule rrule string
Deployment schedule cron string
Control how croniter handles day and day_of_week entries
Deployment schedule timezone string e.g. ‘America/New_York’
Whether the schedule is active. Defaults to True.
Replace the deployment’s current schedule(s) with this new schedule.
Accept the confirmation prompt without prompting

prefect deployment schedule delete

Delete a deployment schedule.

Arguments

string
required
string
required

Options

Accept the confirmation prompt without prompting

prefect deployment schedule pause

Pause deployment schedules.

Arguments

string
string

Options

Pause all deployment schedules
Example:

prefect deployment schedule resume

Resume deployment schedules.

Arguments

string
string

Options

Resume all deployment schedules
Example:

prefect deployment schedule ls

View all schedules for a deployment.

Arguments

string
required

Options

Specify an output format. Currently supports: json

prefect deployment schedule clear

Clear all schedules for a deployment.

Arguments

string
required

Options

Accept the confirmation prompt without prompting

prefect deployment inspect

View details about a deployment.

Arguments

string
required

Options

Specify an output format. Currently supports: json
Example:$ prefect deployment inspect "hello-world/my-deployment"

prefect deployment ls

View all deployments or deployments for specific flows.

Arguments

string
One or more flow names to filter deployments by.

Options

Sort by created time instead of name.
Specify an output format. Currently supports: json

prefect deployment run

Create a flow run for the given flow and deployment.The flow run will be scheduled to run immediately unless --start-in or --start-at is specified. The flow run will not execute until a worker starts. To watch the flow run until it reaches a terminal state, use the --watch flag.

Arguments

string
A deployed flow’s name: <FLOW_NAME>/<DEPLOYMENT_NAME>

Options

A deployment id to search for if no name is given
A key, value pair (key=value) specifying a flow run job variable. The value will be interpreted as JSON. May be passed multiple times to specify multiple job variable values.
A key, value pair (key=value) specifying a flow parameter. The value will be interpreted as JSON. May be passed multiple times to specify multiple parameter values.
A mapping of parameters to values. To use a stdin, pass ’-’. Any parameters passed with --param will take precedence over these values.
A human-readable string specifying a time interval to wait before starting the flow run. E.g. ‘in 5 minutes’, ‘in 1 hour’, ‘in 2 days’.
A human-readable string specifying a time to start the flow run. E.g. ‘at 5:30pm’, ‘at 2022-08-01 17:30’, ‘at 2022-08-01 17:30:00’.
Tag(s) to be applied to flow run.
Whether to poll the flow run until a terminal state is reached.
How often to poll the flow run for state changes (in seconds).
Timeout for —watch.
Custom name to give the flow run.

prefect deployment delete

Delete a deployment.

Arguments

string
A deployed flow’s name: <FLOW_NAME>/<DEPLOYMENT_NAME>

Options

A deployment id to search for if no name is given
Delete all deployments
Example: