gcp_aiplatform_notebook_runtime_template

ancestors

Type: UNORDERED_LIST_STRING

create_time

Type: TIMESTAMP
Provider name: createTime
Description: Output only. Timestamp when this NotebookRuntimeTemplate was created.

data_persistent_disk_spec

Type: STRUCT
Provider name: dataPersistentDiskSpec
Description: Optional. The specification of persistent disk attached to the runtime as data disk storage.

• disk_size_gb
  Type: INT64
  Provider name: diskSizeGb
  Description: Size in GB of the disk (default is 100GB).
  
• disk_type
  Type: STRING
  Provider name: diskType
  Description: Type of the disk (default is “pd-standard”). Valid values: “pd-ssd” (Persistent Disk Solid State Drive) “pd-standard” (Persistent Disk Hard Disk Drive) “pd-balanced” (Balanced Persistent Disk) “pd-extreme” (Extreme Persistent Disk)
  

description

Type: STRING
Provider name: description
Description: The description of the NotebookRuntimeTemplate.

encryption_spec

Type: STRUCT
Provider name: encryptionSpec
Description: Customer-managed encryption key spec for the notebook runtime.

• kms_key_name
  Type: STRING
  Provider name: kmsKeyName
  Description: Required. The Cloud KMS resource identifier of the customer managed encryption key used to protect a resource. Has the form: projects/my-project/locations/my-region/keyRings/my-kr/cryptoKeys/my-key. The key needs to be in the same region as where the compute resource is created.
  

etag

Type: STRING
Provider name: etag
Description: Used to perform consistent read-modify-write updates. If not set, a blind “overwrite” update happens.

euc_config

Type: STRUCT
Provider name: eucConfig
Description: EUC configuration of the NotebookRuntimeTemplate.

• bypass_actas_check
  Type: BOOLEAN
  Provider name: bypassActasCheck
  Description: Output only. Whether ActAs check is bypassed for service account attached to the VM. If false, we need ActAs check for the default Compute Engine Service account. When a Runtime is created, a VM is allocated using Default Compute Engine Service Account. Any user requesting to use this Runtime requires Service Account User (ActAs) permission over this SA. If true, Runtime owner is using EUC and does not require the above permission as VM no longer use default Compute Engine SA, but a P4SA.
  
• euc_disabled
  Type: BOOLEAN
  Provider name: eucDisabled
  Description: Input only. Whether EUC is disabled in this NotebookRuntimeTemplate. In proto3, the default value of a boolean is false. In this way, by default EUC will be enabled for NotebookRuntimeTemplate.
  

gcp_display_name

Type: STRING
Provider name: displayName
Description: Required. The display name of the NotebookRuntimeTemplate. The name can be up to 128 characters long and can consist of any UTF-8 characters.

idle_shutdown_config

Type: STRUCT
Provider name: idleShutdownConfig
Description: The idle shutdown configuration of NotebookRuntimeTemplate. This config will only be set when idle shutdown is enabled.

• idle_shutdown_disabled
  Type: BOOLEAN
  Provider name: idleShutdownDisabled
  Description: Whether Idle Shutdown is disabled in this NotebookRuntimeTemplate.
  
• idle_timeout
  Type: STRING
  Provider name: idleTimeout
  Description: Required. Duration is accurate to the second. In Notebook, Idle Timeout is accurate to minute so the range of idle_timeout (second) is: 10 * 60 ~ 1440 * 60.
  

is_default

Type: BOOLEAN
Provider name: isDefault
Description: Output only. Deprecated: This field has no behavior. Use notebook_runtime_type = ‘ONE_CLICK’ instead. The default template to use if not specified.

labels

Type: UNORDERED_LIST_STRING

machine_spec

Type: STRUCT
Provider name: machineSpec
Description: Optional. Immutable. The specification of a single machine for the template.

• accelerator_count
  Type: INT32
  Provider name: acceleratorCount
  Description: The number of accelerators to attach to the machine.
  
