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

# POST /v1/{+parent}/replays

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

Creates and starts a Replay using the given ReplayConfig.

## Path parameters

- `parent` string, required

## Request body

- GoogleCloudPolicysimulatorV1Replay — A resource describing a `Replay`, or simulation.
  - `name` string — Output only. The resource name of the `Replay`, which has the following format: `{projects|folders|organizations}/{resource-id}/locations/global/replays/{replay-id}`, where `{resource-id}` is the ID of the project, folder, or organization that owns the Replay. Example: `projects/my-example-project/locations/global/replays/506a5f7f-38ce-4d7d-8e03-479ce1833c36`
  - `state` 'STATE_UNSPECIFIED' | 'PENDING' | 'RUNNING' | 'SUCCEEDED' | 'FAILED' — Output only. The current state of the `Replay`.
  - `resultsSummary` GoogleCloudPolicysimulatorV1ReplayResultsSummary — Summary statistics about the replayed log entries.
    - `newestDate` GoogleTypeDate — Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp
      - `year` integer — Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
      - `day` integer — Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
      - `month` integer — Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
    - `differenceCount` integer — The number of replayed log entries with a difference between baseline and simulated policies.
    - `logCount` integer — The total number of log entries replayed.
    - `unchangedCount` integer — The number of replayed log entries with no difference between baseline and simulated policies.
    - `errorCount` integer — The number of log entries that could not be replayed.
    - `oldestDate` GoogleTypeDate — Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp
      - `year` integer — Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
      - `day` integer — Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
      - `month` integer — Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
  - `config` GoogleCloudPolicysimulatorV1ReplayConfig — The configuration used for a Replay.
    - `policyOverlay` object — A mapping of the resources that you want to simulate policies for and the policies that you want to simulate. Keys are the full resource names for the resources. For example, `//cloudresourcemanager.googleapis.com/projects/my-project`. For examples of full resource names for Google Cloud services, see https://cloud.google.com/iam/help/troubleshooter/full-resource-names. Values are Policy objects representing the policies that you want to simulate. Replays automatically take into account any IAM policies inherited through the resource hierarchy, and any policies set on descendant resources. You do not need to include these policies in the policy overlay.
    - `logSource` 'LOG_SOURCE_UNSPECIFIED' | 'RECENT_ACCESSES' — The logs to use as input for the Replay.

## Response `200`

Successful response

---

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