pulumi-gcp-kotlin/com.pulumi.gcp.integrationconnectors.kotlin/Connection

Connection

class Connection : KotlinCustomResource

An Integration connectors Connection. To get more information about Connection, see:

API documentation
How-to Guides

Official Documentation

Example Usage

Integration Connectors Connection Basic

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.organizations.OrganizationsFunctions;
import com.pulumi.gcp.organizations.inputs.GetProjectArgs;
import com.pulumi.gcp.integrationconnectors.Connection;
import com.pulumi.gcp.integrationconnectors.ConnectionArgs;
import com.pulumi.gcp.integrationconnectors.inputs.ConnectionConfigVariableArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        final var testProject = OrganizationsFunctions.getProject();
        var pubsubconnection = new Connection("pubsubconnection", ConnectionArgs.builder()
            .configVariables(
                ConnectionConfigVariableArgs.builder()
                    .key("project_id")
                    .stringValue("connectors-example")
                    .build(),
                ConnectionConfigVariableArgs.builder()
                    .key("topic_id")
                    .stringValue("test")
                    .build())
            .connectorVersion(String.format("projects/%s/locations/global/providers/gcp/connectors/pubsub/versions/1", testProject.applyValue(getProjectResult -> getProjectResult.projectId())))
            .description("tf created description")
            .location("us-central1")
            .build());
    }
}