• accelerator_type
  Type: STRING
  Provider name: acceleratorType
  Description: Immutable. The type of accelerator(s) that may be attached to the machine as per accelerator_count.
  Possible values:
  
  • ACCELERATOR_TYPE_UNSPECIFIED - Unspecified accelerator type, which means no accelerator.
    
  • NVIDIA_TESLA_K80 - Deprecated: Nvidia Tesla K80 GPU has reached end of support, see https://cloud.google.com/compute/docs/eol/k80-eol.
    
  • NVIDIA_TESLA_P100 - Nvidia Tesla P100 GPU.
    
  • NVIDIA_TESLA_V100 - Nvidia Tesla V100 GPU.
    
  • NVIDIA_TESLA_P4 - Nvidia Tesla P4 GPU.
    
  • NVIDIA_TESLA_T4 - Nvidia Tesla T4 GPU.
    
  • NVIDIA_TESLA_A100 - Nvidia Tesla A100 GPU.
    
  • NVIDIA_A100_80GB - Nvidia A100 80GB GPU.
    
  • NVIDIA_L4 - Nvidia L4 GPU.
    
  • NVIDIA_H100_80GB - Nvidia H100 80Gb GPU.
    
  • NVIDIA_H100_MEGA_80GB - Nvidia H100 Mega 80Gb GPU.
    
  • NVIDIA_H200_141GB - Nvidia H200 141Gb GPU.
    
  • TPU_V2 - TPU v2.
    
  • TPU_V3 - TPU v3.
    
  • TPU_V4_POD - TPU v4.
    
  • TPU_V5_LITEPOD - TPU v5.
    
• machine_type
  Type: STRING
  Provider name: machineType
  Description: Immutable. The type of the machine. See the list of machine types supported for prediction See the list of machine types supported for custom training. For DeployedModel this field is optional, and the default value is n1-standard-2. For BatchPredictionJob or as part of WorkerPoolSpec this field is required.
  
• reservation_affinity
  Type: STRUCT
  Provider name: reservationAffinity
  Description: Optional. Immutable. Configuration controlling how this resource pool consumes reservation.
  
  • key
    Type: STRING
    Provider name: key
    Description: Optional. Corresponds to the label key of a reservation resource. To target a SPECIFIC_RESERVATION by name, use compute.googleapis.com/reservation-name as the key and specify the name of your reservation as its value.
    
  • reservation_affinity_type
    Type: STRING
    Provider name: reservationAffinityType
    Description: Required. Specifies the reservation affinity type.
    Possible values:
    
    • TYPE_UNSPECIFIED - Default value. This should not be used.
      
    • NO_RESERVATION - Do not consume from any reserved capacity, only use on-demand.
      
    • ANY_RESERVATION - Consume any reservation available, falling back to on-demand.
      
    • SPECIFIC_RESERVATION - Consume from a specific reservation. When chosen, the reservation must be identified via the key and values fields.
      
  • values
    Type: UNORDERED_LIST_STRING
    Provider name: values
    Description: Optional. Corresponds to the label values of a reservation resource. This must be the full resource name of the reservation or reservation block.
    
• tpu_topology
  Type: STRING
  Provider name: tpuTopology
  Description: Immutable. The topology of the TPUs. Corresponds to the TPU topologies available from GKE. (Example: tpu_topology: “2x2x1”).
  

name

Type: STRING
Provider name: name
Description: The resource name of the NotebookRuntimeTemplate.

network_spec

Type: STRUCT
Provider name: networkSpec
Description: Optional. Network spec.

• enable_internet_access
  Type: BOOLEAN
  Provider name: enableInternetAccess
  Description: Whether to enable public internet access. Default false.
  
• network
  Type: STRING
  Provider name: network
  Description: The full name of the Google Compute Engine network
  
• subnetwork
  Type: STRING
  Provider name: subnetwork
  Description: The name of the subnet that this instance is in. Format: projects/{project_id_or_number}/regions/{region}/subnetworks/{subnetwork_id}
  

network_tags

Type: UNORDERED_LIST_STRING
Provider name: networkTags
Description: Optional. The Compute Engine tags to add to runtime (see Tagging instances).

notebook_runtime_type

Type: STRING
Provider name: notebookRuntimeType
Description: Optional. Immutable. The type of the notebook runtime template.
Possible values:

• NOTEBOOK_RUNTIME_TYPE_UNSPECIFIED - Unspecified notebook runtime type, NotebookRuntimeType will default to USER_DEFINED.
  
