REST Resource: projects.locations.instances

리소스: 인스턴스

노트북 인스턴스의 정의입니다.

JSON 표현
{
  "name": string,
  "proxyUri": string,
  "instanceOwners": [
    string
  ],
  "creator": string,
  "state": enum (State),
  "upgradeHistory": [
    {
      object (UpgradeHistoryEntry)
    }
  ],
  "id": string,
  "healthState": enum (HealthState),
  "healthInfo": {
    string: string,
    ...
  },
  "createTime": string,
  "updateTime": string,
  "disableProxyAccess": boolean,
  "labels": {
    string: string,
    ...
  },
  "thirdPartyProxyUrl": string,
  "satisfiesPzs": boolean,
  "satisfiesPzi": boolean,
  "enableThirdPartyIdentity": boolean,
  "enableManagedEuc": boolean,
  "enableDeletionProtection": boolean,

  // Union field infrastructure can be only one of the following:
  "gceSetup": {
    object (GceSetup)
  }
  // End of list of possible types for union field infrastructure.
}
필드
name

string

출력 전용입니다. 식별자. 이 노트북 인스턴스의 이름입니다. 형식: projects/{projectId}/locations/{location}/instances/{instanceId}

proxyUri

string

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

instanceOwners[]

string

선택사항입니다. 생성 후 이 인스턴스의 소유자입니다. 형식: alias@example.com

현재 소유자는 한 명만 지원됩니다. 지정하지 않으면 VM 인스턴스의 서비스 계정의 모든 서비스 계정 사용자가 인스턴스를 사용할 수 있습니다.

creator

string

출력 전용입니다. 원래 instances.create 요청을 보낸 법인의 이메일 주소입니다.

state

enum (State)

출력 전용입니다. 이 인스턴스의 상태입니다.

upgradeHistory[]

object (UpgradeHistoryEntry)

출력 전용입니다. 이 인스턴스의 업그레이드 내역입니다.

id

string

출력 전용입니다. 리소스의 고유 ID입니다.

healthState

enum (HealthState)

출력 전용입니다. 인스턴스 healthState입니다.

healthInfo

map (key: string, value: string)

출력 전용입니다. 인스턴스 상태에 대한 추가 정보입니다. 예:

healthInfo": {
  "docker_proxy_agent_status": "1",
  "docker_status": "1",
  "jupyterlab_api_status": "-1",
  "jupyterlab_status": "-1",
  "updated": "2020-10-18 09:40:03.573409"
}

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

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"입니다.

disableProxyAccess

boolean

선택사항입니다. true인 경우 노트북 인스턴스가 프록시에 등록되지 않습니다.

labels

map (key: string, value: string)

선택사항입니다. 이 인스턴스에 적용할 라벨입니다. 이러한 값은 나중에 instances.patch 메서드로 수정할 수 있습니다.

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

thirdPartyProxyUrl

string

출력 전용입니다. Jupyter 노트북에 액세스하는 데 사용되는 직원 풀 프록시 엔드포인트입니다.

satisfiesPzs

boolean

출력 전용입니다. 영역 분리를 위해 나중에 사용하도록 예약되어 있습니다.

satisfiesPzi

boolean

출력 전용입니다. 영역 격리를 위해 나중에 사용하도록 예약되어 있습니다.

enableThirdPartyIdentity

boolean

선택사항입니다. 서드 파티 ID 공급업체로 노트북에 액세스할 수 있음을 지정하는 플래그입니다.

enableManagedEuc

boolean

선택사항입니다. 인스턴스에 관리형 최종 사용자 인증 정보를 사용 설정하는 플래그입니다.

enableDeletionProtection

boolean

선택사항입니다. true인 경우 이 워크벤치 인스턴스에 삭제 방지가 사용 설정됩니다. false인 경우 이 워크벤치 인스턴스의 삭제 방지가 사용 중지됩니다.

통합 필드 infrastructure. 노트북 인스턴스 설정입니다. infrastructure은 다음 중 하나여야 합니다.
gceSetup

object (GceSetup)

선택사항입니다. 노트북의 Compute Engine 설정입니다. 노트북 정의 필드를 사용합니다.

GceSetup

리소스 및 ID 외부에서 VM 인스턴스를 구성하는 방법에 관한 정의입니다.

