NAME
    gcloud alpha fault-testing experiments create - create an experiment

SYNOPSIS
    gcloud alpha fault-testing experiments create EXPERIMENT
        --experiment-template=EXPERIMENT_TEMPLATE [--description=DESCRIPTION]
        [--display-name=DISPLAY_NAME] [--location=LOCATION]
        [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (ALPHA) Create an experiment.

EXAMPLES
    To create an experiment test-experiment-id associated with experiment
    template test-template-id in location asia-east1 with display name
    test-experiment run:

        $ gcloud alpha fault-testing experiments create test-experiment-id \
            --experiment-template=test-template-id --location=asia-east1 \
            --display-name=test-experiment

POSITIONAL ARGUMENTS
     Experiment resource - Identifier. Unique identifier for the experiment.
     Format:
     projects/{project_id}/locations/{location}/experiments/{experiment_id}.
     This represents a Cloud resource. (NOTE) Some attributes are not given
     arguments in this group but can be set in other ways.

     To set the project attribute:
      ◆ provide the argument experiment on the command line with a fully
        specified name;
      ◆ provide the argument --project on the command line;
      ◆ set the property core/project.

     To set the location attribute:
      ◆ provide the argument experiment on the command line with a fully
        specified name;
      ◆ provide the argument --location on the command line.

     This must be specified.

       EXPERIMENT
          ID of the experiment or fully qualified identifier for the
          experiment.

          To set the experiment attribute:
          ▸ provide the argument experiment on the command line.

REQUIRED FLAGS
     ExperimentTemplate resource - The unique identifier of the reusable
     experiment template used to configure the experiment. This field
     determines the type of fault, target, and duration. Format:
     projects/{project_id}/locations/{location}/experimentTemplates/{experimentTemplateId}.
     This represents a Cloud resource. (NOTE) Some attributes are not given
     arguments in this group but can be set in other ways.

     To set the project attribute:
      ◆ provide the argument --experiment-template on the command line with a
        fully specified name;
      ◆ provide the argument --project on the command line;
      ◆ set the property core/project.

     To set the location attribute:
      ◆ provide the argument --experiment-template on the command line with a
        fully specified name;
      ◆ provide the argument --location on the command line.

     This must be specified.

       --experiment-template=EXPERIMENT_TEMPLATE
          ID of the experimentTemplate or fully qualified identifier for the
          experimentTemplate.

          To set the experiment-template attribute:
          ▸ provide the argument --experiment-template on the command line.

OPTIONAL FLAGS
     --description=DESCRIPTION
        Notes or details to describe the purpose or context of the experiment.
        Minimum length is 0, maximum length is 2000.

     --display-name=DISPLAY_NAME
        A human-readable name of the experiment.

     --location=LOCATION
        For resources [experiment, experiment-template], provides fallback
        value for resource location attribute. When the resource's full URI
        path is not provided, location will fallback to this flag value.

GCLOUD WIDE FLAGS
    These flags are available to all commands: --access-token-file, --account,
    --billing-project, --configuration, --flags-file, --flatten, --format,
    --help, --impersonate-service-account, --log-http, --project, --quiet,
    --trace-token, --user-output-enabled, --verbosity.

    Run $ gcloud help for details.

API REFERENCE
    This command uses the faulttesting/v1alpha API. The full documentation for
    this API can be found at:

NOTES
    This command is currently in alpha and might change without notice. If this
    command fails with API permission errors despite specifying the correct
    project, you might be trying to access an API with an invitation-only early
    access allowlist.

