---
title: "POST /v1/{+parent}/evaluations"
method: POST
path: "/v1/{+parent}/evaluations"
tags: ["projects"]
---

# POST /v1/{+parent}/evaluations

`POST /v1/{+parent}/evaluations`

Creates a new Evaluation in a given project and location.

## Path parameters

- `parent` string, required

## Query parameters

- `evaluationId` string
- `requestId` string

## Request body

- Evaluation — Represents a Workload Manager Evaluation configuration. An Evaluation defines a set of rules to be validated against a scope of Cloud resources.
  - `customRulesBucket` string — The Cloud Storage bucket name for custom rules.
  - `evaluationType` 'EVALUATION_TYPE_UNSPECIFIED' | 'SAP' | 'SQL_SERVER' | 'OTHER' — Evaluation type.
  - `createTime` string, google-datetime — Output only. [Output only] Create time stamp.
  - `name` string — Name of resource that has the form `projects/{project_id}/locations/{location_id}/evaluations/{evaluation_id}`.
  - `ruleNames` string[] — The names of the rules used for this evaluation.
  - `bigQueryDestination` BigQueryDestination — BigQuery destination for evaluation results.
    - `destinationDataset` string — Optional. Destination dataset to save evaluation results.
    - `createNewResultsTable` boolean — Optional. Determines if a new results table will be created when an Execution is created.
  - `labels` object — Labels as key value pairs.
  - `resourceFilter` ResourceFilter — Resource filter for an evaluation defining the scope of resources to be evaluated.
    - `gceInstanceFilter` GceInstanceFilter — A filter for matching Compute Engine instances.
      - `serviceAccounts` string[] — If non-empty, only Compute Engine instances associated with at least one of the provided service accounts will be included in the evaluation.
    - `scopes` string[] — The scopes of evaluation resource. Format: * `projects/{project_id}` * `folders/{folder_id}` * `organizations/{organization_id}`
    - `resourceIdPatterns` string[] — The pattern to filter resources by their id For example, a pattern of ".*prod-cluster.*" will match all resources that contain "prod-cluster" in their ID.
    - `inclusionLabels` object — Labels to filter resources by. Each key-value pair in the map must exist on the resource for it to be included (e.g. VM instance labels). For example, specifying `{ "env": "prod", "database": "nosql" }` will only include resources that have labels `env=prod` and `database=nosql`.
  - `schedule` string — Crontab format schedule for scheduled evaluation, currently only supports the following fixed schedules: * `0 */1 * * *` # Hourly * `0 */6 * * *` # Every 6 hours * `0 */12 * * *` # Every 12 hours * `0 0 */1 * *` # Daily * `0 0 */7 * *` # Weekly * `0 0 */14 * *` # Every 14 days * `0 0 1 */1 *` # Monthly
  - `resourceStatus` ResourceStatus — The lifecycle status of an Evaluation resource.
    - `state` 'STATE_UNSPECIFIED' | 'CREATING' | 'ACTIVE' | 'DELETING' — State of the Evaluation resource.
  - `description` string — Description of the Evaluation.
  - `kmsKey` string — Optional. Immutable. Customer-managed encryption key name, in the format projects/*/locations/*/keyRings/*/cryptoKeys/*. The key will be used for CMEK encryption of the evaluation resource.
  - `updateTime` string, google-datetime — Output only. [Output only] Update time stamp.

## 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)