REST Resource: folders.locations.replays

Resource: Replay

A resource describing a Replay, or simulation.

JSON representation
{
  "name": string,
  "state": enum (State),
  "config": {
    object (ReplayConfig)
  },
  "resultsSummary": {
    object (ResultsSummary)
  }
}
Fields
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

enum (State)

Output only. The current state of the Replay.

config

object (ReplayConfig)

Required. The configuration used for the Replay.

resultsSummary

object (ResultsSummary)

Output only. Summary statistics about the replayed log entries.

State

The current state of the Replay.

Enums
STATE_UNSPECIFIED Default value. This value is unused.
PENDING The Replay has not started yet.
RUNNING The Replay is currently running.
SUCCEEDED The Replay has successfully completed.
FAILED The Replay has finished with an error.

ReplayConfig

The configuration used for a Replay.

JSON representation
{
  "policyOverlay": {
    string: {
      object (Policy)
    },
    ...
  },
  "logSource": enum (LogSource)
}
Fields
policyOverlay

map (key: string, value: object (Policy))

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.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

logSource

enum (LogSource)

The logs to use as input for the Replay.

LogSource

The source of the logs to use for a Replay.

Enums
LOG_SOURCE_UNSPECIFIED An unspecified log source. If the log source is unspecified, the Replay defaults to using RECENT_ACCESSES.
RECENT_ACCESSES All access logs from the last 90 days. These logs may not include logs from the most recent 7 days.

ResultsSummary

Summary statistics about the replayed log entries.

JSON representation
{
  "logCount": integer,
  "unchangedCount": integer,
  "differenceCount": integer,
  "errorCount": integer,
  "oldestDate": {
    object (Date)
  },
  "newestDate": {
    object (Date)
  }
}
Fields
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.

differenceCount

integer

The number of replayed log entries with a difference between baseline and simulated policies.

errorCount

integer

The number of log entries that could not be replayed.

oldestDate

object (Date)

The date of the oldest log entry replayed.

newestDate

object (Date)

The date of the newest log entry replayed.

Methods

create

Creates and starts a Replay using the given ReplayConfig.

get

Gets the specified Replay.

list

Lists each Replay in a project, folder, or organization.