JSON 표현
{
  "machineType": string,
  "minCpuPlatform": string,
  "acceleratorConfigs": [
    {
      object (AcceleratorConfig)
    }
  ],
  "serviceAccounts": [
    {
      object (ServiceAccount)
    }
  ],
  "bootDisk": {
    object (BootDisk)
  },
  "dataDisks": [
    {
      object (DataDisk)
    }
  ],
  "shieldedInstanceConfig": {
    object (ShieldedInstanceConfig)
  },
  "networkInterfaces": [
    {
      object (NetworkInterface)
    }
  ],
  "disablePublicIp": boolean,
  "tags": [
    string
  ],
  "metadata": {
    string: string,
    ...
  },
  "enableIpForwarding": boolean,
  "gpuDriverConfig": {
    object (GPUDriverConfig)
  },
  "confidentialInstanceConfig": {
    object (ConfidentialInstanceConfig)
  },
  "instanceId": string,

  // Union field image can be only one of the following:
  "vmImage": {
    object (VmImage)
  },
  "containerImage": {
    object (ContainerImage)
  }
  // End of list of possible types for union field image.
}
필드
machineType

string

선택사항입니다. VM 인스턴스의 머신 유형입니다. https://cloud.google.com/compute/docs/machine-resource

minCpuPlatform

string

선택사항입니다. 이 인스턴스에 사용할 최소 CPU 플랫폼입니다. 유효한 값 목록은 https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform#availablezones에서 확인할 수 있습니다.

acceleratorConfigs[]

object (AcceleratorConfig)

선택사항입니다. 이 인스턴스에서 사용되는 하드웨어 가속기입니다. 가속기를 사용하는 경우 구성에 선택한 machineType를 지원할 수 있는 충분한 vCPU와 메모리가 있는지 확인하세요. 현재는 하나의 액셀러레이터 구성만 지원합니다.

serviceAccounts[]

object (ServiceAccount)

선택사항입니다. VM 인스턴스의 ID로 사용되는 서비스 계정입니다. 현재 하나의 서비스 계정만 지원합니다.

bootDisk

object (BootDisk)

선택사항입니다. VM의 부팅 디스크입니다.

dataDisks[]

object (DataDisk)

선택사항입니다. VM 인스턴스에 연결된 데이터 디스크입니다. 현재는 데이터 디스크 하나만 지원됩니다.

shieldedInstanceConfig

object (ShieldedInstanceConfig)

선택사항입니다. 보안 VM 구성입니다. 지원되는 보안 VM 기능을 사용하는 이미지

networkInterfaces[]

object (NetworkInterface)

선택사항입니다. VM의 네트워크 인터페이스입니다. 인터페이스 하나만 지원됩니다.

disablePublicIp

boolean

선택사항입니다. true인 경우 이 VM 인스턴스에 외부 IP가 할당되지 않습니다.

tags[]

string

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

metadata

map (key: string, value: string)

선택사항입니다. 이 인스턴스에 적용할 커스텀 메타데이터입니다.

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

enableIpForwarding

boolean

선택사항입니다. IP 전달을 사용 설정할지 여부를 나타내는 플래그입니다. 기본값은 false/off입니다. https://cloud.google.com/vpc/docs/using-routes#canipforward

gpuDriverConfig

object (GPUDriverConfig)

선택사항입니다. GPU 드라이버 구성

confidentialInstanceConfig

object (ConfidentialInstanceConfig)

선택사항입니다. 컨피덴셜 인스턴스 구성입니다.

instanceId

string

출력 전용입니다. Compute Engine 인스턴스 리소스의 고유 ID입니다.

통합 필드 image. 이미지 유형입니다. VM 이미지 또는 컨테이너 이미지 중 하나일 수 있습니다. image은 다음 중 하나여야 합니다.
vmImage

object (VmImage)

선택사항입니다. Compute Engine VM 이미지를 사용하여 노트북 인스턴스를 시작합니다.

containerImage

object (ContainerImage)

선택사항입니다. 컨테이너 이미지를 사용하여 노트북 인스턴스를 시작합니다.

AcceleratorConfig

VM 인스턴스의 가속기 구성입니다. 하드웨어 가속기의 정의입니다. typecoreCount 조합은 확인하지 않습니다. TPU는 지원되지 않습니다. 유효한 조합은 Compute Engine의 GPU를 참고하세요.

JSON 표현
{
  "type": enum (AcceleratorType),
  "coreCount": string
}
필드
type

enum (AcceleratorType)

선택사항입니다. 이 가속기의 유형입니다.

coreCount

string (int64 format)

선택사항입니다. 이 액셀러레이터의 코어 수입니다.

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

string

