@ryan-pip/pulumi-fivetran 1.9.4-alpha.2 → 1.9.30

package/connection.d.ts

@@ -0,0 +1,341 @@
+import * as pulumi from "@pulumi/pulumi";
+import * as inputs from "./types/input";
+import * as outputs from "./types/output";
+/**
+ * This resource allows you to create, update, and delete connections in Fivetran using JSON-based configuration.
+ *
+ * The `fivetran.Connection` resource creates a connection with basic metadata (service type, destination schema, networking options). To configure connection details like host, port, credentials, use the `fivetran.ConnectionConfig` resource.
+ *
+ * ## Example Usage
+ *
+ * ### Basic PostgreSQL Connection with Minimal Config
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as fivetran from "@ryan-pip/pulumi-fivetran";
+ *
+ * const example = new fivetran.Group("example", {name: "My Destination"});
+ * const postgres = new fivetran.Connection("postgres", {
+ *     groupId: example.id,
+ *     service: "postgres",
+ *     destinationSchema: {
+ *         prefix: "my_postgres",
+ *     },
+ *     config: JSON.stringify({
+ *         update_method: "XMIN",
+ *     }),
+ *     runSetupTests: false,
+ *     trustCertificates: false,
+ *     trustFingerprints: false,
+ * });
+ * ```
+ *
+ * ### PostgreSQL Connection with Full Configuration
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as fivetran from "@ryan-pip/pulumi-fivetran";
+ *
+ * const postgresFull = new fivetran.Connection("postgres_full", {
+ *     groupId: example.id,
+ *     service: "postgres",
+ *     destinationSchema: {
+ *         prefix: "my_postgres",
+ *     },
+ *     config: JSON.stringify({
+ *         update_method: "XMIN",
+ *         host: databaseConfig.host,
+ *         port: 5432,
+ *         database: "mydb",
+ *         user: "fivetran_user",
+ *     }),
+ *     runSetupTests: false,
+ * });
+ * ```
+ *
+ * ### MySQL Connection with Proxy Agent
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as fivetran from "@ryan-pip/pulumi-fivetran";
+ *
+ * const example = new fivetran.ProxyAgent("example", {
+ *     displayName: "My Proxy Agent",
+ *     groupRegion: "GCP_US_EAST4",
+ * });
+ * const mysql = new fivetran.Connection("mysql", {
+ *     groupId: exampleFivetranGroup.id,
+ *     service: "mysql",
+ *     destinationSchema: {
+ *         prefix: "my_mysql",
+ *     },
+ *     networkingMethod: "ProxyAgent",
+ *     proxyAgentId: example.id,
+ *     runSetupTests: false,
+ * });
+ * ```
+ *
+ * ### S3 Connection with Custom Schema Name
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as fivetran from "@ryan-pip/pulumi-fivetran";
+ *
+ * const s3 = new fivetran.Connection("s3", {
+ *     groupId: example.id,
+ *     service: "s3",
+ *     destinationSchema: {
+ *         name: "s3_data_schema",
+ *     },
+ *     runSetupTests: false,
+ * });
+ * ```
+ *
+ * ### Connection with Data Delay Settings
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as fivetran from "@ryan-pip/pulumi-fivetran";
+ *
+ * const snowflakeConnection = new fivetran.Connection("snowflake_connection", {
+ *     groupId: example.id,
+ *     service: "snowflake",
+ *     destinationSchema: {
+ *         prefix: "snowflake_data",
+ *     },
+ *     dataDelaySensitivity: "HIGH",
+ *     dataDelayThreshold: 30,
+ *     runSetupTests: false,
+ * });
+ * ```
+ *
+ * ## Notes
+ *
+ * - **Configuration Details:** This resource creates the connection structure. To configure connection-specific details (host, port, credentials, etc.), use the `fivetran.ConnectionConfig` resource.
+ * - **Setup Tests:** When `runSetupTests` is `true`, Fivetran will validate the connection configuration. Any test failures will appear as warnings in the Terraform output.
+ * - **Paused State:** Connections are created in a paused state by default. Use the connection schedule resource or the Fivetran UI to unpause the connection.
+ * - **Service Types:** See the [Fivetran documentation](https://fivetran.com/docs/connectors) for the complete list of available connection services.
+ *
+ * ## See Also
+ *
+ * - `fivetran.ConnectionConfig` - Configure connection details (host, credentials, etc.)
+ * - `fivetran.ConnectorSchedule` - Manage connection sync schedules
+ * - `fivetranConnectorSchema` - Manage connection schema settings
+ *
+ * ## Import
+ *
+ * Connections can be imported using the connection ID:
+ *
+ * ```sh
+ * $ pulumi import fivetran:index/connection:Connection example connection_id_here
+ * ```
+ *
+ * **Note:** When importing, the `runSetupTests`, `trustCertificates`, and `trustFingerprints` attributes will not be imported as they are plan-only attributes.
+ */
+export declare class Connection extends pulumi.CustomResource {
+    /**
+     * Get an existing Connection resource's state with the given name, ID, and optional extra
+     * properties used to qualify the lookup.
+     *
+     * @param name The _unique_ name of the resulting resource.
+     * @param id The _unique_ provider ID of the resource to lookup.
+     * @param state Any extra arguments used during the lookup.
+     * @param opts Optional settings to control the behavior of the CustomResource.
+     */
+    static get(name: string, id: pulumi.Input<pulumi.ID>, state?: ConnectionState, opts?: pulumi.CustomResourceOptions): Connection;
+    /**
+     * Returns true if the given object is an instance of Connection.  This is designed to work even
+     * when multiple copies of the Pulumi SDK have been loaded into the same process.
+     */
+    static isInstance(obj: any): obj is Connection;
+    /**
+     * Optional connection configuration as a JSON-encoded string. This config is merged with destinationSchema fields and sent to the API during creation. The connection resource does not read this field back, allowing it to be managed separately by the `fivetran.ConnectionConfig` resource. Use this to provide service-specific required fields (e.g., `updateMethod` for Postgres/MySQL) or full connection configuration.
+     */
+    readonly config: pulumi.Output<string | undefined>;
+    /**
+     * The unique identifier of the user who has created the connection in your account.
+     */
+    readonly connectedBy: pulumi.Output<string>;
+    /**
+     * The timestamp of the time the connection was created in your account.
+     */
+    readonly createdAt: pulumi.Output<string>;
+    /**
+     * The level of data delay notification threshold. Possible values: LOW, NORMAL, HIGH, CUSTOM, SYNC_FREQUENCY. The default value NORMAL. CUSTOM is only available for customers using the [Enterprise plan](https://fivetran.com/docs/getting-started/pricing#fivetranplans) or above.
+     */
+    readonly dataDelaySensitivity: pulumi.Output<string | undefined>;
+    /**
+     * Custom sync delay notification threshold in minutes. The default value is 0. This parameter is only used when data*delay*sensitivity set to CUSTOM.
+     */
+    readonly dataDelayThreshold: pulumi.Output<number>;
+    readonly destinationSchema: pulumi.Output<outputs.ConnectionDestinationSchema | undefined>;
+    /**
+     * The unique identifier for the Group (Destination) within the Fivetran system.
+     */
+    readonly groupId: pulumi.Output<string>;
+    /**
+     * The hybrid deployment agent ID that refers to the controller created for the group the connection belongs to. If the value is specified, the system will try to associate the connection with an existing agent.
+     */
+    readonly hybridDeploymentAgentId: pulumi.Output<string | undefined>;
+    /**
+     * The name used both as the connection's name within the Fivetran system and as the source schema's name within your destination.
+     */
+    readonly name: pulumi.Output<string>;
+    /**
+     * The networking method for the connection. Possible values: `Directly`, `SshTunnel`, `ProxyAgent`, `PrivateLink`.
+     */
+    readonly networkingMethod: pulumi.Output<string>;
+    /**
+     * The private link ID. Required when `networkingMethod` is `PrivateLink`.
+     */
+    readonly privateLinkId: pulumi.Output<string | undefined>;
+    /**
+     * The ID of the proxy agent to use. Required when `networkingMethod` is `ProxyAgent`.
+     */
+    readonly proxyAgentId: pulumi.Output<string | undefined>;
+    /**
+     * Whether to run setup tests when creating the connection. Default: `false`. **Note:** This is a plan-only attribute and will not be stored in state.
+     */
+    readonly runSetupTests: pulumi.Output<boolean>;
+    /**
+     * The connection service type (e.g., `postgres`, `mysql`, `s3`, `snowflake`). See [Fivetran connection types documentation](https://fivetran.com/docs/connectors) for available services.
+     */
+    readonly service: pulumi.Output<string>;
+    /**
+     * Specifies whether we should trust the certificate automatically. The default value is FALSE. If a certificate is not trusted automatically, it has to be approved with [Certificates Management API Approve a destination certificate](https://fivetran.com/docs/rest-api/certificates#approveadestinationcertificate). **Note:** This is a plan-only attribute.
+     */
+    readonly trustCertificates: pulumi.Output<boolean>;
+    /**
+     * Specifies whether we should trust the SSH fingerprint automatically. The default value is FALSE. If a fingerprint is not trusted automatically, it has to be approved with [Certificates Management API Approve a destination fingerprint](https://fivetran.com/docs/rest-api/certificates#approveadestinationfingerprint). **Note:** This is a plan-only attribute.
+     */
+    readonly trustFingerprints: pulumi.Output<boolean>;
+    /**
+     * Create a Connection resource with the given unique name, arguments, and options.
+     *
+     * @param name The _unique_ name of the resource.
+     * @param args The arguments to use to populate this resource's properties.
+     * @param opts A bag of options that control this resource's behavior.
+     */
+    constructor(name: string, args: ConnectionArgs, opts?: pulumi.CustomResourceOptions);
+}
+/**
+ * Input properties used for looking up and filtering Connection resources.
+ */
+export interface ConnectionState {
+    /**
+     * Optional connection configuration as a JSON-encoded string. This config is merged with destinationSchema fields and sent to the API during creation. The connection resource does not read this field back, allowing it to be managed separately by the `fivetran.ConnectionConfig` resource. Use this to provide service-specific required fields (e.g., `updateMethod` for Postgres/MySQL) or full connection configuration.
+     */
+    config?: pulumi.Input<string | undefined>;
+    /**
+     * The unique identifier of the user who has created the connection in your account.
+     */
+    connectedBy?: pulumi.Input<string | undefined>;
+    /**
+     * The timestamp of the time the connection was created in your account.
+     */
+    createdAt?: pulumi.Input<string | undefined>;
+    /**
+     * The level of data delay notification threshold. Possible values: LOW, NORMAL, HIGH, CUSTOM, SYNC_FREQUENCY. The default value NORMAL. CUSTOM is only available for customers using the [Enterprise plan](https://fivetran.com/docs/getting-started/pricing#fivetranplans) or above.
+     */
+    dataDelaySensitivity?: pulumi.Input<string | undefined>;
+    /**
+     * Custom sync delay notification threshold in minutes. The default value is 0. This parameter is only used when data*delay*sensitivity set to CUSTOM.
+     */
+    dataDelayThreshold?: pulumi.Input<number | undefined>;
+    destinationSchema?: pulumi.Input<inputs.ConnectionDestinationSchema | undefined>;
+    /**
+     * The unique identifier for the Group (Destination) within the Fivetran system.
+     */
+    groupId?: pulumi.Input<string | undefined>;
+    /**
+     * The hybrid deployment agent ID that refers to the controller created for the group the connection belongs to. If the value is specified, the system will try to associate the connection with an existing agent.
+     */
+    hybridDeploymentAgentId?: pulumi.Input<string | undefined>;
+    /**
+     * The name used both as the connection's name within the Fivetran system and as the source schema's name within your destination.
+     */
+    name?: pulumi.Input<string | undefined>;
+    /**
+     * The networking method for the connection. Possible values: `Directly`, `SshTunnel`, `ProxyAgent`, `PrivateLink`.
+     */
+    networkingMethod?: pulumi.Input<string | undefined>;
+    /**
+     * The private link ID. Required when `networkingMethod` is `PrivateLink`.
+     */
+    privateLinkId?: pulumi.Input<string | undefined>;
+    /**
+     * The ID of the proxy agent to use. Required when `networkingMethod` is `ProxyAgent`.
+     */
+    proxyAgentId?: pulumi.Input<string | undefined>;
+    /**
+     * Whether to run setup tests when creating the connection. Default: `false`. **Note:** This is a plan-only attribute and will not be stored in state.
+     */
+    runSetupTests?: pulumi.Input<boolean | undefined>;
+    /**
+     * The connection service type (e.g., `postgres`, `mysql`, `s3`, `snowflake`). See [Fivetran connection types documentation](https://fivetran.com/docs/connectors) for available services.
+     */
+    service?: pulumi.Input<string | undefined>;
+    /**
+     * Specifies whether we should trust the certificate automatically. The default value is FALSE. If a certificate is not trusted automatically, it has to be approved with [Certificates Management API Approve a destination certificate](https://fivetran.com/docs/rest-api/certificates#approveadestinationcertificate). **Note:** This is a plan-only attribute.
+     */
+    trustCertificates?: pulumi.Input<boolean | undefined>;
+    /**
+     * Specifies whether we should trust the SSH fingerprint automatically. The default value is FALSE. If a fingerprint is not trusted automatically, it has to be approved with [Certificates Management API Approve a destination fingerprint](https://fivetran.com/docs/rest-api/certificates#approveadestinationfingerprint). **Note:** This is a plan-only attribute.
+     */
+    trustFingerprints?: pulumi.Input<boolean | undefined>;
+}
+/**
+ * The set of arguments for constructing a Connection resource.
+ */
+export interface ConnectionArgs {
+    /**
+     * Optional connection configuration as a JSON-encoded string. This config is merged with destinationSchema fields and sent to the API during creation. The connection resource does not read this field back, allowing it to be managed separately by the `fivetran.ConnectionConfig` resource. Use this to provide service-specific required fields (e.g., `updateMethod` for Postgres/MySQL) or full connection configuration.
+     */
+    config?: pulumi.Input<string | undefined>;
+    /**
+     * The level of data delay notification threshold. Possible values: LOW, NORMAL, HIGH, CUSTOM, SYNC_FREQUENCY. The default value NORMAL. CUSTOM is only available for customers using the [Enterprise plan](https://fivetran.com/docs/getting-started/pricing#fivetranplans) or above.
+     */
+    dataDelaySensitivity?: pulumi.Input<string | undefined>;
+    /**
+     * Custom sync delay notification threshold in minutes. The default value is 0. This parameter is only used when data*delay*sensitivity set to CUSTOM.
+     */
+    dataDelayThreshold?: pulumi.Input<number | undefined>;
+    destinationSchema?: pulumi.Input<inputs.ConnectionDestinationSchema | undefined>;
+    /**
+     * The unique identifier for the Group (Destination) within the Fivetran system.
+     */
+    groupId: pulumi.Input<string>;
+    /**
+     * The hybrid deployment agent ID that refers to the controller created for the group the connection belongs to. If the value is specified, the system will try to associate the connection with an existing agent.
+     */
+    hybridDeploymentAgentId?: pulumi.Input<string | undefined>;
+    /**
+     * The networking method for the connection. Possible values: `Directly`, `SshTunnel`, `ProxyAgent`, `PrivateLink`.
+     */
+    networkingMethod?: pulumi.Input<string | undefined>;
+    /**
+     * The private link ID. Required when `networkingMethod` is `PrivateLink`.
+     */
+    privateLinkId?: pulumi.Input<string | undefined>;
+    /**
+     * The ID of the proxy agent to use. Required when `networkingMethod` is `ProxyAgent`.
+     */
+    proxyAgentId?: pulumi.Input<string | undefined>;
+    /**
+     * Whether to run setup tests when creating the connection. Default: `false`. **Note:** This is a plan-only attribute and will not be stored in state.
+     */
+    runSetupTests?: pulumi.Input<boolean | undefined>;
+    /**
+     * The connection service type (e.g., `postgres`, `mysql`, `s3`, `snowflake`). See [Fivetran connection types documentation](https://fivetran.com/docs/connectors) for available services.
+     */
+    service: pulumi.Input<string>;
+    /**
+     * Specifies whether we should trust the certificate automatically. The default value is FALSE. If a certificate is not trusted automatically, it has to be approved with [Certificates Management API Approve a destination certificate](https://fivetran.com/docs/rest-api/certificates#approveadestinationcertificate). **Note:** This is a plan-only attribute.
+     */
+    trustCertificates?: pulumi.Input<boolean | undefined>;
+    /**
+     * Specifies whether we should trust the SSH fingerprint automatically. The default value is FALSE. If a fingerprint is not trusted automatically, it has to be approved with [Certificates Management API Approve a destination fingerprint](https://fivetran.com/docs/rest-api/certificates#approveadestinationfingerprint). **Note:** This is a plan-only attribute.
+     */
+    trustFingerprints?: pulumi.Input<boolean | undefined>;
+}
+//# sourceMappingURL=connection.d.ts.map

