gcloud beta developer-connect connections update

NAME
gcloud beta developer-connect connections update - update the parameters of a single connection
SYNOPSIS
gcloud beta developer-connect connections updateCONNECTION[--[no-]allow-missing][--async][--[no-]disabled][--etag=ETAG][--location=LOCATION][--namespace=NAMESPACE][--request-id=REQUEST_ID][--secret=SECRET][--[no-]validate-only][--annotations=[ANNOTATIONS,…]    |--update-annotations=[UPDATE_ANNOTATIONS,…]--clear-annotations    |--remove-annotations=REMOVE_ANNOTATIONS][--bitbucket-cloud-config-authorizer-credential-user-token-secret-version=BITBUCKET_CLOUD_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION--bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version=BITBUCKET_CLOUD_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION--bitbucket-cloud-config-workspace=BITBUCKET_CLOUD_CONFIG_WORKSPACE--clear-bitbucket-cloud-config    |--bitbucket-data-center-config-authorizer-credential-user-token-secret-version=BITBUCKET_DATA_CENTER_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION--bitbucket-data-center-config-host-uri=BITBUCKET_DATA_CENTER_CONFIG_HOST_URI--bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version=BITBUCKET_DATA_CENTER_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION--bitbucket-data-center-config-service-directory=BITBUCKET_DATA_CENTER_CONFIG_SERVICE_DIRECTORY--bitbucket-data-center-config-ssl-ca-certificate=BITBUCKET_DATA_CENTER_CONFIG_SSL_CA_CERTIFICATE--clear-bitbucket-data-center-config    |--clear-github-config--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    |--clear-github-enterprise-config--github-enterprise-config-app-id=GITHUB_ENTERPRISE_CONFIG_APP_ID--github-enterprise-config-app-installation-id=GITHUB_ENTERPRISE_CONFIG_APP_INSTALLATION_ID--github-enterprise-config-host-uri=GITHUB_ENTERPRISE_CONFIG_HOST_URI--github-enterprise-config-service-directory=GITHUB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY--github-enterprise-config-ssl-ca-certificate=GITHUB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE--clear-github-enterprise-config-private-key-secret-version    |--github-enterprise-config-private-key-secret-version=GITHUB_ENTERPRISE_CONFIG_PRIVATE_KEY_SECRET_VERSION--clear-github-enterprise-config-webhook-secret-version    |--github-enterprise-config-webhook-secret-version=GITHUB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION    |--clear-gitlab-config--gitlab-config-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION--gitlab-config-read-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION    |--clear-gitlab-enterprise-config--gitlab-enterprise-config-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION--gitlab-enterprise-config-host-uri=GITLAB_ENTERPRISE_CONFIG_HOST_URI--gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION--gitlab-enterprise-config-service-directory=GITLAB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY--gitlab-enterprise-config-ssl-ca-certificate=GITLAB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE][--clear-crypto-key-config [--crypto-key-config-reference=CRYPTO_KEY_CONFIG_REFERENCE :--key-ring=KEY_RING]][--clear-git-proxy-config--[no-]git-proxy-config-enabled][--labels=[LABELS,…]    |--update-labels=[UPDATE_LABELS,…]--clear-labels    |--remove-labels=REMOVE_LABELS][GCLOUD_WIDE_FLAG]
DESCRIPTION
(BETA) Update a connection.
EXAMPLES
To update the labels of a connectionmy-connection in locationus-central1 run:
gcloudbetadeveloper-connectconnectionsupdatemy-connection--labels=key1=value1--location=us-central1
POSITIONAL ARGUMENTS
Connection resource - Identifier. The resource name of the connection, in theformatprojects/{project}/locations/{location}/connections/{connection_id}.This represents a Cloud resource. (NOTE) Some attributes are not given argumentsin this group but can be set in other ways.

To set theproject attribute:

  • provide the argumentconnection on the command line with a fullyspecified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

