# -*- 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:
  - GA
  auto_generated: true
  help_text:
    brief: Creates an Parameter Manager parameter version
    description: |
      Creates a new parameter version using the provided parameter data.
    examples: |-
      To create a parameter version `my-parameter-version` of parameter `my-parameter` in location `global` run:

      $ {command} my-parameter-version --parameter=my-parameter --location=global
  arguments:
    params:
    - help_text: |-
        Identifier. [Output only] The resource name of the ParameterVersion in the format
        `projects/*/locations/*/parameters/*/versions/*`.
      is_positional: true
      is_primary_resource: true
      request_id_field: parameterVersionId
      resource_spec: !REF googlecloudsdk.command_lib.parametermanager.v1_resources:projects_locations_parameters_versions
      required: true
    - arg_name: disabled
      api_field: parameterVersion.disabled
      action: store_true
      required: false
      type: bool
      help_text: |-
        Disabled boolean to determine if a ParameterVersion acts as a metadata only
        resource (payload is never returned if disabled is true). If true any calls
        will always default to BASIC view even if the user explicitly passes FULL
        view as part of the request. A render call on a disabled resource fails
        with an error. Default value is False.
      default: null
    - group:
        api_field: parameterVersion.payload
        required: true
        help_text: |-
          Message for storing a ParameterVersion resource's payload data
        params:
        - group:
            mutex: true
            required: true
            params:
            - arg_name: payload-data-from-file
              api_field: parameterVersion.payload.data
              json_name: dataFromFile
              required: false
              repeated: false
              type: file_type
              help_text: |-
                bytes data for storing payload.
            - arg_name: payload-data
              api_field: parameterVersion.payload.data
              required: false
              repeated: false
              type: bytes
              help_text: |-
                bytes data for storing payload.
    - arg_name: request-id
      api_field: requestId
      required: false
      repeated: false
      help_text: |-
        An optional request ID to identify requests. Specify a unique request ID
        so that if you must retry your request, the server will know to ignore
        the request if it has already been completed. The server will guarantee
        that for at least 60 minutes since the first request.

        For example, consider a situation where you make an initial request and the
        request times out. If you make the request again with the same request
        ID, the server can check if original operation with the same request ID
        was received, and if so, will ignore the second request. This prevents
        clients from accidentally creating duplicate commitments.

        The request ID must be a valid UUID with the exception that zero UUID is
        not supported (00000000-0000-0000-0000-000000000000).
  request:
    api_version: v1
    collection:
    - parametermanager.projects.locations.parameters.versions
