pulumi-gcp-kotlin/com.pulumi.gcp.looker.kotlin/InstanceArgs

InstanceArgs

data class InstanceArgs(val adminSettings: Output<InstanceAdminSettingsArgs>? = null, val consumerNetwork: Output<String>? = null, val denyMaintenancePeriod: Output<InstanceDenyMaintenancePeriodArgs>? = null, val encryptionConfig: Output<InstanceEncryptionConfigArgs>? = null, val maintenanceWindow: Output<InstanceMaintenanceWindowArgs>? = null, val name: Output<String>? = null, val oauthConfig: Output<InstanceOauthConfigArgs>? = null, val platformEdition: Output<String>? = null, val privateIpEnabled: Output<Boolean>? = null, val project: Output<String>? = null, val publicIpEnabled: Output<Boolean>? = null, val region: Output<String>? = null, val reservedRange: Output<String>? = null, val userMetadata: Output<InstanceUserMetadataArgs>? = null) : ConvertibleToJava<InstanceArgs>

A Google Cloud Looker instance. To get more information about Instance, see:

Example Usage

Looker Instance Basic

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.looker.Instance;
import com.pulumi.gcp.looker.InstanceArgs;
import com.pulumi.gcp.looker.inputs.InstanceOauthConfigArgs;
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 looker_instance = new Instance("looker-instance", InstanceArgs.builder()
            .oauthConfig(InstanceOauthConfigArgs.builder()
                .clientId("my-client-id")
                .clientSecret("my-client-secret")
                .build())
            .platformEdition("LOOKER_CORE_STANDARD")
            .region("us-central1")
            .build());
    }
}

Looker Instance Full

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.looker.Instance;
import com.pulumi.gcp.looker.InstanceArgs;
import com.pulumi.gcp.looker.inputs.InstanceAdminSettingsArgs;
import com.pulumi.gcp.looker.inputs.InstanceDenyMaintenancePeriodArgs;
import com.pulumi.gcp.looker.inputs.InstanceDenyMaintenancePeriodEndDateArgs;
import com.pulumi.gcp.looker.inputs.InstanceDenyMaintenancePeriodStartDateArgs;
import com.pulumi.gcp.looker.inputs.InstanceDenyMaintenancePeriodTimeArgs;
import com.pulumi.gcp.looker.inputs.InstanceMaintenanceWindowArgs;
import com.pulumi.gcp.looker.inputs.InstanceMaintenanceWindowStartTimeArgs;
import com.pulumi.gcp.looker.inputs.InstanceOauthConfigArgs;
import com.pulumi.gcp.looker.inputs.InstanceUserMetadataArgs;
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 looker_instance = new Instance("looker-instance", InstanceArgs.builder()
            .adminSettings(InstanceAdminSettingsArgs.builder()
                .allowedEmailDomains("google.com")
                .build())
            .denyMaintenancePeriod(InstanceDenyMaintenancePeriodArgs.builder()
                .endDate(InstanceDenyMaintenancePeriodEndDateArgs.builder()
                    .day(1)
                    .month(2)
                    .year(2050)
                    .build())
                .startDate(InstanceDenyMaintenancePeriodStartDateArgs.builder()
                    .day(1)
                    .month(1)
                    .year(2050)
                    .build())
                .time(InstanceDenyMaintenancePeriodTimeArgs.builder()
                    .hours(10)
                    .minutes(0)
                    .nanos(0)
                    .seconds(0)
                    .build())
                .build())
            .maintenanceWindow(InstanceMaintenanceWindowArgs.builder()
                .dayOfWeek("THURSDAY")
                .startTime(InstanceMaintenanceWindowStartTimeArgs.builder()
                    .hours(22)
                    .minutes(0)
                    .nanos(0)
                    .seconds(0)
                    .build())
                .build())
            .oauthConfig(InstanceOauthConfigArgs.builder()
                .clientId("my-client-id")
                .clientSecret("my-client-secret")
                .build())
            .platformEdition("LOOKER_CORE_STANDARD")
            .publicIpEnabled(true)
            .region("us-central1")
            .userMetadata(InstanceUserMetadataArgs.builder()
                .additionalDeveloperUserCount(10)
                .additionalStandardUserCount(10)
                .additionalViewerUserCount(10)
                .build())
            .build());
    }
}

