Status Flag
StatusFlag
Bases: NormanBaseModel
Represents a status indicator for a specific entity (model, file, input, output, staging step, or processing stage) within the Norman system.
A StatusFlag tracks the progress of a workflow step, how far it has advanced, and whether it completed successfully or encountered an error. Status flags are used extensively across staging pipelines, model builds, file processing, input/output transformation, and more.
Fields
id (
str) Unique identifier for the status flag record. Defaults to"0".account_id (
str) Identifier of the account that owns this entity.entity_id (
str) Identifier of the entity being tracked (e.g., model ID, asset ID, invocation ID, or upload ID).update_time (
datetime) UTC timestamp of the most recent update to this flag. Defaults to the current time.flag_name (
StatusFlagName) Name of the workflow step being tracked (seeStatusFlagNameenum).flag_value (
StatusFlagValue) Current progress state for the step (seeStatusFlagValueenum).
StatusFlagName
Bases: str, Enum
Enumeration of all workflow steps tracked in the Norman system.
Each entry represents a discrete stage in model processing, file lifecycle, EFS/S3 handling, input preparation, output handling, or execution.
Groups of Flags
Logo / Branding Asset Handling
Logo_EFS_StagingLogo_S3_Storage
File Preparation & Staging
File_EFS_StagingFile_S3_StorageFile_Image_Build
Input ProcessingInput_EFS_StagingInput_S3_StorageInput_EFS_TranscodingInput_EFS_Tensor
Model Execution
Model_Function_Run
Output Handling
Output_EFS_StagingOutput_S3_Storage
StatusFlagValue
Bases: int, Enum
Represents the progress state of a workflow step.
Values are ordered so they can be compared (e.g., to determine forward progress), thanks to the @total_ordering decorator.
Values
Not_Started (
0) Step has not begun yet.Enqueued (
1) Step is queued but not yet started.In_Progress (
2) Step is currently running.Finished (
3) Step completed successfully.Error (
4) Step failed or encountered an unrecoverable issue.