Integration Connectors Connection Advanced

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.organizations.OrganizationsFunctions;
import com.pulumi.gcp.organizations.inputs.GetProjectArgs;
import com.pulumi.gcp.secretmanager.Secret;
import com.pulumi.gcp.secretmanager.SecretArgs;
import com.pulumi.gcp.secretmanager.inputs.SecretReplicationArgs;
import com.pulumi.gcp.secretmanager.inputs.SecretReplicationUserManagedArgs;
import com.pulumi.gcp.secretmanager.SecretVersion;
import com.pulumi.gcp.secretmanager.SecretVersionArgs;
import com.pulumi.gcp.secretmanager.SecretIamMember;
import com.pulumi.gcp.secretmanager.SecretIamMemberArgs;
import com.pulumi.gcp.integrationconnectors.Connection;
import com.pulumi.gcp.integrationconnectors.ConnectionArgs;
import com.pulumi.gcp.integrationconnectors.inputs.ConnectionConfigVariableArgs;
import com.pulumi.gcp.integrationconnectors.inputs.ConnectionConfigVariableEncryptionKeyValueArgs;
import com.pulumi.gcp.integrationconnectors.inputs.ConnectionConfigVariableSecretValueArgs;
import com.pulumi.gcp.integrationconnectors.inputs.ConnectionAuthConfigArgs;
import com.pulumi.gcp.integrationconnectors.inputs.ConnectionAuthConfigUserPasswordArgs;
import com.pulumi.gcp.integrationconnectors.inputs.ConnectionAuthConfigUserPasswordPasswordArgs;
import com.pulumi.gcp.integrationconnectors.inputs.ConnectionDestinationConfigArgs;
import com.pulumi.gcp.integrationconnectors.inputs.ConnectionLockConfigArgs;
import com.pulumi.gcp.integrationconnectors.inputs.ConnectionLogConfigArgs;
import com.pulumi.gcp.integrationconnectors.inputs.ConnectionNodeConfigArgs;
import com.pulumi.gcp.integrationconnectors.inputs.ConnectionSslConfigArgs;
import com.pulumi.gcp.integrationconnectors.inputs.ConnectionSslConfigClientCertificateArgs;
import com.pulumi.gcp.integrationconnectors.inputs.ConnectionSslConfigClientPrivateKeyArgs;
import com.pulumi.gcp.integrationconnectors.inputs.ConnectionSslConfigClientPrivateKeyPassArgs;
import com.pulumi.gcp.integrationconnectors.inputs.ConnectionSslConfigPrivateServerCertificateArgs;
import com.pulumi.gcp.integrationconnectors.inputs.ConnectionEventingConfigArgs;
import com.pulumi.gcp.integrationconnectors.inputs.ConnectionEventingConfigRegistrationDestinationConfigArgs;
import com.pulumi.gcp.integrationconnectors.inputs.ConnectionEventingConfigAuthConfigArgs;
import com.pulumi.gcp.integrationconnectors.inputs.ConnectionEventingConfigAuthConfigUserPasswordArgs;
import com.pulumi.gcp.integrationconnectors.inputs.ConnectionEventingConfigAuthConfigUserPasswordPasswordArgs;
import com.pulumi.resources.CustomResourceOptions;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        final var testProject = OrganizationsFunctions.getProject();
        var secret_basic = new Secret("secret-basic", SecretArgs.builder()
            .secretId("test-secret")
            .replication(SecretReplicationArgs.builder()
                .userManaged(SecretReplicationUserManagedArgs.builder()
                    .replicas(SecretReplicationUserManagedReplicaArgs.builder()
                        .location("us-central1")
                        .build())
                    .build())
                .build())
            .build());
        var secret_version_basic = new SecretVersion("secret-version-basic", SecretVersionArgs.builder()
            .secret(secret_basic.id())
            .secretData("dummypassword")
            .build());
        var secretIam = new SecretIamMember("secretIam", SecretIamMemberArgs.builder()
            .secretId(secret_basic.id())
            .role("roles/secretmanager.admin")
            .member(String.format("serviceAccount:%s-compute@developer.gserviceaccount.com", testProject.applyValue(getProjectResult -> getProjectResult.number())))
            .build(), CustomResourceOptions.builder()
                .dependsOn(secret_version_basic)
                .build());
        var zendeskconnection = new Connection("zendeskconnection", ConnectionArgs.builder()
            .description("tf updated description")
            .location("us-central1")
            .serviceAccount(String.format("%s-compute@developer.gserviceaccount.com", testProject.applyValue(getProjectResult -> getProjectResult.number())))
            .connectorVersion(String.format("projects/%s/locations/global/providers/zendesk/connectors/zendesk/versions/1", testProject.applyValue(getProjectResult -> getProjectResult.projectId())))
            .configVariables(
                ConnectionConfigVariableArgs.builder()
                    .key("proxy_enabled")
                    .booleanValue(false)
                    .build(),
                ConnectionConfigVariableArgs.builder()
                    .key("sample_integer_value")
                    .integerValue(1)
                    .build(),
                ConnectionConfigVariableArgs.builder()
                    .key("sample_encryption_key_value")
                    .encryptionKeyValue(ConnectionConfigVariableEncryptionKeyValueArgs.builder()
                        .type("GOOGLE_MANAGED")
                        .kmsKeyName("sampleKMSKkey")
                        .build())
                    .build(),
                ConnectionConfigVariableArgs.builder()
                    .key("sample_secret_value")
                    .secretValue(ConnectionConfigVariableSecretValueArgs.builder()
                        .secretVersion(secret_version_basic.name())
                        .build())
                    .build())
            .suspended(false)
            .authConfig(ConnectionAuthConfigArgs.builder()
                .additionalVariables(
                    ConnectionAuthConfigAdditionalVariableArgs.builder()
                        .key("sample_string")
                        .stringValue("sampleString")
                        .build(),
                    ConnectionAuthConfigAdditionalVariableArgs.builder()
                        .key("sample_boolean")
                        .booleanValue(false)
                        .build(),
                    ConnectionAuthConfigAdditionalVariableArgs.builder()
                        .key("sample_integer")
                        .integerValue(1)
                        .build(),
                    ConnectionAuthConfigAdditionalVariableArgs.builder()
                        .key("sample_secret_value")
                        .secretValue(ConnectionAuthConfigAdditionalVariableSecretValueArgs.builder()
                            .secretVersion(secret_version_basic.name())
                            .build())
                        .build(),
                    ConnectionAuthConfigAdditionalVariableArgs.builder()
                        .key("sample_encryption_key_value")
                        .encryptionKeyValue(ConnectionAuthConfigAdditionalVariableEncryptionKeyValueArgs.builder()
                            .type("GOOGLE_MANAGED")
                            .kmsKeyName("sampleKMSKkey")
                            .build())
                        .build())
                .authType("USER_PASSWORD")
                .authKey("sampleAuthKey")
                .userPassword(ConnectionAuthConfigUserPasswordArgs.builder()
                    .username("user@xyz.com")
                    .password(ConnectionAuthConfigUserPasswordPasswordArgs.builder()
                        .secretVersion(secret_version_basic.name())
                        .build())
                    .build())
                .build())
            .destinationConfigs(ConnectionDestinationConfigArgs.builder()
                .key("url")
                .destinations(ConnectionDestinationConfigDestinationArgs.builder()
                    .host("https://test.zendesk.com")
                    .port(80)
                    .build())
                .build())
            .lockConfig(ConnectionLockConfigArgs.builder()
                .locked(false)
                .reason("Its not locked")
                .build())
            .logConfig(ConnectionLogConfigArgs.builder()
                .enabled(true)
                .build())
            .nodeConfig(ConnectionNodeConfigArgs.builder()
                .minNodeCount(2)
                .maxNodeCount(50)
                .build())
            .labels(Map.of("foo", "bar"))
            .sslConfig(ConnectionSslConfigArgs.builder()
                .additionalVariables(
                    ConnectionSslConfigAdditionalVariableArgs.builder()
                        .key("sample_string")
                        .stringValue("sampleString")
                        .build(),
                    ConnectionSslConfigAdditionalVariableArgs.builder()
                        .key("sample_boolean")
                        .booleanValue(false)
                        .build(),
                    ConnectionSslConfigAdditionalVariableArgs.builder()
                        .key("sample_integer")
                        .integerValue(1)
                        .build(),
                    ConnectionSslConfigAdditionalVariableArgs.builder()
                        .key("sample_secret_value")
                        .secretValue(ConnectionSslConfigAdditionalVariableSecretValueArgs.builder()
                            .secretVersion(secret_version_basic.name())
                            .build())
                        .build(),
                    ConnectionSslConfigAdditionalVariableArgs.builder()
                        .key("sample_encryption_key_value")
                        .encryptionKeyValue(ConnectionSslConfigAdditionalVariableEncryptionKeyValueArgs.builder()
                            .type("GOOGLE_MANAGED")
                            .kmsKeyName("sampleKMSKkey")
                            .build())
                        .build())
                .clientCertType("PEM")
                .clientCertificate(ConnectionSslConfigClientCertificateArgs.builder()
                    .secretVersion(secret_version_basic.name())
                    .build())
                .clientPrivateKey(ConnectionSslConfigClientPrivateKeyArgs.builder()
                    .secretVersion(secret_version_basic.name())
                    .build())
                .clientPrivateKeyPass(ConnectionSslConfigClientPrivateKeyPassArgs.builder()
                    .secretVersion(secret_version_basic.name())
                    .build())
                .privateServerCertificate(ConnectionSslConfigPrivateServerCertificateArgs.builder()
                    .secretVersion(secret_version_basic.name())
                    .build())
                .serverCertType("PEM")
                .trustModel("PRIVATE")
                .type("TLS")
                .useSsl(true)
                .build())
            .eventingEnablementType("EVENTING_AND_CONNECTION")
            .eventingConfig(ConnectionEventingConfigArgs.builder()
                .additionalVariables(
                    ConnectionEventingConfigAdditionalVariableArgs.builder()
                        .key("sample_string")
                        .stringValue("sampleString")
                        .build(),
                    ConnectionEventingConfigAdditionalVariableArgs.builder()
                        .key("sample_boolean")
                        .booleanValue(false)
                        .build(),
                    ConnectionEventingConfigAdditionalVariableArgs.builder()
                        .key("sample_integer")
                        .integerValue(1)
                        .build(),
                    ConnectionEventingConfigAdditionalVariableArgs.builder()
                        .key("sample_secret_value")
                        .secretValue(ConnectionEventingConfigAdditionalVariableSecretValueArgs.builder()
                            .secretVersion(secret_version_basic.name())
                            .build())
                        .build(),
                    ConnectionEventingConfigAdditionalVariableArgs.builder()
                        .key("sample_encryption_key_value")
                        .encryptionKeyValue(ConnectionEventingConfigAdditionalVariableEncryptionKeyValueArgs.builder()
                            .type("GOOGLE_MANAGED")
                            .kmsKeyName("sampleKMSKkey")
                            .build())
                        .build())
                .registrationDestinationConfig(ConnectionEventingConfigRegistrationDestinationConfigArgs.builder()
                    .key("registration_destination_config")
                    .destinations(ConnectionEventingConfigRegistrationDestinationConfigDestinationArgs.builder()
                        .host("https://test.zendesk.com")
                        .port(80)
                        .build())
                    .build())
                .authConfig(ConnectionEventingConfigAuthConfigArgs.builder()
                    .authType("USER_PASSWORD")
                    .authKey("sampleAuthKey")
                    .userPassword(ConnectionEventingConfigAuthConfigUserPasswordArgs.builder()
                        .username("user@xyz.com")
                        .password(ConnectionEventingConfigAuthConfigUserPasswordPasswordArgs.builder()
                            .secretVersion(secret_version_basic.name())
                            .build())
                        .build())
                    .additionalVariables(
                        ConnectionEventingConfigAuthConfigAdditionalVariableArgs.builder()
                            .key("sample_string")
                            .stringValue("sampleString")
                            .build(),
                        ConnectionEventingConfigAuthConfigAdditionalVariableArgs.builder()
                            .key("sample_boolean")
                            .booleanValue(false)
                            .build(),
                        ConnectionEventingConfigAuthConfigAdditionalVariableArgs.builder()
                            .key("sample_integer")
                            .integerValue(1)
                            .build(),
                        ConnectionEventingConfigAuthConfigAdditionalVariableArgs.builder()
                            .key("sample_secret_value")
                            .secretValue(ConnectionEventingConfigAuthConfigAdditionalVariableSecretValueArgs.builder()
                                .secretVersion(secret_version_basic.name())
                                .build())
                            .build(),
                        ConnectionEventingConfigAuthConfigAdditionalVariableArgs.builder()
                            .key("sample_encryption_key_value")
                            .encryptionKeyValue(ConnectionEventingConfigAuthConfigAdditionalVariableEncryptionKeyValueArgs.builder()
                                .type("GOOGLE_MANAGED")
                                .kmsKeyName("sampleKMSKkey")
                                .build())
                            .build())
                    .build())
                .enrichmentEnabled(true)
                .build())
            .build());
    }
}

