pub struct ActorStartOptions {
pub build: Option<String>,
pub memory_mbytes: Option<i64>,
pub timeout_secs: Option<i64>,
pub wait_for_finish: Option<i64>,
pub max_items: Option<i64>,
pub max_total_charge_usd: Option<f64>,
pub content_type: Option<String>,
pub restart_on_error: Option<bool>,
pub force_permission_level: Option<String>,
pub webhooks: Option<Vec<Value>>,
pub wait_for_resources: Option<WaitForResources>,
}Expand description
Options shared by ActorClient::start and ActorClient::call (and the task
equivalents).
Fields§
§build: Option<String>Tag or number of the build to run (e.g. latest, 0.1.2).
memory_mbytes: Option<i64>Memory in megabytes allocated for the run.
timeout_secs: Option<i64>Timeout for the run in seconds (0 means no timeout).
wait_for_finish: Option<i64>Maximum seconds to wait server-side for the run to finish (max 60).
max_items: Option<i64>Maximum number of dataset items to charge (pay-per-result Actors).
max_total_charge_usd: Option<f64>Maximum total charge in USD (pay-per-event Actors).
content_type: Option<String>Content type of the input body. Defaults to application/json.
restart_on_error: Option<bool>Whether to restart the run if it fails.
force_permission_level: Option<String>Override the Actor’s permission level for this run.
webhooks: Option<Vec<Value>>Ad-hoc webhooks to attach to this run. Serialized to base64-encoded JSON as the
webhooks query parameter, matching the reference clients.
wait_for_resources: Option<WaitForResources>Retry the start while the account lacks the resources for the run, i.e. while the API
rejects it with an ApiError whose error_type is
actor-memory-limit-exceeded or concurrent-runs-limit-exceeded. Both clear as other
runs or builds finish. The start is retried every 10 seconds; any other error is returned
right away.
WaitForResources::Forever retries until the run starts.
WaitForResources::ForSecs stops retrying after that many seconds and returns the last
error. None (the default) makes a single attempt.
A run that requests more memory than the account’s whole memory limit is rejected with
actor-memory-limit-exceeded as well and never starts, so Forever retries it forever.