gcloud-help/gcloud/alpha/developer-connect/connections/create

NAME
    gcloud alpha developer-connect connections create - create connections

SYNOPSIS
    gcloud alpha developer-connect connections create
        (CONNECTION : --location=LOCATION) [--annotations=[ANNOTATIONS,...]]
        [--async] [--disabled] [--etag=ETAG] [--labels=[LABELS,...]]
        [--github-config-app=GITHUB_CONFIG_APP
          : --github-config-app-installation-id=GITHUB_CONFIG_APP_INSTALLATION_ID (--github-config-authorizer-credential-oauth-token-secret-version=GITHUB_CONFIG_AUTHORIZER_CREDENTIAL_OAUTH_TOKEN_SECRET_VERSION : --secret=SECRET)]
        [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (ALPHA) Create a connection

EXAMPLES
    To create the connection, run:

        $ gcloud alpha developer-connect connections create

POSITIONAL ARGUMENTS
     Connection resource - Identifier. The resource name of the connection, in
     the format
     projects/{project}/locations/{location}/connections/{connection_id}. The
     arguments in this group can be used to specify the attributes of this
     resource. (NOTE) Some attributes are not given arguments in this group but
     can be set in other ways.

     To set the project attribute:
      ◆ provide the argument connection on the command line with a fully
        specified name;
      ◆ set the property core/project;
      ◆ provide the argument --project on the command line.

     This must be specified.

       CONNECTION
          ID of the connection or fully qualified identifier for the
          connection.

          To set the connection attribute:
          ▸ provide the argument connection on the command line.

          This positional argument must be specified if any of the other
          arguments in this group are specified.

       --location=LOCATION
          locations TBD

          To set the location attribute:
          ▸ provide the argument connection on the command line with a fully
            specified name;
          ▸ provide the argument --location on the command line.

FLAGS
     --annotations=[ANNOTATIONS,...]
        Allows clients to store small amounts of arbitrary data.

         KEY
            Sets KEY value.

         VALUE
            Sets VALUE value.

        Shorthand Example:

            --annotations=string=string

        JSON Example:

            --annotations='{"string": "string"}'

        File Example:

            --annotations=path_to_file.(yaml|json)

     --async
        Return immediately, without waiting for the operation in progress to
        complete.

     --disabled
        If disabled is set to true, functionality is disabled for this
        connection. Repository based API methods and webhooks processing for
        repositories in this connection will be disabled.

     --etag=ETAG
        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.

     --labels=[LABELS,...]
        Labels as key value pairs.

         KEY
            Keys must start with a lowercase character and contain only hyphens
            (-), underscores (_), lowercase characters, and numbers.

         VALUE
            Values must contain only hyphens (-), underscores (_), lowercase
            characters, and numbers.

        Shorthand Example:

            --labels=string=string

        JSON Example:

            --labels='{"string": "string"}'

        File Example:

            --labels=path_to_file.(yaml|json)

     Arguments for the connection config.

       Configuration for connections to github.com.

         --github-config-app=GITHUB_CONFIG_APP
            The GitHub Application that was installed to the GitHub user or
            organization. GITHUB_CONFIG_APP must be one of:

             developer-connect
                The Developer Connect GitHub Application.
             firebase
                The Firebase GitHub Application.

            This flag argument must be specified if any of the other arguments
            in this group are specified.

         --github-config-app-installation-id=GITHUB_CONFIG_APP_INSTALLATION_ID
            GitHub App installation id.

         Represents an OAuth token of the account that authorized the
         Connection, and associated metadata.

           SecretVersion resource - A SecretManager resource containing the
           OAuth token that authorizes the connection. Format:
           projects/*/secrets/*/versions/*. The arguments in this group can be
           used to specify the attributes of this resource. (NOTE) Some
           attributes are not given arguments in this group but can be set in
           other ways.

           To set the project attribute:
            ◇ provide the argument
              --github-config-authorizer-credential-oauth-token-secret-version
              on the command line with a fully specified name;
            ◇ set the property core/project;
            ◇ provide the argument --project on the command line.

           This must be specified.

             --github-config-authorizer-credential-oauth-token-secret-version=GITHUB_CONFIG_AUTHORIZER_CREDENTIAL_OAUTH_TOKEN_SECRET_VERSION
                ID of the secretVersion or fully qualified identifier for the
                secretVersion.

                To set the secret-version attribute:
                ▹ provide the argument
                  --github-config-authorizer-credential-oauth-token-secret-version
                  on the command line.

                This flag argument must be specified if any of the other
                arguments in this group are specified.

             --secret=SECRET
                secrets TBD

                To set the secret attribute:
                ▹ provide the argument
                  --github-config-authorizer-credential-oauth-token-secret-version
                  on the command line with a fully specified name;
                ▹ provide the argument --secret on the command line.

GCLOUD WIDE FLAGS
    These flags are available to all commands: --access-token-file, --account,
    --billing-project, --configuration, --flags-file, --flatten, --format,
    --help, --impersonate-service-account, --log-http, --project, --quiet,
    --trace-token, --user-output-enabled, --verbosity.

    Run $ gcloud help for details.

API REFERENCE
    This command uses the developerconnect/v1 API. The full documentation for
    this API can be found at:
    http://cloud.google.com/developer-connect/docs/overview

NOTES
    This command is currently in alpha and might change without notice. If this
    command fails with API permission errors despite specifying the correct
    project, you might be trying to access an API with an invitation-only early
    access allowlist.