- release_tracks: [ALPHA, BETA]
  help_text:
    brief: Create a Unit
    description: Create a Unit
    examples: |-
      To create the Unit, run:

      $ {command}
  arguments:
    params:
    - help_text: |-
        Identifier. The resource name (full URI of the resource) following the standard naming
        scheme:

          "projects/{project}/locations/{location}/units/{unit}"
      is_positional: true
      request_id_field: unitId
      resource_spec: !REF googlecloudsdk.command_lib.saas_runtime.resources:unit
      required: true
    - arg_name: unit-kind
      help_text: |-
        Reference to the UnitKind this Unit belongs to (required and immutable once
        created).
      is_positional: false
      resource_spec: !REF googlecloudsdk.command_lib.saas_runtime.resources:unit_kind
      resource_method_params:
        unit.unitKind: '{__relative_name__}'
      required: false
    - arg_name: tenant
      help_text: |-
        Reference to the Saas Tenant resource this unit belongs to. This for
        example informs the maintenance policies to use for scheduling future
        updates on a unit. (optional and immutable once created)
      is_positional: false
      resource_spec: !REF googlecloudsdk.command_lib.saas_runtime.resources:tenant
      resource_method_params:
        unit.tenant: '{__relative_name__}'
      required: false
    - group:
        required: false
        help_text: |-
          Captures requested directives for performing future maintenance on the
          unit. This includes a request for the unit to skip maintenance for a period
          of time and remain pinned to its current release as well as controls for
          postponing maintenance scheduled in future.
        params:
        - arg_name: maintenance-pinned-until-time
          api_field: unit.maintenance.pinnedUntilTime
          required: false
          repeated: false
          type: googlecloudsdk.core.util.times:ParseDateTime
          processor: googlecloudsdk.core.util.times:FormatDateTime
          help_text: |-
            If present, it fixes the release on the unit until the given time; i.e.
            changes to the release field will be rejected. Rollouts should and will
            also respect this by not requesting an upgrade in the first place.
    - arg_name: management-mode
      api_field: unit.managementMode
      required: false
      help_text: |-
        Indicates whether the Unit life cycle is controlled
        by the user or by the system.
        Immutable once created.
      choices:
      - arg_value: user
        enum_value: MANAGEMENT_MODE_USER
        help_text: |-
          Unit's lifecycle is managed by the user.
      - arg_value: system
        enum_value: MANAGEMENT_MODE_SYSTEM
        help_text: |-
          The system will decide when to deprovision and delete the unit.
          User still can deprovision or delete the unit manually.
    - arg_name: labels
      api_field: unit.labels
      required: false
      repeated: true
      help_text: |-
        The labels on the resource, which can be used for categorization.
        similar to Kubernetes resource labels.
      spec:
      - api_field: key
      - api_field: value
  request:
    api_version: v1beta1
    collection:
    - saasservicemgmt.projects.locations.units