---
title: "POST /v1/{+name}/executions:run"
method: POST
path: "/v1/{+name}/executions:run"
tags: ["projects"]
---

# POST /v1/{+name}/executions:run

`POST /v1/{+name}/executions:run`

Creates a new Execution in a given project and location.

## Path parameters

- `name` string, required

## Request body

- RunEvaluationRequest — Request message for the RunEvaluation RPC.
  - `execution` Execution — Execution that represents a single run of an Evaluation.
    - `notices` Notice[] — Output only. Additional information generated by the execution.
      - `message` string — Output only. Message of the notice.
    - `state` 'STATE_UNSPECIFIED' | 'RUNNING' | 'SUCCEEDED' | 'FAILED' — Output only. [Output only] State.
    - `inventoryTime` string, google-datetime — Output only. [Output only] Inventory time stamp.
    - `evaluationId` string — Output only. [Output only] Evaluation ID.
    - `startTime` string, google-datetime — Output only. [Output only] Start time stamp.
    - `labels` object — Labels as key value pairs.
    - `name` string — The name of execution resource. The format is projects/{project}/locations/{location}/evaluations/{evaluation}/executions/{execution}.
    - `runType` 'TYPE_UNSPECIFIED' | 'ONE_TIME' | 'SCHEDULED' — Type which represents whether the execution executed directly by user or scheduled according to the `Evaluation.schedule` field.
    - `ruleResults` RuleExecutionResult[] — Output only. Execution result summary per rule.
      - `scannedResourceCount` string, int64 — Number of total scanned resources.
      - `resultCount` string, int64 — Number of violations.
      - `rule` string — Rule name as plain text like `sap-hana-configured`.
      - `message` string — Execution message, if any.
      - `state` 'STATE_UNSPECIFIED' | 'STATE_SUCCESS' | 'STATE_FAILURE' | 'STATE_SKIPPED' — Output only. The execution status.
    - `engine` 'ENGINE_UNSPECIFIED' | 'ENGINE_SCANNER' | 'V2' — Optional. Engine.
    - `resultSummary` Summary — Execution summary.
      - `failures` string, int64 — Output only. Number of failures.
      - `newFixes` string, int64 — Output only. Number of new fixes compared to the previous execution.
      - `newFailures` string, int64 — Output only. Number of new failures compared to the previous execution.
    - `endTime` string, google-datetime — Output only. [Output only] End time stamp.
    - `externalDataSources` ExternalDataSources[] — Optional. External data sources.
      - `name` string — Optional. Name of external data source. The name will be used inside the rego/sql to refer the external data.
      - `uri` string — Required. URI of external data source. example of bq table {project_ID}.{dataset_ID}.{table_ID}.
      - `assetType` string — Required. The asset type of the external data source. This can be a supported Cloud Asset Inventory asset type (see https://cloud.google.com/asset-inventory/docs/supported-asset-types) to override the default asset type, or it can be a custom type defined by the user.
      - `type` 'TYPE_UNSPECIFIED' | 'BIG_QUERY_TABLE' — Required. Type of external data source.
  - `executionId` string — Required. ID of the execution which will be created.
  - `requestId` string — Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/workloadmanager.md) · [All operations](https://skmtc.net/google/apis/workloadmanager/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/workloadmanager/versions/1fdb3d3057d0/schema)