# -*- 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 Managed Lustre instance
    description: |
      Creates a Managed Lustre instance.
    examples: |-
      To create an instance `my-instance` in location `us-central1-a` with 18000 Gib capacity run:

      $ {command} my-instance --capacity-gib=18000 --location=us-central1-a --network=projects/my-project/global/networks/default --filesystem=lustrefs --per-unit-storage-throughput=1000
  arguments:
    params:
    - help_text: |-
        Identifier.
        The name of the instance.
      is_positional: true
      is_primary_resource: true
      request_id_field: instanceId
      resource_spec: !REF googlecloudsdk.command_lib.lustre.v1_resources:projects_locations_instances
      required: true
    - arg_name: filesystem
      api_field: instance.filesystem
      required: true
      repeated: false
      help_text: |-
        The filesystem name for this instance. This name is used by client-side
        tools, including when mounting the instance. Must be eight characters or
        less and can only contain letters and numbers.
    - arg_name: capacity-gib
      api_field: instance.capacityGib
      required: true
      repeated: false
      type: long
      help_text: |-
        The storage capacity of the instance in gibibytes (GiB). Allowed values
        are from `18000` to `954000`, in increments of 9000.
    - arg_name: network
      help_text: |-
        The full name of the VPC network to which the instance is connected.
        Must be in the format
        `projects/{project_id}/global/networks/{network_name}`.
      is_positional: false
      is_primary_resource: false
      resource_spec: !REF googlecloudsdk.command_lib.lustre.v1_resources:projects_none_networks
      resource_method_params:
        instance.network: '{__relative_name__}'
      required: true
    - arg_name: description
      api_field: instance.description
      required: false
      repeated: false
      help_text: |-
        A user-readable description of the instance.
    - arg_name: labels
      api_field: instance.labels
      required: false
      repeated: true
      help_text: |-
        Labels as key value pairs.
      spec:
      - api_field: key
      - api_field: value
    - arg_name: per-unit-storage-throughput
      api_field: instance.perUnitStorageThroughput
      required: true
      repeated: false
      type: long
      help_text: |-
        The throughput of the instance in MB/s/TiB.
        Valid values are 125, 250, 500, 1000.
    - arg_name: gke-support-enabled
      api_field: instance.gkeSupportEnabled
      action: store_true
      required: false
      type: bool
      help_text: |-
        Indicates whether you want to enable support for GKE clients. By default,
        GKE clients are not supported.
        Deprecated. No longer required for GKE instance creation.
      default: null
    - 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:
    - lustre.projects.locations.instances
  async:
    collection:
    - lustre.projects.locations.operations