Import

Connection can be imported using any of these accepted formats* projects/{{project}}/locations/{{location}}/connections/{{name}} * {{project}}/{{location}}/{{name}} * {{location}}/{{name}} In Terraform v1.5.0 and later, use an import block to import Connection using one of the formats above. For exampletf import { id = "projects/{{project}}/locations/{{location}}/connections/{{name}}" to = google_integration_connectors_connection.default }

$ pulumi import gcp:integrationconnectors/connection:Connection When using the [`terraform import` command](https://developer.hashicorp.com/terraform/cli/commands/import), Connection can be imported using one of the formats above. For example

$ pulumi import gcp:integrationconnectors/connection:Connection default projects/{{project}}/locations/{{location}}/connections/{{name}}

$ pulumi import gcp:integrationconnectors/connection:Connection default {{project}}/{{location}}/{{name}}

$ pulumi import gcp:integrationconnectors/connection:Connection default {{location}}/{{name}}

Properties

authConfig

val authConfig: Output<ConnectionAuthConfig>?

authConfig for the connection. Structure is documented below.

configVariables

val configVariables: Output<List<ConnectionConfigVariable>>?

Config Variables for the connection. Structure is documented below.

connectionRevision

val connectionRevision: Output<String>

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

connectorVersion

val connectorVersion: Output<String>

connectorVersion of the Connector.

connectorVersionInfraConfigs

val connectorVersionInfraConfigs: Output<List<ConnectionConnectorVersionInfraConfig>>

This cofiguration provides infra configs like rate limit threshold which need to be configurable for every connector version. Structure is documented below.

connectorVersionLaunchStage

val connectorVersionLaunchStage: Output<String>

Flag to mark the version indicating the launch stage.

createTime

val createTime: Output<String>

Time the Namespace was created in UTC.

description

val description: Output<String>?

An arbitrary description for the Conection.

destinationConfigs

val destinationConfigs: Output<List<ConnectionDestinationConfig>>?

Define the Connectors target endpoint. Structure is documented below.

effectiveLabels

val effectiveLabels: Output<Map<String, String>>

All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.

eventingConfig

val eventingConfig: Output<ConnectionEventingConfig>?

Eventing Configuration of a connection Structure is documented below.

eventingEnablementType

val eventingEnablementType: Output<String>?

Eventing enablement type. Will be nil if eventing is not enabled. Possible values are: EVENTING_AND_CONNECTION, ONLY_EVENTING.

eventingRuntimeDatas

val eventingRuntimeDatas: Output<List<ConnectionEventingRuntimeData>>

Eventing Runtime Data. Structure is documented below.

val id: Output<String>

labels

val labels: Output<Map<String, String>>?

Resource labels to represent user provided metadata. Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field effective_labels for all of the labels present on the resource.

location

val location: Output<String>

Location in which Connection needs to be created.

lockConfig

val lockConfig: Output<ConnectionLockConfig>?

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

logConfig

val logConfig: Output<ConnectionLogConfig>?

Log configuration for the connection. Structure is documented below.

name

val name: Output<String>

Name of Connection needs to be created.

nodeConfig

val nodeConfig: Output<ConnectionNodeConfig>

Node configuration for the connection. Structure is documented below.

project

val project: Output<String>

The ID of the project in which the resource belongs. If it is not provided, the provider project is used.

pulumiChildResources

val pulumiChildResources: Set<KotlinResource>

pulumiLabels

val pulumiLabels: Output<Map<String, String>>

The combination of labels configured directly on the resource and default labels configured on the provider.

pulumiResourceName

val pulumiResourceName: String

pulumiResourceType

val pulumiResourceType: String

serviceAccount

val serviceAccount: Output<String>

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

serviceDirectory

val serviceDirectory: Output<String>

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"

sslConfig

val sslConfig: Output<ConnectionSslConfig>?

SSL Configuration of a connection Structure is documented below.

statuses

val statuses: Output<List<ConnectionStatus>>

(Output) Current status of eventing. Structure is documented below.

subscriptionType

val subscriptionType: Output<String>

This subscription type enum states the subscription type of the project.

suspended

val suspended: Output<Boolean>?

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

updateTime

val updateTime: Output<String>

Time the Namespace was updated in UTC.

urn

val urn: Output<String>