package/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../connection.ts"],"names":[],"mappings":"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"}

package/connection.js

@@ -0,0 +1,239 @@
+"use strict";
+// *** WARNING: this file was generated by pulumi-language-nodejs. ***
+// *** Do not edit by hand unless you're certain you know what you are doing! ***
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Connection = void 0;
+const pulumi = __importStar(require("@pulumi/pulumi"));
+const utilities = __importStar(require("./utilities"));
+/**
+ * This resource allows you to create, update, and delete connections in Fivetran using JSON-based configuration.
+ *
+ * The `fivetran.Connection` resource creates a connection with basic metadata (service type, destination schema, networking options). To configure connection details like host, port, credentials, use the `fivetran.ConnectionConfig` resource.
+ *
+ * ## Example Usage
+ *
+ * ### Basic PostgreSQL Connection with Minimal Config
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as fivetran from "@ryan-pip/pulumi-fivetran";
+ *
+ * const example = new fivetran.Group("example", {name: "My Destination"});
+ * const postgres = new fivetran.Connection("postgres", {
+ *     groupId: example.id,
+ *     service: "postgres",
+ *     destinationSchema: {
+ *         prefix: "my_postgres",
+ *     },
+ *     config: JSON.stringify({
+ *         update_method: "XMIN",
+ *     }),
+ *     runSetupTests: false,
+ *     trustCertificates: false,
+ *     trustFingerprints: false,
+ * });
+ * ```
+ *
+ * ### PostgreSQL Connection with Full Configuration
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as fivetran from "@ryan-pip/pulumi-fivetran";
+ *
+ * const postgresFull = new fivetran.Connection("postgres_full", {
+ *     groupId: example.id,
+ *     service: "postgres",
+ *     destinationSchema: {
+ *         prefix: "my_postgres",
+ *     },
+ *     config: JSON.stringify({
+ *         update_method: "XMIN",
+ *         host: databaseConfig.host,
+ *         port: 5432,
+ *         database: "mydb",
+ *         user: "fivetran_user",
+ *     }),
+ *     runSetupTests: false,
+ * });
+ * ```
+ *
+ * ### MySQL Connection with Proxy Agent
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as fivetran from "@ryan-pip/pulumi-fivetran";
+ *
+ * const example = new fivetran.ProxyAgent("example", {
+ *     displayName: "My Proxy Agent",
+ *     groupRegion: "GCP_US_EAST4",
+ * });
+ * const mysql = new fivetran.Connection("mysql", {
+ *     groupId: exampleFivetranGroup.id,
+ *     service: "mysql",
+ *     destinationSchema: {
+ *         prefix: "my_mysql",
+ *     },
+ *     networkingMethod: "ProxyAgent",
+ *     proxyAgentId: example.id,
+ *     runSetupTests: false,
+ * });
+ * ```
+ *
+ * ### S3 Connection with Custom Schema Name
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as fivetran from "@ryan-pip/pulumi-fivetran";
+ *
+ * const s3 = new fivetran.Connection("s3", {
+ *     groupId: example.id,
+ *     service: "s3",
+ *     destinationSchema: {
+ *         name: "s3_data_schema",
+ *     },
+ *     runSetupTests: false,
+ * });
+ * ```
+ *
+ * ### Connection with Data Delay Settings
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as fivetran from "@ryan-pip/pulumi-fivetran";
+ *
+ * const snowflakeConnection = new fivetran.Connection("snowflake_connection", {
+ *     groupId: example.id,
+ *     service: "snowflake",
+ *     destinationSchema: {
+ *         prefix: "snowflake_data",
+ *     },
+ *     dataDelaySensitivity: "HIGH",
+ *     dataDelayThreshold: 30,
+ *     runSetupTests: false,
+ * });
+ * ```
+ *
+ * ## Notes
+ *
+ * - **Configuration Details:** This resource creates the connection structure. To configure connection-specific details (host, port, credentials, etc.), use the `fivetran.ConnectionConfig` resource.
+ * - **Setup Tests:** When `runSetupTests` is `true`, Fivetran will validate the connection configuration. Any test failures will appear as warnings in the Terraform output.
+ * - **Paused State:** Connections are created in a paused state by default. Use the connection schedule resource or the Fivetran UI to unpause the connection.
+ * - **Service Types:** See the [Fivetran documentation](https://fivetran.com/docs/connectors) for the complete list of available connection services.
+ *
+ * ## See Also
+ *
+ * - `fivetran.ConnectionConfig` - Configure connection details (host, credentials, etc.)
+ * - `fivetran.ConnectorSchedule` - Manage connection sync schedules
+ * - `fivetranConnectorSchema` - Manage connection schema settings
+ *
+ * ## Import
+ *
+ * Connections can be imported using the connection ID:
+ *
+ * ```sh
+ * $ pulumi import fivetran:index/connection:Connection example connection_id_here
+ * ```
+ *
+ * **Note:** When importing, the `runSetupTests`, `trustCertificates`, and `trustFingerprints` attributes will not be imported as they are plan-only attributes.
+ */
+class Connection extends pulumi.CustomResource {
+    /**
+     * Get an existing Connection resource's state with the given name, ID, and optional extra
+     * properties used to qualify the lookup.
+     *
+     * @param name The _unique_ name of the resulting resource.
+     * @param id The _unique_ provider ID of the resource to lookup.
+     * @param state Any extra arguments used during the lookup.
+     * @param opts Optional settings to control the behavior of the CustomResource.
+     */
+    static get(name, id, state, opts) {
+        return new Connection(name, state, { ...opts, id: id });
+    }
+    /** @internal */
+    static __pulumiType = 'fivetran:index/connection:Connection';
+    /**
+     * Returns true if the given object is an instance of Connection.  This is designed to work even
+     * when multiple copies of the Pulumi SDK have been loaded into the same process.
+     */
+    static isInstance(obj) {
+        if (obj === undefined || obj === null) {
+            return false;
+        }
+        return obj['__pulumiType'] === Connection.__pulumiType;
+    }
+    constructor(name, argsOrState, opts) {
+        let resourceInputs = {};
+        opts = opts || {};
+        if (opts.id) {
+            const state = argsOrState;
+            resourceInputs["config"] = state?.config;
+            resourceInputs["connectedBy"] = state?.connectedBy;
+            resourceInputs["createdAt"] = state?.createdAt;
+            resourceInputs["dataDelaySensitivity"] = state?.dataDelaySensitivity;
+            resourceInputs["dataDelayThreshold"] = state?.dataDelayThreshold;
+            resourceInputs["destinationSchema"] = state?.destinationSchema;
+            resourceInputs["groupId"] = state?.groupId;
+            resourceInputs["hybridDeploymentAgentId"] = state?.hybridDeploymentAgentId;
+            resourceInputs["name"] = state?.name;
+            resourceInputs["networkingMethod"] = state?.networkingMethod;
+            resourceInputs["privateLinkId"] = state?.privateLinkId;
+            resourceInputs["proxyAgentId"] = state?.proxyAgentId;
+            resourceInputs["runSetupTests"] = state?.runSetupTests;
+            resourceInputs["service"] = state?.service;
+            resourceInputs["trustCertificates"] = state?.trustCertificates;
+            resourceInputs["trustFingerprints"] = state?.trustFingerprints;
+        }
+        else {
+            const args = argsOrState;
+            if (args?.groupId === undefined && !opts.urn) {
+                throw new Error("Missing required property 'groupId'");
+            }
+            if (args?.service === undefined && !opts.urn) {
+                throw new Error("Missing required property 'service'");
+            }
+            resourceInputs["config"] = args?.config;
+            resourceInputs["dataDelaySensitivity"] = args?.dataDelaySensitivity;
+            resourceInputs["dataDelayThreshold"] = args?.dataDelayThreshold;
+            resourceInputs["destinationSchema"] = args?.destinationSchema;
+            resourceInputs["groupId"] = args?.groupId;
+            resourceInputs["hybridDeploymentAgentId"] = args?.hybridDeploymentAgentId;
+            resourceInputs["networkingMethod"] = args?.networkingMethod;
+            resourceInputs["privateLinkId"] = args?.privateLinkId;
+            resourceInputs["proxyAgentId"] = args?.proxyAgentId;
+            resourceInputs["runSetupTests"] = args?.runSetupTests;
+            resourceInputs["service"] = args?.service;
+            resourceInputs["trustCertificates"] = args?.trustCertificates;
+            resourceInputs["trustFingerprints"] = args?.trustFingerprints;
+            resourceInputs["connectedBy"] = undefined /*out*/;
+            resourceInputs["createdAt"] = undefined /*out*/;
+            resourceInputs["name"] = undefined /*out*/;
+        }
+        opts = pulumi.mergeOptions(utilities.resourceOptsDefaults(), opts);
+        super(Connection.__pulumiType, name, resourceInputs, opts);
+    }
+}
+exports.Connection = Connection;
+//# sourceMappingURL=connection.js.map

package/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../connection.ts"],"names":[],"mappings":"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"}