# -*- coding: utf-8 -*- #
# Copyright 2025 Google LLC. All Rights Reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#    http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
# NOTE: This file is autogenerated and should not be edited by hand.
# AUTOGEN_CLI_VERSION: HEAD
- release_tracks:
  - ALPHA
  auto_generated: true
  hidden: true
  help_text:
    brief: Create an experiment
    description: |
      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:

      $ {command} test-experiment-id --experiment-template=test-template-id --location=asia-east1 --display-name=test-experiment
  arguments:
    params:
    - help_text: |-
        Identifier. The resource name of the Experiment, of the form:
        projects/{project_id}/locations/{location}/experiments/{experiment_id}.
      is_positional: true
      is_primary_resource: true
      request_id_field: experimentId
      resource_spec: !REF googlecloudsdk.command_lib.fault_testing.v1alpha_resources:projects_locations_experiments
      required: true
    - arg_name: display-name
      api_field: experiment.displayName
      required: false
      repeated: false
      help_text: |-
        Human-readable name of the experiment
    - arg_name: description
      api_field: experiment.description
      required: false
      repeated: false
      help_text: |-
        Optional user-provided description or notes. Min length 0, max length 2000.
    - arg_name: experiment-template
      help_text: |-
        The resource name of an ExperimentTemplate to create this experiment
        from. Required. Format
        projects/{project_id}/locations/{location}/experimentTemplates/{experimentTemplateId}.
        The server will read the named template and use its contents to fill
        template_display_name, template_description,
        template_duration, and effective_action.
      is_positional: false
      is_primary_resource: false
      resource_spec: !REF googlecloudsdk.command_lib.fault_testing.v1alpha_resources:projects_locations_experiment_templates
      resource_method_params:
        experiment.experimentTemplate: '{__relative_name__}'
      required: true
  request:
    api_version: v1alpha
    collection:
    - faulttesting.projects.locations.experiments
