This product is not supported for your selected Datadog site. ().

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.