Run

Represents an Actor run and its associated data.

Index

Properties

• act_id
• actor_task_id
• build_id
• build_number
• charged_event_counts
• container_url
• default_dataset_id
• default_key_value_store_id
• default_request_queue_id
• exit_code
• finished_at
• general_access
• git_branch_name
• id
• is_container_server_ready
• is_status_message_terminal
• meta
• metamorphs
• model_config
• options
• pricing_info
• started_at
• stats
• status
• status_message
• usage
• usage_total_usd
• usage_usd
• user_id

Properties

act_id

act_id: str

ID of the Actor that was run.

actor_task_id

actor_task_id: str | None

ID of the Actor task, if the run was started from a task.

build_id

build_id: str

ID of the Actor build used for this run.

build_number

build_number: str | None

Build number of the Actor build used for this run.

charged_event_counts

charged_event_counts: dict[str, int] | None

A map of charged event types to their counts. The keys are event type identifiers defined by the Actor's pricing model (pay-per-event), and the values are the number of times each event was charged during this run.

container_url

container_url: AnyUrl | None

URL of the container running the Actor.

default_dataset_id

default_dataset_id: str

ID of the default dataset for this run.

default_key_value_store_id

default_key_value_store_id: str

ID of the default key-value store for this run.

default_request_queue_id

default_request_queue_id: str

ID of the default request queue for this run.

exit_code

exit_code: int | None

Exit code of the Actor run process.

finished_at

finished_at: AwareDatetime | None

Time when the Actor run finished.

general_access

general_access: GeneralAccess

General access level for the Actor run.

git_branch_name

git_branch_name: str | None

Name of the git branch used for the Actor build.

id

id: str

Unique identifier of the Actor run.

is_container_server_ready

is_container_server_ready: bool | None

Whether the container's HTTP server is ready to accept requests.

is_status_message_terminal

is_status_message_terminal: bool | None

Whether the status message is terminal (final).

meta

meta: RunMeta

Metadata about the Actor run.

metamorphs

metamorphs: list[Metamorph] | None

List of metamorph events that occurred during the run.

model_config

model_config: Undefined

options

options: RunOptions

Configuration options for the Actor run.

pricing_info

pricing_info: (((PayPerEventActorPricingInfo | PricePerDatasetItemActorPricingInfo) | FlatPricePerMonthActorPricingInfo) | FreeActorPricingInfo) | None

Pricing information for the Actor.

started_at

started_at: AwareDatetime

Time when the Actor run started.

stats

stats: RunStats

Statistics of the Actor run.

status

status: ActorJobStatus

Current status of the Actor run.

status_message

status_message: str | None

Detailed message about the run status.

usage

usage: RunUsage | None

Resource usage statistics for the run.

usage_total_usd

usage_total_usd: float | None

Total cost in USD for this run. Represents what you actually pay. For run owners: includes platform usage (compute units) and/or event costs depending on the Actor's pricing model. For run non-owners: only available for Pay-Per-Event Actors (event costs only). Not available for Pay-Per-Result Actors when you're not the Actor owner.

usage_usd

usage_usd: RunUsageUsd | None

Platform usage costs breakdown in USD. Only present if you own the run AND are paying for platform usage (Pay-Per-Usage, Rental, or Pay-Per-Event with usage costs like standby Actors). Not available for standard Pay-Per-Event Actors or Pay-Per-Result Actors owned by others.

user_id

user_id: str

ID of the user who started the run.