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-github-app=GITHUB_CONFIG_GITHUB_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-github-app=GITHUB_CONFIG_GITHUB_APP

The GitHub Application that was installed to the GitHub user or organization. GITHUB_CONFIG_GITHUB_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.