gcp.notebooks.Instance
Explore with Pulumi AI
Warning:
google_notebook_instance
is deprecated and will be removed in a future major release. Usegcp.workbench.Instance
instead.
A Cloud AI Platform Notebook instance.
Note: Due to limitations of the Notebooks Instance API, many fields in this resource do not properly detect drift. These fields will also not appear in state once imported.
To get more information about Instance, see:
- API documentation
- How-to Guides
Example Usage
Notebook Instance Basic
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const instance = new gcp.notebooks.Instance("instance", {
name: "notebooks-instance",
location: "us-west1-a",
machineType: "e2-medium",
vmImage: {
project: "deeplearning-platform-release",
imageFamily: "tf-latest-cpu",
},
});
import pulumi
import pulumi_gcp as gcp
instance = gcp.notebooks.Instance("instance",
name="notebooks-instance",
location="us-west1-a",
machine_type="e2-medium",
vm_image={
"project": "deeplearning-platform-release",
"image_family": "tf-latest-cpu",
})
package main
import (
"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/notebooks"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := notebooks.NewInstance(ctx, "instance", ¬ebooks.InstanceArgs{
Name: pulumi.String("notebooks-instance"),
Location: pulumi.String("us-west1-a"),
MachineType: pulumi.String("e2-medium"),
VmImage: ¬ebooks.InstanceVmImageArgs{
Project: pulumi.String("deeplearning-platform-release"),
ImageFamily: pulumi.String("tf-latest-cpu"),
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
var instance = new Gcp.Notebooks.Instance("instance", new()
{
Name = "notebooks-instance",
Location = "us-west1-a",
MachineType = "e2-medium",
VmImage = new Gcp.Notebooks.Inputs.InstanceVmImageArgs
{
Project = "deeplearning-platform-release",
ImageFamily = "tf-latest-cpu",
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.notebooks.Instance;
import com.pulumi.gcp.notebooks.InstanceArgs;
import com.pulumi.gcp.notebooks.inputs.InstanceVmImageArgs;
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 instance = new Instance("instance", InstanceArgs.builder()
.name("notebooks-instance")
.location("us-west1-a")
.machineType("e2-medium")
.vmImage(InstanceVmImageArgs.builder()
.project("deeplearning-platform-release")
.imageFamily("tf-latest-cpu")
.build())
.build());
}
}
resources:
instance:
type: gcp:notebooks:Instance
properties:
name: notebooks-instance
location: us-west1-a
machineType: e2-medium
vmImage:
project: deeplearning-platform-release
imageFamily: tf-latest-cpu
Notebook Instance Basic Stopped
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const instance = new gcp.notebooks.Instance("instance", {
name: "notebooks-instance",
location: "us-west1-a",
machineType: "e2-medium",
vmImage: {
project: "deeplearning-platform-release",
imageFamily: "tf-latest-cpu",
},
desiredState: "STOPPED",
});
import pulumi
import pulumi_gcp as gcp
instance = gcp.notebooks.Instance("instance",
name="notebooks-instance",
location="us-west1-a",
machine_type="e2-medium",
vm_image={
"project": "deeplearning-platform-release",
"image_family": "tf-latest-cpu",
},
desired_state="STOPPED")
package main
import (
"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/notebooks"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := notebooks.NewInstance(ctx, "instance", ¬ebooks.InstanceArgs{
Name: pulumi.String("notebooks-instance"),
Location: pulumi.String("us-west1-a"),
MachineType: pulumi.String("e2-medium"),
VmImage: ¬ebooks.InstanceVmImageArgs{
Project: pulumi.String("deeplearning-platform-release"),
ImageFamily: pulumi.String("tf-latest-cpu"),
},
DesiredState: pulumi.String("STOPPED"),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
var instance = new Gcp.Notebooks.Instance("instance", new()
{
Name = "notebooks-instance",
Location = "us-west1-a",
MachineType = "e2-medium",
VmImage = new Gcp.Notebooks.Inputs.InstanceVmImageArgs
{
Project = "deeplearning-platform-release",
ImageFamily = "tf-latest-cpu",
},
DesiredState = "STOPPED",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.notebooks.Instance;
import com.pulumi.gcp.notebooks.InstanceArgs;
import com.pulumi.gcp.notebooks.inputs.InstanceVmImageArgs;
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 instance = new Instance("instance", InstanceArgs.builder()
.name("notebooks-instance")
.location("us-west1-a")
.machineType("e2-medium")
.vmImage(InstanceVmImageArgs.builder()
.project("deeplearning-platform-release")
.imageFamily("tf-latest-cpu")
.build())
.desiredState("STOPPED")
.build());
}
}
resources:
instance:
type: gcp:notebooks:Instance
properties:
name: notebooks-instance
location: us-west1-a
machineType: e2-medium
vmImage:
project: deeplearning-platform-release
imageFamily: tf-latest-cpu
desiredState: STOPPED
Notebook Instance Basic Container
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const instance = new gcp.notebooks.Instance("instance", {
name: "notebooks-instance",
location: "us-west1-a",
machineType: "e2-medium",
metadata: {
"proxy-mode": "service_account",
},
containerImage: {
repository: "gcr.io/deeplearning-platform-release/base-cpu",
tag: "latest",
},
});
import pulumi
import pulumi_gcp as gcp
instance = gcp.notebooks.Instance("instance",
name="notebooks-instance",
location="us-west1-a",
machine_type="e2-medium",
metadata={
"proxy-mode": "service_account",
},
container_image={
"repository": "gcr.io/deeplearning-platform-release/base-cpu",
"tag": "latest",
})
package main
import (
"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/notebooks"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := notebooks.NewInstance(ctx, "instance", ¬ebooks.InstanceArgs{
Name: pulumi.String("notebooks-instance"),
Location: pulumi.String("us-west1-a"),
MachineType: pulumi.String("e2-medium"),
Metadata: pulumi.StringMap{
"proxy-mode": pulumi.String("service_account"),
},
ContainerImage: ¬ebooks.InstanceContainerImageArgs{
Repository: pulumi.String("gcr.io/deeplearning-platform-release/base-cpu"),
Tag: pulumi.String("latest"),
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
var instance = new Gcp.Notebooks.Instance("instance", new()
{
Name = "notebooks-instance",
Location = "us-west1-a",
MachineType = "e2-medium",
Metadata =
{
{ "proxy-mode", "service_account" },
},
ContainerImage = new Gcp.Notebooks.Inputs.InstanceContainerImageArgs
{
Repository = "gcr.io/deeplearning-platform-release/base-cpu",
Tag = "latest",
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.notebooks.Instance;
import com.pulumi.gcp.notebooks.InstanceArgs;
import com.pulumi.gcp.notebooks.inputs.InstanceContainerImageArgs;
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 instance = new Instance("instance", InstanceArgs.builder()
.name("notebooks-instance")
.location("us-west1-a")
.machineType("e2-medium")
.metadata(Map.of("proxy-mode", "service_account"))
.containerImage(InstanceContainerImageArgs.builder()
.repository("gcr.io/deeplearning-platform-release/base-cpu")
.tag("latest")
.build())
.build());
}
}
resources:
instance:
type: gcp:notebooks:Instance
properties:
name: notebooks-instance
location: us-west1-a
machineType: e2-medium
metadata:
proxy-mode: service_account
containerImage:
repository: gcr.io/deeplearning-platform-release/base-cpu
tag: latest
Notebook Instance Basic Gpu
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const instance = new gcp.notebooks.Instance("instance", {
name: "notebooks-instance",
location: "us-west1-a",
machineType: "n1-standard-1",
installGpuDriver: true,
acceleratorConfig: {
type: "NVIDIA_TESLA_T4",
coreCount: 1,
},
vmImage: {
project: "deeplearning-platform-release",
imageFamily: "tf-latest-gpu",
},
});
import pulumi
import pulumi_gcp as gcp
instance = gcp.notebooks.Instance("instance",
name="notebooks-instance",
location="us-west1-a",
machine_type="n1-standard-1",
install_gpu_driver=True,
accelerator_config={
"type": "NVIDIA_TESLA_T4",
"core_count": 1,
},
vm_image={
"project": "deeplearning-platform-release",
"image_family": "tf-latest-gpu",
})
package main
import (
"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/notebooks"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := notebooks.NewInstance(ctx, "instance", ¬ebooks.InstanceArgs{
Name: pulumi.String("notebooks-instance"),
Location: pulumi.String("us-west1-a"),
MachineType: pulumi.String("n1-standard-1"),
InstallGpuDriver: pulumi.Bool(true),
AcceleratorConfig: ¬ebooks.InstanceAcceleratorConfigArgs{
Type: pulumi.String("NVIDIA_TESLA_T4"),
CoreCount: pulumi.Int(1),
},
VmImage: ¬ebooks.InstanceVmImageArgs{
Project: pulumi.String("deeplearning-platform-release"),
ImageFamily: pulumi.String("tf-latest-gpu"),
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
var instance = new Gcp.Notebooks.Instance("instance", new()
{
Name = "notebooks-instance",
Location = "us-west1-a",
MachineType = "n1-standard-1",
InstallGpuDriver = true,
AcceleratorConfig = new Gcp.Notebooks.Inputs.InstanceAcceleratorConfigArgs
{
Type = "NVIDIA_TESLA_T4",
CoreCount = 1,
},
VmImage = new Gcp.Notebooks.Inputs.InstanceVmImageArgs
{
Project = "deeplearning-platform-release",
ImageFamily = "tf-latest-gpu",
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.notebooks.Instance;
import com.pulumi.gcp.notebooks.InstanceArgs;
import com.pulumi.gcp.notebooks.inputs.InstanceAcceleratorConfigArgs;
import com.pulumi.gcp.notebooks.inputs.InstanceVmImageArgs;
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 instance = new Instance("instance", InstanceArgs.builder()
.name("notebooks-instance")
.location("us-west1-a")
.machineType("n1-standard-1")
.installGpuDriver(true)
.acceleratorConfig(InstanceAcceleratorConfigArgs.builder()
.type("NVIDIA_TESLA_T4")
.coreCount(1)
.build())
.vmImage(InstanceVmImageArgs.builder()
.project("deeplearning-platform-release")
.imageFamily("tf-latest-gpu")
.build())
.build());
}
}
resources:
instance:
type: gcp:notebooks:Instance
properties:
name: notebooks-instance
location: us-west1-a
machineType: n1-standard-1
installGpuDriver: true
acceleratorConfig:
type: NVIDIA_TESLA_T4
coreCount: 1
vmImage:
project: deeplearning-platform-release
imageFamily: tf-latest-gpu
Notebook Instance Full
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const myNetwork = gcp.compute.getNetwork({
name: "default",
});
const mySubnetwork = gcp.compute.getSubnetwork({
name: "default",
region: "us-central1",
});
const instance = new gcp.notebooks.Instance("instance", {
name: "notebooks-instance",
location: "us-central1-a",
machineType: "e2-medium",
vmImage: {
project: "deeplearning-platform-release",
imageFamily: "tf-latest-cpu",
},
instanceOwners: ["my@service-account.com"],
serviceAccount: "my@service-account.com",
installGpuDriver: true,
bootDiskType: "PD_SSD",
bootDiskSizeGb: 110,
noPublicIp: true,
noProxyAccess: true,
network: myNetwork.then(myNetwork => myNetwork.id),
subnet: mySubnetwork.then(mySubnetwork => mySubnetwork.id),
labels: {
k: "val",
},
metadata: {
terraform: "true",
},
serviceAccountScopes: [
"https://www.googleapis.com/auth/bigquery",
"https://www.googleapis.com/auth/devstorage.read_write",
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/userinfo.email",
],
tags: [
"foo",
"bar",
],
diskEncryption: "CMEK",
kmsKey: "my-crypto-key",
desiredState: "ACTIVE",
});
import pulumi
import pulumi_gcp as gcp
my_network = gcp.compute.get_network(name="default")
my_subnetwork = gcp.compute.get_subnetwork(name="default",
region="us-central1")
instance = gcp.notebooks.Instance("instance",
name="notebooks-instance",
location="us-central1-a",
machine_type="e2-medium",
vm_image={
"project": "deeplearning-platform-release",
"image_family": "tf-latest-cpu",
},
instance_owners=["my@service-account.com"],
service_account="my@service-account.com",
install_gpu_driver=True,
boot_disk_type="PD_SSD",
boot_disk_size_gb=110,
no_public_ip=True,
no_proxy_access=True,
network=my_network.id,
subnet=my_subnetwork.id,
labels={
"k": "val",
},
metadata={
"terraform": "true",
},
service_account_scopes=[
"https://www.googleapis.com/auth/bigquery",
"https://www.googleapis.com/auth/devstorage.read_write",
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/userinfo.email",
],
tags=[
"foo",
"bar",
],
disk_encryption="CMEK",
kms_key="my-crypto-key",
desired_state="ACTIVE")
package main
import (
"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/compute"
"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/notebooks"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
myNetwork, err := compute.LookupNetwork(ctx, &compute.LookupNetworkArgs{
Name: "default",
}, nil)
if err != nil {
return err
}
mySubnetwork, err := compute.LookupSubnetwork(ctx, &compute.LookupSubnetworkArgs{
Name: pulumi.StringRef("default"),
Region: pulumi.StringRef("us-central1"),
}, nil)
if err != nil {
return err
}
_, err = notebooks.NewInstance(ctx, "instance", ¬ebooks.InstanceArgs{
Name: pulumi.String("notebooks-instance"),
Location: pulumi.String("us-central1-a"),
MachineType: pulumi.String("e2-medium"),
VmImage: ¬ebooks.InstanceVmImageArgs{
Project: pulumi.String("deeplearning-platform-release"),
ImageFamily: pulumi.String("tf-latest-cpu"),
},
InstanceOwners: pulumi.StringArray{
pulumi.String("my@service-account.com"),
},
ServiceAccount: pulumi.String("my@service-account.com"),
InstallGpuDriver: pulumi.Bool(true),
BootDiskType: pulumi.String("PD_SSD"),
BootDiskSizeGb: pulumi.Int(110),
NoPublicIp: pulumi.Bool(true),
NoProxyAccess: pulumi.Bool(true),
Network: pulumi.String(myNetwork.Id),
Subnet: pulumi.String(mySubnetwork.Id),
Labels: pulumi.StringMap{
"k": pulumi.String("val"),
},
Metadata: pulumi.StringMap{
"terraform": pulumi.String("true"),
},
ServiceAccountScopes: pulumi.StringArray{
pulumi.String("https://www.googleapis.com/auth/bigquery"),
pulumi.String("https://www.googleapis.com/auth/devstorage.read_write"),
pulumi.String("https://www.googleapis.com/auth/cloud-platform"),
pulumi.String("https://www.googleapis.com/auth/userinfo.email"),
},
Tags: pulumi.StringArray{
pulumi.String("foo"),
pulumi.String("bar"),
},
DiskEncryption: pulumi.String("CMEK"),
KmsKey: pulumi.String("my-crypto-key"),
DesiredState: pulumi.String("ACTIVE"),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
var myNetwork = Gcp.Compute.GetNetwork.Invoke(new()
{
Name = "default",
});
var mySubnetwork = Gcp.Compute.GetSubnetwork.Invoke(new()
{
Name = "default",
Region = "us-central1",
});
var instance = new Gcp.Notebooks.Instance("instance", new()
{
Name = "notebooks-instance",
Location = "us-central1-a",
MachineType = "e2-medium",
VmImage = new Gcp.Notebooks.Inputs.InstanceVmImageArgs
{
Project = "deeplearning-platform-release",
ImageFamily = "tf-latest-cpu",
},
InstanceOwners = new[]
{
"my@service-account.com",
},
ServiceAccount = "my@service-account.com",
InstallGpuDriver = true,
BootDiskType = "PD_SSD",
BootDiskSizeGb = 110,
NoPublicIp = true,
NoProxyAccess = true,
Network = myNetwork.Apply(getNetworkResult => getNetworkResult.Id),
Subnet = mySubnetwork.Apply(getSubnetworkResult => getSubnetworkResult.Id),
Labels =
{
{ "k", "val" },
},
Metadata =
{
{ "terraform", "true" },
},
ServiceAccountScopes = new[]
{
"https://www.googleapis.com/auth/bigquery",
"https://www.googleapis.com/auth/devstorage.read_write",
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/userinfo.email",
},
Tags = new[]
{
"foo",
"bar",
},
DiskEncryption = "CMEK",
KmsKey = "my-crypto-key",
DesiredState = "ACTIVE",
});
});
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.inputs.GetSubnetworkArgs;
import com.pulumi.gcp.notebooks.Instance;
import com.pulumi.gcp.notebooks.InstanceArgs;
import com.pulumi.gcp.notebooks.inputs.InstanceVmImageArgs;
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 myNetwork = ComputeFunctions.getNetwork(GetNetworkArgs.builder()
.name("default")
.build());
final var mySubnetwork = ComputeFunctions.getSubnetwork(GetSubnetworkArgs.builder()
.name("default")
.region("us-central1")
.build());
var instance = new Instance("instance", InstanceArgs.builder()
.name("notebooks-instance")
.location("us-central1-a")
.machineType("e2-medium")
.vmImage(InstanceVmImageArgs.builder()
.project("deeplearning-platform-release")
.imageFamily("tf-latest-cpu")
.build())
.instanceOwners("my@service-account.com")
.serviceAccount("my@service-account.com")
.installGpuDriver(true)
.bootDiskType("PD_SSD")
.bootDiskSizeGb(110)
.noPublicIp(true)
.noProxyAccess(true)
.network(myNetwork.applyValue(getNetworkResult -> getNetworkResult.id()))
.subnet(mySubnetwork.applyValue(getSubnetworkResult -> getSubnetworkResult.id()))
.labels(Map.of("k", "val"))
.metadata(Map.of("terraform", "true"))
.serviceAccountScopes(
"https://www.googleapis.com/auth/bigquery",
"https://www.googleapis.com/auth/devstorage.read_write",
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/userinfo.email")
.tags(
"foo",
"bar")
.diskEncryption("CMEK")
.kmsKey("my-crypto-key")
.desiredState("ACTIVE")
.build());
}
}
resources:
instance:
type: gcp:notebooks:Instance
properties:
name: notebooks-instance
location: us-central1-a
machineType: e2-medium
vmImage:
project: deeplearning-platform-release
imageFamily: tf-latest-cpu
instanceOwners:
- my@service-account.com
serviceAccount: my@service-account.com
installGpuDriver: true
bootDiskType: PD_SSD
bootDiskSizeGb: 110
noPublicIp: true
noProxyAccess: true
network: ${myNetwork.id}
subnet: ${mySubnetwork.id}
labels:
k: val
metadata:
terraform: 'true'
serviceAccountScopes:
- https://www.googleapis.com/auth/bigquery
- https://www.googleapis.com/auth/devstorage.read_write
- https://www.googleapis.com/auth/cloud-platform
- https://www.googleapis.com/auth/userinfo.email
tags:
- foo
- bar
diskEncryption: CMEK
kmsKey: my-crypto-key
desiredState: ACTIVE
variables:
myNetwork:
fn::invoke:
Function: gcp:compute:getNetwork
Arguments:
name: default
mySubnetwork:
fn::invoke:
Function: gcp:compute:getSubnetwork
Arguments:
name: default
region: us-central1
Create Instance Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Instance(name: string, args: InstanceArgs, opts?: CustomResourceOptions);
@overload
def Instance(resource_name: str,
args: InstanceArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Instance(resource_name: str,
opts: Optional[ResourceOptions] = None,
location: Optional[str] = None,
machine_type: Optional[str] = None,
metadata: Optional[Mapping[str, str]] = None,
vm_image: Optional[InstanceVmImageArgs] = None,
accelerator_config: Optional[InstanceAcceleratorConfigArgs] = None,
custom_gpu_driver_path: Optional[str] = None,
data_disk_size_gb: Optional[int] = None,
data_disk_type: Optional[str] = None,
desired_state: Optional[str] = None,
disk_encryption: Optional[str] = None,
install_gpu_driver: Optional[bool] = None,
instance_owners: Optional[Sequence[str]] = None,
kms_key: Optional[str] = None,
labels: Optional[Mapping[str, str]] = None,
boot_disk_type: Optional[str] = None,
boot_disk_size_gb: Optional[int] = None,
create_time: Optional[str] = None,
network: Optional[str] = None,
container_image: Optional[InstanceContainerImageArgs] = None,
nic_type: Optional[str] = None,
no_proxy_access: Optional[bool] = None,
no_public_ip: Optional[bool] = None,
no_remove_data_disk: Optional[bool] = None,
post_startup_script: Optional[str] = None,
project: Optional[str] = None,
reservation_affinity: Optional[InstanceReservationAffinityArgs] = None,
service_account: Optional[str] = None,
service_account_scopes: Optional[Sequence[str]] = None,
shielded_instance_config: Optional[InstanceShieldedInstanceConfigArgs] = None,
subnet: Optional[str] = None,
tags: Optional[Sequence[str]] = None,
update_time: Optional[str] = None,
name: Optional[str] = None)
func NewInstance(ctx *Context, name string, args InstanceArgs, opts ...ResourceOption) (*Instance, error)
public Instance(string name, InstanceArgs args, CustomResourceOptions? opts = null)
public Instance(String name, InstanceArgs args)
public Instance(String name, InstanceArgs args, CustomResourceOptions options)
type: gcp:notebooks:Instance
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args InstanceArgs
- 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 InstanceArgs
- 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 InstanceArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args InstanceArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args InstanceArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var exampleinstanceResourceResourceFromNotebooksinstance = new Gcp.Notebooks.Instance("exampleinstanceResourceResourceFromNotebooksinstance", new()
{
Location = "string",
MachineType = "string",
Metadata =
{
{ "string", "string" },
},
VmImage = new Gcp.Notebooks.Inputs.InstanceVmImageArgs
{
Project = "string",
ImageFamily = "string",
ImageName = "string",
},
AcceleratorConfig = new Gcp.Notebooks.Inputs.InstanceAcceleratorConfigArgs
{
CoreCount = 0,
Type = "string",
},
CustomGpuDriverPath = "string",
DataDiskSizeGb = 0,
DataDiskType = "string",
DesiredState = "string",
DiskEncryption = "string",
InstallGpuDriver = false,
InstanceOwners = new[]
{
"string",
},
KmsKey = "string",
Labels =
{
{ "string", "string" },
},
BootDiskType = "string",
BootDiskSizeGb = 0,
CreateTime = "string",
Network = "string",
ContainerImage = new Gcp.Notebooks.Inputs.InstanceContainerImageArgs
{
Repository = "string",
Tag = "string",
},
NicType = "string",
NoProxyAccess = false,
NoPublicIp = false,
NoRemoveDataDisk = false,
PostStartupScript = "string",
Project = "string",
ReservationAffinity = new Gcp.Notebooks.Inputs.InstanceReservationAffinityArgs
{
ConsumeReservationType = "string",
Key = "string",
Values = new[]
{
"string",
},
},
ServiceAccount = "string",
ServiceAccountScopes = new[]
{
"string",
},
ShieldedInstanceConfig = new Gcp.Notebooks.Inputs.InstanceShieldedInstanceConfigArgs
{
EnableIntegrityMonitoring = false,
EnableSecureBoot = false,
EnableVtpm = false,
},
Subnet = "string",
Tags = new[]
{
"string",
},
UpdateTime = "string",
Name = "string",
});
example, err := notebooks.NewInstance(ctx, "exampleinstanceResourceResourceFromNotebooksinstance", ¬ebooks.InstanceArgs{
Location: pulumi.String("string"),
MachineType: pulumi.String("string"),
Metadata: pulumi.StringMap{
"string": pulumi.String("string"),
},
VmImage: ¬ebooks.InstanceVmImageArgs{
Project: pulumi.String("string"),
ImageFamily: pulumi.String("string"),
ImageName: pulumi.String("string"),
},
AcceleratorConfig: ¬ebooks.InstanceAcceleratorConfigArgs{
CoreCount: pulumi.Int(0),
Type: pulumi.String("string"),
},
CustomGpuDriverPath: pulumi.String("string"),
DataDiskSizeGb: pulumi.Int(0),
DataDiskType: pulumi.String("string"),
DesiredState: pulumi.String("string"),
DiskEncryption: pulumi.String("string"),
InstallGpuDriver: pulumi.Bool(false),
InstanceOwners: pulumi.StringArray{
pulumi.String("string"),
},
KmsKey: pulumi.String("string"),
Labels: pulumi.StringMap{
"string": pulumi.String("string"),
},
BootDiskType: pulumi.String("string"),
BootDiskSizeGb: pulumi.Int(0),
CreateTime: pulumi.String("string"),
Network: pulumi.String("string"),
ContainerImage: ¬ebooks.InstanceContainerImageArgs{
Repository: pulumi.String("string"),
Tag: pulumi.String("string"),
},
NicType: pulumi.String("string"),
NoProxyAccess: pulumi.Bool(false),
NoPublicIp: pulumi.Bool(false),
NoRemoveDataDisk: pulumi.Bool(false),
PostStartupScript: pulumi.String("string"),
Project: pulumi.String("string"),
ReservationAffinity: ¬ebooks.InstanceReservationAffinityArgs{
ConsumeReservationType: pulumi.String("string"),
Key: pulumi.String("string"),
Values: pulumi.StringArray{
pulumi.String("string"),
},
},
ServiceAccount: pulumi.String("string"),
ServiceAccountScopes: pulumi.StringArray{
pulumi.String("string"),
},
ShieldedInstanceConfig: ¬ebooks.InstanceShieldedInstanceConfigArgs{
EnableIntegrityMonitoring: pulumi.Bool(false),
EnableSecureBoot: pulumi.Bool(false),
EnableVtpm: pulumi.Bool(false),
},
Subnet: pulumi.String("string"),
Tags: pulumi.StringArray{
pulumi.String("string"),
},
UpdateTime: pulumi.String("string"),
Name: pulumi.String("string"),
})
var exampleinstanceResourceResourceFromNotebooksinstance = new Instance("exampleinstanceResourceResourceFromNotebooksinstance", InstanceArgs.builder()
.location("string")
.machineType("string")
.metadata(Map.of("string", "string"))
.vmImage(InstanceVmImageArgs.builder()
.project("string")
.imageFamily("string")
.imageName("string")
.build())
.acceleratorConfig(InstanceAcceleratorConfigArgs.builder()
.coreCount(0)
.type("string")
.build())
.customGpuDriverPath("string")
.dataDiskSizeGb(0)
.dataDiskType("string")
.desiredState("string")
.diskEncryption("string")
.installGpuDriver(false)
.instanceOwners("string")
.kmsKey("string")
.labels(Map.of("string", "string"))
.bootDiskType("string")
.bootDiskSizeGb(0)
.createTime("string")
.network("string")
.containerImage(InstanceContainerImageArgs.builder()
.repository("string")
.tag("string")
.build())
.nicType("string")
.noProxyAccess(false)
.noPublicIp(false)
.noRemoveDataDisk(false)
.postStartupScript("string")
.project("string")
.reservationAffinity(InstanceReservationAffinityArgs.builder()
.consumeReservationType("string")
.key("string")
.values("string")
.build())
.serviceAccount("string")
.serviceAccountScopes("string")
.shieldedInstanceConfig(InstanceShieldedInstanceConfigArgs.builder()
.enableIntegrityMonitoring(false)
.enableSecureBoot(false)
.enableVtpm(false)
.build())
.subnet("string")
.tags("string")
.updateTime("string")
.name("string")
.build());
exampleinstance_resource_resource_from_notebooksinstance = gcp.notebooks.Instance("exampleinstanceResourceResourceFromNotebooksinstance",
location="string",
machine_type="string",
metadata={
"string": "string",
},
vm_image={
"project": "string",
"imageFamily": "string",
"imageName": "string",
},
accelerator_config={
"coreCount": 0,
"type": "string",
},
custom_gpu_driver_path="string",
data_disk_size_gb=0,
data_disk_type="string",
desired_state="string",
disk_encryption="string",
install_gpu_driver=False,
instance_owners=["string"],
kms_key="string",
labels={
"string": "string",
},
boot_disk_type="string",
boot_disk_size_gb=0,
create_time="string",
network="string",
container_image={
"repository": "string",
"tag": "string",
},
nic_type="string",
no_proxy_access=False,
no_public_ip=False,
no_remove_data_disk=False,
post_startup_script="string",
project="string",
reservation_affinity={
"consumeReservationType": "string",
"key": "string",
"values": ["string"],
},
service_account="string",
service_account_scopes=["string"],
shielded_instance_config={
"enableIntegrityMonitoring": False,
"enableSecureBoot": False,
"enableVtpm": False,
},
subnet="string",
tags=["string"],
update_time="string",
name="string")
const exampleinstanceResourceResourceFromNotebooksinstance = new gcp.notebooks.Instance("exampleinstanceResourceResourceFromNotebooksinstance", {
location: "string",
machineType: "string",
metadata: {
string: "string",
},
vmImage: {
project: "string",
imageFamily: "string",
imageName: "string",
},
acceleratorConfig: {
coreCount: 0,
type: "string",
},
customGpuDriverPath: "string",
dataDiskSizeGb: 0,
dataDiskType: "string",
desiredState: "string",
diskEncryption: "string",
installGpuDriver: false,
instanceOwners: ["string"],
kmsKey: "string",
labels: {
string: "string",
},
bootDiskType: "string",
bootDiskSizeGb: 0,
createTime: "string",
network: "string",
containerImage: {
repository: "string",
tag: "string",
},
nicType: "string",
noProxyAccess: false,
noPublicIp: false,
noRemoveDataDisk: false,
postStartupScript: "string",
project: "string",
reservationAffinity: {
consumeReservationType: "string",
key: "string",
values: ["string"],
},
serviceAccount: "string",
serviceAccountScopes: ["string"],
shieldedInstanceConfig: {
enableIntegrityMonitoring: false,
enableSecureBoot: false,
enableVtpm: false,
},
subnet: "string",
tags: ["string"],
updateTime: "string",
name: "string",
});
type: gcp:notebooks:Instance
properties:
acceleratorConfig:
coreCount: 0
type: string
bootDiskSizeGb: 0
bootDiskType: string
containerImage:
repository: string
tag: string
createTime: string
customGpuDriverPath: string
dataDiskSizeGb: 0
dataDiskType: string
desiredState: string
diskEncryption: string
installGpuDriver: false
instanceOwners:
- string
kmsKey: string
labels:
string: string
location: string
machineType: string
metadata:
string: string
name: string
network: string
nicType: string
noProxyAccess: false
noPublicIp: false
noRemoveDataDisk: false
postStartupScript: string
project: string
reservationAffinity:
consumeReservationType: string
key: string
values:
- string
serviceAccount: string
serviceAccountScopes:
- string
shieldedInstanceConfig:
enableIntegrityMonitoring: false
enableSecureBoot: false
enableVtpm: false
subnet: string
tags:
- string
updateTime: string
vmImage:
imageFamily: string
imageName: string
project: string
Instance 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 Instance resource accepts the following input properties:
- Location string
- A reference to the zone where the machine resides.
- Machine
Type string - A reference to a machine type which defines VM kind.
- Accelerator
Config InstanceAccelerator Config - The hardware accelerator used on this instance. If you use accelerators, make sure that your configuration has enough vCPUs and memory to support the machineType you have selected. Structure is documented below.
- Boot
Disk intSize Gb - The size of the boot disk in GB attached to this instance, up to a maximum of 64000 GB (64 TB). The minimum recommended value is 100 GB. If not specified, this defaults to 100.
- Boot
Disk stringType - Possible disk types for notebook instances.
Possible values are:
DISK_TYPE_UNSPECIFIED
,PD_STANDARD
,PD_SSD
,PD_BALANCED
,PD_EXTREME
. - Container
Image InstanceContainer Image - Use a container image to start the notebook instance. Structure is documented below.
- Create
Time string - Instance creation time
- Custom
Gpu stringDriver Path - Specify a custom Cloud Storage path where the GPU driver is stored. If not specified, we'll automatically choose from official GPU drivers.
- Data
Disk intSize Gb - The size of the data disk in GB attached to this instance, up to a maximum of 64000 GB (64 TB). You can choose the size of the data disk based on how big your notebooks and data are. If not specified, this defaults to 100.
- Data
Disk stringType - Possible disk types for notebook instances.
Possible values are:
DISK_TYPE_UNSPECIFIED
,PD_STANDARD
,PD_SSD
,PD_BALANCED
,PD_EXTREME
. - Desired
State string - Desired state of the Notebook Instance. Set this field to
ACTIVE
to start the Instance, andSTOPPED
to stop the Instance. - Disk
Encryption string - Disk encryption method used on the boot and data disks, defaults to GMEK.
Possible values are:
DISK_ENCRYPTION_UNSPECIFIED
,GMEK
,CMEK
. - Install
Gpu boolDriver - Whether the end user authorizes Google Cloud to install GPU driver on this instance. If this field is empty or set to false, the GPU driver won't be installed. Only applicable to instances with GPUs.
- Instance
Owners List<string> - The list of owners of this instance after creation. Format: alias@example.com. Currently supports one owner only. If not specified, all of the service account users of your VM instance's service account can use the instance.
- Kms
Key string - The KMS key used to encrypt the disks, only applicable if diskEncryption is CMEK. Format: projects/{project_id}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{key_id}
- Labels Dictionary<string, string>
Labels to apply to this instance. These can be later modified by the setLabels method. An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
effective_labels
for all of the labels present on the resource.- Metadata Dictionary<string, string>
- Custom metadata to apply to this instance. An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
- Name string
- The name specified for the Notebook instance.
- Network string
- The name of the VPC that this instance is in. Format: projects/{project_id}/global/networks/{network_id}
- Nic
Type string - The type of vNIC driver.
Possible values are:
UNSPECIFIED_NIC_TYPE
,VIRTIO_NET
,GVNIC
. - No
Proxy boolAccess - The notebook instance will not register with the proxy..
- No
Public boolIp - No public IP will be assigned to this instance.
- No
Remove boolData Disk - If true, the data disk will not be auto deleted when deleting the instance.
- Post
Startup stringScript - Path to a Bash script that automatically runs after a notebook instance fully boots up. The path must be a URL or Cloud Storage path (gs://path-to-file/file-name).
- Project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Reservation
Affinity InstanceReservation Affinity - Reservation Affinity for consuming Zonal reservation. Structure is documented below.
- Service
Account string - The service account on this instance, giving access to other Google Cloud services. You can use any service account within the same project, but you must have the service account user permission to use the instance. If not specified, the Compute Engine default service account is used.
- Service
Account List<string>Scopes - Optional. The URIs of service account scopes to be included in Compute Engine instances.
If not specified, the following scopes are defined:
- https://www.googleapis.com/auth/cloud-platform
- https://www.googleapis.com/auth/userinfo.email
- Shielded
Instance InstanceConfig Shielded Instance Config - A set of Shielded Instance options. Check [Images using supported Shielded VM features] Not all combinations are valid Structure is documented below.
- Subnet string
- The name of the subnet that this instance is in. Format: projects/{project_id}/regions/{region}/subnetworks/{subnetwork_id}
- List<string>
- The Compute Engine tags to add to instance.
- Update
Time string - Instance update time.
- Vm
Image InstanceVm Image - Use a Compute Engine VM image to start the notebook instance. Structure is documented below.
- Location string
- A reference to the zone where the machine resides.
- Machine
Type string - A reference to a machine type which defines VM kind.
- Accelerator
Config InstanceAccelerator Config Args - The hardware accelerator used on this instance. If you use accelerators, make sure that your configuration has enough vCPUs and memory to support the machineType you have selected. Structure is documented below.
- Boot
Disk intSize Gb - The size of the boot disk in GB attached to this instance, up to a maximum of 64000 GB (64 TB). The minimum recommended value is 100 GB. If not specified, this defaults to 100.
- Boot
Disk stringType - Possible disk types for notebook instances.
Possible values are:
DISK_TYPE_UNSPECIFIED
,PD_STANDARD
,PD_SSD
,PD_BALANCED
,PD_EXTREME
. - Container
Image InstanceContainer Image Args - Use a container image to start the notebook instance. Structure is documented below.
- Create
Time string - Instance creation time
- Custom
Gpu stringDriver Path - Specify a custom Cloud Storage path where the GPU driver is stored. If not specified, we'll automatically choose from official GPU drivers.
- Data
Disk intSize Gb - The size of the data disk in GB attached to this instance, up to a maximum of 64000 GB (64 TB). You can choose the size of the data disk based on how big your notebooks and data are. If not specified, this defaults to 100.
- Data
Disk stringType - Possible disk types for notebook instances.
Possible values are:
DISK_TYPE_UNSPECIFIED
,PD_STANDARD
,PD_SSD
,PD_BALANCED
,PD_EXTREME
. - Desired
State string - Desired state of the Notebook Instance. Set this field to
ACTIVE
to start the Instance, andSTOPPED
to stop the Instance. - Disk
Encryption string - Disk encryption method used on the boot and data disks, defaults to GMEK.
Possible values are:
DISK_ENCRYPTION_UNSPECIFIED
,GMEK
,CMEK
. - Install
Gpu boolDriver - Whether the end user authorizes Google Cloud to install GPU driver on this instance. If this field is empty or set to false, the GPU driver won't be installed. Only applicable to instances with GPUs.
- Instance
Owners []string - The list of owners of this instance after creation. Format: alias@example.com. Currently supports one owner only. If not specified, all of the service account users of your VM instance's service account can use the instance.
- Kms
Key string - The KMS key used to encrypt the disks, only applicable if diskEncryption is CMEK. Format: projects/{project_id}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{key_id}
- Labels map[string]string
Labels to apply to this instance. These can be later modified by the setLabels method. An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
effective_labels
for all of the labels present on the resource.- Metadata map[string]string
- Custom metadata to apply to this instance. An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
- Name string
- The name specified for the Notebook instance.
- Network string
- The name of the VPC that this instance is in. Format: projects/{project_id}/global/networks/{network_id}
- Nic
Type string - The type of vNIC driver.
Possible values are:
UNSPECIFIED_NIC_TYPE
,VIRTIO_NET
,GVNIC
. - No
Proxy boolAccess - The notebook instance will not register with the proxy..
- No
Public boolIp - No public IP will be assigned to this instance.
- No
Remove boolData Disk - If true, the data disk will not be auto deleted when deleting the instance.
- Post
Startup stringScript - Path to a Bash script that automatically runs after a notebook instance fully boots up. The path must be a URL or Cloud Storage path (gs://path-to-file/file-name).
- Project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Reservation
Affinity InstanceReservation Affinity Args - Reservation Affinity for consuming Zonal reservation. Structure is documented below.
- Service
Account string - The service account on this instance, giving access to other Google Cloud services. You can use any service account within the same project, but you must have the service account user permission to use the instance. If not specified, the Compute Engine default service account is used.
- Service
Account []stringScopes - Optional. The URIs of service account scopes to be included in Compute Engine instances.
If not specified, the following scopes are defined:
- https://www.googleapis.com/auth/cloud-platform
- https://www.googleapis.com/auth/userinfo.email
- Shielded
Instance InstanceConfig Shielded Instance Config Args - A set of Shielded Instance options. Check [Images using supported Shielded VM features] Not all combinations are valid Structure is documented below.
- Subnet string
- The name of the subnet that this instance is in. Format: projects/{project_id}/regions/{region}/subnetworks/{subnetwork_id}
- []string
- The Compute Engine tags to add to instance.
- Update
Time string - Instance update time.
- Vm
Image InstanceVm Image Args - Use a Compute Engine VM image to start the notebook instance. Structure is documented below.
- location String
- A reference to the zone where the machine resides.
- machine
Type String - A reference to a machine type which defines VM kind.
- accelerator
Config InstanceAccelerator Config - The hardware accelerator used on this instance. If you use accelerators, make sure that your configuration has enough vCPUs and memory to support the machineType you have selected. Structure is documented below.
- boot
Disk IntegerSize Gb - The size of the boot disk in GB attached to this instance, up to a maximum of 64000 GB (64 TB). The minimum recommended value is 100 GB. If not specified, this defaults to 100.
- boot
Disk StringType - Possible disk types for notebook instances.
Possible values are:
DISK_TYPE_UNSPECIFIED
,PD_STANDARD
,PD_SSD
,PD_BALANCED
,PD_EXTREME
. - container
Image InstanceContainer Image - Use a container image to start the notebook instance. Structure is documented below.
- create
Time String - Instance creation time
- custom
Gpu StringDriver Path - Specify a custom Cloud Storage path where the GPU driver is stored. If not specified, we'll automatically choose from official GPU drivers.
- data
Disk IntegerSize Gb - The size of the data disk in GB attached to this instance, up to a maximum of 64000 GB (64 TB). You can choose the size of the data disk based on how big your notebooks and data are. If not specified, this defaults to 100.
- data
Disk StringType - Possible disk types for notebook instances.
Possible values are:
DISK_TYPE_UNSPECIFIED
,PD_STANDARD
,PD_SSD
,PD_BALANCED
,PD_EXTREME
. - desired
State String - Desired state of the Notebook Instance. Set this field to
ACTIVE
to start the Instance, andSTOPPED
to stop the Instance. - disk
Encryption String - Disk encryption method used on the boot and data disks, defaults to GMEK.
Possible values are:
DISK_ENCRYPTION_UNSPECIFIED
,GMEK
,CMEK
. - install
Gpu BooleanDriver - Whether the end user authorizes Google Cloud to install GPU driver on this instance. If this field is empty or set to false, the GPU driver won't be installed. Only applicable to instances with GPUs.
- instance
Owners List<String> - The list of owners of this instance after creation. Format: alias@example.com. Currently supports one owner only. If not specified, all of the service account users of your VM instance's service account can use the instance.
- kms
Key String - The KMS key used to encrypt the disks, only applicable if diskEncryption is CMEK. Format: projects/{project_id}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{key_id}
- labels Map<String,String>
Labels to apply to this instance. These can be later modified by the setLabels method. An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
effective_labels
for all of the labels present on the resource.- metadata Map<String,String>
- Custom metadata to apply to this instance. An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
- name String
- The name specified for the Notebook instance.
- network String
- The name of the VPC that this instance is in. Format: projects/{project_id}/global/networks/{network_id}
- nic
Type String - The type of vNIC driver.
Possible values are:
UNSPECIFIED_NIC_TYPE
,VIRTIO_NET
,GVNIC
. - no
Proxy BooleanAccess - The notebook instance will not register with the proxy..
- no
Public BooleanIp - No public IP will be assigned to this instance.
- no
Remove BooleanData Disk - If true, the data disk will not be auto deleted when deleting the instance.
- post
Startup StringScript - Path to a Bash script that automatically runs after a notebook instance fully boots up. The path must be a URL or Cloud Storage path (gs://path-to-file/file-name).
- project String
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- reservation
Affinity InstanceReservation Affinity - Reservation Affinity for consuming Zonal reservation. Structure is documented below.
- service
Account String - The service account on this instance, giving access to other Google Cloud services. You can use any service account within the same project, but you must have the service account user permission to use the instance. If not specified, the Compute Engine default service account is used.
- service
Account List<String>Scopes - Optional. The URIs of service account scopes to be included in Compute Engine instances.
If not specified, the following scopes are defined:
- https://www.googleapis.com/auth/cloud-platform
- https://www.googleapis.com/auth/userinfo.email
- shielded
Instance InstanceConfig Shielded Instance Config - A set of Shielded Instance options. Check [Images using supported Shielded VM features] Not all combinations are valid Structure is documented below.
- subnet String
- The name of the subnet that this instance is in. Format: projects/{project_id}/regions/{region}/subnetworks/{subnetwork_id}
- List<String>
- The Compute Engine tags to add to instance.
- update
Time String - Instance update time.
- vm
Image InstanceVm Image - Use a Compute Engine VM image to start the notebook instance. Structure is documented below.
- location string
- A reference to the zone where the machine resides.
- machine
Type string - A reference to a machine type which defines VM kind.
- accelerator
Config InstanceAccelerator Config - The hardware accelerator used on this instance. If you use accelerators, make sure that your configuration has enough vCPUs and memory to support the machineType you have selected. Structure is documented below.
- boot
Disk numberSize Gb - The size of the boot disk in GB attached to this instance, up to a maximum of 64000 GB (64 TB). The minimum recommended value is 100 GB. If not specified, this defaults to 100.
- boot
Disk stringType - Possible disk types for notebook instances.
Possible values are:
DISK_TYPE_UNSPECIFIED
,PD_STANDARD
,PD_SSD
,PD_BALANCED
,PD_EXTREME
. - container
Image InstanceContainer Image - Use a container image to start the notebook instance. Structure is documented below.
- create
Time string - Instance creation time
- custom
Gpu stringDriver Path - Specify a custom Cloud Storage path where the GPU driver is stored. If not specified, we'll automatically choose from official GPU drivers.
- data
Disk numberSize Gb - The size of the data disk in GB attached to this instance, up to a maximum of 64000 GB (64 TB). You can choose the size of the data disk based on how big your notebooks and data are. If not specified, this defaults to 100.
- data
Disk stringType - Possible disk types for notebook instances.
Possible values are:
DISK_TYPE_UNSPECIFIED
,PD_STANDARD
,PD_SSD
,PD_BALANCED
,PD_EXTREME
. - desired
State string - Desired state of the Notebook Instance. Set this field to
ACTIVE
to start the Instance, andSTOPPED
to stop the Instance. - disk
Encryption string - Disk encryption method used on the boot and data disks, defaults to GMEK.
Possible values are:
DISK_ENCRYPTION_UNSPECIFIED
,GMEK
,CMEK
. - install
Gpu booleanDriver - Whether the end user authorizes Google Cloud to install GPU driver on this instance. If this field is empty or set to false, the GPU driver won't be installed. Only applicable to instances with GPUs.
- instance
Owners string[] - The list of owners of this instance after creation. Format: alias@example.com. Currently supports one owner only. If not specified, all of the service account users of your VM instance's service account can use the instance.
- kms
Key string - The KMS key used to encrypt the disks, only applicable if diskEncryption is CMEK. Format: projects/{project_id}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{key_id}
- labels {[key: string]: string}
Labels to apply to this instance. These can be later modified by the setLabels method. An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
effective_labels
for all of the labels present on the resource.- metadata {[key: string]: string}
- Custom metadata to apply to this instance. An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
- name string
- The name specified for the Notebook instance.
- network string
- The name of the VPC that this instance is in. Format: projects/{project_id}/global/networks/{network_id}
- nic
Type string - The type of vNIC driver.
Possible values are:
UNSPECIFIED_NIC_TYPE
,VIRTIO_NET
,GVNIC
. - no
Proxy booleanAccess - The notebook instance will not register with the proxy..
- no
Public booleanIp - No public IP will be assigned to this instance.
- no
Remove booleanData Disk - If true, the data disk will not be auto deleted when deleting the instance.
- post
Startup stringScript - Path to a Bash script that automatically runs after a notebook instance fully boots up. The path must be a URL or Cloud Storage path (gs://path-to-file/file-name).
- project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- reservation
Affinity InstanceReservation Affinity - Reservation Affinity for consuming Zonal reservation. Structure is documented below.
- service
Account string - The service account on this instance, giving access to other Google Cloud services. You can use any service account within the same project, but you must have the service account user permission to use the instance. If not specified, the Compute Engine default service account is used.
- service
Account string[]Scopes - Optional. The URIs of service account scopes to be included in Compute Engine instances.
If not specified, the following scopes are defined:
- https://www.googleapis.com/auth/cloud-platform
- https://www.googleapis.com/auth/userinfo.email
- shielded
Instance InstanceConfig Shielded Instance Config - A set of Shielded Instance options. Check [Images using supported Shielded VM features] Not all combinations are valid Structure is documented below.
- subnet string
- The name of the subnet that this instance is in. Format: projects/{project_id}/regions/{region}/subnetworks/{subnetwork_id}
- string[]
- The Compute Engine tags to add to instance.
- update
Time string - Instance update time.
- vm
Image InstanceVm Image - Use a Compute Engine VM image to start the notebook instance. Structure is documented below.
- location str
- A reference to the zone where the machine resides.
- machine_
type str - A reference to a machine type which defines VM kind.
- accelerator_
config InstanceAccelerator Config Args - The hardware accelerator used on this instance. If you use accelerators, make sure that your configuration has enough vCPUs and memory to support the machineType you have selected. Structure is documented below.
- boot_
disk_ intsize_ gb - The size of the boot disk in GB attached to this instance, up to a maximum of 64000 GB (64 TB). The minimum recommended value is 100 GB. If not specified, this defaults to 100.
- boot_
disk_ strtype - Possible disk types for notebook instances.
Possible values are:
DISK_TYPE_UNSPECIFIED
,PD_STANDARD
,PD_SSD
,PD_BALANCED
,PD_EXTREME
. - container_
image InstanceContainer Image Args - Use a container image to start the notebook instance. Structure is documented below.
- create_
time str - Instance creation time
- custom_
gpu_ strdriver_ path - Specify a custom Cloud Storage path where the GPU driver is stored. If not specified, we'll automatically choose from official GPU drivers.
- data_
disk_ intsize_ gb - The size of the data disk in GB attached to this instance, up to a maximum of 64000 GB (64 TB). You can choose the size of the data disk based on how big your notebooks and data are. If not specified, this defaults to 100.
- data_
disk_ strtype - Possible disk types for notebook instances.
Possible values are:
DISK_TYPE_UNSPECIFIED
,PD_STANDARD
,PD_SSD
,PD_BALANCED
,PD_EXTREME
. - desired_
state str - Desired state of the Notebook Instance. Set this field to
ACTIVE
to start the Instance, andSTOPPED
to stop the Instance. - disk_
encryption str - Disk encryption method used on the boot and data disks, defaults to GMEK.
Possible values are:
DISK_ENCRYPTION_UNSPECIFIED
,GMEK
,CMEK
. - install_
gpu_ booldriver - Whether the end user authorizes Google Cloud to install GPU driver on this instance. If this field is empty or set to false, the GPU driver won't be installed. Only applicable to instances with GPUs.
- instance_
owners Sequence[str] - The list of owners of this instance after creation. Format: alias@example.com. Currently supports one owner only. If not specified, all of the service account users of your VM instance's service account can use the instance.
- kms_
key str - The KMS key used to encrypt the disks, only applicable if diskEncryption is CMEK. Format: projects/{project_id}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{key_id}
- labels Mapping[str, str]
Labels to apply to this instance. These can be later modified by the setLabels method. An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
effective_labels
for all of the labels present on the resource.- metadata Mapping[str, str]
- Custom metadata to apply to this instance. An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
- name str
- The name specified for the Notebook instance.
- network str
- The name of the VPC that this instance is in. Format: projects/{project_id}/global/networks/{network_id}
- nic_
type str - The type of vNIC driver.
Possible values are:
UNSPECIFIED_NIC_TYPE
,VIRTIO_NET
,GVNIC
. - no_
proxy_ boolaccess - The notebook instance will not register with the proxy..
- no_
public_ boolip - No public IP will be assigned to this instance.
- no_
remove_ booldata_ disk - If true, the data disk will not be auto deleted when deleting the instance.
- post_
startup_ strscript - Path to a Bash script that automatically runs after a notebook instance fully boots up. The path must be a URL or Cloud Storage path (gs://path-to-file/file-name).
- project str
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- reservation_
affinity InstanceReservation Affinity Args - Reservation Affinity for consuming Zonal reservation. Structure is documented below.
- service_
account str - The service account on this instance, giving access to other Google Cloud services. You can use any service account within the same project, but you must have the service account user permission to use the instance. If not specified, the Compute Engine default service account is used.
- service_
account_ Sequence[str]scopes - Optional. The URIs of service account scopes to be included in Compute Engine instances.
If not specified, the following scopes are defined:
- https://www.googleapis.com/auth/cloud-platform
- https://www.googleapis.com/auth/userinfo.email
- shielded_
instance_ Instanceconfig Shielded Instance Config Args - A set of Shielded Instance options. Check [Images using supported Shielded VM features] Not all combinations are valid Structure is documented below.
- subnet str
- The name of the subnet that this instance is in. Format: projects/{project_id}/regions/{region}/subnetworks/{subnetwork_id}
- Sequence[str]
- The Compute Engine tags to add to instance.
- update_
time str - Instance update time.
- vm_
image InstanceVm Image Args - Use a Compute Engine VM image to start the notebook instance. Structure is documented below.
- location String
- A reference to the zone where the machine resides.
- machine
Type String - A reference to a machine type which defines VM kind.
- accelerator
Config Property Map - The hardware accelerator used on this instance. If you use accelerators, make sure that your configuration has enough vCPUs and memory to support the machineType you have selected. Structure is documented below.
- boot
Disk NumberSize Gb - The size of the boot disk in GB attached to this instance, up to a maximum of 64000 GB (64 TB). The minimum recommended value is 100 GB. If not specified, this defaults to 100.
- boot
Disk StringType - Possible disk types for notebook instances.
Possible values are:
DISK_TYPE_UNSPECIFIED
,PD_STANDARD
,PD_SSD
,PD_BALANCED
,PD_EXTREME
. - container
Image Property Map - Use a container image to start the notebook instance. Structure is documented below.
- create
Time String - Instance creation time
- custom
Gpu StringDriver Path - Specify a custom Cloud Storage path where the GPU driver is stored. If not specified, we'll automatically choose from official GPU drivers.
- data
Disk NumberSize Gb - The size of the data disk in GB attached to this instance, up to a maximum of 64000 GB (64 TB). You can choose the size of the data disk based on how big your notebooks and data are. If not specified, this defaults to 100.
- data
Disk StringType - Possible disk types for notebook instances.
Possible values are:
DISK_TYPE_UNSPECIFIED
,PD_STANDARD
,PD_SSD
,PD_BALANCED
,PD_EXTREME
. - desired
State String - Desired state of the Notebook Instance. Set this field to
ACTIVE
to start the Instance, andSTOPPED
to stop the Instance. - disk
Encryption String - Disk encryption method used on the boot and data disks, defaults to GMEK.
Possible values are:
DISK_ENCRYPTION_UNSPECIFIED
,GMEK
,CMEK
. - install
Gpu BooleanDriver - Whether the end user authorizes Google Cloud to install GPU driver on this instance. If this field is empty or set to false, the GPU driver won't be installed. Only applicable to instances with GPUs.
- instance
Owners List<String> - The list of owners of this instance after creation. Format: alias@example.com. Currently supports one owner only. If not specified, all of the service account users of your VM instance's service account can use the instance.
- kms
Key String - The KMS key used to encrypt the disks, only applicable if diskEncryption is CMEK. Format: projects/{project_id}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{key_id}
- labels Map<String>
Labels to apply to this instance. These can be later modified by the setLabels method. An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
effective_labels
for all of the labels present on the resource.- metadata Map<String>
- Custom metadata to apply to this instance. An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
- name String
- The name specified for the Notebook instance.
- network String
- The name of the VPC that this instance is in. Format: projects/{project_id}/global/networks/{network_id}
- nic
Type String - The type of vNIC driver.
Possible values are:
UNSPECIFIED_NIC_TYPE
,VIRTIO_NET
,GVNIC
. - no
Proxy BooleanAccess - The notebook instance will not register with the proxy..
- no
Public BooleanIp - No public IP will be assigned to this instance.
- no
Remove BooleanData Disk - If true, the data disk will not be auto deleted when deleting the instance.
- post
Startup StringScript - Path to a Bash script that automatically runs after a notebook instance fully boots up. The path must be a URL or Cloud Storage path (gs://path-to-file/file-name).
- project String
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- reservation
Affinity Property Map - Reservation Affinity for consuming Zonal reservation. Structure is documented below.
- service
Account String - The service account on this instance, giving access to other Google Cloud services. You can use any service account within the same project, but you must have the service account user permission to use the instance. If not specified, the Compute Engine default service account is used.
- service
Account List<String>Scopes - Optional. The URIs of service account scopes to be included in Compute Engine instances.
If not specified, the following scopes are defined:
- https://www.googleapis.com/auth/cloud-platform
- https://www.googleapis.com/auth/userinfo.email
- shielded
Instance Property MapConfig - A set of Shielded Instance options. Check [Images using supported Shielded VM features] Not all combinations are valid Structure is documented below.
- subnet String
- The name of the subnet that this instance is in. Format: projects/{project_id}/regions/{region}/subnetworks/{subnetwork_id}
- List<String>
- The Compute Engine tags to add to instance.
- update
Time String - Instance update time.
- vm
Image Property Map - Use a Compute Engine VM image to start the notebook instance. Structure is documented below.
Outputs
All input properties are implicitly available as output properties. Additionally, the Instance resource produces the following output properties:
- Effective
Labels Dictionary<string, string> - All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- Id string
- The provider-assigned unique ID for this managed resource.
- Proxy
Uri string - The proxy endpoint that is used to access the Jupyter notebook.
Only returned when the resource is in a
PROVISIONED
state. If needed you can utilizepulumi up -refresh-only
to await the population of this value. - Pulumi
Labels Dictionary<string, string> - The combination of labels configured directly on the resource and default labels configured on the provider.
- State string
- The state of this instance.
- Effective
Labels map[string]string - All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- Id string
- The provider-assigned unique ID for this managed resource.
- Proxy
Uri string - The proxy endpoint that is used to access the Jupyter notebook.
Only returned when the resource is in a
PROVISIONED
state. If needed you can utilizepulumi up -refresh-only
to await the population of this value. - Pulumi
Labels map[string]string - The combination of labels configured directly on the resource and default labels configured on the provider.
- State string
- The state of this instance.
- effective
Labels Map<String,String> - All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- id String
- The provider-assigned unique ID for this managed resource.
- proxy
Uri String - The proxy endpoint that is used to access the Jupyter notebook.
Only returned when the resource is in a
PROVISIONED
state. If needed you can utilizepulumi up -refresh-only
to await the population of this value. - pulumi
Labels Map<String,String> - The combination of labels configured directly on the resource and default labels configured on the provider.
- state String
- The state of this instance.
- effective
Labels {[key: string]: string} - All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- id string
- The provider-assigned unique ID for this managed resource.
- proxy
Uri string - The proxy endpoint that is used to access the Jupyter notebook.
Only returned when the resource is in a
PROVISIONED
state. If needed you can utilizepulumi up -refresh-only
to await the population of this value. - pulumi
Labels {[key: string]: string} - The combination of labels configured directly on the resource and default labels configured on the provider.
- state string
- The state of this instance.
- effective_
labels Mapping[str, str] - All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- id str
- The provider-assigned unique ID for this managed resource.
- proxy_
uri str - The proxy endpoint that is used to access the Jupyter notebook.
Only returned when the resource is in a
PROVISIONED
state. If needed you can utilizepulumi up -refresh-only
to await the population of this value. - pulumi_
labels Mapping[str, str] - The combination of labels configured directly on the resource and default labels configured on the provider.
- state str
- The state of this instance.
- effective
Labels Map<String> - All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- id String
- The provider-assigned unique ID for this managed resource.
- proxy
Uri String - The proxy endpoint that is used to access the Jupyter notebook.
Only returned when the resource is in a
PROVISIONED
state. If needed you can utilizepulumi up -refresh-only
to await the population of this value. - pulumi
Labels Map<String> - The combination of labels configured directly on the resource and default labels configured on the provider.
- state String
- The state of this instance.
Look up Existing Instance Resource
Get an existing Instance 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?: InstanceState, opts?: CustomResourceOptions): Instance
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
accelerator_config: Optional[InstanceAcceleratorConfigArgs] = None,
boot_disk_size_gb: Optional[int] = None,
boot_disk_type: Optional[str] = None,
container_image: Optional[InstanceContainerImageArgs] = None,
create_time: Optional[str] = None,
custom_gpu_driver_path: Optional[str] = None,
data_disk_size_gb: Optional[int] = None,
data_disk_type: Optional[str] = None,
desired_state: Optional[str] = None,
disk_encryption: Optional[str] = None,
effective_labels: Optional[Mapping[str, str]] = None,
install_gpu_driver: Optional[bool] = None,
instance_owners: Optional[Sequence[str]] = None,
kms_key: Optional[str] = None,
labels: Optional[Mapping[str, str]] = None,
location: Optional[str] = None,
machine_type: Optional[str] = None,
metadata: Optional[Mapping[str, str]] = None,
name: Optional[str] = None,
network: Optional[str] = None,
nic_type: Optional[str] = None,
no_proxy_access: Optional[bool] = None,
no_public_ip: Optional[bool] = None,
no_remove_data_disk: Optional[bool] = None,
post_startup_script: Optional[str] = None,
project: Optional[str] = None,
proxy_uri: Optional[str] = None,
pulumi_labels: Optional[Mapping[str, str]] = None,
reservation_affinity: Optional[InstanceReservationAffinityArgs] = None,
service_account: Optional[str] = None,
service_account_scopes: Optional[Sequence[str]] = None,
shielded_instance_config: Optional[InstanceShieldedInstanceConfigArgs] = None,
state: Optional[str] = None,
subnet: Optional[str] = None,
tags: Optional[Sequence[str]] = None,
update_time: Optional[str] = None,
vm_image: Optional[InstanceVmImageArgs] = None) -> Instance
func GetInstance(ctx *Context, name string, id IDInput, state *InstanceState, opts ...ResourceOption) (*Instance, error)
public static Instance Get(string name, Input<string> id, InstanceState? state, CustomResourceOptions? opts = null)
public static Instance get(String name, Output<String> id, InstanceState 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.
- Accelerator
Config InstanceAccelerator Config - The hardware accelerator used on this instance. If you use accelerators, make sure that your configuration has enough vCPUs and memory to support the machineType you have selected. Structure is documented below.
- Boot
Disk intSize Gb - The size of the boot disk in GB attached to this instance, up to a maximum of 64000 GB (64 TB). The minimum recommended value is 100 GB. If not specified, this defaults to 100.
- Boot
Disk stringType - Possible disk types for notebook instances.
Possible values are:
DISK_TYPE_UNSPECIFIED
,PD_STANDARD
,PD_SSD
,PD_BALANCED
,PD_EXTREME
. - Container
Image InstanceContainer Image - Use a container image to start the notebook instance. Structure is documented below.
- Create
Time string - Instance creation time
- Custom
Gpu stringDriver Path - Specify a custom Cloud Storage path where the GPU driver is stored. If not specified, we'll automatically choose from official GPU drivers.
- Data
Disk intSize Gb - The size of the data disk in GB attached to this instance, up to a maximum of 64000 GB (64 TB). You can choose the size of the data disk based on how big your notebooks and data are. If not specified, this defaults to 100.
- Data
Disk stringType - Possible disk types for notebook instances.
Possible values are:
DISK_TYPE_UNSPECIFIED
,PD_STANDARD
,PD_SSD
,PD_BALANCED
,PD_EXTREME
. - Desired
State string - Desired state of the Notebook Instance. Set this field to
ACTIVE
to start the Instance, andSTOPPED
to stop the Instance. - Disk
Encryption string - Disk encryption method used on the boot and data disks, defaults to GMEK.
Possible values are:
DISK_ENCRYPTION_UNSPECIFIED
,GMEK
,CMEK
. - Effective
Labels Dictionary<string, string> - All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- Install
Gpu boolDriver - Whether the end user authorizes Google Cloud to install GPU driver on this instance. If this field is empty or set to false, the GPU driver won't be installed. Only applicable to instances with GPUs.
- Instance
Owners List<string> - The list of owners of this instance after creation. Format: alias@example.com. Currently supports one owner only. If not specified, all of the service account users of your VM instance's service account can use the instance.
- Kms
Key string - The KMS key used to encrypt the disks, only applicable if diskEncryption is CMEK. Format: projects/{project_id}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{key_id}
- Labels Dictionary<string, string>
Labels to apply to this instance. These can be later modified by the setLabels method. An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
effective_labels
for all of the labels present on the resource.- Location string
- A reference to the zone where the machine resides.
- Machine
Type string - A reference to a machine type which defines VM kind.
- Metadata Dictionary<string, string>
- Custom metadata to apply to this instance. An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
- Name string
- The name specified for the Notebook instance.
- Network string
- The name of the VPC that this instance is in. Format: projects/{project_id}/global/networks/{network_id}
- Nic
Type string - The type of vNIC driver.
Possible values are:
UNSPECIFIED_NIC_TYPE
,VIRTIO_NET
,GVNIC
. - No
Proxy boolAccess - The notebook instance will not register with the proxy..
- No
Public boolIp - No public IP will be assigned to this instance.
- No
Remove boolData Disk - If true, the data disk will not be auto deleted when deleting the instance.
- Post
Startup stringScript - Path to a Bash script that automatically runs after a notebook instance fully boots up. The path must be a URL or Cloud Storage path (gs://path-to-file/file-name).
- Project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Proxy
Uri string - The proxy endpoint that is used to access the Jupyter notebook.
Only returned when the resource is in a
PROVISIONED
state. If needed you can utilizepulumi up -refresh-only
to await the population of this value. - Pulumi
Labels Dictionary<string, string> - The combination of labels configured directly on the resource and default labels configured on the provider.
- Reservation
Affinity InstanceReservation Affinity - Reservation Affinity for consuming Zonal reservation. Structure is documented below.
- Service
Account string - The service account on this instance, giving access to other Google Cloud services. You can use any service account within the same project, but you must have the service account user permission to use the instance. If not specified, the Compute Engine default service account is used.
- Service
Account List<string>Scopes - Optional. The URIs of service account scopes to be included in Compute Engine instances.
If not specified, the following scopes are defined:
- https://www.googleapis.com/auth/cloud-platform
- https://www.googleapis.com/auth/userinfo.email
- Shielded
Instance InstanceConfig Shielded Instance Config - A set of Shielded Instance options. Check [Images using supported Shielded VM features] Not all combinations are valid Structure is documented below.
- State string
- The state of this instance.
- Subnet string
- The name of the subnet that this instance is in. Format: projects/{project_id}/regions/{region}/subnetworks/{subnetwork_id}
- List<string>
- The Compute Engine tags to add to instance.
- Update
Time string - Instance update time.
- Vm
Image InstanceVm Image - Use a Compute Engine VM image to start the notebook instance. Structure is documented below.
- Accelerator
Config InstanceAccelerator Config Args - The hardware accelerator used on this instance. If you use accelerators, make sure that your configuration has enough vCPUs and memory to support the machineType you have selected. Structure is documented below.
- Boot
Disk intSize Gb - The size of the boot disk in GB attached to this instance, up to a maximum of 64000 GB (64 TB). The minimum recommended value is 100 GB. If not specified, this defaults to 100.
- Boot
Disk stringType - Possible disk types for notebook instances.
Possible values are:
DISK_TYPE_UNSPECIFIED
,PD_STANDARD
,PD_SSD
,PD_BALANCED
,PD_EXTREME
. - Container
Image InstanceContainer Image Args - Use a container image to start the notebook instance. Structure is documented below.
- Create
Time string - Instance creation time
- Custom
Gpu stringDriver Path - Specify a custom Cloud Storage path where the GPU driver is stored. If not specified, we'll automatically choose from official GPU drivers.
- Data
Disk intSize Gb - The size of the data disk in GB attached to this instance, up to a maximum of 64000 GB (64 TB). You can choose the size of the data disk based on how big your notebooks and data are. If not specified, this defaults to 100.
- Data
Disk stringType - Possible disk types for notebook instances.
Possible values are:
DISK_TYPE_UNSPECIFIED
,PD_STANDARD
,PD_SSD
,PD_BALANCED
,PD_EXTREME
. - Desired
State string - Desired state of the Notebook Instance. Set this field to
ACTIVE
to start the Instance, andSTOPPED
to stop the Instance. - Disk
Encryption string - Disk encryption method used on the boot and data disks, defaults to GMEK.
Possible values are:
DISK_ENCRYPTION_UNSPECIFIED
,GMEK
,CMEK
. - Effective
Labels map[string]string - All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- Install
Gpu boolDriver - Whether the end user authorizes Google Cloud to install GPU driver on this instance. If this field is empty or set to false, the GPU driver won't be installed. Only applicable to instances with GPUs.
- Instance
Owners []string - The list of owners of this instance after creation. Format: alias@example.com. Currently supports one owner only. If not specified, all of the service account users of your VM instance's service account can use the instance.
- Kms
Key string - The KMS key used to encrypt the disks, only applicable if diskEncryption is CMEK. Format: projects/{project_id}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{key_id}
- Labels map[string]string
Labels to apply to this instance. These can be later modified by the setLabels method. An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
effective_labels
for all of the labels present on the resource.- Location string
- A reference to the zone where the machine resides.
- Machine
Type string - A reference to a machine type which defines VM kind.
- Metadata map[string]string
- Custom metadata to apply to this instance. An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
- Name string
- The name specified for the Notebook instance.
- Network string
- The name of the VPC that this instance is in. Format: projects/{project_id}/global/networks/{network_id}
- Nic
Type string - The type of vNIC driver.
Possible values are:
UNSPECIFIED_NIC_TYPE
,VIRTIO_NET
,GVNIC
. - No
Proxy boolAccess - The notebook instance will not register with the proxy..
- No
Public boolIp - No public IP will be assigned to this instance.
- No
Remove boolData Disk - If true, the data disk will not be auto deleted when deleting the instance.
- Post
Startup stringScript - Path to a Bash script that automatically runs after a notebook instance fully boots up. The path must be a URL or Cloud Storage path (gs://path-to-file/file-name).
- Project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Proxy
Uri string - The proxy endpoint that is used to access the Jupyter notebook.
Only returned when the resource is in a
PROVISIONED
state. If needed you can utilizepulumi up -refresh-only
to await the population of this value. - Pulumi
Labels map[string]string - The combination of labels configured directly on the resource and default labels configured on the provider.
- Reservation
Affinity InstanceReservation Affinity Args - Reservation Affinity for consuming Zonal reservation. Structure is documented below.
- Service
Account string - The service account on this instance, giving access to other Google Cloud services. You can use any service account within the same project, but you must have the service account user permission to use the instance. If not specified, the Compute Engine default service account is used.
- Service
Account []stringScopes - Optional. The URIs of service account scopes to be included in Compute Engine instances.
If not specified, the following scopes are defined:
- https://www.googleapis.com/auth/cloud-platform
- https://www.googleapis.com/auth/userinfo.email
- Shielded
Instance InstanceConfig Shielded Instance Config Args - A set of Shielded Instance options. Check [Images using supported Shielded VM features] Not all combinations are valid Structure is documented below.
- State string
- The state of this instance.
- Subnet string
- The name of the subnet that this instance is in. Format: projects/{project_id}/regions/{region}/subnetworks/{subnetwork_id}
- []string
- The Compute Engine tags to add to instance.
- Update
Time string - Instance update time.
- Vm
Image InstanceVm Image Args - Use a Compute Engine VM image to start the notebook instance. Structure is documented below.
- accelerator
Config InstanceAccelerator Config - The hardware accelerator used on this instance. If you use accelerators, make sure that your configuration has enough vCPUs and memory to support the machineType you have selected. Structure is documented below.
- boot
Disk IntegerSize Gb - The size of the boot disk in GB attached to this instance, up to a maximum of 64000 GB (64 TB). The minimum recommended value is 100 GB. If not specified, this defaults to 100.
- boot
Disk StringType - Possible disk types for notebook instances.
Possible values are:
DISK_TYPE_UNSPECIFIED
,PD_STANDARD
,PD_SSD
,PD_BALANCED
,PD_EXTREME
. - container
Image InstanceContainer Image - Use a container image to start the notebook instance. Structure is documented below.
- create
Time String - Instance creation time
- custom
Gpu StringDriver Path - Specify a custom Cloud Storage path where the GPU driver is stored. If not specified, we'll automatically choose from official GPU drivers.
- data
Disk IntegerSize Gb - The size of the data disk in GB attached to this instance, up to a maximum of 64000 GB (64 TB). You can choose the size of the data disk based on how big your notebooks and data are. If not specified, this defaults to 100.
- data
Disk StringType - Possible disk types for notebook instances.
Possible values are:
DISK_TYPE_UNSPECIFIED
,PD_STANDARD
,PD_SSD
,PD_BALANCED
,PD_EXTREME
. - desired
State String - Desired state of the Notebook Instance. Set this field to
ACTIVE
to start the Instance, andSTOPPED
to stop the Instance. - disk
Encryption String - Disk encryption method used on the boot and data disks, defaults to GMEK.
Possible values are:
DISK_ENCRYPTION_UNSPECIFIED
,GMEK
,CMEK
. - effective
Labels Map<String,String> - All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- install
Gpu BooleanDriver - Whether the end user authorizes Google Cloud to install GPU driver on this instance. If this field is empty or set to false, the GPU driver won't be installed. Only applicable to instances with GPUs.
- instance
Owners List<String> - The list of owners of this instance after creation. Format: alias@example.com. Currently supports one owner only. If not specified, all of the service account users of your VM instance's service account can use the instance.
- kms
Key String - The KMS key used to encrypt the disks, only applicable if diskEncryption is CMEK. Format: projects/{project_id}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{key_id}
- labels Map<String,String>
Labels to apply to this instance. These can be later modified by the setLabels method. An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
effective_labels
for all of the labels present on the resource.- location String
- A reference to the zone where the machine resides.
- machine
Type String - A reference to a machine type which defines VM kind.
- metadata Map<String,String>
- Custom metadata to apply to this instance. An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
- name String
- The name specified for the Notebook instance.
- network String
- The name of the VPC that this instance is in. Format: projects/{project_id}/global/networks/{network_id}
- nic
Type String - The type of vNIC driver.
Possible values are:
UNSPECIFIED_NIC_TYPE
,VIRTIO_NET
,GVNIC
. - no
Proxy BooleanAccess - The notebook instance will not register with the proxy..
- no
Public BooleanIp - No public IP will be assigned to this instance.
- no
Remove BooleanData Disk - If true, the data disk will not be auto deleted when deleting the instance.
- post
Startup StringScript - Path to a Bash script that automatically runs after a notebook instance fully boots up. The path must be a URL or Cloud Storage path (gs://path-to-file/file-name).
- project String
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- proxy
Uri String - The proxy endpoint that is used to access the Jupyter notebook.
Only returned when the resource is in a
PROVISIONED
state. If needed you can utilizepulumi up -refresh-only
to await the population of this value. - pulumi
Labels Map<String,String> - The combination of labels configured directly on the resource and default labels configured on the provider.
- reservation
Affinity InstanceReservation Affinity - Reservation Affinity for consuming Zonal reservation. Structure is documented below.
- service
Account String - The service account on this instance, giving access to other Google Cloud services. You can use any service account within the same project, but you must have the service account user permission to use the instance. If not specified, the Compute Engine default service account is used.
- service
Account List<String>Scopes - Optional. The URIs of service account scopes to be included in Compute Engine instances.
If not specified, the following scopes are defined:
- https://www.googleapis.com/auth/cloud-platform
- https://www.googleapis.com/auth/userinfo.email
- shielded
Instance InstanceConfig Shielded Instance Config - A set of Shielded Instance options. Check [Images using supported Shielded VM features] Not all combinations are valid Structure is documented below.
- state String
- The state of this instance.
- subnet String
- The name of the subnet that this instance is in. Format: projects/{project_id}/regions/{region}/subnetworks/{subnetwork_id}
- List<String>
- The Compute Engine tags to add to instance.
- update
Time String - Instance update time.
- vm
Image InstanceVm Image - Use a Compute Engine VM image to start the notebook instance. Structure is documented below.
- accelerator
Config InstanceAccelerator Config - The hardware accelerator used on this instance. If you use accelerators, make sure that your configuration has enough vCPUs and memory to support the machineType you have selected. Structure is documented below.
- boot
Disk numberSize Gb - The size of the boot disk in GB attached to this instance, up to a maximum of 64000 GB (64 TB). The minimum recommended value is 100 GB. If not specified, this defaults to 100.
- boot
Disk stringType - Possible disk types for notebook instances.
Possible values are:
DISK_TYPE_UNSPECIFIED
,PD_STANDARD
,PD_SSD
,PD_BALANCED
,PD_EXTREME
. - container
Image InstanceContainer Image - Use a container image to start the notebook instance. Structure is documented below.
- create
Time string - Instance creation time
- custom
Gpu stringDriver Path - Specify a custom Cloud Storage path where the GPU driver is stored. If not specified, we'll automatically choose from official GPU drivers.
- data
Disk numberSize Gb - The size of the data disk in GB attached to this instance, up to a maximum of 64000 GB (64 TB). You can choose the size of the data disk based on how big your notebooks and data are. If not specified, this defaults to 100.
- data
Disk stringType - Possible disk types for notebook instances.
Possible values are:
DISK_TYPE_UNSPECIFIED
,PD_STANDARD
,PD_SSD
,PD_BALANCED
,PD_EXTREME
. - desired
State string - Desired state of the Notebook Instance. Set this field to
ACTIVE
to start the Instance, andSTOPPED
to stop the Instance. - disk
Encryption string - Disk encryption method used on the boot and data disks, defaults to GMEK.
Possible values are:
DISK_ENCRYPTION_UNSPECIFIED
,GMEK
,CMEK
. - effective
Labels {[key: string]: string} - All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- install
Gpu booleanDriver - Whether the end user authorizes Google Cloud to install GPU driver on this instance. If this field is empty or set to false, the GPU driver won't be installed. Only applicable to instances with GPUs.
- instance
Owners string[] - The list of owners of this instance after creation. Format: alias@example.com. Currently supports one owner only. If not specified, all of the service account users of your VM instance's service account can use the instance.
- kms
Key string - The KMS key used to encrypt the disks, only applicable if diskEncryption is CMEK. Format: projects/{project_id}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{key_id}
- labels {[key: string]: string}
Labels to apply to this instance. These can be later modified by the setLabels method. An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
effective_labels
for all of the labels present on the resource.- location string
- A reference to the zone where the machine resides.
- machine
Type string - A reference to a machine type which defines VM kind.
- metadata {[key: string]: string}
- Custom metadata to apply to this instance. An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
- name string
- The name specified for the Notebook instance.
- network string
- The name of the VPC that this instance is in. Format: projects/{project_id}/global/networks/{network_id}
- nic
Type string - The type of vNIC driver.
Possible values are:
UNSPECIFIED_NIC_TYPE
,VIRTIO_NET
,GVNIC
. - no
Proxy booleanAccess - The notebook instance will not register with the proxy..
- no
Public booleanIp - No public IP will be assigned to this instance.
- no
Remove booleanData Disk - If true, the data disk will not be auto deleted when deleting the instance.
- post
Startup stringScript - Path to a Bash script that automatically runs after a notebook instance fully boots up. The path must be a URL or Cloud Storage path (gs://path-to-file/file-name).
- project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- proxy
Uri string - The proxy endpoint that is used to access the Jupyter notebook.
Only returned when the resource is in a
PROVISIONED
state. If needed you can utilizepulumi up -refresh-only
to await the population of this value. - pulumi
Labels {[key: string]: string} - The combination of labels configured directly on the resource and default labels configured on the provider.
- reservation
Affinity InstanceReservation Affinity - Reservation Affinity for consuming Zonal reservation. Structure is documented below.
- service
Account string - The service account on this instance, giving access to other Google Cloud services. You can use any service account within the same project, but you must have the service account user permission to use the instance. If not specified, the Compute Engine default service account is used.
- service
Account string[]Scopes - Optional. The URIs of service account scopes to be included in Compute Engine instances.
If not specified, the following scopes are defined:
- https://www.googleapis.com/auth/cloud-platform
- https://www.googleapis.com/auth/userinfo.email
- shielded
Instance InstanceConfig Shielded Instance Config - A set of Shielded Instance options. Check [Images using supported Shielded VM features] Not all combinations are valid Structure is documented below.
- state string
- The state of this instance.
- subnet string
- The name of the subnet that this instance is in. Format: projects/{project_id}/regions/{region}/subnetworks/{subnetwork_id}
- string[]
- The Compute Engine tags to add to instance.
- update
Time string - Instance update time.
- vm
Image InstanceVm Image - Use a Compute Engine VM image to start the notebook instance. Structure is documented below.
- accelerator_
config InstanceAccelerator Config Args - The hardware accelerator used on this instance. If you use accelerators, make sure that your configuration has enough vCPUs and memory to support the machineType you have selected. Structure is documented below.
- boot_
disk_ intsize_ gb - The size of the boot disk in GB attached to this instance, up to a maximum of 64000 GB (64 TB). The minimum recommended value is 100 GB. If not specified, this defaults to 100.
- boot_
disk_ strtype - Possible disk types for notebook instances.
Possible values are:
DISK_TYPE_UNSPECIFIED
,PD_STANDARD
,PD_SSD
,PD_BALANCED
,PD_EXTREME
. - container_
image InstanceContainer Image Args - Use a container image to start the notebook instance. Structure is documented below.
- create_
time str - Instance creation time
- custom_
gpu_ strdriver_ path - Specify a custom Cloud Storage path where the GPU driver is stored. If not specified, we'll automatically choose from official GPU drivers.
- data_
disk_ intsize_ gb - The size of the data disk in GB attached to this instance, up to a maximum of 64000 GB (64 TB). You can choose the size of the data disk based on how big your notebooks and data are. If not specified, this defaults to 100.
- data_
disk_ strtype - Possible disk types for notebook instances.
Possible values are:
DISK_TYPE_UNSPECIFIED
,PD_STANDARD
,PD_SSD
,PD_BALANCED
,PD_EXTREME
. - desired_
state str - Desired state of the Notebook Instance. Set this field to
ACTIVE
to start the Instance, andSTOPPED
to stop the Instance. - disk_
encryption str - Disk encryption method used on the boot and data disks, defaults to GMEK.
Possible values are:
DISK_ENCRYPTION_UNSPECIFIED
,GMEK
,CMEK
. - effective_
labels Mapping[str, str] - All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- install_
gpu_ booldriver - Whether the end user authorizes Google Cloud to install GPU driver on this instance. If this field is empty or set to false, the GPU driver won't be installed. Only applicable to instances with GPUs.
- instance_
owners Sequence[str] - The list of owners of this instance after creation. Format: alias@example.com. Currently supports one owner only. If not specified, all of the service account users of your VM instance's service account can use the instance.
- kms_
key str - The KMS key used to encrypt the disks, only applicable if diskEncryption is CMEK. Format: projects/{project_id}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{key_id}
- labels Mapping[str, str]
Labels to apply to this instance. These can be later modified by the setLabels method. An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
effective_labels
for all of the labels present on the resource.- location str
- A reference to the zone where the machine resides.
- machine_
type str - A reference to a machine type which defines VM kind.
- metadata Mapping[str, str]
- Custom metadata to apply to this instance. An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
- name str
- The name specified for the Notebook instance.
- network str
- The name of the VPC that this instance is in. Format: projects/{project_id}/global/networks/{network_id}
- nic_
type str - The type of vNIC driver.
Possible values are:
UNSPECIFIED_NIC_TYPE
,VIRTIO_NET
,GVNIC
. - no_
proxy_ boolaccess - The notebook instance will not register with the proxy..
- no_
public_ boolip - No public IP will be assigned to this instance.
- no_
remove_ booldata_ disk - If true, the data disk will not be auto deleted when deleting the instance.
- post_
startup_ strscript - Path to a Bash script that automatically runs after a notebook instance fully boots up. The path must be a URL or Cloud Storage path (gs://path-to-file/file-name).
- project str
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- proxy_
uri str - The proxy endpoint that is used to access the Jupyter notebook.
Only returned when the resource is in a
PROVISIONED
state. If needed you can utilizepulumi up -refresh-only
to await the population of this value. - pulumi_
labels Mapping[str, str] - The combination of labels configured directly on the resource and default labels configured on the provider.
- reservation_
affinity InstanceReservation Affinity Args - Reservation Affinity for consuming Zonal reservation. Structure is documented below.
- service_
account str - The service account on this instance, giving access to other Google Cloud services. You can use any service account within the same project, but you must have the service account user permission to use the instance. If not specified, the Compute Engine default service account is used.
- service_
account_ Sequence[str]scopes - Optional. The URIs of service account scopes to be included in Compute Engine instances.
If not specified, the following scopes are defined:
- https://www.googleapis.com/auth/cloud-platform
- https://www.googleapis.com/auth/userinfo.email
- shielded_
instance_ Instanceconfig Shielded Instance Config Args - A set of Shielded Instance options. Check [Images using supported Shielded VM features] Not all combinations are valid Structure is documented below.
- state str
- The state of this instance.
- subnet str
- The name of the subnet that this instance is in. Format: projects/{project_id}/regions/{region}/subnetworks/{subnetwork_id}
- Sequence[str]
- The Compute Engine tags to add to instance.
- update_
time str - Instance update time.
- vm_
image InstanceVm Image Args - Use a Compute Engine VM image to start the notebook instance. Structure is documented below.
- accelerator
Config Property Map - The hardware accelerator used on this instance. If you use accelerators, make sure that your configuration has enough vCPUs and memory to support the machineType you have selected. Structure is documented below.
- boot
Disk NumberSize Gb - The size of the boot disk in GB attached to this instance, up to a maximum of 64000 GB (64 TB). The minimum recommended value is 100 GB. If not specified, this defaults to 100.
- boot
Disk StringType - Possible disk types for notebook instances.
Possible values are:
DISK_TYPE_UNSPECIFIED
,PD_STANDARD
,PD_SSD
,PD_BALANCED
,PD_EXTREME
. - container
Image Property Map - Use a container image to start the notebook instance. Structure is documented below.
- create
Time String - Instance creation time
- custom
Gpu StringDriver Path - Specify a custom Cloud Storage path where the GPU driver is stored. If not specified, we'll automatically choose from official GPU drivers.
- data
Disk NumberSize Gb - The size of the data disk in GB attached to this instance, up to a maximum of 64000 GB (64 TB). You can choose the size of the data disk based on how big your notebooks and data are. If not specified, this defaults to 100.
- data
Disk StringType - Possible disk types for notebook instances.
Possible values are:
DISK_TYPE_UNSPECIFIED
,PD_STANDARD
,PD_SSD
,PD_BALANCED
,PD_EXTREME
. - desired
State String - Desired state of the Notebook Instance. Set this field to
ACTIVE
to start the Instance, andSTOPPED
to stop the Instance. - disk
Encryption String - Disk encryption method used on the boot and data disks, defaults to GMEK.
Possible values are:
DISK_ENCRYPTION_UNSPECIFIED
,GMEK
,CMEK
. - effective
Labels Map<String> - All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- install
Gpu BooleanDriver - Whether the end user authorizes Google Cloud to install GPU driver on this instance. If this field is empty or set to false, the GPU driver won't be installed. Only applicable to instances with GPUs.
- instance
Owners List<String> - The list of owners of this instance after creation. Format: alias@example.com. Currently supports one owner only. If not specified, all of the service account users of your VM instance's service account can use the instance.
- kms
Key String - The KMS key used to encrypt the disks, only applicable if diskEncryption is CMEK. Format: projects/{project_id}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{key_id}
- labels Map<String>
Labels to apply to this instance. These can be later modified by the setLabels method. An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
effective_labels
for all of the labels present on the resource.- location String
- A reference to the zone where the machine resides.
- machine
Type String - A reference to a machine type which defines VM kind.
- metadata Map<String>
- Custom metadata to apply to this instance. An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
- name String
- The name specified for the Notebook instance.
- network String
- The name of the VPC that this instance is in. Format: projects/{project_id}/global/networks/{network_id}
- nic
Type String - The type of vNIC driver.
Possible values are:
UNSPECIFIED_NIC_TYPE
,VIRTIO_NET
,GVNIC
. - no
Proxy BooleanAccess - The notebook instance will not register with the proxy..
- no
Public BooleanIp - No public IP will be assigned to this instance.
- no
Remove BooleanData Disk - If true, the data disk will not be auto deleted when deleting the instance.
- post
Startup StringScript - Path to a Bash script that automatically runs after a notebook instance fully boots up. The path must be a URL or Cloud Storage path (gs://path-to-file/file-name).
- project String
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- proxy
Uri String - The proxy endpoint that is used to access the Jupyter notebook.
Only returned when the resource is in a
PROVISIONED
state. If needed you can utilizepulumi up -refresh-only
to await the population of this value. - pulumi
Labels Map<String> - The combination of labels configured directly on the resource and default labels configured on the provider.
- reservation
Affinity Property Map - Reservation Affinity for consuming Zonal reservation. Structure is documented below.
- service
Account String - The service account on this instance, giving access to other Google Cloud services. You can use any service account within the same project, but you must have the service account user permission to use the instance. If not specified, the Compute Engine default service account is used.
- service
Account List<String>Scopes - Optional. The URIs of service account scopes to be included in Compute Engine instances.
If not specified, the following scopes are defined:
- https://www.googleapis.com/auth/cloud-platform
- https://www.googleapis.com/auth/userinfo.email
- shielded
Instance Property MapConfig - A set of Shielded Instance options. Check [Images using supported Shielded VM features] Not all combinations are valid Structure is documented below.
- state String
- The state of this instance.
- subnet String
- The name of the subnet that this instance is in. Format: projects/{project_id}/regions/{region}/subnetworks/{subnetwork_id}
- List<String>
- The Compute Engine tags to add to instance.
- update
Time String - Instance update time.
- vm
Image Property Map - Use a Compute Engine VM image to start the notebook instance. Structure is documented below.
Supporting Types
InstanceAcceleratorConfig, InstanceAcceleratorConfigArgs
- Core
Count int - Count of cores of this accelerator.
- Type string
- Type of this accelerator.
Possible values are:
ACCELERATOR_TYPE_UNSPECIFIED
,NVIDIA_TESLA_K80
,NVIDIA_TESLA_P100
,NVIDIA_TESLA_V100
,NVIDIA_TESLA_P4
,NVIDIA_TESLA_T4
,NVIDIA_TESLA_T4_VWS
,NVIDIA_TESLA_P100_VWS
,NVIDIA_TESLA_P4_VWS
,NVIDIA_TESLA_A100
,TPU_V2
,TPU_V3
.
- Core
Count int - Count of cores of this accelerator.
- Type string
- Type of this accelerator.
Possible values are:
ACCELERATOR_TYPE_UNSPECIFIED
,NVIDIA_TESLA_K80
,NVIDIA_TESLA_P100
,NVIDIA_TESLA_V100
,NVIDIA_TESLA_P4
,NVIDIA_TESLA_T4
,NVIDIA_TESLA_T4_VWS
,NVIDIA_TESLA_P100_VWS
,NVIDIA_TESLA_P4_VWS
,NVIDIA_TESLA_A100
,TPU_V2
,TPU_V3
.
- core
Count Integer - Count of cores of this accelerator.
- type String
- Type of this accelerator.
Possible values are:
ACCELERATOR_TYPE_UNSPECIFIED
,NVIDIA_TESLA_K80
,NVIDIA_TESLA_P100
,NVIDIA_TESLA_V100
,NVIDIA_TESLA_P4
,NVIDIA_TESLA_T4
,NVIDIA_TESLA_T4_VWS
,NVIDIA_TESLA_P100_VWS
,NVIDIA_TESLA_P4_VWS
,NVIDIA_TESLA_A100
,TPU_V2
,TPU_V3
.
- core
Count number - Count of cores of this accelerator.
- type string
- Type of this accelerator.
Possible values are:
ACCELERATOR_TYPE_UNSPECIFIED
,NVIDIA_TESLA_K80
,NVIDIA_TESLA_P100
,NVIDIA_TESLA_V100
,NVIDIA_TESLA_P4
,NVIDIA_TESLA_T4
,NVIDIA_TESLA_T4_VWS
,NVIDIA_TESLA_P100_VWS
,NVIDIA_TESLA_P4_VWS
,NVIDIA_TESLA_A100
,TPU_V2
,TPU_V3
.
- core_
count int - Count of cores of this accelerator.
- type str
- Type of this accelerator.
Possible values are:
ACCELERATOR_TYPE_UNSPECIFIED
,NVIDIA_TESLA_K80
,NVIDIA_TESLA_P100
,NVIDIA_TESLA_V100
,NVIDIA_TESLA_P4
,NVIDIA_TESLA_T4
,NVIDIA_TESLA_T4_VWS
,NVIDIA_TESLA_P100_VWS
,NVIDIA_TESLA_P4_VWS
,NVIDIA_TESLA_A100
,TPU_V2
,TPU_V3
.
- core
Count Number - Count of cores of this accelerator.
- type String
- Type of this accelerator.
Possible values are:
ACCELERATOR_TYPE_UNSPECIFIED
,NVIDIA_TESLA_K80
,NVIDIA_TESLA_P100
,NVIDIA_TESLA_V100
,NVIDIA_TESLA_P4
,NVIDIA_TESLA_T4
,NVIDIA_TESLA_T4_VWS
,NVIDIA_TESLA_P100_VWS
,NVIDIA_TESLA_P4_VWS
,NVIDIA_TESLA_A100
,TPU_V2
,TPU_V3
.
InstanceContainerImage, InstanceContainerImageArgs
- Repository string
- The path to the container image repository. For example: gcr.io/{project_id}/{imageName}
- Tag string
- The tag of the container image. If not specified, this defaults to the latest tag.
- Repository string
- The path to the container image repository. For example: gcr.io/{project_id}/{imageName}
- Tag string
- The tag of the container image. If not specified, this defaults to the latest tag.
- repository String
- The path to the container image repository. For example: gcr.io/{project_id}/{imageName}
- tag String
- The tag of the container image. If not specified, this defaults to the latest tag.
- repository string
- The path to the container image repository. For example: gcr.io/{project_id}/{imageName}
- tag string
- The tag of the container image. If not specified, this defaults to the latest tag.
- repository str
- The path to the container image repository. For example: gcr.io/{project_id}/{imageName}
- tag str
- The tag of the container image. If not specified, this defaults to the latest tag.
- repository String
- The path to the container image repository. For example: gcr.io/{project_id}/{imageName}
- tag String
- The tag of the container image. If not specified, this defaults to the latest tag.
InstanceReservationAffinity, InstanceReservationAffinityArgs
- Consume
Reservation stringType - The type of Compute Reservation.
Possible values are:
NO_RESERVATION
,ANY_RESERVATION
,SPECIFIC_RESERVATION
. - Key string
- Corresponds to the label key of reservation resource.
- Values List<string>
- Corresponds to the label values of reservation resource.
- Consume
Reservation stringType - The type of Compute Reservation.
Possible values are:
NO_RESERVATION
,ANY_RESERVATION
,SPECIFIC_RESERVATION
. - Key string
- Corresponds to the label key of reservation resource.
- Values []string
- Corresponds to the label values of reservation resource.
- consume
Reservation StringType - The type of Compute Reservation.
Possible values are:
NO_RESERVATION
,ANY_RESERVATION
,SPECIFIC_RESERVATION
. - key String
- Corresponds to the label key of reservation resource.
- values List<String>
- Corresponds to the label values of reservation resource.
- consume
Reservation stringType - The type of Compute Reservation.
Possible values are:
NO_RESERVATION
,ANY_RESERVATION
,SPECIFIC_RESERVATION
. - key string
- Corresponds to the label key of reservation resource.
- values string[]
- Corresponds to the label values of reservation resource.
- consume_
reservation_ strtype - The type of Compute Reservation.
Possible values are:
NO_RESERVATION
,ANY_RESERVATION
,SPECIFIC_RESERVATION
. - key str
- Corresponds to the label key of reservation resource.
- values Sequence[str]
- Corresponds to the label values of reservation resource.
- consume
Reservation StringType - The type of Compute Reservation.
Possible values are:
NO_RESERVATION
,ANY_RESERVATION
,SPECIFIC_RESERVATION
. - key String
- Corresponds to the label key of reservation resource.
- values List<String>
- Corresponds to the label values of reservation resource.
InstanceShieldedInstanceConfig, InstanceShieldedInstanceConfigArgs
- Enable
Integrity boolMonitoring - Defines whether the instance has integrity monitoring enabled. Enables monitoring and attestation of the boot integrity of the instance. The attestation is performed against the integrity policy baseline. This baseline is initially derived from the implicitly trusted boot image when the instance is created. Enabled by default.
- Enable
Secure boolBoot - Defines whether the instance has Secure Boot enabled. Secure Boot helps ensure that the system only runs authentic software by verifying the digital signature of all boot components, and halting the boot process if signature verification fails. Disabled by default.
- Enable
Vtpm bool - Defines whether the instance has the vTPM enabled. Enabled by default.
- Enable
Integrity boolMonitoring - Defines whether the instance has integrity monitoring enabled. Enables monitoring and attestation of the boot integrity of the instance. The attestation is performed against the integrity policy baseline. This baseline is initially derived from the implicitly trusted boot image when the instance is created. Enabled by default.
- Enable
Secure boolBoot - Defines whether the instance has Secure Boot enabled. Secure Boot helps ensure that the system only runs authentic software by verifying the digital signature of all boot components, and halting the boot process if signature verification fails. Disabled by default.
- Enable
Vtpm bool - Defines whether the instance has the vTPM enabled. Enabled by default.
- enable
Integrity BooleanMonitoring - Defines whether the instance has integrity monitoring enabled. Enables monitoring and attestation of the boot integrity of the instance. The attestation is performed against the integrity policy baseline. This baseline is initially derived from the implicitly trusted boot image when the instance is created. Enabled by default.
- enable
Secure BooleanBoot - Defines whether the instance has Secure Boot enabled. Secure Boot helps ensure that the system only runs authentic software by verifying the digital signature of all boot components, and halting the boot process if signature verification fails. Disabled by default.
- enable
Vtpm Boolean - Defines whether the instance has the vTPM enabled. Enabled by default.
- enable
Integrity booleanMonitoring - Defines whether the instance has integrity monitoring enabled. Enables monitoring and attestation of the boot integrity of the instance. The attestation is performed against the integrity policy baseline. This baseline is initially derived from the implicitly trusted boot image when the instance is created. Enabled by default.
- enable
Secure booleanBoot - Defines whether the instance has Secure Boot enabled. Secure Boot helps ensure that the system only runs authentic software by verifying the digital signature of all boot components, and halting the boot process if signature verification fails. Disabled by default.
- enable
Vtpm boolean - Defines whether the instance has the vTPM enabled. Enabled by default.
- enable_
integrity_ boolmonitoring - Defines whether the instance has integrity monitoring enabled. Enables monitoring and attestation of the boot integrity of the instance. The attestation is performed against the integrity policy baseline. This baseline is initially derived from the implicitly trusted boot image when the instance is created. Enabled by default.
- enable_
secure_ boolboot - Defines whether the instance has Secure Boot enabled. Secure Boot helps ensure that the system only runs authentic software by verifying the digital signature of all boot components, and halting the boot process if signature verification fails. Disabled by default.
- enable_
vtpm bool - Defines whether the instance has the vTPM enabled. Enabled by default.
- enable
Integrity BooleanMonitoring - Defines whether the instance has integrity monitoring enabled. Enables monitoring and attestation of the boot integrity of the instance. The attestation is performed against the integrity policy baseline. This baseline is initially derived from the implicitly trusted boot image when the instance is created. Enabled by default.
- enable
Secure BooleanBoot - Defines whether the instance has Secure Boot enabled. Secure Boot helps ensure that the system only runs authentic software by verifying the digital signature of all boot components, and halting the boot process if signature verification fails. Disabled by default.
- enable
Vtpm Boolean - Defines whether the instance has the vTPM enabled. Enabled by default.
InstanceVmImage, InstanceVmImageArgs
- Project string
- The name of the Google Cloud project that this VM image belongs to. Format: projects/{project_id}
- Image
Family string - Use this VM image family to find the image; the newest image in this family will be used.
- Image
Name string - Use VM image name to find the image.
- Project string
- The name of the Google Cloud project that this VM image belongs to. Format: projects/{project_id}
- Image
Family string - Use this VM image family to find the image; the newest image in this family will be used.
- Image
Name string - Use VM image name to find the image.
- project String
- The name of the Google Cloud project that this VM image belongs to. Format: projects/{project_id}
- image
Family String - Use this VM image family to find the image; the newest image in this family will be used.
- image
Name String - Use VM image name to find the image.
- project string
- The name of the Google Cloud project that this VM image belongs to. Format: projects/{project_id}
- image
Family string - Use this VM image family to find the image; the newest image in this family will be used.
- image
Name string - Use VM image name to find the image.
- project str
- The name of the Google Cloud project that this VM image belongs to. Format: projects/{project_id}
- image_
family str - Use this VM image family to find the image; the newest image in this family will be used.
- image_
name str - Use VM image name to find the image.
- project String
- The name of the Google Cloud project that this VM image belongs to. Format: projects/{project_id}
- image
Family String - Use this VM image family to find the image; the newest image in this family will be used.
- image
Name String - Use VM image name to find the image.
Import
Instance can be imported using any of these accepted formats:
projects/{{project}}/locations/{{location}}/instances/{{name}}
{{project}}/{{location}}/{{name}}
{{location}}/{{name}}
When using the pulumi import
command, Instance can be imported using one of the formats above. For example:
$ pulumi import gcp:notebooks/instance:Instance default projects/{{project}}/locations/{{location}}/instances/{{name}}
$ pulumi import gcp:notebooks/instance:Instance default {{project}}/{{location}}/{{name}}
$ pulumi import gcp:notebooks/instance:Instance default {{location}}/{{name}}
To learn more about importing existing cloud resources, see Importing resources.
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.