# -*- 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
  help_text:
    brief: Create accountConnectors
    description: Create an accountConnector
    examples: |-
      To create the accountConnector, run:

      $ {command}
  arguments:
    params:
    - group:
        mutex: true
        help_text: |-
          Arguments for the account connector config.
        params:
        - group:
            api_field: accountConnector.providerOauthConfig
            required: false
            help_text: |-
              ProviderOAuthConfig is the OAuth config for a provider.
            params:
            - group:
                mutex: true
                help_text: |-
                  Arguments for the oauth provider id.
                params:
                - arg_name: provider-oauth-config-system-id
                  api_field: accountConnector.providerOauthConfig.systemProviderId
                  required: false
                  help_text: |-
                    Developer Connect provided OAuth.
                  choices:
                  - arg_value: github
                    enum_value: GITHUB
                    help_text: |-
                      GitHub provider.
                      Scopes can be found at
                      https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/scopes-for-oauth-apps#available-scopes
                  - arg_value: gitlab
                    enum_value: GITLAB
                    help_text: |-
                      GitLab provider.
                      Scopes can be found at
                      https://docs.gitlab.com/user/profile/personal_access_tokens/#personal-access-token-scopes
                  - arg_value: google
                    enum_value: GOOGLE
                    help_text: |-
                      Google provider.
                      Recommended scopes:
                        "https://www.googleapis.com/auth/drive.readonly",
                        "https://www.googleapis.com/auth/documents.readonly"
                  - arg_value: sentry
                    enum_value: SENTRY
                    help_text: |-
                      Sentry provider.
                      Scopes can be found at
                      https://docs.sentry.io/api/permissions/
                  - arg_value: rovo
                    enum_value: ROVO
                    help_text: |-
                      Rovo provider.
                      Must select the "rovo" scope.
                  - arg_value: new-relic
                    enum_value: NEW_RELIC
                    help_text: |-
                      New Relic provider.
                      No scopes are allowed.
                  - arg_value: datastax
                    enum_value: DATASTAX
                    help_text: |-
                      Datastax provider.
                      No scopes are allowed.
            - arg_name: provider-oauth-config-scopes
              api_field: accountConnector.providerOauthConfig.scopes
              required: true
              repeated: true
              help_text: |-
                User selected scopes to apply to the Oauth config
                In the event of changing scopes, user records under AccountConnector will
                be deleted and users will re-auth again.
    - help_text: |-
        Identifier. The resource name of the accountConnector, in the format
        `projects/{project}/locations/{location}/accountConnectors/{account_connector_id}`.
      is_positional: true
      is_primary_resource: true
      request_id_field: accountConnectorId
      resource_spec: !REF googlecloudsdk.command_lib.developer_connect.v1_resources:projects_locations_account_connectors
      required: true
    - arg_name: annotations
      api_field: accountConnector.annotations
      required: false
      repeated: true
      help_text: |-
        Allows users to store small amounts of arbitrary data.
      spec:
      - api_field: key
      - api_field: value
    - arg_name: etag
      api_field: accountConnector.etag
      required: false
      repeated: false
      help_text: |-
        This checksum is computed by the server based on the value of other
        fields, and may be sent on update and delete requests to ensure the
        client has an up-to-date value before proceeding.
    - arg_name: labels
      api_field: accountConnector.labels
      required: false
      repeated: true
      help_text: |-
        Labels as key value pairs
      spec:
      - api_field: key
      - api_field: value
    - 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).
    - arg_name: validate-only
      api_field: validateOnly
      action: store_true
      required: false
      type: bool
      help_text: |-
        If set, validate the request, but do not actually post it.
      default: null
  request:
    api_version: v1
    collection:
    - developerconnect.projects.locations.accountConnectors
  async:
    collection:
    - developerconnect.projects.locations.operations
