import * as pulumi from "@pulumi/pulumi"; import * as inputs from "../types/input"; import * as outputs from "../types/output"; /** * A BeyondCorp AppConnection resource represents a BeyondCorp protected AppConnection to a remote application. * It creates all the necessary GCP components needed for creating a BeyondCorp protected AppConnection. * Multiple connectors can be authorised for a single AppConnection. * * To get more information about AppConnection, see: * * * [API documentation](https://cloud.google.com/beyondcorp/docs/reference/rest#rest-resource:-v1.projects.locations.appconnections) * * How-to Guides * * [Official Documentation](https://cloud.google.com/beyondcorp-enterprise/docs/enable-app-connector) * * ## Example Usage * * ### Beyondcorp App Connection Basic * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as gcp from "@pulumi/gcp"; * * const serviceAccount = new gcp.serviceaccount.Account("service_account", { * accountId: "my-account", * displayName: "Test Service Account", * }); * const appConnector = new gcp.beyondcorp.AppConnector("app_connector", { * name: "my-app-connector", * principalInfo: { * serviceAccount: { * email: serviceAccount.email, * }, * }, * }); * const appConnection = new gcp.beyondcorp.AppConnection("app_connection", { * name: "my-app-connection", * type: "TCP_PROXY", * applicationEndpoint: { * host: "foo-host", * port: 8080, * }, * connectors: [appConnector.id], * }); * ``` * ### Beyondcorp App Connection Full * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as gcp from "@pulumi/gcp"; * * const serviceAccount = new gcp.serviceaccount.Account("service_account", { * accountId: "my-account", * displayName: "Test Service Account", * }); * const appGateway = new gcp.beyondcorp.AppGateway("app_gateway", { * name: "my-app-gateway", * type: "TCP_PROXY", * hostType: "GCP_REGIONAL_MIG", * }); * const appConnector = new gcp.beyondcorp.AppConnector("app_connector", { * name: "my-app-connector", * principalInfo: { * serviceAccount: { * email: serviceAccount.email, * }, * }, * }); * const appConnection = new gcp.beyondcorp.AppConnection("app_connection", { * name: "my-app-connection", * type: "TCP_PROXY", * displayName: "some display name", * applicationEndpoint: { * host: "foo-host", * port: 8080, * }, * connectors: [appConnector.id], * gateway: { * appGateway: appGateway.id, * }, * labels: { * foo: "bar", * bar: "baz", * }, * }); * ``` * * ## Import * * AppConnection can be imported using any of these accepted formats: * * * `projects/{{project}}/locations/{{region}}/appConnections/{{name}}` * * * `{{project}}/{{region}}/{{name}}` * * * `{{region}}/{{name}}` * * * `{{name}}` * * When using the `pulumi import` command, AppConnection can be imported using one of the formats above. For example: * * ```sh * $ pulumi import gcp:beyondcorp/appConnection:AppConnection default projects/{{project}}/locations/{{region}}/appConnections/{{name}} * ``` * * ```sh * $ pulumi import gcp:beyondcorp/appConnection:AppConnection default {{project}}/{{region}}/{{name}} * ``` * * ```sh * $ pulumi import gcp:beyondcorp/appConnection:AppConnection default {{region}}/{{name}} * ``` * * ```sh * $ pulumi import gcp:beyondcorp/appConnection:AppConnection default {{name}} * ``` */ export declare class AppConnection extends pulumi.CustomResource { /** * Get an existing AppConnection 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, state?: AppConnectionState, opts?: pulumi.CustomResourceOptions): AppConnection; /** * Returns true if the given object is an instance of AppConnection. 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 AppConnection; /** * Address of the remote application endpoint for the BeyondCorp AppConnection. * Structure is documented below. */ readonly applicationEndpoint: pulumi.Output; /** * List of AppConnectors that are authorised to be associated with this AppConnection */ readonly connectors: pulumi.Output; /** * An arbitrary user-provided name for the AppConnection. */ readonly displayName: pulumi.Output; /** * All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services. */ readonly effectiveLabels: pulumi.Output<{ [key: string]: string; }>; /** * Gateway used by the AppConnection. * Structure is documented below. */ readonly gateway: pulumi.Output; /** * 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 `effectiveLabels` for all of the labels present on the resource. */ readonly labels: pulumi.Output<{ [key: string]: string; } | undefined>; /** * ID of the AppConnection. */ readonly name: pulumi.Output; /** * The ID of the project in which the resource belongs. * If it is not provided, the provider project is used. */ readonly project: pulumi.Output; /** * The combination of labels configured directly on the resource * and default labels configured on the provider. */ readonly pulumiLabels: pulumi.Output<{ [key: string]: string; }>; /** * The region of the AppConnection. */ readonly region: pulumi.Output; /** * The type of network connectivity used by the AppConnection. Refer * to https://cloud.google.com/beyondcorp/docs/reference/rest/v1/projects.locations.appConnections#type * for a list of possible values. */ readonly type: pulumi.Output; /** * Create a AppConnection 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: AppConnectionArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering AppConnection resources. */ export interface AppConnectionState { /** * Address of the remote application endpoint for the BeyondCorp AppConnection. * Structure is documented below. */ applicationEndpoint?: pulumi.Input; /** * List of AppConnectors that are authorised to be associated with this AppConnection */ connectors?: pulumi.Input[]>; /** * An arbitrary user-provided name for the AppConnection. */ displayName?: pulumi.Input; /** * All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services. */ effectiveLabels?: pulumi.Input<{ [key: string]: pulumi.Input; }>; /** * Gateway used by the AppConnection. * Structure is documented below. */ gateway?: pulumi.Input; /** * 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 `effectiveLabels` for all of the labels present on the resource. */ labels?: pulumi.Input<{ [key: string]: pulumi.Input; }>; /** * ID of the AppConnection. */ name?: pulumi.Input; /** * The ID of the project in which the resource belongs. * If it is not provided, the provider project is used. */ project?: pulumi.Input; /** * The combination of labels configured directly on the resource * and default labels configured on the provider. */ pulumiLabels?: pulumi.Input<{ [key: string]: pulumi.Input; }>; /** * The region of the AppConnection. */ region?: pulumi.Input; /** * The type of network connectivity used by the AppConnection. Refer * to https://cloud.google.com/beyondcorp/docs/reference/rest/v1/projects.locations.appConnections#type * for a list of possible values. */ type?: pulumi.Input; } /** * The set of arguments for constructing a AppConnection resource. */ export interface AppConnectionArgs { /** * Address of the remote application endpoint for the BeyondCorp AppConnection. * Structure is documented below. */ applicationEndpoint: pulumi.Input; /** * List of AppConnectors that are authorised to be associated with this AppConnection */ connectors?: pulumi.Input[]>; /** * An arbitrary user-provided name for the AppConnection. */ displayName?: pulumi.Input; /** * Gateway used by the AppConnection. * Structure is documented below. */ gateway?: pulumi.Input; /** * 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 `effectiveLabels` for all of the labels present on the resource. */ labels?: pulumi.Input<{ [key: string]: pulumi.Input; }>; /** * ID of the AppConnection. */ name?: pulumi.Input; /** * The ID of the project in which the resource belongs. * If it is not provided, the provider project is used. */ project?: pulumi.Input; /** * The region of the AppConnection. */ region?: pulumi.Input; /** * The type of network connectivity used by the AppConnection. Refer * to https://cloud.google.com/beyondcorp/docs/reference/rest/v1/projects.locations.appConnections#type * for a list of possible values. */ type?: pulumi.Input; }