To set thelocation attribute:

  • provide the argumentconnection on the command line with a fullyspecified name;
  • provide the argument--location on the command line.

This must be specified.

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

To set theconnection attribute:

  • provide the argumentconnection on the command line.
FLAGS
--[no-]allow-missing
If set to true, and the connection is not found a new connection will becreated. In this situationupdate_mask is ignored. The creationwill succeed only if the input connection has all the necessary information (e.ga github_config with both user_oauth_token and installation_id properties). Use--allow-missing to enable and--no-allow-missing todisable.
--async
Return immediately, without waiting for the operation in progress to complete.
--[no-]disabled
If disabled is set to true, functionality is disabled for this connection.Repository based API methods and webhooks processing for repositories in thisconnection will be disabled. Use--disabled to enable and--no-disabled to disable.
--etag=ETAG
This checksum is computed by the server based on the value of other fields, andmay be sent on update and delete requests to ensure the client has an up-to-datevalue before proceeding.
--location=LOCATION
For resources [connection,bitbucket-cloud-config-authorizer-credential-user-token-secret-version,bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version,bitbucket-data-center-config-authorizer-credential-user-token-secret-version,bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version,bitbucket-data-center-config-service-directory, crypto-key-config-reference,github-config-authorizer-credential-oauth-token-secret-version,github-enterprise-config-private-key-secret-version,github-enterprise-config-service-directory,github-enterprise-config-webhook-secret-version,gitlab-config-authorizer-credential-user-token-secret-version,gitlab-config-read-authorizer-credential-user-token-secret-version,gitlab-enterprise-config-authorizer-credential-user-token-secret-version,gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version,gitlab-enterprise-config-service-directory,http-config-basic-authentication-password-secret-version,http-config-bearer-token-authentication-secret-version,http-config-service-directory], provides fallback value for resource locationattribute. When the resource's full URI path is not provided, location willfallback to this flag value.
--namespace=NAMESPACE
For resources [bitbucket-data-center-config-service-directory,github-enterprise-config-service-directory,gitlab-enterprise-config-service-directory, http-config-service-directory],provides fallback value for resource namespace attribute. When the resource'sfull URI path is not provided, namespace will fallback to this flag value.
--request-id=REQUEST_ID
An optional request ID to identify requests. Specify a unique request ID so thatif you must retry your request, the server will know to ignore the request if ithas already been completed. The server will guarantee that for at least 60minutes since the first request.

For example, consider a situation where you make an initial request and therequest times out. If you make the request again with the same request ID, theserver can check if original operation with the same request ID was received,and if so, will ignore the second request. This prevents clients fromaccidentally creating duplicate commitments.

The request ID must be a valid UUID with the exception that zero UUID is notsupported (00000000-0000-0000-0000-000000000000).

--secret=SECRET
For resources[bitbucket-cloud-config-authorizer-credential-user-token-secret-version,bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version,bitbucket-data-center-config-authorizer-credential-user-token-secret-version,bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version,github-config-authorizer-credential-oauth-token-secret-version,github-enterprise-config-private-key-secret-version,github-enterprise-config-webhook-secret-version,gitlab-config-authorizer-credential-user-token-secret-version,gitlab-config-read-authorizer-credential-user-token-secret-version,gitlab-enterprise-config-authorizer-credential-user-token-secret-version,gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version,http-config-basic-authentication-password-secret-version,http-config-bearer-token-authentication-secret-version], provides fallback valuefor resource secret attribute. When the resource's full URI path is notprovided, secret will fallback to this flag value.
--[no-]validate-only
If set, validate the request, but do not actually post it. Use--validate-only to enable and--no-validate-only todisable.
Update annotations.

At most one of these can be specified:

--annotations=[ANNOTATIONS,…]
Set annotations to new value. Allows clients to store small amounts of arbitrarydata.
KEY
SetsKEY value.
VALUE
SetsVALUE value.
Shorthand Example:
--annotations=string=string

JSON Example:

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

File Example:

