Docs Packages
  1. Packages
  2. Google Cloud (GCP) Classic
  3. API Docs
  4. beyondcorp
  5. AppConnector
Google Cloud Classic v6.58.0 published on Tuesday, Jun 6, 2023 by Pulumi
pulumi/pulumi-gcp

gcp.beyondcorp.AppConnector

Explore with Pulumi AI

gcp logo
Google Cloud Classic v6.58.0 published on Tuesday, Jun 6, 2023 by Pulumi
pulumi/pulumi-gcp

    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 System.Linq;
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 System.Linq;
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.

    gcp logo
    Google Cloud Classic v6.58.0 published on Tuesday, Jun 6, 2023 by Pulumi
    pulumi/pulumi-gcp