Looker Instance Enterprise Full

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.compute.ComputeFunctions;
import com.pulumi.gcp.compute.inputs.GetNetworkArgs;
import com.pulumi.gcp.compute.GlobalAddress;
import com.pulumi.gcp.compute.GlobalAddressArgs;
import com.pulumi.gcp.servicenetworking.Connection;
import com.pulumi.gcp.servicenetworking.ConnectionArgs;
import com.pulumi.gcp.looker.Instance;
import com.pulumi.gcp.looker.InstanceArgs;
import com.pulumi.gcp.looker.inputs.InstanceAdminSettingsArgs;
import com.pulumi.gcp.looker.inputs.InstanceEncryptionConfigArgs;
import com.pulumi.gcp.looker.inputs.InstanceMaintenanceWindowArgs;
import com.pulumi.gcp.looker.inputs.InstanceMaintenanceWindowStartTimeArgs;
import com.pulumi.gcp.looker.inputs.InstanceDenyMaintenancePeriodArgs;
import com.pulumi.gcp.looker.inputs.InstanceDenyMaintenancePeriodStartDateArgs;
import com.pulumi.gcp.looker.inputs.InstanceDenyMaintenancePeriodEndDateArgs;
import com.pulumi.gcp.looker.inputs.InstanceDenyMaintenancePeriodTimeArgs;
import com.pulumi.gcp.looker.inputs.InstanceOauthConfigArgs;
import com.pulumi.gcp.organizations.OrganizationsFunctions;
import com.pulumi.gcp.organizations.inputs.GetProjectArgs;
import com.pulumi.gcp.kms.CryptoKeyIAMMember;
import com.pulumi.gcp.kms.CryptoKeyIAMMemberArgs;
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 lookerNetwork = ComputeFunctions.getNetwork(GetNetworkArgs.builder()
            .name("looker-network")
            .build());
        var lookerRange = new GlobalAddress("lookerRange", GlobalAddressArgs.builder()
            .purpose("VPC_PEERING")
            .addressType("INTERNAL")
            .prefixLength(20)
            .network(lookerNetwork.applyValue(getNetworkResult -> getNetworkResult.id()))
            .build());
        var lookerVpcConnection = new Connection("lookerVpcConnection", ConnectionArgs.builder()
            .network(lookerNetwork.applyValue(getNetworkResult -> getNetworkResult.id()))
            .service("servicenetworking.googleapis.com")
            .reservedPeeringRanges(lookerRange.name())
            .build());
        var looker_instance = new Instance("looker-instance", InstanceArgs.builder()
            .platformEdition("LOOKER_CORE_ENTERPRISE_ANNUAL")
            .region("us-central1")
            .privateIpEnabled(true)
            .publicIpEnabled(false)
            .reservedRange(lookerRange.name())
            .consumerNetwork(lookerNetwork.applyValue(getNetworkResult -> getNetworkResult.id()))
            .adminSettings(InstanceAdminSettingsArgs.builder()
                .allowedEmailDomains("google.com")
                .build())
            .encryptionConfig(InstanceEncryptionConfigArgs.builder()
                .kmsKeyName("looker-kms-key")
                .build())
            .maintenanceWindow(InstanceMaintenanceWindowArgs.builder()
                .dayOfWeek("THURSDAY")
                .startTime(InstanceMaintenanceWindowStartTimeArgs.builder()
                    .hours(22)
                    .minutes(0)
                    .seconds(0)
                    .nanos(0)
                    .build())
                .build())
            .denyMaintenancePeriod(InstanceDenyMaintenancePeriodArgs.builder()
                .startDate(InstanceDenyMaintenancePeriodStartDateArgs.builder()
                    .year(2050)
                    .month(1)
                    .day(1)
                    .build())
                .endDate(InstanceDenyMaintenancePeriodEndDateArgs.builder()
                    .year(2050)
                    .month(2)
                    .day(1)
                    .build())
                .time(InstanceDenyMaintenancePeriodTimeArgs.builder()
                    .hours(10)
                    .minutes(0)
                    .seconds(0)
                    .nanos(0)
                    .build())
                .build())
            .oauthConfig(InstanceOauthConfigArgs.builder()
                .clientId("my-client-id")
                .clientSecret("my-client-secret")
                .build())
            .build(), CustomResourceOptions.builder()
                .dependsOn(lookerVpcConnection)
                .build());
        final var project = OrganizationsFunctions.getProject();
        var cryptoKey = new CryptoKeyIAMMember("cryptoKey", CryptoKeyIAMMemberArgs.builder()
            .cryptoKeyId("looker-kms-key")
            .role("roles/cloudkms.cryptoKeyEncrypterDecrypter")
            .member(String.format("serviceAccount:service-%s@gcp-sa-looker.iam.gserviceaccount.com", project.applyValue(getProjectResult -> getProjectResult.number())))
            .build());
    }
}

