gcp logo
Google Cloud Classic v6.49.0, Feb 1 23

gcp.beyondcorp.AppConnector

A BeyondCorp AppConnector resource represents an application facing component deployed proximal to and with direct access to the application instances. It is used to establish connectivity between the remote enterprise environment and GCP. It initiates connections to the applications and can proxy the data from users over the connection.

To get more information about AppConnector, see:

Example Usage

Beyondcorp App Connector Basic

using System.Collections.Generic;
using Pulumi;
using Gcp = Pulumi.Gcp;

return await Deployment.RunAsync(() => 
{
    var serviceAccount = new Gcp.ServiceAccount.Account("serviceAccount", new()
    {
        AccountId = "my-account",
        DisplayName = "Test Service Account",
    });

    var appConnector = new Gcp.Beyondcorp.AppConnector("appConnector", new()
    {
        PrincipalInfo = new Gcp.Beyondcorp.Inputs.AppConnectorPrincipalInfoArgs
        {
            ServiceAccount = new Gcp.Beyondcorp.Inputs.AppConnectorPrincipalInfoServiceAccountArgs
            {
                Email = serviceAccount.Email,
            },
        },
    });

});
package main

import (
	"github.com/pulumi/pulumi-gcp/sdk/v6/go/gcp/beyondcorp"
	"github.com/pulumi/pulumi-gcp/sdk/v6/go/gcp/serviceAccount"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		serviceAccount, err := serviceAccount.NewAccount(ctx, "serviceAccount", &serviceAccount.AccountArgs{
			AccountId:   pulumi.String("my-account"),
			DisplayName: pulumi.String("Test Service Account"),
		})
		if err != nil {
			return err
		}
		_, err = beyondcorp.NewAppConnector(ctx, "appConnector", &beyondcorp.AppConnectorArgs{
			PrincipalInfo: &beyondcorp.AppConnectorPrincipalInfoArgs{
				ServiceAccount: &beyondcorp.AppConnectorPrincipalInfoServiceAccountArgs{
					Email: serviceAccount.Email,
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.serviceAccount.Account;
import com.pulumi.gcp.serviceAccount.AccountArgs;
import com.pulumi.gcp.beyondcorp.AppConnector;
import com.pulumi.gcp.beyondcorp.AppConnectorArgs;
import com.pulumi.gcp.beyondcorp.inputs.AppConnectorPrincipalInfoArgs;
import com.pulumi.gcp.beyondcorp.inputs.AppConnectorPrincipalInfoServiceAccountArgs;
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) {
        var serviceAccount = new Account("serviceAccount", AccountArgs.builder()        
            .accountId("my-account")
            .displayName("Test Service Account")
            .build());

        var appConnector = new AppConnector("appConnector", AppConnectorArgs.builder()        
            .principalInfo(AppConnectorPrincipalInfoArgs.builder()
                .serviceAccount(AppConnectorPrincipalInfoServiceAccountArgs.builder()
                    .email(serviceAccount.email())
                    .build())
                .build())
            .build());

    }
}
import pulumi
import pulumi_gcp as gcp

service_account = gcp.service_account.Account("serviceAccount",
    account_id="my-account",
    display_name="Test Service Account")
app_connector = gcp.beyondcorp.AppConnector("appConnector", principal_info=gcp.beyondcorp.AppConnectorPrincipalInfoArgs(
    service_account=gcp.beyondcorp.AppConnectorPrincipalInfoServiceAccountArgs(
        email=service_account.email,
    ),
))
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";

const serviceAccount = new gcp.serviceaccount.Account("serviceAccount", {
    accountId: "my-account",
    displayName: "Test Service Account",
});
const appConnector = new gcp.beyondcorp.AppConnector("appConnector", {principalInfo: {
    serviceAccount: {
        email: serviceAccount.email,
    },
}});
resources:
  serviceAccount:
    type: gcp:serviceAccount:Account
    properties:
      accountId: my-account
      displayName: Test Service Account
  appConnector:
    type: gcp:beyondcorp:AppConnector
    properties:
      principalInfo:
        serviceAccount:
          email: ${serviceAccount.email}

Beyondcorp App Connector Full

using System.Collections.Generic;
using Pulumi;
using Gcp = Pulumi.Gcp;

return await Deployment.RunAsync(() => 
{
    var serviceAccount = new Gcp.ServiceAccount.Account("serviceAccount", new()
    {
        AccountId = "my-account",
        DisplayName = "Test Service Account",
    });

    var appConnector = new Gcp.Beyondcorp.AppConnector("appConnector", new()
    {
        Region = "us-central1",
        DisplayName = "some display name",
        PrincipalInfo = new Gcp.Beyondcorp.Inputs.AppConnectorPrincipalInfoArgs
        {
            ServiceAccount = new Gcp.Beyondcorp.Inputs.AppConnectorPrincipalInfoServiceAccountArgs
            {
                Email = serviceAccount.Email,
            },
        },
        Labels = 
        {
            { "foo", "bar" },
            { "bar", "baz" },
        },
    });

});
package main

import (
	"github.com/pulumi/pulumi-gcp/sdk/v6/go/gcp/beyondcorp"
	"github.com/pulumi/pulumi-gcp/sdk/v6/go/gcp/serviceAccount"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		serviceAccount, err := serviceAccount.NewAccount(ctx, "serviceAccount", &serviceAccount.AccountArgs{
			AccountId:   pulumi.String("my-account"),
			DisplayName: pulumi.String("Test Service Account"),
		})
		if err != nil {
			return err
		}
		_, err = beyondcorp.NewAppConnector(ctx, "appConnector", &beyondcorp.AppConnectorArgs{
			Region:      pulumi.String("us-central1"),
			DisplayName: pulumi.String("some display name"),
			PrincipalInfo: &beyondcorp.AppConnectorPrincipalInfoArgs{
				ServiceAccount: &beyondcorp.AppConnectorPrincipalInfoServiceAccountArgs{
					Email: serviceAccount.Email,
				},
			},
			Labels: pulumi.StringMap{
				"foo": pulumi.String("bar"),
				"bar": pulumi.String("baz"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.serviceAccount.Account;
import com.pulumi.gcp.serviceAccount.AccountArgs;
import com.pulumi.gcp.beyondcorp.AppConnector;
import com.pulumi.gcp.beyondcorp.AppConnectorArgs;
import com.pulumi.gcp.beyondcorp.inputs.AppConnectorPrincipalInfoArgs;
import com.pulumi.gcp.beyondcorp.inputs.AppConnectorPrincipalInfoServiceAccountArgs;
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) {
        var serviceAccount = new Account("serviceAccount", AccountArgs.builder()        
            .accountId("my-account")
            .displayName("Test Service Account")
            .build());

        var appConnector = new AppConnector("appConnector", AppConnectorArgs.builder()        
            .region("us-central1")
            .displayName("some display name")
            .principalInfo(AppConnectorPrincipalInfoArgs.builder()
                .serviceAccount(AppConnectorPrincipalInfoServiceAccountArgs.builder()
                    .email(serviceAccount.email())
                    .build())
                .build())
            .labels(Map.ofEntries(
                Map.entry("foo", "bar"),
                Map.entry("bar", "baz")
            ))
            .build());

    }
}
import pulumi
import pulumi_gcp as gcp

service_account = gcp.service_account.Account("serviceAccount",
    account_id="my-account",
    display_name="Test Service Account")
app_connector = gcp.beyondcorp.AppConnector("appConnector",
    region="us-central1",
    display_name="some display name",
    principal_info=gcp.beyondcorp.AppConnectorPrincipalInfoArgs(
        service_account=gcp.beyondcorp.AppConnectorPrincipalInfoServiceAccountArgs(
            email=service_account.email,
        ),
    ),
    labels={
        "foo": "bar",
        "bar": "baz",
    })
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";

const serviceAccount = new gcp.serviceaccount.Account("serviceAccount", {
    accountId: "my-account",
    displayName: "Test Service Account",
});
const appConnector = new gcp.beyondcorp.AppConnector("appConnector", {
    region: "us-central1",
    displayName: "some display name",
    principalInfo: {
        serviceAccount: {
            email: serviceAccount.email,
        },
    },
    labels: {
        foo: "bar",
        bar: "baz",
    },
});
resources:
  serviceAccount:
    type: gcp:serviceAccount:Account
    properties:
      accountId: my-account
      displayName: Test Service Account
  appConnector:
    type: gcp:beyondcorp:AppConnector
    properties:
      region: us-central1
      displayName: some display name
      principalInfo:
        serviceAccount:
          email: ${serviceAccount.email}
      labels:
        foo: bar
        bar: baz

Create AppConnector Resource

new AppConnector(name: string, args: AppConnectorArgs, opts?: CustomResourceOptions);
@overload
def AppConnector(resource_name: str,
                 opts: Optional[ResourceOptions] = None,
                 display_name: Optional[str] = None,
                 labels: Optional[Mapping[str, str]] = None,
                 name: Optional[str] = None,
                 principal_info: Optional[AppConnectorPrincipalInfoArgs] = None,
                 project: Optional[str] = None,
                 region: Optional[str] = None)
@overload
def AppConnector(resource_name: str,
                 args: AppConnectorArgs,
                 opts: Optional[ResourceOptions] = None)
func NewAppConnector(ctx *Context, name string, args AppConnectorArgs, opts ...ResourceOption) (*AppConnector, error)
public AppConnector(string name, AppConnectorArgs args, CustomResourceOptions? opts = null)
public AppConnector(String name, AppConnectorArgs args)
public AppConnector(String name, AppConnectorArgs args, CustomResourceOptions options)
type: gcp:beyondcorp:AppConnector
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

name string
The unique name of the resource.
args AppConnectorArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name str
The unique name of the resource.
args AppConnectorArgs
The arguments to resource properties.
opts ResourceOptions
Bag of options to control resource's behavior.
ctx Context
Context object for the current deployment.
name string
The unique name of the resource.
args AppConnectorArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name string
The unique name of the resource.
args AppConnectorArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
name String
The unique name of the resource.
args AppConnectorArgs
The arguments to resource properties.
options CustomResourceOptions
Bag of options to control resource's behavior.

AppConnector Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

The AppConnector resource accepts the following input properties:

PrincipalInfo AppConnectorPrincipalInfoArgs

Principal information about the Identity of the AppConnector. Structure is documented below.

DisplayName string

An arbitrary user-provided name for the AppConnector.

Labels Dictionary<string, string>

Resource labels to represent user provided metadata.

Name string

ID of the AppConnector.

Project string

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

Region string

The region of the AppConnector.

PrincipalInfo AppConnectorPrincipalInfoArgs

Principal information about the Identity of the AppConnector. Structure is documented below.

DisplayName string

An arbitrary user-provided name for the AppConnector.

Labels map[string]string

Resource labels to represent user provided metadata.

Name string

ID of the AppConnector.

Project string

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

Region string

The region of the AppConnector.

principalInfo AppConnectorPrincipalInfoArgs

Principal information about the Identity of the AppConnector. Structure is documented below.

displayName String

An arbitrary user-provided name for the AppConnector.

labels Map<String,String>

Resource labels to represent user provided metadata.

name String

ID of the AppConnector.

project String

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

region String

The region of the AppConnector.

principalInfo AppConnectorPrincipalInfoArgs

Principal information about the Identity of the AppConnector. Structure is documented below.

displayName string

An arbitrary user-provided name for the AppConnector.

labels {[key: string]: string}

Resource labels to represent user provided metadata.

name string

ID of the AppConnector.

project string

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

region string

The region of the AppConnector.

principal_info AppConnectorPrincipalInfoArgs

Principal information about the Identity of the AppConnector. Structure is documented below.

display_name str

An arbitrary user-provided name for the AppConnector.

labels Mapping[str, str]

Resource labels to represent user provided metadata.

name str

ID of the AppConnector.

project str

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

region str

The region of the AppConnector.

principalInfo Property Map

Principal information about the Identity of the AppConnector. Structure is documented below.

displayName String

An arbitrary user-provided name for the AppConnector.

labels Map<String>

Resource labels to represent user provided metadata.

name String

ID of the AppConnector.

project String

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

region String

The region of the AppConnector.

Outputs

All input properties are implicitly available as output properties. Additionally, the AppConnector resource produces the following output properties:

Id string

The provider-assigned unique ID for this managed resource.

State string

Represents the different states of a AppConnector.

Id string

The provider-assigned unique ID for this managed resource.

State string

Represents the different states of a AppConnector.

id String

The provider-assigned unique ID for this managed resource.

state String

Represents the different states of a AppConnector.

id string

The provider-assigned unique ID for this managed resource.

state string

Represents the different states of a AppConnector.

id str

The provider-assigned unique ID for this managed resource.

state str

Represents the different states of a AppConnector.

id String

The provider-assigned unique ID for this managed resource.

state String

Represents the different states of a AppConnector.

Look up Existing AppConnector Resource

Get an existing AppConnector resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

public static get(name: string, id: Input<ID>, state?: AppConnectorState, opts?: CustomResourceOptions): AppConnector
@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        display_name: Optional[str] = None,
        labels: Optional[Mapping[str, str]] = None,
        name: Optional[str] = None,
        principal_info: Optional[AppConnectorPrincipalInfoArgs] = None,
        project: Optional[str] = None,
        region: Optional[str] = None,
        state: Optional[str] = None) -> AppConnector
func GetAppConnector(ctx *Context, name string, id IDInput, state *AppConnectorState, opts ...ResourceOption) (*AppConnector, error)
public static AppConnector Get(string name, Input<string> id, AppConnectorState? state, CustomResourceOptions? opts = null)
public static AppConnector get(String name, Output<String> id, AppConnectorState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
resource_name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
The following state arguments are supported:
DisplayName string

An arbitrary user-provided name for the AppConnector.

Labels Dictionary<string, string>

Resource labels to represent user provided metadata.

Name string

ID of the AppConnector.

PrincipalInfo AppConnectorPrincipalInfoArgs

Principal information about the Identity of the AppConnector. Structure is documented below.

Project string

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

Region string

The region of the AppConnector.

State string

Represents the different states of a AppConnector.

DisplayName string

An arbitrary user-provided name for the AppConnector.

Labels map[string]string

Resource labels to represent user provided metadata.

Name string

ID of the AppConnector.

PrincipalInfo AppConnectorPrincipalInfoArgs

Principal information about the Identity of the AppConnector. Structure is documented below.

Project string

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

Region string

The region of the AppConnector.

State string

Represents the different states of a AppConnector.

displayName String

An arbitrary user-provided name for the AppConnector.

labels Map<String,String>

Resource labels to represent user provided metadata.

name String

ID of the AppConnector.

principalInfo AppConnectorPrincipalInfoArgs

Principal information about the Identity of the AppConnector. Structure is documented below.

project String

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

region String

The region of the AppConnector.

state String

Represents the different states of a AppConnector.

displayName string

An arbitrary user-provided name for the AppConnector.

labels {[key: string]: string}

Resource labels to represent user provided metadata.

name string

ID of the AppConnector.

principalInfo AppConnectorPrincipalInfoArgs

Principal information about the Identity of the AppConnector. Structure is documented below.

project string

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

region string

The region of the AppConnector.

state string

Represents the different states of a AppConnector.

display_name str

An arbitrary user-provided name for the AppConnector.

labels Mapping[str, str]

Resource labels to represent user provided metadata.

name str

ID of the AppConnector.

principal_info AppConnectorPrincipalInfoArgs

Principal information about the Identity of the AppConnector. Structure is documented below.

project str

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

region str

The region of the AppConnector.

state str

Represents the different states of a AppConnector.

displayName String

An arbitrary user-provided name for the AppConnector.

labels Map<String>

Resource labels to represent user provided metadata.

name String

ID of the AppConnector.

principalInfo Property Map

Principal information about the Identity of the AppConnector. Structure is documented below.

project String

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

region String

The region of the AppConnector.

state String

Represents the different states of a AppConnector.

Supporting Types

AppConnectorPrincipalInfo

ServiceAccount AppConnectorPrincipalInfoServiceAccount

ServiceAccount represents a GCP service account. Structure is documented below.

ServiceAccount AppConnectorPrincipalInfoServiceAccount

ServiceAccount represents a GCP service account. Structure is documented below.

serviceAccount AppConnectorPrincipalInfoServiceAccount

ServiceAccount represents a GCP service account. Structure is documented below.

serviceAccount AppConnectorPrincipalInfoServiceAccount

ServiceAccount represents a GCP service account. Structure is documented below.

service_account AppConnectorPrincipalInfoServiceAccount

ServiceAccount represents a GCP service account. Structure is documented below.

serviceAccount Property Map

ServiceAccount represents a GCP service account. Structure is documented below.

AppConnectorPrincipalInfoServiceAccount

Email string

Email address of the service account.

Email string

Email address of the service account.

email String

Email address of the service account.

email string

Email address of the service account.

email str

Email address of the service account.

email String

Email address of the service account.

Import

AppConnector can be imported using any of these accepted formats

 $ pulumi import gcp:beyondcorp/appConnector:AppConnector default projects/{{project}}/locations/{{region}}/appConnectors/{{name}}
 $ pulumi import gcp:beyondcorp/appConnector:AppConnector default {{project}}/{{region}}/{{name}}
 $ pulumi import gcp:beyondcorp/appConnector:AppConnector default {{region}}/{{name}}
 $ pulumi import gcp:beyondcorp/appConnector:AppConnector default {{name}}

Package Details

Repository
Google Cloud (GCP) Classic pulumi/pulumi-gcp
License
Apache-2.0
Notes

This Pulumi package is based on the google-beta Terraform Provider.