REST Resource: projects.locations.connections

Resource: Connection

Connection represents an instance of connector.

JSON representation 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "description": string,
  "connectorVersion": string,
  "status": {
    object (ConnectionStatus)
  },
  "configVariables": [
    {
      object (ConfigVariable)
    }
  ],
  "authConfig": {
    object (AuthConfig)
  },
  "lockConfig": {
    object (LockConfig)
  },
  "destinationConfigs": [
    {
      object (DestinationConfig)
    }
  ],
  "imageLocation": string,
  "serviceAccount": string,
  "serviceDirectory": string,
  "envoyImageLocation": string,
  "suspended": boolean,
  "nodeConfig": {
    object (NodeConfig)
  },
  "logConfig": {
    object (LogConfig)
  },
  "sslConfig": {
    object (SslConfig)
  },
  "subscriptionType": enum (SubscriptionType),
  "connectionRevision": string,
  "eventingEnablementType": enum (EventingEnablementType),
  "eventingConfig": {
    object (EventingConfig)
  },
  "connectorVersionLaunchStage": enum (LaunchStage),
  "eventingRuntimeData": {
    object (EventingRuntimeData)
  },
  "isTrustedTester": boolean
}
Fields
name

string

Output only. Resource name of the Connection. Format: projects/{project}/locations/{location}/connections/{connection}
createTime

string (Timestamp format)

Output only. Created time.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Output only. Updated time.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
labels

map (key: string, value: string)

Optional. Resource labels to represent user-provided metadata. Refer to cloud documentation on labels for more details. https://cloud.google.com/compute/docs/labeling-resources

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
description

string

Optional. Description of the resource.
connectorVersion

string

