리소스: 인스턴스
노트북 인스턴스의 정의입니다.
| JSON 표현 |
|---|
{ "name": string, "proxyUri": string, "instanceOwners": [ string ], "creator": string, "state": enum ( |
| 필드 | |
|---|---|
name |
출력 전용입니다. 식별자. 이 노트북 인스턴스의 이름입니다. 형식: |
proxyUri |
출력 전용입니다. Jupyter Notebook에 액세스하는 데 사용되는 프록시 엔드포인트입니다. |
instanceOwners[] |
선택사항입니다. 생성 후 이 인스턴스의 소유자입니다. 형식: 현재 소유자는 한 명만 지원됩니다. 지정하지 않으면 VM 인스턴스의 서비스 계정의 모든 서비스 계정 사용자가 인스턴스를 사용할 수 있습니다. |
creator |
출력 전용입니다. 원래 instances.create 요청을 보낸 법인의 이메일 주소입니다. |
state |
출력 전용입니다. 이 인스턴스의 상태입니다. |
upgradeHistory[] |
출력 전용입니다. 이 인스턴스의 업그레이드 내역입니다. |
id |
출력 전용입니다. 리소스의 고유 ID입니다. |
healthState |
출력 전용입니다. 인스턴스 healthState입니다. |
healthInfo |
출력 전용입니다. 인스턴스 상태에 대한 추가 정보입니다. 예:
|
createTime |
출력 전용입니다. 인스턴스 생성 시간입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 |
updateTime |
출력 전용입니다. 인스턴스 업데이트 시간입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 |
disableProxyAccess |
선택사항입니다. true인 경우 노트북 인스턴스가 프록시에 등록되지 않습니다. |
labels |
선택사항입니다. 이 인스턴스에 적용할 라벨입니다. 이러한 값은 나중에 instances.patch 메서드로 수정할 수 있습니다.
|
thirdPartyProxyUrl |
출력 전용입니다. Jupyter 노트북에 액세스하는 데 사용되는 직원 풀 프록시 엔드포인트입니다. |
satisfiesPzs |
출력 전용입니다. 영역 분리를 위해 나중에 사용하도록 예약되어 있습니다. |
satisfiesPzi |
출력 전용입니다. 영역 격리를 위해 나중에 사용하도록 예약되어 있습니다. |
enableThirdPartyIdentity |
선택사항입니다. 서드 파티 ID 공급업체로 노트북에 액세스할 수 있음을 지정하는 플래그입니다. |
enableManagedEuc |
선택사항입니다. 인스턴스에 관리형 최종 사용자 인증 정보를 사용 설정하는 플래그입니다. |
enableDeletionProtection |
선택사항입니다. true인 경우 이 워크벤치 인스턴스에 삭제 방지가 사용 설정됩니다. false인 경우 이 워크벤치 인스턴스의 삭제 방지가 사용 중지됩니다. |
통합 필드 infrastructure. 노트북 인스턴스 설정입니다. infrastructure은 다음 중 하나여야 합니다. |
|
gceSetup |
선택사항입니다. 노트북의 Compute Engine 설정입니다. 노트북 정의 필드를 사용합니다. |
GceSetup
리소스 및 ID 외부에서 VM 인스턴스를 구성하는 방법에 관한 정의입니다.
| JSON 표현 |
|---|
{ "machineType": string, "minCpuPlatform": string, "acceleratorConfigs": [ { object ( |
| 필드 | |
|---|---|
machineType |
선택사항입니다. VM 인스턴스의 머신 유형입니다. https://cloud.google.com/compute/docs/machine-resource |
minCpuPlatform |
선택사항입니다. 이 인스턴스에 사용할 최소 CPU 플랫폼입니다. 유효한 값 목록은 https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform#availablezones에서 확인할 수 있습니다. |
acceleratorConfigs[] |
선택사항입니다. 이 인스턴스에서 사용되는 하드웨어 가속기입니다. 가속기를 사용하는 경우 구성에 선택한 |
serviceAccounts[] |
선택사항입니다. VM 인스턴스의 ID로 사용되는 서비스 계정입니다. 현재 하나의 서비스 계정만 지원합니다. |
bootDisk |
선택사항입니다. VM의 부팅 디스크입니다. |
dataDisks[] |
선택사항입니다. VM 인스턴스에 연결된 데이터 디스크입니다. 현재는 데이터 디스크 하나만 지원됩니다. |
shieldedInstanceConfig |
선택사항입니다. 보안 VM 구성입니다. 지원되는 보안 VM 기능을 사용하는 이미지 |
networkInterfaces[] |
선택사항입니다. VM의 네트워크 인터페이스입니다. 인터페이스 하나만 지원됩니다. |
disablePublicIp |
선택사항입니다. true인 경우 이 VM 인스턴스에 외부 IP가 할당되지 않습니다. |
tags[] |
선택사항입니다. 런타임에 추가할 Compute Engine 네트워크 태그입니다 (네트워크 태그 추가 참고). |
metadata |
선택사항입니다. 이 인스턴스에 적용할 커스텀 메타데이터입니다.
|
enableIpForwarding |
선택사항입니다. IP 전달을 사용 설정할지 여부를 나타내는 플래그입니다. 기본값은 false/off입니다. https://cloud.google.com/vpc/docs/using-routes#canipforward |
gpuDriverConfig |
선택사항입니다. GPU 드라이버 구성 |
confidentialInstanceConfig |
선택사항입니다. 컨피덴셜 인스턴스 구성입니다. |
instanceId |
출력 전용입니다. Compute Engine 인스턴스 리소스의 고유 ID입니다. |
통합 필드 image. 이미지 유형입니다. VM 이미지 또는 컨테이너 이미지 중 하나일 수 있습니다. image은 다음 중 하나여야 합니다. |
|
vmImage |
선택사항입니다. Compute Engine VM 이미지를 사용하여 노트북 인스턴스를 시작합니다. |
containerImage |
선택사항입니다. 컨테이너 이미지를 사용하여 노트북 인스턴스를 시작합니다. |
AcceleratorConfig
VM 인스턴스의 가속기 구성입니다. 하드웨어 가속기의 정의입니다. type 및 coreCount 조합은 확인하지 않습니다. TPU는 지원되지 않습니다. 유효한 조합은 Compute Engine의 GPU를 참고하세요.
| JSON 표현 |
|---|
{
"type": enum ( |
| 필드 | |
|---|---|
type |
선택사항입니다. 이 가속기의 유형입니다. |
coreCount |
선택사항입니다. 이 액셀러레이터의 코어 수입니다. |
AcceleratorType
이 인스턴스에서 사용할 수 있는 하드웨어 가속기 유형의 정의입니다.
| 열거형 | |
|---|---|
ACCELERATOR_TYPE_UNSPECIFIED |
가속기 유형이 지정되지 않았습니다. |
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_A100_80GB |
가속기 유형은 Nvidia Tesla A100 - 80GB입니다. |
NVIDIA_L4 |
가속기 유형은 Nvidia Tesla L4입니다. |
NVIDIA_H100_80GB |
가속기 유형은 Nvidia Tesla H100 - 80GB입니다. |
NVIDIA_H100_MEGA_80GB |
가속기 유형은 Nvidia Tesla H100 - MEGA 80GB입니다. |
NVIDIA_H200_141GB |
가속기 유형은 Nvidia Tesla H200 - 141GB입니다. |
NVIDIA_TESLA_T4_VWS |
가속기 유형은 NVIDIA Tesla T4 가상 워크스테이션입니다. |
NVIDIA_TESLA_P100_VWS |
가속기 유형은 NVIDIA Tesla P100 가상 워크스테이션입니다. |
NVIDIA_TESLA_P4_VWS |
가속기 유형은 NVIDIA Tesla P4 가상 워크스테이션입니다. |
NVIDIA_B200 |
가속기 유형은 NVIDIA B200입니다. |
ServiceAccount
ID 역할을 하는 서비스 계정입니다.
| JSON 표현 |
|---|
{ "email": string, "scopes": [ string ] } |
| 필드 | |
|---|---|
email |
선택사항입니다. 서비스 계정의 이메일 주소 |
scopes[] |
출력 전용입니다. 이 서비스 계정에 사용할 수 있도록 할 범위 목록입니다. CLH에 의해 https://www.googleapis.com/auth/cloud-platform으로 설정됩니다. |
VmImage
VM에 직접 설치된 환경으로 노트북 인스턴스를 시작하기 위한 맞춤 Compute Engine 가상 머신 이미지의 정의입니다.
| JSON 표현 |
|---|
{ "project": string, // Union field |
| 필드 | |
|---|---|
project |
필수 항목입니다. 이 VM 이미지가 속한 Google Cloud 프로젝트의 이름입니다. 형식: |
통합 필드 image. 외부 Compute Engine VM 이미지를 참조합니다. image은 다음 중 하나여야 합니다. |
|
name |
선택사항입니다. VM 이미지 이름을 사용하여 이미지를 찾습니다. |
family |
선택사항입니다. 이 VM 이미지 계열을 사용하여 이미지를 찾습니다. 이 계열의 최신 이미지가 사용됩니다. |
ContainerImage
컨테이너에 설치된 환경으로 노트북 인스턴스를 시작하기 위한 컨테이너 이미지의 정의입니다.
| JSON 표현 |
|---|
{ "repository": string, "tag": string } |
| 필드 | |
|---|---|
repository |
필수 항목입니다. 컨테이너 이미지 저장소의 경로입니다. 예: |
tag |
선택사항입니다. 컨테이너 이미지의 태그입니다. 지정하지 않으면 기본적으로 최신 태그가 사용됩니다. |
BootDisk
부팅 디스크의 정의입니다.
| JSON 표현 |
|---|
{ "diskSizeGb": string, "diskType": enum ( |
| 필드 | |
|---|---|
diskSizeGb |
선택사항입니다. 이 인스턴스에 연결된 부팅 디스크의 크기(GB)입니다. 최대 64, 000GB(64TB)까지 가능합니다. 지정하지 않으면 권장 값인 150GB가 기본값으로 설정됩니다. |
diskType |
선택사항입니다. 디스크 유형을 나타냅니다. |
diskEncryption |
선택사항입니다. 입력 전용입니다. 부팅 및 데이터 디스크에 사용되는 디스크 암호화 방법입니다. 기본값은 GMEK입니다. |
kmsKey |
선택사항입니다. 입력 전용입니다. 디스크를 암호화하는 데 사용되는 KMS 키입니다. diskEncryption이 CMEK인 경우에만 적용됩니다. 형식: 자체 암호화 키 사용에 대해 자세히 알아보세요. |
DiskType
가능한 디스크 유형입니다.
| 열거형 | |
|---|---|
DISK_TYPE_UNSPECIFIED |
디스크 유형이 설정되지 않았습니다. |
PD_STANDARD |
표준 영구 디스크 유형입니다. |
PD_SSD |
SSD 영구 디스크 유형입니다. |
PD_BALANCED |
균형 있는 영구 디스크 유형입니다. |
PD_EXTREME |
익스트림 영구 디스크 유형입니다. |
HYPERDISK_BALANCED |
Hyperdisk Balanced 영구 디스크 유형을 나타냅니다. 부팅 디스크 또는 데이터 디스크로 사용할 수 있습니다. |
HYPERDISK_EXTREME |
Hyperdisk Extreme 영구 디스크 유형을 나타냅니다. 데이터 디스크로만 사용할 수 있습니다. |
HYPERDISK_THROUGHPUT |
Hyperdisk Throughput 영구 디스크 유형을 나타냅니다. 데이터 디스크로만 사용할 수 있습니다. |
HYPERDISK_BALANCED_HIGH_AVAILABILITY |
Hyperdisk Balanced High Availability 영구 디스크 유형을 나타냅니다. 부팅 디스크 또는 데이터 디스크로 사용할 수 있습니다. |
HYPERDISK_ML |
Hyperdisk ML 영구 디스크 유형을 나타냅니다. 부팅 디스크 또는 데이터 디스크로 사용할 수 있습니다. |
DiskEncryption
디스크 암호화 옵션의 정의입니다.
| 열거형 | |
|---|---|
DISK_ENCRYPTION_UNSPECIFIED |
디스크 암호화가 지정되지 않았습니다. |
GMEK |
Google 관리 암호화 키를 사용하여 부팅 디스크를 암호화합니다. |
CMEK |
고객 관리 암호화 키를 사용하여 부팅 디스크를 암호화합니다. |
DataDisk
인스턴스에 연결된 디스크 리소스입니다.
| JSON 표현 |
|---|
{ "diskSizeGb": string, "diskType": enum ( |
| 필드 | |
|---|---|
diskSizeGb |
선택사항입니다. 이 VM 인스턴스에 연결된 디스크의 크기(GB)입니다. 최대 64, 000GB(64TB)까지 가능합니다. 지정하지 않으면 기본값은 100입니다. |
diskType |
선택사항입니다. 입력 전용입니다. 디스크 유형을 나타냅니다. |
diskEncryption |
선택사항입니다. 입력 전용입니다. 부팅 및 데이터 디스크에 사용되는 디스크 암호화 방법입니다. 기본값은 GMEK입니다. |
kmsKey |
선택사항입니다. 입력 전용입니다. 디스크를 암호화하는 데 사용되는 KMS 키입니다. diskEncryption이 CMEK인 경우에만 적용됩니다. 형식: 자체 암호화 키 사용에 대해 자세히 알아보세요. |
resourcePolicies[] |
선택사항입니다. 데이터 디스크에 적용할 리소스 정책입니다. |
ShieldedInstanceConfig
보안 인스턴스 옵션 집합입니다. 지원되는 보안 VM 기능을 사용하는 이미지를 참고하세요. 일부 조합은 유효하지 않습니다.
| JSON 표현 |
|---|
{ "enableSecureBoot": boolean, "enableVtpm": boolean, "enableIntegrityMonitoring": boolean } |
| 필드 | |
|---|---|
enableSecureBoot |
선택사항입니다. VM 인스턴스에 보안 부팅이 사용 설정되어 있는지 정의합니다. 보안 부팅은 모든 부팅 구성요소의 디지털 서명을 확인하고 서명 확인에 실패할 경우 부팅 프로세스를 중지하여 시스템에서 신뢰할 수 있는 소프트웨어만 실행하도록 합니다. 기본적으로 사용 중지됩니다. |
enableVtpm |
선택사항입니다. VM 인스턴스에 vTPM이 사용 설정되어 있는지 여부를 정의합니다. |
enableIntegrityMonitoring |
선택사항입니다. VM 인스턴스에 무결성 모니터링이 사용 설정되었는지 여부를 정의합니다. VM 인스턴스의 부팅 무결성 모니터링 및 증명을 사용 설정합니다. 증명은 무결성 정책 기준에 따라 실행됩니다. 이 기준은 VM 인스턴스가 생성될 때 암시적으로 신뢰할 수 있는 부팅 이미지에서 처음 파생됩니다. |
NetworkInterface
VM에 연결된 네트워크 인터페이스 리소스의 정의입니다.
| JSON 표현 |
|---|
{ "network": string, "subnet": string, "nicType": enum ( |
| 필드 | |
|---|---|
network |
선택사항입니다. 이 VM 인스턴스가 있는 VPC의 이름입니다. 형식: |
subnet |
선택사항입니다. 이 VM 인스턴스가 있는 서브넷의 이름입니다. 형식: |
nicType |
선택사항입니다. 이 인터페이스에서 사용할 vNIC 유형입니다. gVNIC 또는 VirtioNet일 수 있습니다. |
accessConfigs[] |
선택사항입니다. 이 인터페이스의 구성 배열입니다. 현재는 액세스 구성인 ONE_TO_ONE_NAT만 지원됩니다. accessConfigs가 지정되지 않은 경우 인스턴스는 임시 외부 IP 주소를 통해 외부 인터넷에 액세스할 수 있습니다. |
NicType
vNIC 드라이버의 유형입니다. 기본값은 NIC_TYPE_UNSPECIFIED여야 합니다.
| 열거형 | |
|---|---|
NIC_TYPE_UNSPECIFIED |
유형이 지정되지 않았습니다. |
VIRTIO_NET |
VIRTIO |
GVNIC |
gVNIC |
AccessConfig
인스턴스의 네트워크 인터페이스에 연결된 액세스 구성입니다.
| JSON 표현 |
|---|
{ "externalIp": string } |
| 필드 | |
|---|---|
externalIp |
이 인스턴스에 연결된 외부 IP 주소입니다. 프로젝트에 사용할 수 있는 사용하지 않는 고정 외부 IP 주소를 지정하거나 이 필드를 정의되지 않은 상태로 두어 공유 임시 IP 주소 풀의 IP를 사용합니다. 고정 외부 IP 주소를 지정하는 경우 인스턴스의 영역과 동일한 리전에 있어야 합니다. |
GPUDriverConfig
GPU 드라이버 구성
| JSON 표현 |
|---|
{ "enableGpuDriver": boolean, "customGpuDriverPath": string } |
| 필드 | |
|---|---|
enableGpuDriver |
선택사항입니다. 최종 사용자가 Google Cloud가 이 VM 인스턴스에 GPU 드라이버를 설치하도록 승인했는지 여부입니다. 이 필드가 비어 있거나 false로 설정된 경우 GPU 드라이버가 설치되지 않습니다. GPU가 있는 인스턴스에만 적용됩니다. |
customGpuDriverPath |
선택사항입니다. GPU 드라이버가 저장된 맞춤 Cloud Storage 경로를 지정합니다. 지정하지 않으면 공식 GPU 드라이버 중에서 자동으로 선택됩니다. |
ConfidentialInstanceConfig
컨피덴셜 인스턴스 옵션 집합입니다.
| JSON 표현 |
|---|
{
"confidentialInstanceType": enum ( |
| 필드 | |
|---|---|
confidentialInstanceType |
선택사항입니다. 컨피덴셜 인스턴스에서 사용하는 기술 유형을 정의합니다. |
ConfidentialInstanceType
컨피덴셜 인스턴스의 유형입니다.
| 열거형 | |
|---|---|
CONFIDENTIAL_INSTANCE_TYPE_UNSPECIFIED |
유형이 지정되지 않았습니다. 이 값을 사용하지 마세요. |
SEV |
AMD 보안 암호화 가상화 |
주
이 인스턴스의 상태 정의입니다.
| 열거형 | |
|---|---|
STATE_UNSPECIFIED |
상태가 지정되지 않았습니다. |
STARTING |
제어 로직이 인스턴스를 시작하고 있습니다. |
PROVISIONING |
제어 로직은 필수 프레임워크를 설치하고 노트북 프록시에 인스턴스를 등록하는 것입니다. |
ACTIVE |
인스턴스가 실행 중입니다. |
STOPPING |
제어 로직이 인스턴스를 중지하고 있습니다. |
STOPPED |
인스턴스가 중지되었습니다. |
DELETED |
인스턴스가 삭제되었습니다. |
UPGRADING |
인스턴스가 업그레이드 중입니다. |
INITIALIZING |
인스턴스를 만드는 중입니다. |
SUSPENDING |
인스턴스가 정지되는 중입니다. |
SUSPENDED |
인스턴스가 정지되었습니다. |
UpgradeHistoryEntry
VM 이미지 업그레이드 기록 항목입니다.
| JSON 표현 |
|---|
{ "snapshot": string, "vmImage": string, "containerImage": string, "framework": string, "version": string, "state": enum ( |
| 필드 | |
|---|---|
snapshot |
선택사항입니다. 업그레이드 전 이 노트북 인스턴스의 부팅 디스크 스냅샷입니다. |
vmImage |
선택사항입니다. 이 인스턴스 업그레이드 전의 VM 이미지입니다. |
containerImage |
선택사항입니다. 이 인스턴스 업그레이드 전의 컨테이너 이미지입니다. |
framework |
선택사항입니다. 이 노트북 인스턴스의 프레임워크입니다. |
version |
선택사항입니다. 이 업그레이드 전의 노트북 인스턴스 버전입니다. |
state |
출력 전용입니다. 이 인스턴스 업그레이드 기록 항목의 상태입니다. |
createTime |
변경할 수 없습니다. 이 인스턴스 업그레이드 기록 항목이 생성된 시간입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 |
action |
선택사항입니다. 작업입니다. 롤백 또는 업그레이드 |
targetVersion |
선택사항입니다. 타겟 VM 버전(예: m63)입니다. |
주
이 업그레이드 기록 항목의 상태 정의입니다.
| 열거형 | |
|---|---|
STATE_UNSPECIFIED |
상태가 지정되지 않았습니다. |
STARTED |
인스턴스 업그레이드가 시작됩니다. |
SUCCEEDED |
인스턴스 업그레이드가 완료되었습니다. |
FAILED |
인스턴스 업그레이드에 실패했습니다. |
작업
이 업그레이드 기록 항목의 작업 정의입니다.
| 열거형 | |
|---|---|
ACTION_UNSPECIFIED |
작업이 지정되지 않았습니다. |
UPGRADE |
업그레이드하세요. |
ROLLBACK |
롤백 |
HealthState
인스턴스 상태입니다.
| 열거형 | |
|---|---|
HEALTH_STATE_UNSPECIFIED |
인스턴스 하위 상태를 알 수 없습니다. |
HEALTHY |
인스턴스가 정상 상태인 것으로 알려져 있습니다 (예: 중요한 데몬이 실행 중임). ACTIVE 상태에 적용됩니다. |
UNHEALTHY |
인스턴스가 비정상 상태인 것으로 알려져 있습니다 (예: 중요한 데몬이 실행되지 않음). ACTIVE 상태에 적용됩니다. |
AGENT_NOT_INSTALLED |
인스턴스에 상태 모니터링 에이전트가 설치되어 있지 않습니다. ACTIVE 상태에 적용됩니다. |
AGENT_NOT_RUNNING |
인스턴스 상태 모니터링 에이전트가 실행되고 있지 않습니다. ACTIVE 상태에 적용됩니다. |
메서드 |
|
|---|---|
|
노트북 인스턴스를 업그레이드할 수 있는지 확인합니다. |
|
특정 프로젝트 및 위치에 새 인스턴스를 만듭니다. |
|
단일 인스턴스를 삭제합니다. |
|
인스턴스가 주어지면 진단 파일을 만들고 진단 도구를 실행합니다. |
|
단일 인스턴스의 세부정보를 가져옵니다. |
|
다양한 구성 매개변수를 반환합니다. |
|
리소스의 액세스 제어 정책을 가져옵니다. |
|
특정 프로젝트 및 위치의 인스턴스를 나열합니다. |
|
UpdateInstance는 인스턴스를 업데이트합니다. |
|
노트북 인스턴스를 재설정합니다. |
|
노트북 인스턴스 디스크의 크기를 더 큰 용량으로 조정합니다. |
|
RestoreInstance는 BackupSource에서 인스턴스를 복원합니다. |
|
노트북 인스턴스를 이전 버전으로 롤백합니다. |
|
지정된 리소스의 액세스 제어 정책을 설정합니다. |
|
노트북 인스턴스를 시작합니다. |
|
메모장 인스턴스를 중지합니다. |
|
지정된 리소스에 대해 호출자가 보유한 권한을 반환합니다. |
|
노트북 인스턴스를 최신 버전으로 업그레이드합니다. |