gcloud beta notebooks instances create

NAME
gcloud beta notebooks instances create - request for creating an instance
SYNOPSIS
gcloud beta notebooks instances create (INSTANCE : --location=LOCATION) ([--container-repository=CONTAINER_REPOSITORY : --container-tag=CONTAINER_TAG]     | [--environment=ENVIRONMENT : --environment-location=ENVIRONMENT_LOCATION]     | [(--vm-image-family=VM_IMAGE_FAMILY | --vm-image-name=VM_IMAGE_NAME) : --vm-image-project=VM_IMAGE_PROJECT; default="deeplearning-platform-release"]) [--async] [--instance-owners=INSTANCE_OWNERS] [--labels=[KEY=VALUE,…]] [--machine-type=MACHINE_TYPE; default="n1-standard-1"] [--metadata=[KEY=VALUE,…]] [--post-startup-script=POST_STARTUP_SCRIPT] [--service-account=SERVICE_ACCOUNT] [--accelerator-core-count=ACCELERATOR_CORE_COUNT --accelerator-type=ACCELERATOR_TYPE] [--boot-disk-size=BOOT_DISK_SIZE --boot-disk-type=BOOT_DISK_TYPE] [--custom-gpu-driver-path=CUSTOM_GPU_DRIVER_PATH --install-gpu-driver] [--disk-encryption=DISK_ENCRYPTION [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT]] [--network=NETWORK : --no-proxy-access --no-public-ip [--subnet=SUBNET : --subnet-region=SUBNET_REGION]] [GCLOUD_WIDE_FLAG]
DESCRIPTION
(BETA) Request for creating notebook instances.
POSITIONAL ARGUMENTS
Instance resource - User-defined unique name of this instance. The instance name must be 1 to 63 characters long and contain only lowercase letters, numeric characters, and dashes. The first character must be a lowercase letter and the last character cannot be a dash. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. To set the [project] attribute: provide the argument [instance] on the command line with a fully specified name; provide the argument [--project] on the command line; set the property [core/project]. This must be specified.
INSTANCE
ID of the instance or fully qualified identifier for the instance. This positional must be specified if any of the other arguments in this group are specified.
--location=LOCATION
Google Cloud location of this environment https://cloud.google.com/compute/docs/regions-zones/#locations.
REQUIRED FLAGS
Exactly one of these must be specified:
--container-repository=CONTAINER_REPOSITORY
The path to the container image repository. For example: gcr.io/{project_id}/{image_name}. This flag must be specified if any of the other arguments in this group are specified.
--container-tag=CONTAINER_TAG
The tag of the container image. If not specified, this defaults to the latest tag.
Environment resource - User-defined unique name of this environment. The environment name must be 1 to 63 characters long and contain only lowercase letters, numeric characters, and dashes. The first character must be a lowercase letter and the last character cannot be a dash. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. To set the [project] attribute: provide the argument [--environment] on the command line with a fully specified name; provide the argument [--project] on the command line; set the property [core/project].
--environment=ENVIRONMENT
ID of the environment or fully qualified identifier for the environment. This flag must be specified if any of the other arguments in this group are specified.
--environment-location=ENVIRONMENT_LOCATION
Google Cloud location of this environment https://cloud.google.com/compute/docs/regions-zones/#locations.
--vm-image-project=VM_IMAGE_PROJECT; default="deeplearning-platform-release"
The ID of the Google Cloud project that this VM image belongs to. Format: projects/{project_id}.
Exactly one of these must be specified:
--vm-image-family=VM_IMAGE_FAMILY
Use this VM image family to find the image; the newest image in this family will be used.
--vm-image-name=VM_IMAGE_NAME
Use this VM image name to find the image.
OPTIONAL FLAGS
--async
Return immediately, without waiting for the operation in progress to complete.
--instance-owners=INSTANCE_OWNERS
The 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 the VM instance's service account can use the instance.
--labels=[KEY=VALUE,…]
Labels to apply to this instance. These can be later modified by the setLabels method.
--machine-type=MACHINE_TYPE; default="n1-standard-1"
The Compute Engine machine type of this instance.
--metadata=[KEY=VALUE,…]
Custom metadata to apply to this instance.
--post-startup-script=POST_STARTUP_SCRIPT
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).
--service-account=SERVICE_ACCOUNT
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.
The hardware accelerator used on this instance. If you use accelerators, make sure that your configuration has enough vCPUs and memory to support the `machine_type` you have selected.
--accelerator-core-count=ACCELERATOR_CORE_COUNT
Count of cores of this accelerator.
--accelerator-type=ACCELERATOR_TYPE
Type of this accelerator. ACCELERATOR_TYPE must be one of: 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, TPU_V2, TPU_V3.
Boot disk configurations.
--boot-disk-size=BOOT_DISK_SIZE
The size of the 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-type=BOOT_DISK_TYPE
The type of disk attached to this instance, defaults to standard persistent disk (PD_STANDARD). BOOT_DISK_TYPE must be one of: PD_STANDARD, PD_SSD.
GPU driver configurations.
--custom-gpu-driver-path=CUSTOM_GPU_DRIVER_PATH
Specify a custom Cloud Storage path where the GPU driver is stored. If not specified, we'll automatically choose from official GPU drivers.
--install-gpu-driver
Whether the end user authorizes Google Cloud to install a 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.
Disk encryption configurations.
--disk-encryption=DISK_ENCRYPTION
Disk encryption method used on the boot disk, defaults to GMEK. DISK_ENCRYPTION must be one of: GMEK, CMEK.
Key resource - The Cloud KMS (Key Management Service) cryptokey that will be used to protect the instance. The 'Compute Engine Service Agent' service account must hold permission 'Cloud KMS CryptoKey Encrypter/Decrypter'. The arguments in this group can be used to specify the attributes of this resource.
--kms-key=KMS_KEY
ID of the key or fully qualified identifier for the key. This flag must be specified if any of the other arguments in this group are specified.
--kms-keyring=KMS_KEYRING
The KMS keyring of the key.
--kms-location=KMS_LOCATION
The Cloud location for the key.
--kms-project=KMS_PROJECT
The Cloud project for the key.
Network configs.
Network resource - The name of the VPC that this instance is in. Format: projects/{project_id}/global/networks/{network_id}. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. To set the [project] attribute: provide the argument [--network] on the command line with a fully specified name; provide the argument [--project] on the command line; set the property [core/project].
--network=NETWORK
ID of the network or fully qualified identifier for the network.
--no-proxy-access
If true, the notebook instance will not register with the proxy.
--no-public-ip
If specified, no public IP will be assigned to this instance.
Subnetwork resource - The name of the subnet that this instance is in. Format: projects/{project_id}/regions/{region}/subnetworks/{subnetwork_id}. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. To set the [project] attribute: provide the argument [--subnet] on the command line with a fully specified name; provide the argument [--project] on the command line; set the property [core/project].
--subnet=SUBNET
ID of the subnetwork or fully qualified identifier for the subnetwork. This flag must be specified if any of the other arguments in this group are specified.
--subnet-region=SUBNET_REGION
Google Cloud region of this subnetwork https://cloud.google.com/compute/docs/regions-zones/#locations.
GCLOUD WIDE FLAGS
These flags are available to all commands: --account, --billing-project, --configuration, --flags-file, --flatten, --format, --help, --impersonate-service-account, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity.

Run $ gcloud help for details.

EXAMPLES
To create an instance from an environment, run:
gcloud beta notebooks instances create example-instance --environment=example-env --environment-location=us-central1-a --machine-type=n1-standard-4  example-instance --location=us-central1-b

To create an instance from a VmImage family, run:

gcloud beta notebooks instances create example-instance --vm-image-project=deeplearning-platform-release --vm-image-family=caffe1-latest-cpu-experimental --machine-type=n1-standard-4 --location=us-central1-b

To create an instance from a VmImage name, run:

gcloud beta notebooks instances create example-instance --vm-image-project=deeplearning-platform-release --vm-image-name=tf2-2-1-cu101-notebooks-20200110 --machine-type=n1-standard-4 --location=us-central1-b

To create an instance from a Container Repository, run:

gcloud beta notebooks instances create example-instance --container-repository=gcr.io/deeplearning-platform-release/base-cpu --container-tag=test-tag --machine-type=n1-standard-4 --location=us-central1-b
NOTES
This command is currently in BETA and may change without notice. This variant is also available:
gcloud alpha notebooks instances create