Back to Prefect

block_registration

docs/v3/api-ref/python/prefect-server-models-block_registration.mdx

3.6.30.dev31.9 KB
Original Source

prefect.server.models.block_registration

Functions

register_block_schema <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/server/models/block_registration.py#L56" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

python
register_block_schema(session: AsyncSession, block_schema: Union[schemas.core.BlockSchema, 'ClientBlockSchema']) -> UUID

Stores the provided block schema in the Prefect REST API database.

If a block schema with a matching checksum and version is already saved, then the ID of the existing block schema will be returned.

Args:

  • session: A database session.
  • block_schema: A block schema object.

Returns:

  • The ID of the registered block schema.

register_block_type <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/server/models/block_registration.py#L92" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

python
register_block_type(session: AsyncSession, block_type: Union[schemas.core.BlockType, 'ClientBlockType']) -> UUID

Stores the provided block type in the Prefect REST API database.

If a block type with a matching slug is already saved, then the block type will be updated to match the passed in block type.

Args:

  • session: A database session.
  • block_type: A block type object.

Returns:

  • The ID of the registered block type.

run_block_auto_registration <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/server/models/block_registration.py#L211" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

python
run_block_auto_registration(session: AsyncSession) -> None

Registers all blocks in the client block registry and any blocks from Prefect Collections that are configured for auto-registration.

Args:

  • session: A database session.