Skip to main content
Version: Next

ActorCallOptions

Hierarchy

Index

Properties

optionalinheritedbuild

build?: string

Tag or number of the actor build to run (e.g. beta or 1.2.345). If not provided, the run uses build tag or number from the default actor run configuration (typically latest).

optionalinheritedcontentType

contentType?: string

Content type for the input. If not specified, input is expected to be an object that will be stringified to JSON and content type set to application/json; charset=utf-8. If options.contentType is specified, then input must be a String or Buffer.

optionalinheritedforcePermissionLevel

forcePermissionLevel?: string

Override the Actor's permissions for this run. If not set, the Actor will run with permissions configured in the Actor settings.

optionallog

log?: null | Log | default

Log instance that should be used to redirect actor run logs to. If undefined or 'default' the pre-defined Log will be created and used. If null, no log redirection will occur.

optionalinheritedmaxItems

maxItems?: number

Specifies the maximum number of dataset items that will be charged for pay-per-result Actors. This does NOT guarantee that the Actor will return only this many items. It only ensures you won't be charged for more than this number of items. Only works for pay-per-result Actors. Value can be accessed in the Actor run using ACTOR_MAX_PAID_DATASET_ITEMS environment variable.

optionalinheritedmaxTotalChargeUsd

maxTotalChargeUsd?: number

Specifies the maximum cost of the Actor run. This parameter is used only for pay-per-event Actors. It allows you to limit the amount charged to your subscription. You can access the maximum cost in your Actor by using the ACTOR_MAX_TOTAL_CHARGE_USD environment variable.

optionalinheritedmemory

memory?: number

Memory in megabytes which will be allocated for the new actor run. If not provided, the run uses memory of the default actor run configuration.

optionalinheritedrestartOnError

restartOnError?: boolean

Determines whether the run will be restarted if it fails.

optionalinheritedtimeout

timeout?: number

Timeout for the actor run in seconds. Zero value means there is no timeout. If not provided, the run uses timeout of the default actor run configuration.

optionalwaitSecs

waitSecs?: number

Wait time in seconds for the actor run to finish.

optionalinheritedwebhooks

webhooks?: readonly WebhookUpdateData[]

Specifies optional webhooks associated with the actor run, which can be used to receive a notification e.g. when the actor finished or failed, see ad hook webhooks documentation for detailed description.