선택사항입니다. 서비스 계정의 이메일 주소

scopes[]

string

출력 전용입니다. 이 서비스 계정에 사용할 수 있도록 할 범위 목록입니다. CLH에 의해 https://www.googleapis.com/auth/cloud-platform으로 설정됩니다.

VmImage

VM에 직접 설치된 환경으로 노트북 인스턴스를 시작하기 위한 맞춤 Compute Engine 가상 머신 이미지의 정의입니다.

JSON 표현
{
  "project": string,

  // Union field image can be only one of the following:
  "name": string,
  "family": string
  // End of list of possible types for union field image.
}
필드
project

string

필수 항목입니다. 이 VM 이미지가 속한 Google Cloud 프로젝트의 이름입니다. 형식: {projectId}

통합 필드 image. 외부 Compute Engine VM 이미지를 참조합니다. image은 다음 중 하나여야 합니다.
name

string

선택사항입니다. VM 이미지 이름을 사용하여 이미지를 찾습니다.

family

string

선택사항입니다. 이 VM 이미지 계열을 사용하여 이미지를 찾습니다. 이 계열의 최신 이미지가 사용됩니다.

ContainerImage

컨테이너에 설치된 환경으로 노트북 인스턴스를 시작하기 위한 컨테이너 이미지의 정의입니다.

JSON 표현
{
  "repository": string,
  "tag": string
}
필드
repository

string

필수 항목입니다. 컨테이너 이미지 저장소의 경로입니다. 예: gcr.io/{projectId}/{imageName}

tag

string

선택사항입니다. 컨테이너 이미지의 태그입니다. 지정하지 않으면 기본적으로 최신 태그가 사용됩니다.

BootDisk

부팅 디스크의 정의입니다.

JSON 표현
{
  "diskSizeGb": string,
  "diskType": enum (DiskType),
  "diskEncryption": enum (DiskEncryption),
  "kmsKey": string
}
필드
diskSizeGb

string (int64 format)

선택사항입니다. 이 인스턴스에 연결된 부팅 디스크의 크기(GB)입니다. 최대 64, 000GB(64TB)까지 가능합니다. 지정하지 않으면 권장 값인 150GB가 기본값으로 설정됩니다.

diskType

enum (DiskType)

선택사항입니다. 디스크 유형을 나타냅니다.

diskEncryption

enum (DiskEncryption)

선택사항입니다. 입력 전용입니다. 부팅 및 데이터 디스크에 사용되는 디스크 암호화 방법입니다. 기본값은 GMEK입니다.

kmsKey

string

선택사항입니다. 입력 전용입니다. 디스크를 암호화하는 데 사용되는 KMS 키입니다. diskEncryption이 CMEK인 경우에만 적용됩니다. 형식: projects/{projectId}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{key_id}

자체 암호화 키 사용에 대해 자세히 알아보세요.

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 (DiskType),
  "diskEncryption": enum (DiskEncryption),
  "kmsKey": string,
  "resourcePolicies": [
    string
  ]
}
필드
diskSizeGb

string (int64 format)

선택사항입니다. 이 VM 인스턴스에 연결된 디스크의 크기(GB)입니다. 최대 64, 000GB(64TB)까지 가능합니다. 지정하지 않으면 기본값은 100입니다.

diskType

enum (DiskType)

선택사항입니다. 입력 전용입니다. 디스크 유형을 나타냅니다.

diskEncryption

enum (DiskEncryption)

선택사항입니다. 입력 전용입니다. 부팅 및 데이터 디스크에 사용되는 디스크 암호화 방법입니다. 기본값은 GMEK입니다.

kmsKey

string

선택사항입니다. 입력 전용입니다. 디스크를 암호화하는 데 사용되는 KMS 키입니다. diskEncryption이 CMEK인 경우에만 적용됩니다. 형식: projects/{projectId}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{key_id}

자체 암호화 키 사용에 대해 자세히 알아보세요.

resourcePolicies[]

string

선택사항입니다. 데이터 디스크에 적용할 리소스 정책입니다.

ShieldedInstanceConfig

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

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

boolean

선택사항입니다. VM 인스턴스에 보안 부팅이 사용 설정되어 있는지 정의합니다.

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

enableVtpm

boolean

선택사항입니다. VM 인스턴스에 vTPM이 사용 설정되어 있는지 여부를 정의합니다.

enableIntegrityMonitoring

boolean

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

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

NetworkInterface

VM에 연결된 네트워크 인터페이스 리소스의 정의입니다.