• USER_DEFINED - runtime or template with coustomized configurations from user.
  
• ONE_CLICK - runtime or template with system defined configurations.
  

organization_id

Type: STRING

parent

Type: STRING

project_id

Type: STRING

project_number

Type: STRING

reservation_affinity

Type: STRUCT
Provider name: reservationAffinity
Description: Optional. Reservation Affinity of the notebook runtime template.

• consume_reservation_type
  Type: STRING
  Provider name: consumeReservationType
  Description: Required. Specifies the type of reservation from which this instance can consume resources: RESERVATION_ANY (default), RESERVATION_SPECIFIC, or RESERVATION_NONE. See Consuming reserved instances for examples.
  Possible values:
  
  • RESERVATION_AFFINITY_TYPE_UNSPECIFIED - Default type.
    
  • RESERVATION_NONE - Do not consume from any allocated capacity.
    
  • RESERVATION_ANY - Consume any reservation available.
    
  • RESERVATION_SPECIFIC - Must consume from a specific reservation. Must specify key value fields for specifying the reservations.
    
• key
  Type: STRING
  Provider name: key
  Description: Optional. Corresponds to the label key of a reservation resource. To target a RESERVATION_SPECIFIC by name, use compute.googleapis.com/reservation-name as the key and specify the name of your reservation as its value.
  
• values
  Type: UNORDERED_LIST_STRING
  Provider name: values
  Description: Optional. Corresponds to the label values of a reservation resource. This must be the full path name of Reservation.
  

resource_name

Type: STRING

service_account

Type: STRING
Provider name: serviceAccount
Description: Deprecated: This field is ignored and the “Vertex AI Notebook Service Account” (service-PROJECT_NUMBER@gcp-sa-aiplatform-vm.iam.gserviceaccount.com) is used for the runtime workload identity. See https://cloud.google.com/iam/docs/service-agents#vertex-ai-notebook-service-account for more details. For NotebookExecutionJob, use NotebookExecutionJob.service_account instead. The service account that the runtime workload runs as. 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.

shielded_vm_config

Type: STRUCT
Provider name: shieldedVmConfig
Description: Optional. Immutable. Runtime Shielded VM spec.

• enable_secure_boot
  Type: BOOLEAN
  Provider name: enableSecureBoot
  Description: 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.
  

software_config

Type: STRUCT
Provider name: softwareConfig
Description: Optional. The notebook software configuration of the notebook runtime.

• env
  Type: UNORDERED_LIST_STRUCT
  Provider name: env
  Description: Optional. Environment variables to be passed to the container. Maximum limit is 100.
  
  • name
    Type: STRING
    Provider name: name
    Description: Required. Name of the environment variable. Must be a valid C identifier.
    
  • value
    Type: STRING
    Provider name: value
    Description: Required. Variables that reference a $(VAR_NAME) are expanded using the previous defined environment variables in the container and any service environment variables. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not.
    
• post_startup_script_config
  Type: STRUCT
  Provider name: postStartupScriptConfig
  Description: Optional. Post startup script config.
  
  • post_startup_script
    Type: STRING
    Provider name: postStartupScript
    Description: Optional. Post startup script to run after runtime is started.
    
  • post_startup_script_behavior
    Type: STRING
    Provider name: postStartupScriptBehavior
    Description: Optional. Post startup script behavior that defines download and execution behavior.
    Possible values:
    
    • POST_STARTUP_SCRIPT_BEHAVIOR_UNSPECIFIED - Unspecified post startup script behavior.
      
    • RUN_ONCE - Run post startup script after runtime is started.
      
    • RUN_EVERY_START - Run post startup script after runtime is stopped.
      
    • DOWNLOAD_AND_RUN_EVERY_START - Download and run post startup script every time runtime is started.
      
  • post_startup_script_url
    Type: STRING
    Provider name: postStartupScriptUrl
    Description: Optional. Post startup script url to download. Example: gs://bucket/script.sh
    

tags

Type: UNORDERED_LIST_STRING

update_time

Type: TIMESTAMP
Provider name: updateTime
Description: Output only. Timestamp when this NotebookRuntimeTemplate was most recently updated.