# -*- 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 a Parameter Manager parameter
    description: |
      Creates a parameter resource with the specified name and properties. If a parameter of the given
      name already exists, this command will return an error.
    examples: |-
      To create a parameter `my-parameter` in location `global` run:

      $ {command} my-parameter --location=global
  arguments:
    params:
    - group:
        mutex: true
        help_text: |-
          Arguments for the  kms key.
        params:
        - arg_name: kms-key
          help_text: |-
            Customer managed encryption key (CMEK) to use for encrypting the
            Parameter Versions. If not set, the default Google-managed encryption key
            will be used. Cloud KMS CryptoKeys must reside in the same location as the
            Parameter. The expected format is
            `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
          is_positional: false
          is_primary_resource: false
          resource_spec: !REF googlecloudsdk.command_lib.parametermanager.v1_resources:projects_locations_key_rings_crypto_keys
          resource_method_params:
            parameter.kmsKey: '{__relative_name__}'
          required: false
    - help_text: |-
        Identifier. [Output only] The resource name of the Parameter in the format
        `projects/*/locations/*/parameters/*`.
      is_positional: true
      is_primary_resource: true
      request_id_field: parameterId
      resource_spec: !REF googlecloudsdk.command_lib.parametermanager.v1_resources:projects_locations_parameters
      required: true
    - arg_name: labels
      api_field: parameter.labels
      required: false
      repeated: true
      help_text: |-
        Labels as key value pairs
      spec:
      - api_field: key
      - api_field: value
    - arg_name: parameter-format
      api_field: parameter.format
      required: false
      help_text: |-
        Specifies the format of a Parameter.
      choices:
      - arg_value: unformatted
        enum_value: UNFORMATTED
        help_text: |-
          Unformatted.
      - arg_value: yaml
        enum_value: YAML
        help_text: |-
          YAML format.
      - arg_value: json
        enum_value: JSON
        help_text: |-
          JSON format.
    - 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