JSON 표현
{
  "network": string,
  "subnet": string,
  "nicType": enum (NicType),
  "accessConfigs": [
    {
      object (AccessConfig)
    }
  ]
}
필드
network

string

선택사항입니다. 이 VM 인스턴스가 있는 VPC의 이름입니다. 형식: projects/{projectId}/global/networks/{network_id}

subnet

string

선택사항입니다. 이 VM 인스턴스가 있는 서브넷의 이름입니다. 형식: projects/{projectId}/regions/{region}/subnetworks/{subnetwork_id}

nicType

enum (NicType)

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

accessConfigs[]

object (AccessConfig)

선택사항입니다. 이 인터페이스의 구성 배열입니다. 현재는 액세스 구성인 ONE_TO_ONE_NAT만 지원됩니다. accessConfigs가 지정되지 않은 경우 인스턴스는 임시 외부 IP 주소를 통해 외부 인터넷에 액세스할 수 있습니다.

NicType

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

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

AccessConfig

인스턴스의 네트워크 인터페이스에 연결된 액세스 구성입니다.

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

string

이 인스턴스에 연결된 외부 IP 주소입니다. 프로젝트에 사용할 수 있는 사용하지 않는 고정 외부 IP 주소를 지정하거나 이 필드를 정의되지 않은 상태로 두어 공유 임시 IP 주소 풀의 IP를 사용합니다. 고정 외부 IP 주소를 지정하는 경우 인스턴스의 영역과 동일한 리전에 있어야 합니다.

GPUDriverConfig

GPU 드라이버 구성

JSON 표현
{
  "enableGpuDriver": boolean,
  "customGpuDriverPath": string
}
필드
enableGpuDriver

boolean

선택사항입니다. 최종 사용자가 Google Cloud가 이 VM 인스턴스에 GPU 드라이버를 설치하도록 승인했는지 여부입니다. 이 필드가 비어 있거나 false로 설정된 경우 GPU 드라이버가 설치되지 않습니다. GPU가 있는 인스턴스에만 적용됩니다.

customGpuDriverPath

string

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

ConfidentialInstanceConfig

컨피덴셜 인스턴스 옵션 집합입니다.

JSON 표현
{
  "confidentialInstanceType": enum (ConfidentialInstanceType)
}
필드
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 (State),
  "createTime": string,
  "action": enum (Action),
  "targetVersion": string
}
필드
snapshot

string

선택사항입니다. 업그레이드 전 이 노트북 인스턴스의 부팅 디스크 스냅샷입니다.

vmImage

string

선택사항입니다. 이 인스턴스 업그레이드 전의 VM 이미지입니다.

containerImage

string

선택사항입니다. 이 인스턴스 업그레이드 전의 컨테이너 이미지입니다.

framework

string

선택사항입니다. 이 노트북 인스턴스의 프레임워크입니다.

version

string

선택사항입니다. 이 업그레이드 전의 노트북 인스턴스 버전입니다.

state

enum (State)

출력 전용입니다. 이 인스턴스 업그레이드 기록 항목의 상태입니다.

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"입니다.

action

enum (Action)

선택사항입니다. 작업입니다. 롤백 또는 업그레이드

targetVersion

string

선택사항입니다. 타겟 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 상태에 적용됩니다.

메서드

checkUpgradability

노트북 인스턴스를 업그레이드할 수 있는지 확인합니다.

create

특정 프로젝트 및 위치에 새 인스턴스를 만듭니다.

delete

단일 인스턴스를 삭제합니다.

diagnose

인스턴스가 주어지면 진단 파일을 만들고 진단 도구를 실행합니다.

get

단일 인스턴스의 세부정보를 가져옵니다.

getConfig

다양한 구성 매개변수를 반환합니다.

getIamPolicy

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

list

특정 프로젝트 및 위치의 인스턴스를 나열합니다.

patch

UpdateInstance는 인스턴스를 업데이트합니다.

reset

노트북 인스턴스를 재설정합니다.

resizeDisk

노트북 인스턴스 디스크의 크기를 더 큰 용량으로 조정합니다.

restore

RestoreInstance는 BackupSource에서 인스턴스를 복원합니다.

rollback

노트북 인스턴스를 이전 버전으로 롤백합니다.

setIamPolicy

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

start

노트북 인스턴스를 시작합니다.

stop

메모장 인스턴스를 중지합니다.

testIamPermissions

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

upgrade

노트북 인스턴스를 최신 버전으로 업그레이드합니다.