Back to Prefect

actions

docs/v3/api-ref/python/prefect-events-actions.mdx

3.6.30.dev312.9 KB
Original Source

prefect.events.actions

Classes

Action <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L14" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

An Action that may be performed when an Automation is triggered

Methods:

describe_for_cli <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L19" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

python
describe_for_cli(self) -> str

A human-readable description of the action

model_validate_list <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/_internal/schemas/bases.py#L56" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

python
model_validate_list(cls, obj: Any) -> list[Self]

reset_fields <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/_internal/schemas/bases.py#L85" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

python
reset_fields(self: Self) -> Self

Reset the fields of the model that are in the _reset_fields set.

Returns:

  • A new instance of the model with the reset fields.

DoNothing <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L24" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

Do nothing when an Automation is triggered

Methods:

describe_for_cli <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L19" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

python
describe_for_cli(self) -> str

A human-readable description of the action

DeploymentAction <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L30" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

Base class for Actions that operate on Deployments and need to infer them from events

Methods:

describe_for_cli <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L19" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

python
describe_for_cli(self) -> str

A human-readable description of the action

selected_deployment_requires_id <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L49" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

python
selected_deployment_requires_id(self)

RunDeployment <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L60" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

Runs the given deployment with the given parameters

Methods:

selected_deployment_requires_id <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L49" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

python
selected_deployment_requires_id(self)

PauseDeployment <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L88" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

Pauses the given Deployment

Methods:

selected_deployment_requires_id <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L49" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

python
selected_deployment_requires_id(self)

ResumeDeployment <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L94" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

Resumes the given Deployment

Methods:

selected_deployment_requires_id <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L49" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

python
selected_deployment_requires_id(self)

ChangeFlowRunState <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L100" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

Changes the state of a flow run associated with the trigger

Methods:

describe_for_cli <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L19" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

python
describe_for_cli(self) -> str

A human-readable description of the action

CancelFlowRun <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L123" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

Cancels a flow run associated with the trigger

Methods:

describe_for_cli <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L19" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

python
describe_for_cli(self) -> str

A human-readable description of the action

ResumeFlowRun <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L129" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

Resumes a flow run associated with the trigger

Methods:

describe_for_cli <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L19" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

python
describe_for_cli(self) -> str

A human-readable description of the action

SuspendFlowRun <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L135" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

Suspends a flow run associated with the trigger

Methods:

describe_for_cli <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L19" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

python
describe_for_cli(self) -> str

A human-readable description of the action

CallWebhook <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L141" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

Call a webhook when an Automation is triggered.

Methods:

describe_for_cli <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L19" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

python
describe_for_cli(self) -> str

A human-readable description of the action

SendNotification <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L154" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

Send a notification when an Automation is triggered

Methods:

describe_for_cli <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L19" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

python
describe_for_cli(self) -> str

A human-readable description of the action

WorkPoolAction <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L165" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

Base class for Actions that operate on Work Pools and need to infer them from events

Methods:

describe_for_cli <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L19" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

python
describe_for_cli(self) -> str

A human-readable description of the action

PauseWorkPool <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L185" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

Pauses a Work Pool

ResumeWorkPool <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L191" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

Resumes a Work Pool

WorkQueueAction <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L197" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

Base class for Actions that operate on Work Queues and need to infer them from events

Methods:

describe_for_cli <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L19" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

python
describe_for_cli(self) -> str

A human-readable description of the action

selected_work_queue_requires_id <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L216" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

python
selected_work_queue_requires_id(self) -> Self

PauseWorkQueue <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L227" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

Pauses a Work Queue

Methods:

selected_work_queue_requires_id <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L216" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

python
selected_work_queue_requires_id(self) -> Self

ResumeWorkQueue <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L233" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

Resumes a Work Queue

Methods:

selected_work_queue_requires_id <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L216" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

python
selected_work_queue_requires_id(self) -> Self

AutomationAction <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L239" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

Base class for Actions that operate on Automations and need to infer them from events

Methods:

describe_for_cli <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L19" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

python
describe_for_cli(self) -> str

A human-readable description of the action

selected_automation_requires_id <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L258" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

python
selected_automation_requires_id(self) -> Self

PauseAutomation <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L269" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

Pauses a Work Queue

Methods:

selected_automation_requires_id <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L258" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

python
selected_automation_requires_id(self) -> Self

ResumeAutomation <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L275" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

Resumes a Work Queue

Methods:

selected_automation_requires_id <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L258" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

python
selected_automation_requires_id(self) -> Self

DeclareIncident <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L281" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

Declares an incident for the triggering event. Only available on Prefect Cloud

Methods:

describe_for_cli <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/events/actions.py#L19" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

python
describe_for_cli(self) -> str

A human-readable description of the action