REST Resource: projects.locations.runtimes

리소스: 런타임

관리형 노트북 인스턴스의 런타임 정의입니다.

JSON 표현 
{
  "name": string,
  "state": enum (State),
  "healthState": enum (HealthState),
  "accessConfig": {
    object (RuntimeAccessConfig)
  },
  "softwareConfig": {
    object (RuntimeSoftwareConfig)
  },
  "metrics": {
    object (RuntimeMetrics)
  },
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "runtimeMigrationEligibility": {
    object (RuntimeMigrationEligibility)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "virtualMachine": {
    object (VirtualMachine)
  }
  // End of mutually exclusive fields.
  "migrated": boolean
}
필드
name

string

출력 전용입니다. 런타임의 리소스 이름입니다. 형식: projects/{project}/locations/{location}/runtimes/{runtimeId}
state

enum (State)

출력 전용입니다. 런타임 상태입니다.
healthState

enum (HealthState)

출력 전용입니다. 런타임 healthState입니다.
accessConfig

object (RuntimeAccessConfig)

런타임 액세스를 위한 구성 설정입니다.
softwareConfig

object (RuntimeSoftwareConfig)

런타임 내 소프트웨어의 구성 설정입니다.
metrics

object (RuntimeMetrics)

출력 전용입니다. 서비스 상태, JupyterLab 통계와 같은 런타임 데몬 측정항목이 포함되어 있습니다.
createTime

string (Timestamp format)

출력 전용입니다. 런타임 생성 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
updateTime

string (Timestamp format)

출력 전용입니다. 런타임 업데이트 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
labels

map (key: string, value: string)

(선택사항) 이 관리형 노트북 또는 런타임과 연결할 라벨입니다. 라벨 키는 1~63자(영문 기준)여야 하며 RFC 1035를 준수해야 합니다. 라벨 값은 비워 둘 수 있지만, 값이 있는 경우 1~63자(영문 기준)여야 하며 RFC 1035를 준수해야 합니다. 클러스터와 연결할 수 있는 라벨은 32개 미만입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
runtimeMigrationEligibility

object (RuntimeMigrationEligibility)

출력 전용입니다. GmN에서 WbI로의 마이그레이션 가능성을 확인합니다.
런타임 유형입니다. 현재 Compute Engine VM만 지원합니다. 다음은 상호 배타적인 필드의 목록입니다. 응답에는 다음 필드 중 최대 하나가 설정됩니다.
virtualMachine

object (VirtualMachine)

Compute Engine VM 이미지를 사용하여 관리형 노트북 인스턴스를 시작합니다.
상호 배타적 필드의 끝입니다.
migrated

boolean

출력 전용입니다. 이 노트북이 Workbench 인스턴스로 마이그레이션되었는지 여부를 나타내는 불리언

VirtualMachine

컴퓨팅을 위해 가상 머신을 사용하는 런타임입니다.

JSON 표현 
{
  "instanceName": string,
  "instanceId": string,
  "virtualMachineConfig": {
    object (VirtualMachineConfig)
  }
}
필드
instanceName

string

출력 전용입니다. 관리형 Compute Engine 인스턴스의 사용자 친화적인 이름입니다.
instanceId

string

출력 전용입니다. 관리형 Compute Engine 인스턴스의 고유 식별자입니다.
virtualMachineConfig

object (VirtualMachineConfig)

가상 머신 구성 설정입니다.

VirtualMachineConfig

가상 머신의 구성 설정입니다.

JSON 표현 
{
  "zone": string,
  "machineType": string,
  "containerImages": [
    {
      object (ContainerImage)
    }
  ],
  "dataDisk": {
    object (LocalDisk)
  },
  "encryptionConfig": {
    object (EncryptionConfig)
  },
  "shieldedInstanceConfig": {
    object (RuntimeShieldedInstanceConfig)
  },
  "acceleratorConfig": {
    object (RuntimeAcceleratorConfig)
  },
  "network": string,
  "subnet": string,
  "internalIpOnly": boolean,
  "tags": [
    string
  ],
  "guestAttributes": {
    string: string,
    ...
  },
  "metadata": {
    string: string,
    ...
  },
  "labels": {
    string: string,
    ...
  },
  "nicType": enum (NicType),
  "reservedIpRange": string,
  "bootImage": {
    object (BootImage)
  }
}
필드
zone

string

출력 전용입니다. 가상 머신이 있는 영역입니다. 리전 요청을 사용하는 경우 노트북 서비스는 해당 런타임 리전의 위치를 선택합니다. get 요청에서는 항상 영역이 표시됩니다. 예: * us-central1-b
machineType

string

필수 항목입니다. 런타임에 사용되는 Compute Engine 머신 유형입니다. 닉네임이 유효합니다. 예: * n1-standard-2 * e2-standard-8
containerImages[]

object (ContainerImage)

(선택사항) 노트북 인스턴스에서 커널로 사용할 컨테이너 이미지 목록을 사용합니다.
dataDisk

object (LocalDisk)

필수 항목입니다. 데이터 디스크 옵션 구성 설정입니다.
encryptionConfig

object (EncryptionConfig)

(선택사항) 가상 머신 데이터 디스크의 암호화 설정입니다.
shieldedInstanceConfig

object (RuntimeShieldedInstanceConfig)

(선택사항) 보안 VM 인스턴스 구성 설정입니다.
acceleratorConfig

object (RuntimeAcceleratorConfig)

(선택사항) 이 런타임의 Compute Engine 가속기 구성입니다.
network

string

(선택사항) 머신 통신에 사용할 Compute Engine 네트워크입니다. 서브네트워크와 함께 지정할 수 없습니다. network와 subnet가 모두 지정되지 않은 경우 프로젝트의 'default' 네트워크가 사용됩니다(있는 경우).

전체 URL 또는 부분 URI입니다. 예:

  • https://www.googleapis.com/compute/v1/projects/[projectId]/global/networks/default
  • projects/[projectId]/global/networks/default

런타임은 Google 인프라 내의 관리 리소스입니다. 런타임은 다음 네트워크 구성을 지원합니다.

  • Google 관리 네트워크 (네트워크 및 서브넷이 비어 있음)
  • 소비자 프로젝트 VPC (네트워크 및 서브넷 필수) 비공개 서비스 액세스를 구성해야 합니다.
  • 공유 VPC (네트워크 및 서브넷이 필요함) 비공개 서비스 액세스를 구성해야 합니다.
subnet

string

(선택사항) 머신 통신에 사용할 Compute Engine 서브넷입니다. 네트워크와 함께 지정할 수 없습니다.

전체 URL 또는 부분 URI가 유효합니다. 예:

  • https://www.googleapis.com/compute/v1/projects/[projectId]/regions/us-east1/subnetworks/sub0
  • projects/[projectId]/regions/us-east1/subnetworks/sub0
internalIpOnly

boolean

(선택사항) true인 경우 런타임에 내부 IP 주소만 있습니다. 기본적으로 런타임은 내부 IP 주소로 제한되지 않으며 각 VM에 임시 외부 IP 주소가 할당됩니다. 이 internalIpOnly 제한은 서브네트워크 지원 네트워크에만 사용 설정할 수 있으며 모든 종속 항목은 외부 IP 주소 없이 액세스할 수 있도록 구성해야 합니다.
tags[]

string

(선택사항) 런타임에 추가할 Compute Engine 네트워크 태그입니다 (네트워크 태그 추가 참고).
guestAttributes

map (key: string, value: string)

출력 전용입니다. Compute Engine 게스트 속성입니다. 프로젝트 및 인스턴스 게스트 속성을 참고하세요.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
metadata

map (key: string, value: string)

(선택사항) 가상 머신에 추가할 Compute Engine 메타데이터 항목입니다. (프로젝트 및 인스턴스 메타데이터 참고)

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
labels

map (key: string, value: string)

(선택사항) 이 런타임과 연결할 라벨입니다. 라벨 키는 1~63자(영문 기준)여야 하며 RFC 1035를 준수해야 합니다. 라벨 값은 비워 둘 수 있지만, 값이 있는 경우 1~63자(영문 기준)여야 하며 RFC 1035를 준수해야 합니다. 클러스터와 연결할 수 있는 라벨은 32개 미만입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
nicType

enum (NicType)

(선택사항) 이 인터페이스에서 사용할 vNIC 유형입니다. gVNIC 또는 VirtioNet일 수 있습니다.
reservedIpRange

string

(선택사항) 예약된 IP 범위 이름은 VPC 피어링에 사용됩니다. 할당된 경우 서브네트워크 할당에 name 범위가 사용됩니다.

예: managed-notebooks-range-c

PEERING_RANGE_NAME_3=managed-notebooks-range-c
gcloud compute addresses create $PEERING_RANGE_NAME_3 \
  --global \
  --prefix-length=24 \
  --description="Google Cloud Managed Notebooks Range 24 c" \
  --network=$NETWORK \
  --addresses=192.168.0.0 \
  --purpose=VPC_PEERING

필드 값은 managed-notebooks-range-c입니다.
bootImage

object (BootImage)

(선택사항) 런타임 업그레이드 가능성에 사용되는 부팅 이미지 메타데이터

LocalDisk

로컬 연결 디스크 리소스입니다.

JSON 표현 
{
  "autoDelete": boolean,
  "boot": boolean,
  "deviceName": string,
  "guestOsFeatures": [
    {
      object (RuntimeGuestOsFeature)
    }
  ],
  "index": integer,
  "initializeParams": {
    object (LocalDiskInitializeParams)
  },
  "interface": string,
  "kind": string,
  "licenses": [
    string
  ],
  "mode": string,
  "source": string,
  "type": string
}
필드
autoDelete

boolean

(선택사항) 출력 전용입니다. 인스턴스가 삭제될 때 디스크가 자동으로 삭제되는지 여부를 지정합니다 (인스턴스에서 디스크가 분리될 때는 아님).
boot

boolean

(선택사항) 출력 전용입니다. 부팅 디스크임을 나타냅니다. 가상 머신은 디스크의 첫 번째 파티션을 루트 파일 시스템으로 사용합니다.
deviceName

string

(선택사항) 출력 전용입니다. 인스턴스 내에서 실행되는 Linux 운영체제의 /dev/disk/by-id/google-* 트리에 반영되는 원하는 고유 기기 이름을 지정합니다. 인스턴스 내에서 마운트, 크기 조절 등을 위해 기기를 참조하는 데 이 이름을 사용할 수 있습니다.

지정하지 않으면 서버는 이 디스크에 적용할 기본 기기 이름을 선택합니다. 기본 기기 이름은 persistent-disk-x 형식입니다. 여기서 x는 Google Compute Engine에서 할당한 번호입니다. 이 필드는 영구 디스크에만 적용됩니다.
guestOsFeatures[]

object (RuntimeGuestOsFeature)

출력 전용입니다. 게스트 운영체제에서 사용 설정할 기능 목록을 나타냅니다. 부팅 가능한 이미지에만 적용됩니다. 게스트 운영체제 기능 사용 설정을 읽고 사용 가능한 옵션 목록을 확인하세요.
index

integer

출력 전용입니다. 이 디스크의 0부터 시작하는 색인입니다. 0은 부팅 디스크용으로 예약되어 있습니다. 인스턴스에 연결된 디스크가 많은 경우 각 디스크에는 고유한 색인 번호가 있습니다.
initializeParams

object (LocalDiskInitializeParams)

입력 전용입니다. 새 인스턴스와 함께 생성될 새 디스크의 매개변수를 지정합니다. 초기화 매개변수를 사용하여 새 인스턴스에 연결된 부팅 디스크 또는 로컬 SSD를 만듭니다.

이 속성은 소스 속성과 상호 배타적입니다. 둘 중 하나만 정의할 수 있으며 둘 다 정의할 수는 없습니다.
interface

string

이 디스크를 연결하는 데 사용할 디스크 인터페이스를 지정합니다. SCSI 또는 NVME 중 하나입니다. 기본값은 SCSI입니다. 영구 디스크는 항상 SCSI를 사용해야 하며 SCSI 이외의 형식으로 영구 디스크를 연결하려고 하면 요청이 실패합니다. 로컬 SSD는 NVME 또는 SCSI를 사용할 수 있습니다. NVMe를 통한 SCSI의 성능 특성은 로컬 SSD 성능을 참고하세요. 유효한 값:

  • NVME
  • SCSI
kind

string

출력 전용입니다. 리소스 유형입니다. 연결된 디스크의 경우 항상 compute#attachedDisk를 계산합니다.
licenses[]

string

출력 전용입니다. 유효하고 공개적으로 표시되는 라이선스
mode

string

이 디스크를 연결할 모드입니다(READ_WRITE 또는 READ_ONLY). 지정하지 않으면 기본적으로 READ_WRITE 모드로 디스크가 연결됩니다. 유효한 값:

  • READ_ONLY
  • READ_WRITE
source

string

기존 영구 디스크 리소스의 유효한 부분 또는 전체 URL을 지정합니다.
type

string

디스크 유형을 지정합니다(SCRATCH 또는 PERSISTENT). 지정하지 않으면 기본값은 PERSISTENT입니다. 유효한 값:

  • PERSISTENT
  • SCRATCH

RuntimeGuestOsFeature

(선택사항) 게스트 운영체제에서 사용 설정할 기능 목록입니다. 부팅 가능한 이미지에만 적용됩니다. 게스트 운영체제 기능 사용 설정에서 사용 가능한 옵션 목록을 확인하세요. 부팅 디스크의 게스트 OS 기능입니다.

JSON 표현 
{
  "type": string
}
필드
type

string

지원되는 기능의 ID입니다. 게스트 운영체제 기능 사용 설정에서 사용 가능한 옵션 목록을 확인하세요.

유효한 값:

  • FEATURE_TYPE_UNSPECIFIED
  • MULTI_IP_SUBNET
  • SECURE_BOOT
  • UEFI_COMPATIBLE
  • VIRTIO_SCSI_MULTIQUEUE
  • WINDOWS

LocalDiskInitializeParams

입력 전용입니다. 새 인스턴스와 함께 생성될 새 디스크의 매개변수를 지정합니다. 초기화 매개변수를 사용하여 새 런타임에 연결된 부팅 디스크 또는 로컬 SSD를 만듭니다. 이 속성은 소스 속성과 상호 배타적입니다. 둘 중 하나만 정의할 수 있으며 둘 다 정의할 수는 없습니다.

JSON 표현 
{
  "description": string,
  "diskName": string,
  "diskSizeGb": string,
  "diskType": enum (DiskType),
  "labels": {
    string: string,
    ...
  }
}
필드
description

string

(선택사항) 디스크를 만들 때 이 속성을 제공하세요.
diskName

string

(선택사항) 디스크 이름을 지정합니다. 지정하지 않으면 인스턴스 이름이 기본적으로 사용됩니다. 인스턴스 이름이 지정된 디스크가 지정된 영역/리전에 이미 있는 경우 새 이름이 자동으로 생성됩니다.
diskSizeGb

string (int64 format)

(선택사항) 디스크 크기를 2진수 GB로 지정합니다. 지정하지 않으면 디스크 크기는 이미지 크기 (일반적으로 10GB)와 동일합니다. 지정된 경우 크기는 10GB 이상이어야 합니다. 기본값은 100GB입니다.
diskType

enum (DiskType)

입력 전용입니다. 이 인스턴스에 연결된 부팅 디스크의 유형입니다. 기본값은 표준 영구 디스크 (PD_STANDARD)입니다.
labels

map (key: string, value: string)

(선택사항) 이 디스크에 적용할 라벨입니다. 이러한 값은 나중에 disks.setLabels 메서드로 수정할 수 있습니다. 이 필드는 영구 디스크에만 적용됩니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

DiskType

가능한 디스크 유형입니다.

열거형
DISK_TYPE_UNSPECIFIED 디스크 유형이 설정되지 않았습니다.
PD_STANDARD 표준 영구 디스크 유형입니다.
PD_SSD SSD 영구 디스크 유형입니다.
PD_BALANCED 균형 있는 영구 디스크 유형입니다.
PD_EXTREME 익스트림 영구 디스크 유형입니다.

EncryptionConfig

리소스에 적용할 수 있는 커스텀 암호화 키 구성을 나타냅니다. 이렇게 하면 가상 머신의 모든 디스크가 암호화됩니다.

JSON 표현 
{
  "kmsKey": string
}
필드
kmsKey

string

디스크와 같은 리소스를 보호하는 데 사용되는 고객 관리 암호화 키의 Cloud KMS 리소스 식별자입니다. 형식은 projects/{PROJECT_ID}/locations/{REGION}/keyRings/{KEY_RING_NAME}/cryptoKeys/{KEY_NAME}입니다.

RuntimeShieldedInstanceConfig

보안 인스턴스 옵션 집합입니다. 지원되는 보안 VM 기능을 사용하는 이미지를 참고하세요. 일부 조합은 유효하지 않습니다.

JSON 표현 
{
  "enableSecureBoot": boolean,
  "enableVtpm": boolean,
  "enableIntegrityMonitoring": boolean
}
필드
enableSecureBoot

boolean

인스턴스에 보안 부팅이 사용 설정되었는지 여부를 정의합니다.

보안 부트에서는 모든 부팅 구성요소의 디지털 서명을 확인하고 서명 확인에 실패할 경우 부팅 프로세스를 중단하여 시스템에서 인증된 소프트웨어만 실행하도록 보장합니다. 기본적으로 사용 중지됩니다.
enableVtpm

boolean

인스턴스에 vTPM이 사용 설정되었는지 여부를 정의합니다. 기본적으로 사용 설정됩니다.
enableIntegrityMonitoring

boolean

인스턴스에 무결성 모니터링이 사용 설정되었는지 여부를 정의합니다.

인스턴스의 부팅 무결성 모니터링 및 증명을 사용 설정합니다. 증명은 무결성 정책 기준에 대해 실행됩니다. 이 기준은 인스턴스가 생성될 때 암시적으로 신뢰할 수 있는 부팅 이미지에서 처음 파생됩니다. 기본적으로 사용 설정됩니다.

RuntimeAcceleratorConfig

사용할 수 있는 하드웨어 가속기 유형의 정의입니다. Compute Engine AcceleratorTypes를 참고하세요. 예:

  • nvidia-tesla-k80
  • nvidia-tesla-p100
  • nvidia-tesla-v100
  • nvidia-tesla-p4
  • nvidia-tesla-t4
  • nvidia-tesla-a100
JSON 표현 
{
  "type": enum (AcceleratorType),
  "coreCount": string
}
필드
type

enum (AcceleratorType)

가속기 모델입니다.
coreCount

string (int64 format)

이 액셀러레이터의 코어 수입니다.

AcceleratorType

이 가속기의 유형입니다.

열거형
ACCELERATOR_TYPE_UNSPECIFIED 가속기 유형이 지정되지 않았습니다.
NVIDIA_TESLA_K80

가속기 유형은 Nvidia Tesla K80입니다.
NVIDIA_TESLA_P100 가속기 유형은 Nvidia Tesla P100입니다.
NVIDIA_TESLA_V100 가속기 유형은 Nvidia Tesla V100입니다.
NVIDIA_TESLA_P4 가속기 유형은 Nvidia Tesla P4입니다.
NVIDIA_TESLA_T4 가속기 유형은 Nvidia Tesla T4입니다.
NVIDIA_TESLA_A100 가속기 유형은 Nvidia Tesla A100 - 40GB입니다.
NVIDIA_L4 가속기 유형은 Nvidia L4입니다.
TPU_V2 (출시 예정) 가속기 유형은 TPU V2입니다.
TPU_V3 (출시 예정) 가속기 유형은 TPU V3입니다.
NVIDIA_TESLA_T4_VWS 가속기 유형은 NVIDIA Tesla T4 가상 워크스테이션입니다.
NVIDIA_TESLA_P100_VWS 가속기 유형은 NVIDIA Tesla P100 가상 워크스테이션입니다.
NVIDIA_TESLA_P4_VWS 가속기 유형은 NVIDIA Tesla P4 가상 워크스테이션입니다.

NicType

vNIC 드라이버의 유형입니다. 기본값은 UNSPECIFIED_NIC_TYPE이어야 합니다.

열거형
UNSPECIFIED_NIC_TYPE 유형이 지정되지 않았습니다.
VIRTIO_NET VIRTIO
GVNIC gVNIC

BootImage

이 유형에는 필드가 없습니다.

런타임에서 사용하는 부팅 이미지의 정의입니다. 런타임 업그레이드 가능성을 촉진하는 데 사용됩니다.

주

이 런타임의 상태 정의입니다.

열거형
STATE_UNSPECIFIED 상태가 지정되지 않았습니다.
STARTING 컴퓨팅 레이어가 런타임을 시작하고 있습니다. 사용할 준비가 되지 않았습니다.
PROVISIONING 컴퓨팅 레이어에서 필수 프레임워크를 설치하고 노트북 프록시에 런타임을 등록하고 있습니다. 사용할 수 없습니다.
ACTIVE 런타임이 현재 실행 중입니다. 사용할 준비가 되었습니다.
STOPPING 제어 로직이 런타임을 중지하고 있습니다. 사용할 수 없습니다.
STOPPED 런타임이 중지되었습니다. 사용할 수 없습니다.
DELETING 런타임을 삭제하는 중입니다. 사용할 수 없습니다.
UPGRADING 런타임이 업그레이드되고 있습니다. 사용할 수 없습니다.
INITIALIZING 런타임을 만들고 설정하는 중입니다. 사용할 준비가 되지 않았습니다.

HealthState

런타임 하위 상태입니다.

열거형
HEALTH_STATE_UNSPECIFIED 런타임 하위 상태를 알 수 없습니다.
HEALTHY 런타임이 정상 상태인 것으로 알려져 있습니다 (예: 중요한 데몬이 실행 중임). ACTIVE 상태에 적용됩니다.
UNHEALTHY 런타임이 비정상 상태인 것으로 알려져 있습니다 (예: 중요한 데몬이 실행되지 않음). ACTIVE 상태에 적용됩니다.
AGENT_NOT_INSTALLED 런타임에 상태 모니터링 에이전트가 설치되지 않았습니다. 활성 상태에 적용됩니다.
AGENT_NOT_RUNNING 런타임 상태 모니터링 에이전트가 실행되고 있지 않습니다. 활성 상태에 적용됩니다.

RuntimeAccessConfig

런타임의 로그인 구성을 지정합니다.

JSON 표현 
{
  "accessType": enum (RuntimeAccessType),
  "runtimeOwner": string,
  "proxyUri": string
}
필드
accessType

enum (RuntimeAccessType)

이 인스턴스의 액세스 모드 유형입니다.
runtimeOwner

string

생성 후 이 런타임의 소유자입니다. 형식: alias@example.com 현재 소유자 1명만 지원됩니다.
proxyUri

string

출력 전용입니다. 런타임에 액세스하는 데 사용되는 프록시 엔드포인트입니다.

RuntimeAccessType

런타임에 액세스하는 가능한 방법 인증 모드입니다. 현재는 단일 사용자만 지원됩니다.

열거형
RUNTIME_ACCESS_TYPE_UNSPECIFIED 액세스가 지정되지 않았습니다.
SINGLE_USER 단일 사용자 로그인
SERVICE_ACCOUNT 서비스 계정 모드입니다. 서비스 계정 모드에서 런타임 생성자는 소비자 프로젝트에 있는 SA를 지정합니다. 런타임 서비스 계정 필드 사용 런타임에 액세스하는 사용자에게는 ActAs (서비스 계정 사용자) 권한이 필요합니다.

RuntimeSoftwareConfig

런타임 내 소프트웨어의 선택 및 구성을 지정합니다. 런타임에 설정할 속성입니다. 속성 키는 key:value 형식으로 지정됩니다. 예를 들면 다음과 같습니다.

  • idleShutdown: true
  • idleShutdownTimeout: 180
  • enableHealthMonitoring: true
JSON 표현 
{
  "notebookUpgradeSchedule": string,
  "idleShutdownTimeout": integer,
  "installGpuDriver": boolean,
  "customGpuDriverPath": string,
  "postStartupScript": string,
  "kernels": [
    {
      object (ContainerImage)
    }
  ],
  "postStartupScriptBehavior": enum (PostStartupScriptBehavior),
  "enableHealthMonitoring": boolean,
  "idleShutdown": boolean,
  "upgradeable": boolean,
  "disableTerminal": boolean,
  "version": string,
  "mixerDisabled": boolean
}
필드
notebookUpgradeSchedule

string

인스턴스 자동 업그레이드를 예약하는 데 사용되는 UTC 시간대의 크론 표현식입니다. 크론 형식을 따르세요.
idleShutdownTimeout

integer

런타임을 종료하기 전에 대기하는 시간(분)입니다. 기본값: 180분
installGpuDriver

boolean

Nvidia 드라이버를 자동으로 설치합니다. 기본값: True
customGpuDriverPath

string

GPU 드라이버가 저장된 맞춤 Cloud Storage 경로를 지정합니다. 지정하지 않으면 공식 GPU 드라이버 중에서 자동으로 선택됩니다.
postStartupScript

string

노트북 인스턴스가 완전히 부팅된 후 자동으로 실행되는 Bash 스크립트의 경로입니다. 경로는 URL 또는 Cloud Storage 경로 (gs://path-to-file/file-name)여야 합니다.
kernels[]

object (ContainerImage)

(선택사항) 노트북 인스턴스에서 커널로 사용할 컨테이너 이미지 목록을 사용합니다.
postStartupScriptBehavior

enum (PostStartupScriptBehavior)

시작 후 스크립트의 동작입니다.
enableHealthMonitoring

boolean

핵심 내부 서비스가 실행 중인지 확인합니다. 기본값: True
idleShutdown

boolean

런타임은 idle_shutdown_time이 지나면 자동으로 종료됩니다. 기본값: True
upgradeable

boolean

출력 전용입니다. 이미지 계열에서 새 이미지를 사용할 수 있는지 여부를 나타내는 불리언입니다.
disableTerminal

boolean

JupyterLab 터미널의 사용 가능 여부를 나타내는 불리언입니다. 기본값: False
version

string

출력 전용입니다. 이미지의 출시 라벨에서 가져온 부팅 이미지 버전입니다(예: M100).
mixerDisabled

boolean

믹서 클라이언트를 사용 중지해야 하는지 여부를 나타내는 불리언입니다. 기본값: False

PostStartupScriptBehavior

시작 후 스크립트의 동작입니다.

열거형
POST_STARTUP_SCRIPT_BEHAVIOR_UNSPECIFIED 지정되지 않은 시작 스크립트 후 동작입니다. 생성 시 한 번만 실행됩니다.
RUN_EVERY_START 생성 중에 제공된 시작 스크립트를 시작할 때마다 실행합니다.
DOWNLOAD_AND_RUN_EVERY_START 시작할 때마다 제공된 시작 스크립트를 다운로드하고 실행합니다.

RuntimeMetrics

OS, 커널, 세션 통계와 같은 런타임 데몬 측정항목이 포함되어 있습니다.

JSON 표현 
{
  "systemMetrics": {
    string: string,
    ...
  }
}
필드
systemMetrics

map (key: string, value: string)

출력 전용입니다. 시스템 측정항목입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

RuntimeMigrationEligibility

RuntimeMigrationEligibility는 GmN에서 WbI로의 이전 가능성 정보를 나타냅니다.

JSON 표현 
{
  "warnings": [
    enum (Warning)
  ],
  "errors": [
    enum (Error)
  ]
}
필드
warnings[]

enum (Warning)

출력 전용입니다. 마이그레이션 중에 특정 구성이 기본값으로 설정됩니다.
errors[]

enum (Error)

출력 전용입니다. 특정 구성에서는 GmN이 자동 이전 대상이 되지 않습니다. 수동 마이그레이션이 필요합니다.

경고

마이그레이션 경고 메시지는 마이그레이션 중에 특정 구성이 기본값으로 설정됨을 의미합니다.

열거형
WARNING_UNSPECIFIED 기본 유형입니다.
UNSUPPORTED_ACCELERATOR_TYPE GmN이 WbI에서 지원되지 않는 가속기 유형을 사용합니다. 가속기 없이 마이그레이션됩니다. 사용자는 마이그레이션 후 가속기를 연결할 수 있습니다.
UNSUPPORTED_OS GmN이 WbI에서 지원되지 않는 운영체제 (예: Debian 10)를 사용합니다. WbI에서는 Debian 11로 대체됩니다.
RESERVED_IP_RANGE 이 GmN은 WbI에서 더 이상 적용되지 않는 예약된 IP 범위로 구성되어 있습니다.
GOOGLE_MANAGED_NETWORK 이 GmN은 Google 관리 네트워크로 구성됩니다. 마이그레이션에 사용할 network 및 subnet 옵션을 제공하세요.
POST_STARTUP_SCRIPT 이 GmN은 시작 스크립트 후 스크립트로 구성됩니다. 선택적으로 마이그레이션의 postStartupScriptOption를 제공하세요.
SINGLE_USER 이 GmN은 단일 사용자 모드로 구성되어 있습니다. 원하는 경우 마이그레이션에 사용할 serviceAccount 옵션을 제공하세요.

오류

이전 오류 메시지는 특정 구성으로 인해 GmN이 자동 이전 대상이 아님을 의미합니다. 수동 마이그레이션이 필요합니다.

열거형
ERROR_UNSPECIFIED 기본 유형입니다.
CUSTOM_CONTAINER GmN이 맞춤 컨테이너로 구성되어 있어 이전할 수 없습니다.

메서드

create

 특정 프로젝트와 위치에 새 런타임을 만듭니다.

delete

 단일 런타임을 삭제합니다.

get

 단일 런타임의 세부정보를 가져옵니다.

getIamPolicy

 리소스의 액세스 제어 정책을 가져옵니다.

list

 특정 프로젝트와 위치의 런타임을 나열합니다.

migrate

 기존 런타임을 새 Workbench 인스턴스로 마이그레이션합니다.

patch

 노트북 런타임 구성을 업데이트합니다.

reportEvent

 런타임 이벤트를 보고하고 처리합니다.

reset

 관리형 노트북 런타임을 재설정합니다.

setIamPolicy

 지정된 리소스의 액세스 제어 정책을 설정합니다.

start

 관리형 노트북 런타임을 시작합니다.

stop

 관리형 노트북 런타임을 중지합니다.

switch

 관리형 노트북 런타임을 전환합니다.

testIamPermissions

 지정된 리소스에 대해 호출자가 보유한 권한을 반환합니다.