--- title: "GET /v1/projects/{projectsId}/locations/{locationsId}/connections" method: GET path: "/v1/projects/{projectsId}/locations/{locationsId}/connections" tags: ["projects"] --- # GET /v1/projects/{projectsId}/locations/{locationsId}/connections `GET /v1/projects/{projectsId}/locations/{locationsId}/connections` ## Request - Base URL: `https://developerconnect.googleapis.com` - URL: `https://developerconnect.googleapis.com/v1/projects/{projectsId}/locations/{locationsId}/connections` - Auth: OAuth 2 and OAuth 2 - Implicit: `https://accounts.google.com/o/oauth2/auth` - Scopes: `https://www.googleapis.com/auth/cloud-platform` - Authorization code: `https://accounts.google.com/o/oauth2/auth` - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/cloud-platform` Lists Connections in a given project and location. ## Path parameters - `projectsId` string, required - `locationsId` string, required ## Query parameters - `filter` string - `orderBy` string - `pageSize` integer - `pageToken` string ## Response `200` Successful response - ListConnectionsResponse: Message for response to listing Connections - `connections` Connection[]: The list of Connections. - `annotations` object: Optional. Allows clients to store small amounts of arbitrary data. - `bitbucketCloudConfig` BitbucketCloudConfig: Configuration for connections to an instance of Bitbucket Cloud. - `authorizerCredential` UserCredential: Represents a personal access token that authorized the Connection, and associated metadata. - `userTokenSecretVersion` string: Required. A SecretManager resource containing the user token that authorizes the Developer Connect connection. Format: `projects/*/secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/*` (if regional secrets are supported in that location). - `username` string: Output only. The username associated with this token. - `readAuthorizerCredential` UserCredential: Represents a personal access token that authorized the Connection, and associated metadata. - `userTokenSecretVersion` string: Required. A SecretManager resource containing the user token that authorizes the Developer Connect connection. Format: `projects/*/secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/*` (if regional secrets are supported in that location). - `username` string: Output only. The username associated with this token. - `webhookSecretSecretVersion` string: Required. Immutable. SecretManager resource containing the webhook secret used to verify webhook events, formatted as `projects/*/secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/*` (if regional secrets are supported in that location). This is used to validate and create webhooks. - `workspace` string: Required. The Bitbucket Cloud Workspace ID to be connected to Google Cloud Platform. - `bitbucketDataCenterConfig` BitbucketDataCenterConfig: Configuration for connections to an instance of Bitbucket Data Center. - `authorizerCredential` UserCredential: Represents a personal access token that authorized the Connection, and associated metadata. - `userTokenSecretVersion` string: Required. A SecretManager resource containing the user token that authorizes the Developer Connect connection. Format: `projects/*/secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/*` (if regional secrets are supported in that location). - `username` string: Output only. The username associated with this token. - `hostUri` string: Required. The URI of the Bitbucket Data Center host this connection is for. - `readAuthorizerCredential` UserCredential: Represents a personal access token that authorized the Connection, and associated metadata. - `userTokenSecretVersion` string: Required. A SecretManager resource containing the user token that authorizes the Developer Connect connection. Format: `projects/*/secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/*` (if regional secrets are supported in that location). - `username` string: Output only. The username associated with this token. - `serverVersion` string: Output only. Version of the Bitbucket Data Center server running on the `host_uri`. - `serviceDirectoryConfig` ServiceDirectoryConfig: ServiceDirectoryConfig represents Service Directory configuration for a connection. - `service` string: Required. The Service Directory service name. Format: projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}. - `sslCaCertificate` string: Optional. SSL certificate authority to trust when making requests to Bitbucket Data Center. - `webhookSecretSecretVersion` string: Required. Immutable. SecretManager resource containing the webhook secret used to verify webhook events, formatted as `projects/*/secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/*` (if regional secrets are supported in that location). This is used to validate webhooks. - `createTime` string, google-datetime: Output only. Create timestamp. - `cryptoKeyConfig` CryptoKeyConfig: The crypto key configuration. This field is used by the Customer-managed encryption keys (CMEK) feature. - `keyReference` string: Required. The name of the key which is used to encrypt/decrypt customer data. For key in Cloud KMS, the key should be in the format of `projects/*/locations/*/keyRings/*/cryptoKeys/*`. - `deleteTime` string, google-datetime: Output only. Delete timestamp. - `disabled` boolean: Optional. 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` string: Optional. 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. - `gitProxyConfig` GitProxyConfig: Configuration for proxies. For legacy reasons, this message is named `GitProxyConfig`, but it includes settings for both Git and HTTP proxy. - `enabled` boolean: Optional. Setting this to true allows the Git proxy to be used for performing Git operations on the repositories linked in the connection. - `httpProxyBaseUri` string: Output only. The base URI for the HTTP proxy endpoint. Has the format `https://{generatedID}-c-h-{shortRegion}.developerconnect.dev` Populated only when enabled is set to true. This endpoint is used by other Google services that integrate with Developer Connect. - `githubConfig` GitHubConfig: Configuration for connections to github.com. - `appInstallationId` string, int64: Optional. GitHub App installation id. - `authorizerCredential` OAuthCredential: Represents an OAuth token of the account that authorized the Connection, and associated metadata. - `oauthTokenSecretVersion` string: Required. A SecretManager resource containing the OAuth token that authorizes the connection. Format: `projects/*/secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/*` (if regional secrets are supported in that location). - `username` string: Output only. The username associated with this token. - `githubApp` 'GIT_HUB_APP_UNSPECIFIED' | 'DEVELOPER_CONNECT' | 'FIREBASE' | 'GEMINI_CODE_ASSIST' | 'DATAFORM': Required. Immutable. The GitHub Application that was installed to the GitHub user or organization. - `installationUri` string: Output only. The URI to navigate to in order to manage the installation associated with this GitHubConfig. - `githubEnterpriseConfig` GitHubEnterpriseConfig: Configuration for connections to an instance of GitHub Enterprise. - `appId` string, int64: Optional. ID of the GitHub App created from the manifest. - `appInstallationId` string, int64: Optional. ID of the installation of the GitHub App. - `appSlug` string: Output only. The URL-friendly name of the GitHub App. - `hostUri` string: Required. The URI of the GitHub Enterprise host this connection is for. - `installationUri` string: Output only. The URI to navigate to in order to manage the installation associated with this GitHubEnterpriseConfig. - `organization` string: Optional. Immutable. GitHub Enterprise organization in which the GitHub App is created. - `privateKeySecretVersion` string: Optional. SecretManager resource containing the private key of the GitHub App, formatted as `projects/*/secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/*` (if regional secrets are supported in that location). - `serverVersion` string: Output only. GitHub Enterprise version installed at the host_uri. - `serviceDirectoryConfig` ServiceDirectoryConfig: ServiceDirectoryConfig represents Service Directory configuration for a connection. - `service` string: Required. The Service Directory service name. Format: projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}. - `sslCaCertificate` string: Optional. SSL certificate to use for requests to GitHub Enterprise. - `webhookSecretSecretVersion` string: Optional. SecretManager resource containing the webhook secret of the GitHub App, formatted as `projects/*/secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/*` (if regional secrets are supported in that location). - `gitlabConfig` GitLabConfig: Configuration for connections to gitlab.com. - `authorizerCredential` UserCredential: Represents a personal access token that authorized the Connection, and associated metadata. - `userTokenSecretVersion` string: Required. A SecretManager resource containing the user token that authorizes the Developer Connect connection. Format: `projects/*/secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/*` (if regional secrets are supported in that location). - `username` string: Output only. The username associated with this token. - `readAuthorizerCredential` UserCredential: Represents a personal access token that authorized the Connection, and associated metadata. - `userTokenSecretVersion` string: Required. A SecretManager resource containing the user token that authorizes the Developer Connect connection. Format: `projects/*/secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/*` (if regional secrets are supported in that location). - `username` string: Output only. The username associated with this token. - `webhookSecretSecretVersion` string: Required. Immutable. SecretManager resource containing the webhook secret of a GitLab project, formatted as `projects/*/secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/*` (if regional secrets are supported in that location). This is used to validate webhooks. - `gitlabEnterpriseConfig` GitLabEnterpriseConfig: Configuration for connections to an instance of GitLab Enterprise. - `authorizerCredential` UserCredential: Represents a personal access token that authorized the Connection, and associated metadata. - `userTokenSecretVersion` string: Required. A SecretManager resource containing the user token that authorizes the Developer Connect connection. Format: `projects/*/secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/*` (if regional secrets are supported in that location). - `username` string: Output only. The username associated with this token. - `hostUri` string: Required. The URI of the GitLab Enterprise host this connection is for. - `readAuthorizerCredential` UserCredential: Represents a personal access token that authorized the Connection, and associated metadata. - `userTokenSecretVersion` string: Required. A SecretManager resource containing the user token that authorizes the Developer Connect connection. Format: `projects/*/secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/*` (if regional secrets are supported in that location). - `username` string: Output only. The username associated with this token. - `serverVersion` string: Output only. Version of the GitLab Enterprise server running on the `host_uri`. - `serviceDirectoryConfig` ServiceDirectoryConfig: ServiceDirectoryConfig represents Service Directory configuration for a connection. - `service` string: Required. The Service Directory service name. Format: projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}. - `sslCaCertificate` string: Optional. SSL Certificate Authority certificate to use for requests to GitLab Enterprise instance. - `webhookSecretSecretVersion` string: Required. Immutable. SecretManager resource containing the webhook secret of a GitLab project, formatted as `projects/*/secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/*` (if regional secrets are supported in that location). This is used to validate webhooks. - `httpConfig` GenericHTTPEndpointConfig: Defines the configuration for connections to an HTTP service provider. - `basicAuthentication` BasicAuthentication: Basic authentication with username and password. - `passwordSecretVersion` string: The password SecretManager secret version to authenticate as. - `username` string: Required. The username to authenticate as. - `bearerTokenAuthentication` BearerTokenAuthentication: Bearer token authentication with a token. - `tokenSecretVersion` string: Optional. The token SecretManager secret version to authenticate as. - `hostUri` string: Required. Immutable. The service provider's https endpoint. - `serviceDirectoryConfig` ServiceDirectoryConfig: ServiceDirectoryConfig represents Service Directory configuration for a connection. - `service` string: Required. The Service Directory service name. Format: projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}. - `sslCaCertificate` string: Optional. The SSL certificate to use for requests to the HTTP service provider. - `installationState` InstallationState: Describes stage and necessary actions to be taken by the user to complete the installation. Used for GitHub and GitHub Enterprise based connections. - `actionUri` string: Output only. Link to follow for next action. Empty string if the installation is already complete. - `message` string: Output only. Message of what the user should do next to continue the installation. Empty string if the installation is already complete. - `stage` 'STAGE_UNSPECIFIED' | 'PENDING_CREATE_APP' | 'PENDING_USER_OAUTH' | 'PENDING_INSTALL_APP' | 'COMPLETE': Output only. Current step of the installation process. - `labels` object: Optional. Labels as key value pairs - `name` string: Identifier. The resource name of the connection, in the format `projects/{project}/locations/{location}/connections/{connection_id}`. - `reconciling` boolean: Output only. Set to true when the connection is being set up or updated in the background. - `secureSourceManagerInstanceConfig` SecureSourceManagerInstanceConfig: Configuration for connections to Secure Source Manager instance - `instance` string: Required. Immutable. Secure Source Manager instance resource, formatted as `projects/*/locations/*/instances/*` - `uid` string: Output only. A system-assigned unique identifier for the Connection. - `updateTime` string, google-datetime: Output only. Update timestamp. - `nextPageToken` string: A token identifying a page of results the server should return. - `unreachable` string[]: Locations that could not be reached. --- [API](https://skmtc.dev/google/apis/developerconnect.md) - [All operations](https://skmtc.dev/google/apis/developerconnect/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/developerconnect/revisions/2f1551e5d3d6?raw)