Back to Prefect

actions

docs/v3/api-ref/python/prefect-client-schemas-actions.mdx

3.7.514.2 KB
Original Source

prefect.client.schemas.actions

Classes

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

Data used by the Prefect REST API to create a new state.

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

Data used by the Prefect REST API to create a flow.

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

Data used by the Prefect REST API to update a flow.

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

Methods:

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

python
from_schedule(cls, schedule: Schedule) -> 'DeploymentScheduleCreate'

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

python
validate_active(cls, v: Any, handler: Callable[[Any], Any]) -> bool

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

python
validate_max_scheduled_runs(cls, v: Optional[int]) -> Optional[int]

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

Methods:

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

python
validate_max_scheduled_runs(cls, v: Optional[int]) -> Optional[int]

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

Data used by the Prefect REST API to create a deployment.

Methods:

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

python
check_valid_configuration(self, base_job_template: dict[str, Any]) -> None

Check that the combination of base_job_template defaults and job_variables conforms to the specified schema.

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

python
convert_to_strings(cls, values: Optional[Union[str, list[str]]]) -> Union[str, list[str]]

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

python
remove_old_fields(cls, values: dict[str, Any]) -> dict[str, Any]

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

Data used by the Prefect REST API to update a deployment.

Methods:

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

python
check_valid_configuration(self, base_job_template: dict[str, Any]) -> None

Check that the combination of base_job_template defaults and job_variables conforms to the specified schema.

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

python
remove_old_fields(cls, values: dict[str, Any]) -> dict[str, Any]

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

Methods:

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

python
validate_branch_length(cls, v: str) -> str

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

Data used by the Prefect REST API to update a flow run.

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

Data used by the Prefect REST API to create a task run

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

Data used by the Prefect REST API to update a task run

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

Data used by the Prefect REST API to create a flow run.

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

Data used by the Prefect REST API to create a flow run from a deployment.

Methods:

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

python
convert_parameters_to_plain_data(cls, values: dict[str, Any]) -> dict[str, Any]

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

python
serialize_parameters(self, value: dict[str, Any]) -> dict[str, Any]

Serialize datetime types as ISO strings instead of timestamps.

PrefectBaseModel has ser_json_timedelta='float' to serialize timedeltas as floats, but this also causes datetime/date/time to serialize as timestamps. This serializer overrides that behavior for datetime types while preserving float serialization for timedeltas.

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

Data used by the Prefect REST API to create a saved search.

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

Data used by the Prefect REST API to create a concurrency limit.

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

Data used by the Prefect REST API to create a v2 concurrency limit.

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

Data used by the Prefect REST API to update a v2 concurrency limit.

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

Data used by the Prefect REST API to create a block type.

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

Data used by the Prefect REST API to update a block type.

Methods:

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

python
updatable_fields(cls) -> set[str]

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

Data used by the Prefect REST API to create a block schema.

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

Data used by the Prefect REST API to create a block document.

Methods:

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

python
validate_name_is_present_if_not_anonymous(cls, values: dict[str, Any]) -> dict[str, Any]

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

Data used by the Prefect REST API to update a block document.

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

Data used to create block document reference.

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

Data used by the Prefect REST API to create a log.

Methods:

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

python
model_dump(self, *args: Any, **kwargs: Any) -> dict[str, Any]

The worker_id field is only included in logs sent to Prefect Cloud. If it's unset, we should not include it in the log payload.

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

Data used by the Prefect REST API to create a work pool.

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

Data used by the Prefect REST API to update a work pool.

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

Data used by the Prefect REST API to create a work queue.

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

Data used by the Prefect REST API to update a work queue.

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

Data used by the Prefect REST API to create an artifact.

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

Data used by the Prefect REST API to update an artifact.

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

Data used by the Prefect REST API to create a Variable.

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

Data used by the Prefect REST API to update a Variable.

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

Data used by the Prefect REST API to create a global concurrency limit.

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

Data used by the Prefect REST API to update a global concurrency limit.