Sign in
Actors/Actor runs

Resurrect run

[DEPRECATED] API endpoints related to run of the Actor were moved under new namespace actor-runs.Resurrects a finished Actor run and returns an object that contains all the details about the resurrected run.

Only finished runs, i.e. runs with status FINISHED, FAILED, ABORTED and TIMED-OUT can be resurrected. Run status will be updated to RUNNING and its container will be restarted with the same storages (the same behaviour as when the run gets migrated to the new server).

For more information, see the Actor docs.

post/v2/actors/{actorId}/runs/{runId}/resurrect

Path parameters

actorIdstring required
Example:compass~google-maps-extractor

Actor ID or the username of the Actor owner and the Actor name, separated by a tilde (~).

runIdstring required
Example:3KH8gEpp4d8uQSe8T

Actor run ID.

Query parameters

buildstring
Example:0.1.234

Specifies the Actor build to run. It can be either a build tag or build number. By default, the run is resurrected with the same build it originally used. Specifically, if a run was first started with the latest tag, which resolves to version 0.0.3 at the time, a run resurrected without this parameter will continue running with 0.0.3, even if latest already points to a newer build.

timeoutnumber double
Example:60

Optional timeout for the run, in seconds. By default, the run uses the timeout specified in the run that is being resurrected.

memorynumber double
Example:256

Memory limit for the run, in megabytes. The amount of memory can be set to a power of 2 with a minimum of 128. By default, the run uses the memory limit specified in the run that is being resurrected.

restartOnErrorboolean

Determines whether the resurrected run will be restarted if it fails. By default, the resurrected run uses the same setting as before.

Response

Example response

{
  "data": {
    "id": "HG7ML7M8z78YcAPEB",
    "actId": "HDSasDasz78YcAPEB",
    "userId": "7sT5jcggjjA9fNcxF",
    "actorTaskId": "KJHSKHausidyaJKHs",
    "startedAt": "2019-11-30T07:34:24.202Z",
    "finishedAt": "2019-12-12T09:30:12.202Z",
    "statusMessage": "Actor is running",
    "pricingInfo": {
      "apifyMarginPercentage": 0.2
    },
    "stats": {
      "inputBodyLen": 240,
      "resurrectCount": 2,
      "memAvgBytes": 267874071.9,
      "memMaxBytes": 404713472,
      "cpuAvgUsage": 33.7532101107538,
      "cpuMaxUsage": 169.650735534941,
      "netRxBytes": 103508042,
      "netTxBytes": 4854600,
      "durationMillis": 248472,
      "runTimeSecs": 248.472,
      "computeUnits": 0.13804
    },
    "chargedEventCounts": {
      "actor-start": 1,
      "page-crawled": 150,
      "data-extracted": 75
    },
    "options": {
      "build": "latest",
      "timeoutSecs": 300,
      "memoryMbytes": 1024,
      "diskMbytes": 2048,
      "maxItems": 1000,
      "maxTotalChargeUsd": 5
    },
    "buildId": "7sT5jcggjjA9fNcxF",
    "generalAccess": "RESTRICTED",
    "defaultKeyValueStoreId": "eJNzqsbPiopwJcgGQ",
    "defaultDatasetId": "wmKPijuyDnPZAPRMk",
    "defaultRequestQueueId": "FL35cSF7jrxr3BY39",
    "storageIds": {
      "datasets": {
        "default": "wmKPijuyDnPZAPRMk"
      },
      "keyValueStores": {
        "default": "eJNzqsbPiopwJcgGQ"
      },
      "requestQueues": {
        "default": "FL35cSF7jrxr3BY39"
      }
    },
    "buildNumber": "0.0.36",
    "containerUrl": "https://g8kd8kbc5ge8.runs.apify.net",
    "isContainerServerReady": true,
    "gitBranchName": "master",
    "usage": {
      "ACTOR_COMPUTE_UNITS": 3,
      "DATASET_READS": 4,
      "DATASET_WRITES": 4,
      "KEY_VALUE_STORE_READS": 5,
      "KEY_VALUE_STORE_WRITES": 3,
      "KEY_VALUE_STORE_LISTS": 5,
      "REQUEST_QUEUE_READS": 2,
      "REQUEST_QUEUE_WRITES": 1,
      "DATA_TRANSFER_INTERNAL_GBYTES": 1,
      "DATA_TRANSFER_EXTERNAL_GBYTES": 3,
      "PROXY_RESIDENTIAL_TRANSFER_GBYTES": 34,
      "PROXY_SERPS": 3
    },
    "usageTotalUsd": 0.2654,
    "usageUsd": {
      "ACTOR_COMPUTE_UNITS": 0.0003,
      "DATASET_READS": 0.0001,
      "DATASET_WRITES": 0.0001,
      "KEY_VALUE_STORE_READS": 0.0001,
      "KEY_VALUE_STORE_WRITES": 0.00005,
      "KEY_VALUE_STORE_LISTS": 0.0001,
      "REQUEST_QUEUE_READS": 0.0001,
      "REQUEST_QUEUE_WRITES": 0.0001,
      "DATA_TRANSFER_INTERNAL_GBYTES": 0.001,
      "DATA_TRANSFER_EXTERNAL_GBYTES": 0.003,
      "PROXY_RESIDENTIAL_TRANSFER_GBYTES": 0.034,
      "PROXY_SERPS": 0.003
    },
    "metamorphs": [
      {
        "createdAt": "2019-11-30T07:39:24.202Z",
        "actorId": "nspoEjklmnsF2oosD",
        "buildId": "ME6oKecqy5kXDS4KQ",
        "inputKey": "INPUT-METAMORPH-1"
      }
    ],
    "platformUsageBillingModel": "USER"
  }
}

Changes

Changed in 3 of the 7 revisions of this API.141

  • 0a98d6a098a47See the full diff
    • ●

      added the new cannot-publish-actor-task enum value to the error/type response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new cannot-publish-actor-task enum value to the error/type response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new cannot-publish-actor-task enum value to the error/type response property for the response status 402

      response-property-enum-value-added

    • ●

      added the new cannot-publish-actor-task enum value to the error/type response property for the response status 403

      response-property-enum-value-added

    • ●

      added the new cannot-publish-actor-task enum value to the error/type response property for the response status 404

      response-property-enum-value-added

    • ●

      added the new cannot-publish-actor-task enum value to the error/type response property for the response status 405

      response-property-enum-value-added

    • ●

      added the new cannot-publish-actor-task enum value to the error/type response property for the response status 429

      response-property-enum-value-added

  • 5ceb2cdfe6161See the full diff
    • ○

      api operation id act_run_resurrect_post removed and replaced with actor_run_resurrect_post

      api-operation-id-removed

  • b94a8abdfff17See the full diff
    • ●

      added the new cannot-monetize-without-payout-billing-info enum value to the error/type response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new cannot-monetize-without-payout-billing-info enum value to the error/type response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new cannot-monetize-without-payout-billing-info enum value to the error/type response property for the response status 402

      response-property-enum-value-added

    • ●

      added the new cannot-monetize-without-payout-billing-info enum value to the error/type response property for the response status 403

      response-property-enum-value-added

    • ●

      added the new cannot-monetize-without-payout-billing-info enum value to the error/type response property for the response status 404

      response-property-enum-value-added

    • ●

      added the new cannot-monetize-without-payout-billing-info enum value to the error/type response property for the response status 405

      response-property-enum-value-added

    • ●

      added the new cannot-monetize-without-payout-billing-info enum value to the error/type response property for the response status 429

      response-property-enum-value-added