Required. Connector version on which the connection is created. The format is: projects/*/locations/*/providers/*/connectors/*/versions/* Only global location is supported for ConnectorVersion resource.
status

object (ConnectionStatus)

Output only. Current status of the connection.
configVariables[]

object (ConfigVariable)

Optional. Configuration for configuring the connection with an external system.
authConfig

object (AuthConfig)

Optional. Configuration for establishing the connection's authentication with an external system.
lockConfig

object (LockConfig)

Optional. Configuration that indicates whether or not the Connection can be edited.
destinationConfigs[]

object (DestinationConfig)

Optional. Configuration of the Connector's destination. Only accepted for Connectors that accepts user defined destination(s).
imageLocation

string

Output only. GCR location where the runtime image is stored. formatted like: gcr.io/{bucketName}/{imageName}
serviceAccount

string

Optional. Service account needed for runtime plane to access Google Cloud resources.
serviceDirectory

string

Output only. The name of the Service Directory service name. Used for Private Harpoon to resolve the ILB address. e.g. "projects/cloud-connectors-e2e-testing/locations/us-central1/namespaces/istio-system/services/istio-ingressgateway-connectors"
envoyImageLocation

string

Output only. GCR location where the envoy image is stored. formatted like: gcr.io/{bucketName}/{imageName}
suspended

boolean

Optional. Suspended indicates if a user has suspended a connection or not.
nodeConfig

object (NodeConfig)

Optional. Node configuration for the connection.
logConfig

object (LogConfig)

Optional. Log configuration for the connection.
sslConfig

object (SslConfig)

Optional. Ssl config of a connection
subscriptionType

enum (SubscriptionType)

Output only. This subscription type enum states the subscription type of the project.
connectionRevision

string (int64 format)

Output only. Connection revision. This field is only updated when the connection is created or updated by User.
eventingEnablementType

enum (EventingEnablementType)

Optional. Eventing enablement type. Will be nil if eventing is not enabled.
eventingConfig

object (EventingConfig)

Optional. Eventing config of a connection
connectorVersionLaunchStage

enum (LaunchStage)

Output only. Flag to mark the version indicating the launch stage.
eventingRuntimeData

object (EventingRuntimeData)

Output only. Eventing Runtime Data.
isTrustedTester

boolean

Output only. Is trusted tester program enabled for the project.

ConnectionStatus

ConnectionStatus indicates the state of the connection.

JSON representation 
{
  "state": enum (State),
  "description": string,
  "status": string
}
Fields
state

enum (State)

State.
description

string

Description.
status

string

Status provides detailed information for the state.

State

All the possible Connection State.

Enums
STATE_UNSPECIFIED Connection does not have a state yet.
CREATING Connection is being created.
ACTIVE Connection is running and ready for requests.
INACTIVE Connection is stopped.
DELETING Connection is being deleted.
UPDATING Connection is being updated.
ERROR Connection is not running due to an error.
AUTHORIZATION_REQUIRED Connection is not running because the authorization configuration is not complete.

LockConfig

Determines whether or no a connection is locked. If locked, a reason must be specified.

JSON representation 
{
  "locked": boolean,
  "reason": string
}
Fields
locked

boolean

Indicates whether or not the connection is locked.
reason

string

Describes why a connection is locked.

NodeConfig

Node configuration for the connection.

JSON representation 
{
  "minNodeCount": integer,
  "maxNodeCount": integer
}
Fields
minNodeCount

integer

Minimum number of nodes in the runtime nodes.
maxNodeCount

integer

Maximum number of nodes in the runtime nodes.

LogConfig

Log configuration for the connection.

JSON representation 
{
  "enabled": boolean
}
Fields
enabled

boolean

Enabled represents whether logging is enabled or not for a connection.

SslConfig

SSL Configuration of a connection

JSON representation 
{
  "type": enum (SslType),
  "trustModel": enum (TrustModel),
  "privateServerCertificate": {
    object (Secret)
  },
  "clientCertificate": {
    object (Secret)
  },
  "clientPrivateKey": {
    object (Secret)
  },
  "clientPrivateKeyPass": {
    object (Secret)
  },
  "serverCertType": enum (CertType),
  "clientCertType": enum (CertType),
  "useSsl": boolean,
  "additionalVariables": [
    {
      object (ConfigVariable)
    }
  ]
}
Fields
type

enum (SslType)

Controls the ssl type for the given connector version.
trustModel

enum (TrustModel)

Trust Model of the SSL connection
privateServerCertificate

object (Secret)

Private Server Certificate. Needs to be specified if trust model is PRIVATE.
clientCertificate

object (Secret)

Client Certificate
clientPrivateKey

object (Secret)

Client Private Key
clientPrivateKeyPass

object (Secret)

Secret containing the passphrase protecting the Client Private Key
serverCertType

enum (CertType)

Type of Server Cert (PEM/JKS/.. etc.)
clientCertType

enum (CertType)

Type of Client Cert (PEM/JKS/.. etc.)
useSsl

boolean

Bool for enabling SSL
additionalVariables[]

object (ConfigVariable)

Additional SSL related field values

TrustModel

Enum for Ttust Model

Enums
PUBLIC Public Trust Model. Takes the Default Java trust store.
PRIVATE Private Trust Model. Takes custom/private trust store.
INSECURE Insecure Trust Model. Accept all certificates.

SubscriptionType

Subscription Types

Enums
SUBSCRIPTION_TYPE_UNSPECIFIED Unspecified subscription type.
PAY_G PayG subscription.
PAID Paid Subscription.

EventingEnablementType

Eventing Enablement Type enum.

Enums
EVENTING_ENABLEMENT_TYPE_UNSPECIFIED Eventing Enablement Type Unspecifeied.
EVENTING_AND_CONNECTION Both connection and eventing.
ONLY_EVENTING Only Eventing.

EventingConfig

Eventing Configuration of a connection

JSON representation 
{
  "registrationDestinationConfig": {
    object (DestinationConfig)
  },
  "authConfig": {
    object (AuthConfig)
  },
  "listenerAuthConfig": {
    object (AuthConfig)
  },
  "additionalVariables": [
    {
      object (ConfigVariable)
    }
  ],
  "enrichmentEnabled": boolean,
  "privateConnectivityEnabled": boolean,
  "eventsListenerIngressEndpoint": string,
  "deadLetterConfig": {
    object (DeadLetterConfig)
  },
  "proxyDestinationConfig": {
    object (DestinationConfig)
  }
}
Fields
registrationDestinationConfig

object (DestinationConfig)

Registration endpoint for auto registration.
authConfig

object (AuthConfig)

Auth details for the webhook adapter.
listenerAuthConfig

object (AuthConfig)

Optional. Auth details for the event listener.
additionalVariables[]

object (ConfigVariable)

Additional eventing related field values
enrichmentEnabled

boolean

Enrichment Enabled.
privateConnectivityEnabled

boolean

Optional. Private Connectivity Enabled.
eventsListenerIngressEndpoint

string

Optional. Ingress endpoint of the event listener. This is used only when private connectivity is enabled.
deadLetterConfig

object (DeadLetterConfig)

Optional. Dead letter configuration for eventing of a connection.
proxyDestinationConfig

object (DestinationConfig)

Optional. Proxy for Eventing auto-registration.

DeadLetterConfig

Dead Letter configuration details provided by the user.

JSON representation 
{
  "topic": string,
  "projectId": string
}
Fields
topic

string

Optional. Topic to push events which couldn't be processed.
projectId

string

Optional. Project which has the topic given.

EventingRuntimeData

Eventing runtime data has the details related to eventing managed by the system.

JSON representation 
{
  "status": {
    object (EventingStatus)
  },
  "eventsListenerEndpoint": string,
  "eventsListenerPscSa": string
}
Fields
status

object (EventingStatus)

Output only. Current status of eventing.
eventsListenerEndpoint

string

Output only. Events listener endpoint. The value will populated after provisioning the events listener.
eventsListenerPscSa

string

Output only. Events listener PSC Service attachment. The value will be populated after provisioning the events listener with private connectivity enabled.

EventingStatus

EventingStatus indicates the state of eventing.

JSON representation 
{
  "state": enum (State),
  "description": string
}
Fields
state

enum (State)

Output only. State.
description

string

Output only. Description of error if State is set to "ERROR".

State

All the possible Eventing States.

Enums
STATE_UNSPECIFIED Default state.
ACTIVE Eventing is enabled and ready to receive events.
ERROR Eventing is not active due to an error.
INGRESS_ENDPOINT_REQUIRED Ingress endpoint required.

DeploymentModel

Enum for different deployment models

Enums
DEPLOYMENT_MODEL_UNSPECIFIED Deployment model is not specified.
GKE_MST Default model gke mst.
CLOUD_RUN_MST Cloud run mst.

Methods

create

 Creates a new Connection in a given project and location.

delete

 Deletes a single Connection.

get

 Gets details of a single Connection.

getConnectionSchemaMetadata

 Gets schema metadata of a connection.

getIamPolicy

 Gets the access control policy for a resource.

list

 Lists Connections in a given project and location.

patch

 Updates the parameters of a single Connection.

repairEventing

 RepaiEventing tries to repair eventing related event subscriptions.

setIamPolicy

 Sets the access control policy on the specified resource.

testIamPermissions

 Returns permissions that a caller has on the specified resource.