Import

Instance can be imported using any of these accepted formats

$ pulumi import gcp:looker/instance:Instance default projects/{{project}}/locations/{{region}}/instances/{{name}}

$ pulumi import gcp:looker/instance:Instance default {{project}}/{{region}}/{{name}}

$ pulumi import gcp:looker/instance:Instance default {{region}}/{{name}}

$ pulumi import gcp:looker/instance:Instance default {{name}}

Constructors

InstanceArgs

constructor(adminSettings: Output<InstanceAdminSettingsArgs>? = null, consumerNetwork: Output<String>? = null, denyMaintenancePeriod: Output<InstanceDenyMaintenancePeriodArgs>? = null, encryptionConfig: Output<InstanceEncryptionConfigArgs>? = null, maintenanceWindow: Output<InstanceMaintenanceWindowArgs>? = null, name: Output<String>? = null, oauthConfig: Output<InstanceOauthConfigArgs>? = null, platformEdition: Output<String>? = null, privateIpEnabled: Output<Boolean>? = null, project: Output<String>? = null, publicIpEnabled: Output<Boolean>? = null, region: Output<String>? = null, reservedRange: Output<String>? = null, userMetadata: Output<InstanceUserMetadataArgs>? = null)

Properties

adminSettings

val adminSettings: Output<InstanceAdminSettingsArgs>? = null

Looker instance Admin settings. Structure is documented below.

consumerNetwork

val consumerNetwork: Output<String>? = null

Network name in the consumer project in the format of: projects/{project}/global/networks/{network} Note that the consumer network may be in a different GCP project than the consumer project that is hosting the Looker Instance.

denyMaintenancePeriod

val denyMaintenancePeriod: Output<InstanceDenyMaintenancePeriodArgs>? = null

Maintenance denial period for this instance. You must allow at least 14 days of maintenance availability between any two deny maintenance periods. Structure is documented below.

encryptionConfig

val encryptionConfig: Output<InstanceEncryptionConfigArgs>? = null

Looker instance encryption settings. Structure is documented below.

maintenanceWindow

val maintenanceWindow: Output<InstanceMaintenanceWindowArgs>? = null

Maintenance window for an instance. Maintenance of your instance takes place once a month, and will require your instance to be restarted during updates, which will temporarily disrupt service. Structure is documented below.

name

val name: Output<String>? = null

The ID of the instance or a fully qualified identifier for the instance.

oauthConfig

val oauthConfig: Output<InstanceOauthConfigArgs>? = null

Looker Instance OAuth login settings. Structure is documented below.

platformEdition

val platformEdition: Output<String>? = null

Platform editions for a Looker instance. Each edition maps to a set of instance features, like its size. Must be one of these values:

privateIpEnabled

val privateIpEnabled: Output<Boolean>? = null

Whether private IP is enabled on the Looker instance.

project

val project: Output<String>? = null

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

publicIpEnabled

val publicIpEnabled: Output<Boolean>? = null

Whether public IP is enabled on the Looker instance.

region

val region: Output<String>? = null

The name of the Looker region of the instance.

reservedRange

val reservedRange: Output<String>? = null

Name of a reserved IP address range within the consumer network, to be used for private service access connection. User may or may not specify this in a request.

userMetadata

val userMetadata: Output<InstanceUserMetadataArgs>? = null

Metadata about users for a Looker instance. These settings are only available when platform edition LOOKER_CORE_STANDARD is set. There are ten Standard and two Developer users included in the cost of the product. You can allocate additional Standard, Viewer, and Developer users for this instance. It is an optional step and can be modified later. With the Standard edition of Looker (Google Cloud core), you can provision up to 50 total users, distributed across Viewer, Standard, and Developer. Structure is documented below.

Functions

toJava

open override fun toJava(): InstanceArgs