--annotations=path_to_file.(yaml|json)
--update-annotations=[UPDATE_ANNOTATIONS,…]
Update annotations value or add key value pair. Allows clients to store smallamounts of arbitrary data.
KEY
SetsKEY value.
VALUE
SetsVALUE value.
Shorthand Example:
--update-annotations=string=string

JSON Example:

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

File Example:

--update-annotations=path_to_file.(yaml|json)
At most one of these can be specified:
--clear-annotations
Clear annotations value and set to empty map.
--remove-annotations=REMOVE_ANNOTATIONS
Remove existing value from map annotations. Setsremove_annotationsvalue.Shorthand Example:
--remove-annotations=string,string

JSON Example:

--remove-annotations=["string"]

File Example:

--remove-annotations=path_to_file.(yaml|json)
Arguments for the connection config.

At most one of these can be specified:

Configuration for connections to an instance of Bitbucket Cloud.
Represents a personal access token that authorized the Connection, andassociated metadata.
SecretVersion resource - A SecretManager resource containing the user token thatauthorizes the Developer Connect connection. Format:projects/*/secrets/*/versions/* orprojects/*/locations/*/secrets/*/versions/* (if regional secretsare supported in that location). This represents a Cloud resource. (NOTE) Someattributes are not given arguments in this group but can be set in other ways.

To set theproject attribute:

  • provide the argument--bitbucket-cloud-config-authorizer-credential-user-token-secret-versionon the command line with a fully specified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

To set thelocation attribute:

  • provide the argument--bitbucket-cloud-config-authorizer-credential-user-token-secret-versionon the command line with a fully specified name;
  • provide the argument--location on the command line.

To set thesecret attribute:

  • provide the argument--bitbucket-cloud-config-authorizer-credential-user-token-secret-versionon the command line with a fully specified name;
  • provide the argument--secret on the command line. This resourcecan be one of the following types:[developerconnect.projects.locations.secrets.versions,developerconnect.projects.secrets.versions].
--bitbucket-cloud-config-authorizer-credential-user-token-secret-version=BITBUCKET_CLOUD_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION
ID of the secretVersion or fully qualified identifier for the secretVersion.

To set thesecret_version attribute:

  • provide the argument--bitbucket-cloud-config-authorizer-credential-user-token-secret-versionon the command line.
Represents a personal access token that authorized the Connection, andassociated metadata.
SecretVersion resource - A SecretManager resource containing the user token thatauthorizes the Developer Connect connection. Format:projects/*/secrets/*/versions/* orprojects/*/locations/*/secrets/*/versions/* (if regional secretsare supported in that location). This represents a Cloud resource. (NOTE) Someattributes are not given arguments in this group but can be set in other ways.

To set theproject attribute:

  • provide the argument--bitbucket-cloud-config-read-authorizer-credential-user-token-secret-versionon the command line with a fully specified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

To set thelocation attribute:

  • provide the argument--bitbucket-cloud-config-read-authorizer-credential-user-token-secret-versionon the command line with a fully specified name;
  • provide the argument--location on the command line.

To set thesecret attribute:

  • provide the argument--bitbucket-cloud-config-read-authorizer-credential-user-token-secret-versionon the command line with a fully specified name;
  • provide the argument--secret on the command line. This resourcecan be one of the following types:[developerconnect.projects.locations.secrets.versions,developerconnect.projects.secrets.versions].
--bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version=BITBUCKET_CLOUD_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION
ID of the secretVersion or fully qualified identifier for the secretVersion.

To set thesecret_version attribute:

  • provide the argument--bitbucket-cloud-config-read-authorizer-credential-user-token-secret-versionon the command line.
--bitbucket-cloud-config-workspace=BITBUCKET_CLOUD_CONFIG_WORKSPACE
The Bitbucket Cloud Workspace ID to be connected to Google Cloud Platform.
--clear-bitbucket-cloud-config
Set connection.bitbucketCloudConfig back to default value.
Configuration for connections to an instance of Bitbucket Data Center.
Represents a personal access token that authorized the Connection, andassociated metadata.
SecretVersion resource - A SecretManager resource containing the user token thatauthorizes the Developer Connect connection. Format:projects/*/secrets/*/versions/* orprojects/*/locations/*/secrets/*/versions/* (if regional secretsare supported in that location). This represents a Cloud resource. (NOTE) Someattributes are not given arguments in this group but can be set in other ways.

To set theproject attribute:

  • provide the argument--bitbucket-data-center-config-authorizer-credential-user-token-secret-versionon the command line with a fully specified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

To set thelocation attribute:

  • provide the argument--bitbucket-data-center-config-authorizer-credential-user-token-secret-versionon the command line with a fully specified name;
  • provide the argument--location on the command line.

To set thesecret attribute:

  • provide the argument--bitbucket-data-center-config-authorizer-credential-user-token-secret-versionon the command line with a fully specified name;
  • provide the argument--secret on the command line. This resourcecan be one of the following types:[developerconnect.projects.locations.secrets.versions,developerconnect.projects.secrets.versions].
--bitbucket-data-center-config-authorizer-credential-user-token-secret-version=BITBUCKET_DATA_CENTER_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION
ID of the secretVersion or fully qualified identifier for the secretVersion.

To set thesecret_version attribute:

  • provide the argument--bitbucket-data-center-config-authorizer-credential-user-token-secret-versionon the command line.
--bitbucket-data-center-config-host-uri=BITBUCKET_DATA_CENTER_CONFIG_HOST_URI
The URI of the Bitbucket Data Center host this connection is for.
Represents a personal access token that authorized the Connection, andassociated metadata.
SecretVersion resource - A SecretManager resource containing the user token thatauthorizes the Developer Connect connection. Format:projects/*/secrets/*/versions/* orprojects/*/locations/*/secrets/*/versions/* (if regional secretsare supported in that location). This represents a Cloud resource. (NOTE) Someattributes are not given arguments in this group but can be set in other ways.

To set theproject attribute:

  • provide the argument--bitbucket-data-center-config-read-authorizer-credential-user-token-secret-versionon the command line with a fully specified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

To set thelocation attribute:

  • provide the argument--bitbucket-data-center-config-read-authorizer-credential-user-token-secret-versionon the command line with a fully specified name;
  • provide the argument--location on the command line.

To set thesecret attribute:

  • provide the argument--bitbucket-data-center-config-read-authorizer-credential-user-token-secret-versionon the command line with a fully specified name;
  • provide the argument--secret on the command line. This resourcecan be one of the following types:[developerconnect.projects.locations.secrets.versions,developerconnect.projects.secrets.versions].
--bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version=BITBUCKET_DATA_CENTER_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION
ID of the secretVersion or fully qualified identifier for the secretVersion.

To set thesecret_version attribute:

  • provide the argument--bitbucket-data-center-config-read-authorizer-credential-user-token-secret-versionon the command line.
ServiceDirectoryConfig represents Service Directory configuration for aconnection.
Service resource - The Service Directory service name. Format:projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}.This represents a Cloud resource. (NOTE) Some attributes are not given argumentsin this group but can be set in other ways.

To set theproject attribute:

  • provide the argument--bitbucket-data-center-config-service-directory on the commandline with a fully specified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

To set thelocation attribute:

  • provide the argument--bitbucket-data-center-config-service-directory on the commandline with a fully specified name;
  • provide the argument--location on the command line.

To set thenamespace attribute:

  • provide the argument--bitbucket-data-center-config-service-directory on the commandline with a fully specified name;
  • provide the argument--namespace on the command line.
--bitbucket-data-center-config-service-directory=BITBUCKET_DATA_CENTER_CONFIG_SERVICE_DIRECTORY
ID of the service or fully qualified identifier for the service.

To set theservice attribute:

  • provide the argument--bitbucket-data-center-config-service-directory on the commandline.
--bitbucket-data-center-config-ssl-ca-certificate=BITBUCKET_DATA_CENTER_CONFIG_SSL_CA_CERTIFICATE
SSL certificate authority to trust when making requests to Bitbucket DataCenter.
--clear-bitbucket-data-center-config
Set connection.bitbucketDataCenterConfig back to default value.
Configuration for connections to github.com.
--clear-github-config
Set connection.githubConfig back to default value.
--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, andassociated metadata.
SecretVersion resource - A SecretManager resource containing the OAuth tokenthat authorizes the connection. Format:projects/*/secrets/*/versions/* orprojects/*/locations/*/secrets/*/versions/* (if regional secretsare supported in that location). This represents a Cloud resource. (NOTE) Someattributes are not given arguments in this group but can be set in other ways.

To set theproject attribute:

  • provide the argument--github-config-authorizer-credential-oauth-token-secret-version onthe command line with a fully specified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

To set thelocation attribute:

  • provide the argument--github-config-authorizer-credential-oauth-token-secret-version onthe command line with a fully specified name;
  • provide the argument--location on the command line.

To set thesecret attribute:

  • provide the argument--github-config-authorizer-credential-oauth-token-secret-version onthe command line with a fully specified name;
  • provide the argument--secret on the command line. This resourcecan be one of the following types:[developerconnect.projects.locations.secrets.versions,developerconnect.projects.secrets.versions].
--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 thesecret_version attribute:

  • provide the argument--github-config-authorizer-credential-oauth-token-secret-version onthe command line.
Configuration for connections to an instance of GitHub Enterprise.
--clear-github-enterprise-config
Set connection.githubEnterpriseConfig back to default value.
--github-enterprise-config-app-id=GITHUB_ENTERPRISE_CONFIG_APP_ID
ID of the GitHub App created from the manifest.
--github-enterprise-config-app-installation-id=GITHUB_ENTERPRISE_CONFIG_APP_INSTALLATION_ID
ID of the installation of the GitHub App.
--github-enterprise-config-host-uri=GITHUB_ENTERPRISE_CONFIG_HOST_URI
The URI of the GitHub Enterprise host this connection is for.
ServiceDirectoryConfig represents Service Directory configuration for aconnection.
Service resource - The Service Directory service name. Format:projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}.This represents a Cloud resource. (NOTE) Some attributes are not given argumentsin this group but can be set in other ways.

To set theproject attribute:

  • provide the argument--github-enterprise-config-service-directoryon the command line with a fully specified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

To set thelocation attribute:

  • provide the argument--github-enterprise-config-service-directoryon the command line with a fully specified name;
  • provide the argument--location on the command line.

To set thenamespace attribute:

  • provide the argument--github-enterprise-config-service-directoryon the command line with a fully specified name;
  • provide the argument--namespace on the command line.
--github-enterprise-config-service-directory=GITHUB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY
ID of the service or fully qualified identifier for the service.

To set theservice attribute:

  • provide the argument--github-enterprise-config-service-directoryon the command line.
--github-enterprise-config-ssl-ca-certificate=GITHUB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE
SSL certificate to use for requests to GitHub Enterprise.
Update github_enterprise_config_private_key_secret_version.

At most one of these can be specified:

--clear-github-enterprise-config-private-key-secret-version
Clear github_enterprise_config_private_key_secret_version value and set to null.
SecretVersion resource - Set github_enterprise_config_private_key_secret_versionto new value.

SecretManager resource containing the private key of the GitHub App, formattedasprojects/*/secrets/*/versions/* orprojects/*/locations/*/secrets/*/versions/* (if regional secretsare supported in that location). This represents a Cloud resource. (NOTE) Someattributes are not given arguments in this group but can be set in other ways.

To set theproject attribute:

  • provide the argument--github-enterprise-config-private-key-secret-version on thecommand line with a fully specified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

To set thelocation attribute:

  • provide the argument--github-enterprise-config-private-key-secret-version on thecommand line with a fully specified name;
  • provide the argument--location on the command line.

To set thesecret attribute:

  • provide the argument--github-enterprise-config-private-key-secret-version on thecommand line with a fully specified name;
  • provide the argument--secret on the command line. This resourcecan be one of the following types:[developerconnect.projects.locations.secrets.versions,developerconnect.projects.secrets.versions].
--github-enterprise-config-private-key-secret-version=GITHUB_ENTERPRISE_CONFIG_PRIVATE_KEY_SECRET_VERSION
ID of the secretVersion or fully qualified identifier for the secretVersion.

To set thesecret_version attribute:

  • provide the argument--github-enterprise-config-private-key-secret-version on thecommand line.
Update github_enterprise_config_webhook_secret_version.

At most one of these can be specified:

--clear-github-enterprise-config-webhook-secret-version
Clear github_enterprise_config_webhook_secret_version value and set to null.
SecretVersion resource - Set github_enterprise_config_webhook_secret_version tonew value.

SecretManager resource containing the webhook secret of the GitHub App,formatted asprojects/*/secrets/*/versions/* orprojects/*/locations/*/secrets/*/versions/* (if regional secretsare supported in that location). This represents a Cloud resource. (NOTE) Someattributes are not given arguments in this group but can be set in other ways.

To set theproject attribute:

  • provide the argument--github-enterprise-config-webhook-secret-version on the commandline with a fully specified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

To set thelocation attribute:

  • provide the argument--github-enterprise-config-webhook-secret-version on the commandline with a fully specified name;
  • provide the argument--location on the command line.

To set thesecret attribute:

  • provide the argument--github-enterprise-config-webhook-secret-version on the commandline with a fully specified name;
  • provide the argument--secret on the command line. This resourcecan be one of the following types:[developerconnect.projects.locations.secrets.versions,developerconnect.projects.secrets.versions].
--github-enterprise-config-webhook-secret-version=GITHUB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION
ID of the secretVersion or fully qualified identifier for the secretVersion.

To set thesecret_version attribute:

  • provide the argument--github-enterprise-config-webhook-secret-version on the commandline.
Configuration for connections to gitlab.com.
--clear-gitlab-config
Set connection.gitlabConfig back to default value.
Represents a personal access token that authorized the Connection, andassociated metadata.
SecretVersion resource - A SecretManager resource containing the user token thatauthorizes the Developer Connect connection. Format:projects/*/secrets/*/versions/* orprojects/*/locations/*/secrets/*/versions/* (if regional secretsare supported in that location). This represents a Cloud resource. (NOTE) Someattributes are not given arguments in this group but can be set in other ways.

To set theproject attribute:

  • provide the argument--gitlab-config-authorizer-credential-user-token-secret-version onthe command line with a fully specified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

To set thelocation attribute:

  • provide the argument--gitlab-config-authorizer-credential-user-token-secret-version onthe command line with a fully specified name;
  • provide the argument--location on the command line.

To set thesecret attribute:

  • provide the argument--gitlab-config-authorizer-credential-user-token-secret-version onthe command line with a fully specified name;
  • provide the argument--secret on the command line. This resourcecan be one of the following types:[developerconnect.projects.locations.secrets.versions,developerconnect.projects.secrets.versions].
--gitlab-config-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION
ID of the secretVersion or fully qualified identifier for the secretVersion.

To set thesecret_version attribute:

  • provide the argument--gitlab-config-authorizer-credential-user-token-secret-version onthe command line.
Represents a personal access token that authorized the Connection, andassociated metadata.
SecretVersion resource - A SecretManager resource containing the user token thatauthorizes the Developer Connect connection. Format:projects/*/secrets/*/versions/* orprojects/*/locations/*/secrets/*/versions/* (if regional secretsare supported in that location). This represents a Cloud resource. (NOTE) Someattributes are not given arguments in this group but can be set in other ways.

To set theproject attribute:

  • provide the argument--gitlab-config-read-authorizer-credential-user-token-secret-versionon the command line with a fully specified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

To set thelocation attribute:

  • provide the argument--gitlab-config-read-authorizer-credential-user-token-secret-versionon the command line with a fully specified name;
  • provide the argument--location on the command line.

To set thesecret attribute:

  • provide the argument--gitlab-config-read-authorizer-credential-user-token-secret-versionon the command line with a fully specified name;
  • provide the argument--secret on the command line. This resourcecan be one of the following types:[developerconnect.projects.locations.secrets.versions,developerconnect.projects.secrets.versions].
--gitlab-config-read-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION
ID of the secretVersion or fully qualified identifier for the secretVersion.

To set thesecret_version attribute:

  • provide the argument--gitlab-config-read-authorizer-credential-user-token-secret-versionon the command line.
Configuration for connections to an instance of GitLab Enterprise.
--clear-gitlab-enterprise-config
Set connection.gitlabEnterpriseConfig back to default value.
Represents a personal access token that authorized the Connection, andassociated metadata.
SecretVersion resource - A SecretManager resource containing the user token thatauthorizes the Developer Connect connection. Format:projects/*/secrets/*/versions/* orprojects/*/locations/*/secrets/*/versions/* (if regional secretsare supported in that location). This represents a Cloud resource. (NOTE) Someattributes are not given arguments in this group but can be set in other ways.

To set theproject attribute:

  • provide the argument--gitlab-enterprise-config-authorizer-credential-user-token-secret-versionon the command line with a fully specified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

To set thelocation attribute:

  • provide the argument--gitlab-enterprise-config-authorizer-credential-user-token-secret-versionon the command line with a fully specified name;
  • provide the argument--location on the command line.

To set thesecret attribute:

  • provide the argument--gitlab-enterprise-config-authorizer-credential-user-token-secret-versionon the command line with a fully specified name;
  • provide the argument--secret on the command line. This resourcecan be one of the following types:[developerconnect.projects.locations.secrets.versions,developerconnect.projects.secrets.versions].
--gitlab-enterprise-config-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION
ID of the secretVersion or fully qualified identifier for the secretVersion.

To set thesecret_version attribute:

  • provide the argument--gitlab-enterprise-config-authorizer-credential-user-token-secret-versionon the command line.
--gitlab-enterprise-config-host-uri=GITLAB_ENTERPRISE_CONFIG_HOST_URI
The URI of the GitLab Enterprise host this connection is for.
Represents a personal access token that authorized the Connection, andassociated metadata.
SecretVersion resource - A SecretManager resource containing the user token thatauthorizes the Developer Connect connection. Format:projects/*/secrets/*/versions/* orprojects/*/locations/*/secrets/*/versions/* (if regional secretsare supported in that location). This represents a Cloud resource. (NOTE) Someattributes are not given arguments in this group but can be set in other ways.

To set theproject attribute:

  • provide the argument--gitlab-enterprise-config-read-authorizer-credential-user-token-secret-versionon the command line with a fully specified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

To set thelocation attribute:

  • provide the argument--gitlab-enterprise-config-read-authorizer-credential-user-token-secret-versionon the command line with a fully specified name;
  • provide the argument--location on the command line.

To set thesecret attribute:

  • provide the argument--gitlab-enterprise-config-read-authorizer-credential-user-token-secret-versionon the command line with a fully specified name;
  • provide the argument--secret on the command line. This resourcecan be one of the following types:[developerconnect.projects.locations.secrets.versions,developerconnect.projects.secrets.versions].
--gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION
ID of the secretVersion or fully qualified identifier for the secretVersion.

To set thesecret_version attribute:

  • provide the argument--gitlab-enterprise-config-read-authorizer-credential-user-token-secret-versionon the command line.
ServiceDirectoryConfig represents Service Directory configuration for aconnection.
Service resource - The Service Directory service name. Format:projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}.This represents a Cloud resource. (NOTE) Some attributes are not given argumentsin this group but can be set in other ways.

To set theproject attribute:

  • provide the argument--gitlab-enterprise-config-service-directoryon the command line with a fully specified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

To set thelocation attribute:

  • provide the argument--gitlab-enterprise-config-service-directoryon the command line with a fully specified name;
  • provide the argument--location on the command line.

To set thenamespace attribute:

  • provide the argument--gitlab-enterprise-config-service-directoryon the command line with a fully specified name;
  • provide the argument--namespace on the command line.
--gitlab-enterprise-config-service-directory=GITLAB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY
ID of the service or fully qualified identifier for the service.

To set theservice attribute:

  • provide the argument--gitlab-enterprise-config-service-directoryon the command line.
--gitlab-enterprise-config-ssl-ca-certificate=GITLAB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE
SSL Certificate Authority certificate to use for requests to GitLab Enterpriseinstance.
The crypto key configuration. This field is used by the Customer-managedencryption keys (CMEK) feature.
--clear-crypto-key-config
Set connection.cryptoKeyConfig back to default value.
CryptoKey resource - The name of the key which is used to encrypt/decryptcustomer data. For key in Cloud KMS, the key should be in the format ofprojects/*/locations/*/keyRings/*/cryptoKeys/*. The arguments inthis group can be used to specify the attributes of this resource. (NOTE) Someattributes are not given arguments in this group but can be set in other ways.

To set theproject attribute:

  • provide the argument--crypto-key-config-reference on the commandline with a fully specified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

To set thelocation attribute:

  • provide the argument--crypto-key-config-reference on the commandline with a fully specified name;
  • provide the argument--location on the command line.
--crypto-key-config-reference=CRYPTO_KEY_CONFIG_REFERENCE
ID of the cryptoKey or fully qualified identifier for the cryptoKey.

To set thecrypto-key attribute:

  • provide the argument--crypto-key-config-reference on the commandline.

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

--key-ring=KEY_RING
The keyRing id of the cryptoKey resource.

To set thekey-ring attribute:

  • provide the argument--crypto-key-config-reference on the commandline with a fully specified name;
  • provide the argument--key-ring on the command line.
The git proxy configuration.
--clear-git-proxy-config
Set connection.gitProxyConfig back to default value.
--[no-]git-proxy-config-enabled
Setting this to true allows the git proxy to be used for performing gitoperations on the repositories linked in the connection. Use--git-proxy-config-enabled to enable and--no-git-proxy-config-enabled to disable.
Update labels.

At most one of these can be specified:

--labels=[LABELS,…]
Set labels to new value. Labels as key value pairs.
KEY
Keys must start with a lowercase character and contain only hyphens(-), underscores (_), lowercase characters, andnumbers.
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)
--update-labels=[UPDATE_LABELS,…]
Update labels value or add key value pair. Labels as key value pairs.
KEY
Keys must start with a lowercase character and contain only hyphens(-), underscores (_), lowercase characters, andnumbers.
VALUE
Values must contain only hyphens (-), underscores (_),lowercase characters, and numbers.
Shorthand Example:
--update-labels=string=string

JSON Example:

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

File Example:

--update-labels=path_to_file.(yaml|json)
At most one of these can be specified:
--clear-labels
Clear labels value and set to empty map.
--remove-labels=REMOVE_LABELS
Remove existing value from map labels. Setsremove_labels value.Shorthand Example:
--remove-labels=string,string

JSON Example:

--remove-labels=["string"]

File Example:

--remove-labels=path_to_file.(yaml|json)
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 thedeveloperconnect/v1 API. The fulldocumentation for this API can be found at:http://cloud.google.com/developer-connect/docs/overview
NOTES
This command is currently in beta and might change without notice. Thesevariants are also available:
gclouddeveloper-connectconnectionsupdate
gcloudalphadeveloper-connectconnectionsupdate

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-12-09 UTC.