이 페이지의 일부 또는 모든 정보는 S3NS의 Cloud de Confiance에 적용되지 않을 수 있습니다. 자세한 내용은 Google Cloud와의 차이점을 참조하세요.

Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

REST Resource: projects.locations.instances

리소스: 인스턴스

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

JSON 표현

JSON 표현
{ "name": string, "postStartupScript": string, "proxyUri": string, "instanceOwners": [ string ], "serviceAccount": string, "serviceAccountScopes": [ string ], "machineType": string, "acceleratorConfig": { object (`AcceleratorConfig`) }, "state": enum (`State`), "installGpuDriver": boolean, "customGpuDriverPath": string, "bootDiskType": enum (`DiskType`), "bootDiskSizeGb": string, "dataDiskType": enum (`DiskType`), "dataDiskSizeGb": string, "noRemoveDataDisk": boolean, "diskEncryption": enum (`DiskEncryption`), "kmsKey": string, "disks": [ { object (`Disk`) } ], "shieldedInstanceConfig": { object (`ShieldedInstanceConfig`) }, "noPublicIp": boolean, "noProxyAccess": boolean, "network": string, "subnet": string, "labels": { string: string, ... }, "metadata": { string: string, ... }, "tags": [ string ], "upgradeHistory": [ { object (`UpgradeHistoryEntry`) } ], "nicType": enum (`NicType`), "reservationAffinity": { object (`ReservationAffinity`) }, "creator": string, "canIpForward": boolean, "createTime": string, "updateTime": string, "instanceMigrationEligibility": { object (`InstanceMigrationEligibility`) }, // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "vmImage": { object (`VmImage`) }, "containerImage": { object (`ContainerImage`) } // End of mutually exclusive fields. "migrated": boolean }

{
  "name": string,
  "postStartupScript": string,
  "proxyUri": string,
  "instanceOwners": [
    string
  ],
  "serviceAccount": string,
  "serviceAccountScopes": [
    string
  ],
  "machineType": string,
  "acceleratorConfig": {
    object (AcceleratorConfig)
  },
  "state": enum (State),
  "installGpuDriver": boolean,
  "customGpuDriverPath": string,
  "bootDiskType": enum (DiskType),
  "bootDiskSizeGb": string,
  "dataDiskType": enum (DiskType),
  "dataDiskSizeGb": string,
  "noRemoveDataDisk": boolean,
  "diskEncryption": enum (DiskEncryption),
  "kmsKey": string,
  "disks": [
    {
      object (Disk)
    }
  ],
  "shieldedInstanceConfig": {
    object (ShieldedInstanceConfig)
  },
  "noPublicIp": boolean,
  "noProxyAccess": boolean,
  "network": string,
  "subnet": string,
  "labels": {
    string: string,
    ...
  },
  "metadata": {
    string: string,
    ...
  },
  "tags": [
    string
  ],
  "upgradeHistory": [
    {
      object (UpgradeHistoryEntry)
    }
  ],
  "nicType": enum (NicType),
  "reservationAffinity": {
    object (ReservationAffinity)
  },
  "creator": string,
  "canIpForward": boolean,
  "createTime": string,
  "updateTime": string,
  "instanceMigrationEligibility": {
    object (InstanceMigrationEligibility)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "vmImage": {
    object (VmImage)
  },
  "containerImage": {
    object (ContainerImage)
  }
  // End of mutually exclusive fields.
  "migrated": boolean
}

필드
`name`	`string` 출력 전용입니다. 이 노트북 인스턴스의 이름입니다. 형식: `projects/{projectId}/locations/{location}/instances/{instanceId}`
`postStartupScript`	`string` 노트북 인스턴스가 완전히 부팅된 후 자동으로 실행되는 Bash 스크립트의 경로입니다. 경로는 URL 또는 Cloud Storage 경로 (`gs://path-to-file/file-name`)여야 합니다.
`proxyUri`	`string` 출력 전용입니다. Jupyter 노트북에 액세스하는 데 사용되는 프록시 엔드포인트입니다.
`instanceOwners[]`	`string` 입력 전용입니다. 생성 후 이 인스턴스의 소유자입니다. 형식: `alias@example.com` 현재 소유자는 한 명만 지원됩니다. 지정하지 않으면 VM 인스턴스의 서비스 계정의 모든 서비스 계정 사용자가 인스턴스를 사용할 수 있습니다.
`serviceAccount`	`string` 이 인스턴스의 서비스 계정으로, 다른 Google Cloud 서비스에 대한 액세스 권한을 제공합니다. 동일한 프로젝트 내에서 서비스 계정을 사용할 수 있지만 인스턴스를 사용하려면 서비스 계정 사용자 권한이 있어야 합니다. 지정하지 않으면 Compute Engine 기본 서비스 계정이 사용됩니다.
`serviceAccountScopes[]`	`string` (선택사항) Compute Engine 인스턴스에 포함할 서비스 계정 범위의 URI입니다. 지정하지 않으면 다음 범위가 정의됩니다. - https://www.googleapis.com/auth/cloud-platform - https://www.googleapis.com/auth/userinfo.email 기본 범위를 사용하지 않는 경우 최소한 https://www.googleapis.com/auth/compute가 필요합니다.
`machineType`	`string` 필수 항목입니다. 이 인스턴스의 Compute Engine 머신 유형입니다.
`acceleratorConfig`	`object (AcceleratorConfig)` 이 인스턴스에서 사용되는 하드웨어 가속기입니다. 액셀러레이터를 사용하는 경우 구성에 선택한 `machineType`를 지원할 수 있는 충분한 vCPU와 메모리가 있는지 확인하세요.
`state`	`enum (State)` 출력 전용입니다. 이 인스턴스의 상태입니다.
`installGpuDriver`	`boolean` 최종 사용자가 Google Cloud에서 이 인스턴스에 GPU 드라이버를 설치하도록 승인했는지 여부입니다. 이 필드가 비어 있거나 false로 설정된 경우 GPU 드라이버가 설치되지 않습니다. GPU가 있는 인스턴스에만 적용됩니다.
`customGpuDriverPath`	`string` GPU 드라이버가 저장된 맞춤 Cloud Storage 경로를 지정합니다. 지정하지 않으면 공식 GPU 드라이버 중에서 자동으로 선택됩니다.
`bootDiskType`	`enum (DiskType)` 입력 전용입니다. 이 인스턴스에 연결된 부팅 디스크의 유형입니다. 기본값은 표준 영구 디스크 (`PD_STANDARD`)입니다.
`bootDiskSizeGb`	`string (int64 format)` 입력 전용입니다. 이 인스턴스에 연결된 부팅 디스크의 크기(GB)입니다. 최대 64, 000GB(64TB)까지 가능합니다. 권장되는 최소값은 100GB입니다. 지정하지 않으면 기본값은 100입니다.
`dataDiskType`	`enum (DiskType)` 입력 전용입니다. 이 인스턴스에 연결된 데이터 디스크의 유형입니다. 기본값은 표준 영구 디스크 (`PD_STANDARD`)입니다.
`dataDiskSizeGb`	`string (int64 format)` 입력 전용입니다. 이 인스턴스에 연결된 데이터 디스크의 크기(GB)입니다. 최대 64, 000GB(64TB)까지 가능합니다. 노트북과 데이터의 크기에 따라 데이터 디스크의 크기를 선택할 수 있습니다. 지정하지 않으면 기본값은 100입니다.
`noRemoveDataDisk`	`boolean` 입력 전용입니다. true인 경우 인스턴스를 삭제할 때 데이터 디스크가 자동 삭제되지 않습니다.
`diskEncryption`	`enum (DiskEncryption)` 입력 전용입니다. 부팅 및 데이터 디스크에 사용되는 디스크 암호화 방법입니다. 기본값은 GMEK입니다.
`kmsKey`	`string` 입력 전용입니다. 디스크를 암호화하는 데 사용되는 KMS 키입니다. diskEncryption이 CMEK인 경우에만 적용됩니다. 형식: `projects/{projectId}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{key_id}` 자체 암호화 키 사용에 대해 자세히 알아보세요.
`disks[]`	`object (Disk)` 출력 전용입니다. 노트북 인스턴스에 디스크가 연결되었습니다.
`shieldedInstanceConfig`	`object (ShieldedInstanceConfig)` (선택사항) 보안 VM 구성입니다. 지원되는 보안 VM 기능을 사용하는 이미지
`noPublicIp`	`boolean` true인 경우 이 인스턴스에 외부 IP가 할당되지 않습니다.
`noProxyAccess`	`boolean` true인 경우 노트북 인스턴스가 프록시에 등록되지 않습니다.
`network`	`string` 이 인스턴스가 있는 VPC의 이름입니다. 형식: `projects/{projectId}/global/networks/{network_id}`
`subnet`	`string` 이 인스턴스가 있는 서브넷의 이름입니다. 형식: `projects/{projectId}/regions/{region}/subnetworks/{subnetwork_id}`
`labels`	`map (key: string, value: string)` 이 인스턴스에 적용할 라벨입니다. 이러한 값은 나중에 setLabels 메서드로 수정할 수 있습니다. `"key": value` 쌍 목록을 포함하는 객체입니다. 예: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`
`metadata`	`map (key: string, value: string)` 이 인스턴스에 적용할 커스텀 메타데이터입니다. 예를 들어 자동 백업용 Cloud Storage 버킷을 지정하려면 `gcs-data-bucket` 메타데이터 태그를 사용하면 됩니다. 형식은 `"--metadata=gcs-data-bucket=BUCKET"`입니다. `"key": value` 쌍 목록을 포함하는 객체입니다. 예: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`
`tags[]`	`string` (선택사항) 런타임에 추가할 Compute Engine 네트워크 태그입니다 (네트워크 태그 추가 참고).
`upgradeHistory[]`	`object (UpgradeHistoryEntry)` 이 인스턴스의 업그레이드 기록입니다.
`nicType`	`enum (NicType)` (선택사항) 이 인터페이스에서 사용할 vNIC 유형입니다. gVNIC 또는 VirtioNet일 수 있습니다.
`reservationAffinity`	`object (ReservationAffinity)` (선택사항) 선택적 예약 어피니티입니다. 이 필드를 설정하면 지정된 영역 Compute 예약이 이 노트북 인스턴스에 적용됩니다.
`creator`	`string` 출력 전용입니다. 원래 instances.create 요청을 보낸 법인의 이메일 주소입니다.
`canIpForward`	`boolean` (선택사항) IP 전달을 사용 설정할지 여부를 나타내는 플래그입니다. 기본값은 false/off입니다. https://cloud.google.com/vpc/docs/using-routes#canipforward
`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"`입니다.
`instanceMigrationEligibility`	`object (InstanceMigrationEligibility)` 출력 전용입니다. UmN에서 WbI로의 마이그레이션 가능성을 확인합니다.
환경 유형입니다. VM 이미지 또는 컨테이너 이미지 중 하나일 수 있습니다. 다음은 상호 배타적인 필드의 목록입니다. 응답에는 다음 필드 중 최대 하나가 설정됩니다.
`vmImage`	`object (VmImage)` Compute Engine VM 이미지를 사용하여 노트북 인스턴스를 시작합니다.
`containerImage`	`object (ContainerImage)` 컨테이너 이미지를 사용하여 노트북 인스턴스를 시작합니다.
상호 배타적 필드의 끝입니다.
`migrated`	`boolean` 출력 전용입니다. 이 노트북이 Workbench 인스턴스로 마이그레이션되었는지 여부를 나타내는 불리언

AcceleratorConfig

하드웨어 가속기의 정의입니다. type 및 coreCount의 모든 조합이 유효한 것은 아닙니다. 유효한 조합을 확인하려면 Compute Engine의 GPU를 참고하세요. TPU는 지원되지 않습니다.

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

필드

필드
`type`	`enum (AcceleratorType)` 이 가속기의 유형입니다.
`coreCount`	`string (int64 format)` 이 액셀러레이터의 코어 수입니다.

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입니다.
`NVIDIA_L4`	가속기 유형은 Nvidia Tesla L4입니다.
`NVIDIA_A100_80GB`	가속기 유형은 Nvidia Tesla A100 80GB입니다.
`NVIDIA_TESLA_T4_VWS`	가속기 유형은 NVIDIA Tesla T4 가상 워크스테이션입니다.
`NVIDIA_TESLA_P100_VWS`	가속기 유형은 NVIDIA Tesla P100 가상 워크스테이션입니다.
`NVIDIA_TESLA_P4_VWS`	가속기 유형은 NVIDIA Tesla P4 가상 워크스테이션입니다.
`NVIDIA_H100_80GB`	가속기 유형은 NVIDIA H100 80GB입니다.
`NVIDIA_H100_MEGA_80GB`	가속기 유형은 NVIDIA H100 Mega 80GB입니다.
`TPU_V2`	(출시 예정) 가속기 유형은 TPU V2입니다.
`TPU_V3`	(출시 예정) 가속기 유형은 TPU V3입니다.

주

이 인스턴스의 상태 정의입니다.

열거형
`STATE_UNSPECIFIED`	상태가 지정되지 않았습니다.
`STARTING`	제어 로직이 인스턴스를 시작하고 있습니다.
`PROVISIONING`	제어 로직은 필수 프레임워크를 설치하고 노트북 프록시에 인스턴스를 등록하는 것입니다.
`ACTIVE`	인스턴스가 실행 중입니다.
`STOPPING`	제어 로직이 인스턴스를 중지하고 있습니다.
`STOPPED`	인스턴스가 중지되었습니다.
`DELETED`	인스턴스가 삭제되었습니다.
`UPGRADING`	인스턴스를 업그레이드하는 중입니다.
`INITIALIZING`	인스턴스를 만드는 중입니다.
`REGISTERING`	인스턴스가 등록되고 있습니다.
`SUSPENDING`	인스턴스가 정지되는 중입니다.
`SUSPENDED`	인스턴스가 정지되었습니다.

DiskType

노트북 인스턴스에 사용할 수 있는 디스크 유형입니다.

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

DiskEncryption

디스크 암호화 옵션의 정의입니다.

열거형
`DISK_ENCRYPTION_UNSPECIFIED`	디스크 암호화가 지정되지 않았습니다.
`GMEK`	Google 관리 암호화 키를 사용하여 부팅 디스크를 암호화합니다.
`CMEK`	고객 관리 암호화 키를 사용하여 부팅 디스크를 암호화합니다.

디스크

인스턴스에 연결된 디스크 리소스입니다.

JSON 표현

JSON 표현
{ "autoDelete": boolean, "boot": boolean, "deviceName": string, "diskSizeGb": string, "guestOsFeatures": [ { object (`GuestOsFeature`) } ], "index": string, "interface": string, "kind": string, "licenses": [ string ], "mode": string, "source": string, "type": string }

{
  "autoDelete": boolean,
  "boot": boolean,
  "deviceName": string,
  "diskSizeGb": string,
  "guestOsFeatures": [
    {
      object (GuestOsFeature)
    }
  ],
  "index": string,
  "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에서 할당한 번호입니다. 이 필드는 영구 디스크에만 적용됩니다.
`diskSizeGb`	`string (int64 format)` 디스크 크기를 2진수 GB로 나타냅니다.
`guestOsFeatures[]`	`object (GuestOsFeature)` 게스트 운영체제에서 사용 설정할 기능 목록을 나타냅니다. 부팅 가능한 이미지에만 적용됩니다. 게스트 운영체제 기능 사용 설정을 읽고 사용 가능한 옵션 목록을 확인하세요.
`index`	`string (int64 format)` 이 디스크의 0부터 시작하는 색인입니다. 0은 부팅 디스크용으로 예약되어 있습니다. 인스턴스에 연결된 디스크가 많은 경우 각 디스크에는 고유한 색인 번호가 있습니다.
`interface`	`string` 이 디스크를 연결하는 데 사용할 디스크 인터페이스를 나타냅니다(SCSI 또는 NVME). 기본값은 SCSI입니다. 영구 디스크는 항상 SCSI를 사용해야 하며 SCSI 이외의 형식으로 영구 디스크를 연결하려고 하면 요청이 실패합니다. 로컬 SSD는 NVME 또는 SCSI를 사용할 수 있습니다. NVMe를 통한 SCSI의 성능 특성은 로컬 SSD 성능을 참고하세요. 유효한 값: `NVME` `SCSI`
`kind`	`string` 리소스 유형입니다. 연결된 디스크의 경우 항상 compute#attachedDisk를 계산합니다.
`licenses[]`	`string` 공개적으로 표시되는 라이선스 목록입니다. Google에서 사용하도록 예약되어 있습니다. 라이선스는 공개 및 마켓 이미지의 청구 및 집계 사용량 데이터를 나타냅니다.
`mode`	`string` 이 디스크를 연결할 모드입니다(`READ_WRITE` 또는 `READ_ONLY`). 지정하지 않으면 기본적으로 `READ_WRITE` 모드로 디스크가 연결됩니다. 유효한 값: `READ_ONLY` `READ_WRITE`
`source`	`string` 기존 영구 디스크 리소스의 유효한 부분 또는 전체 URL을 나타냅니다.
`type`	`string` 디스크 유형(`SCRATCH` 또는 `PERSISTENT`)을 나타냅니다. 유효한 값: `PERSISTENT` `SCRATCH`

GuestOsFeature

부팅 디스크의 게스트 OS 기능입니다.

JSON 표현
{ "type": string }

필드

필드
`type`	`string` 지원되는 기능의 ID입니다. 게스트 운영체제 기능 사용 설정을 읽고 사용 가능한 옵션 목록을 확인하세요. 유효한 값: `FEATURE_TYPE_UNSPECIFIED` `MULTI_IP_SUBNET` `SECURE_BOOT` `UEFI_COMPATIBLE` `VIRTIO_SCSI_MULTIQUEUE` `WINDOWS`

type

string

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

FEATURE_TYPE_UNSPECIFIED
MULTI_IP_SUBNET
SECURE_BOOT
UEFI_COMPATIBLE
VIRTIO_SCSI_MULTIQUEUE
WINDOWS

ShieldedInstanceConfig

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

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

필드

필드
`enableSecureBoot`	`boolean` 인스턴스에 보안 부팅이 사용 설정되었는지 여부를 정의합니다. 보안 부트에서는 모든 부팅 구성요소의 디지털 서명을 확인하고 서명 확인에 실패할 경우 부팅 프로세스를 중단하여 시스템에서 인증된 소프트웨어만 실행하도록 보장합니다. 기본적으로 사용 중지됩니다.
`enableVtpm`	`boolean` 인스턴스에 vTPM이 사용 설정되었는지 여부를 정의합니다. 기본적으로 사용 설정됩니다.
`enableIntegrityMonitoring`	`boolean` 인스턴스에 무결성 모니터링이 사용 설정되었는지 여부를 정의합니다. 인스턴스의 부팅 무결성 모니터링 및 증명을 사용 설정합니다. 증명은 무결성 정책 기준에 대해 실행됩니다. 이 기준은 인스턴스가 생성될 때 암시적으로 신뢰할 수 있는 부팅 이미지에서 처음 파생됩니다. 기본적으로 사용 설정됩니다.

enableSecureBoot

boolean

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

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

enableVtpm

boolean

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

enableIntegrityMonitoring

boolean

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

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

UpgradeHistoryEntry

VM 이미지 업그레이드 기록 항목입니다.

JSON 표현

JSON 표현
{ "snapshot": string, "vmImage": string, "containerImage": string, "framework": string, "version": string, "state": enum (`State`), "createTime": string, "targetImage": string, "action": enum (`Action`), "targetVersion": string }

{
  "snapshot": string,
  "vmImage": string,
  "containerImage": string,
  "framework": string,
  "version": string,
  "state": enum (State),
  "createTime": string,
  "targetImage": 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"`입니다.
`targetImage (deprecated)`	`string` 이 항목은 지원 중단되었습니다. 타겟 VM 이미지입니다. 형식은 `ainotebooks-vm/project/image-name/name`입니다.
`action`	`enum (Action)` 작업입니다. 롤백 또는 업그레이드
`targetVersion`	`string` 타겟 VM 버전(예: m63)

주

이 업그레이드 기록 항목의 상태 정의입니다.

열거형
`STATE_UNSPECIFIED`	상태가 지정되지 않았습니다.
`STARTED`	인스턴스 업그레이드가 시작되었습니다.
`SUCCEEDED`	인스턴스 업그레이드에 성공했습니다.
`FAILED`	인스턴스 업그레이드에 실패했습니다.

작업

이 업그레이드 기록 항목의 작업 정의입니다.

열거형
`ACTION_UNSPECIFIED`	작업이 지정되지 않았습니다.
`UPGRADE`	업그레이드하세요.
`ROLLBACK`	롤백

NicType

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

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

ReservationAffinity

영역 예약 사용을 위한 예약 어피니티입니다.

JSON 표현
{ "consumeReservationType": enum (`Type`), "key": string, "values": [ string ] }

필드

필드
`consumeReservationType`	`enum (Type)` (선택사항) 사용할 예약 유형
`key`	`string` (선택사항) 예약 리소스의 라벨 키에 해당합니다.
`values[]`	`string` (선택사항) 예약 리소스의 라벨 값에 해당합니다.

consumeReservationType

enum (Type)

(선택사항) 사용할 예약 유형

key

string

(선택사항) 예약 리소스의 라벨 키에 해당합니다.

values[]

string

(선택사항) 예약 리소스의 라벨 값에 해당합니다.

유형

예약에서 용량을 사용할지 여부를 나타냅니다.

열거형
`TYPE_UNSPECIFIED`	기본 유형입니다.
`NO_RESERVATION`	할당된 용량을 사용하지 않습니다.
`ANY_RESERVATION`	사용 가능한 예약을 사용합니다.
`SPECIFIC_RESERVATION`	특정 예약에서 사용해야 합니다. 예약을 지정하기 위한 키 값 필드를 지정해야 합니다.

InstanceMigrationEligibility

InstanceMigrationEligibility는 UmN에서 WbI로의 마이그레이션 가능성 정보를 나타냅니다.

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

필드

필드
`warnings[]`	`enum (Warning)` 출력 전용입니다. 마이그레이션 중에 특정 구성이 기본값으로 설정됩니다.
`errors[]`	`enum (Error)` 출력 전용입니다. 특정 구성에서는 UmN을 자동으로 이전할 수 없습니다. 수동 마이그레이션이 필요합니다.

warnings[]

enum (Warning)

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

errors[]

enum (Error)

출력 전용입니다. 특정 구성에서는 UmN을 자동으로 이전할 수 없습니다. 수동 마이그레이션이 필요합니다.

경고

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

열거형
`WARNING_UNSPECIFIED`	기본 유형입니다.
`UNSUPPORTED_MACHINE_TYPE`	UmN이 WbI에서 지원되지 않는 머신 유형을 사용합니다. 기본 머신 유형 e2-standard-4로 마이그레이션됩니다. 마이그레이션 후 사용자가 머신 유형을 변경할 수 있습니다.
`UNSUPPORTED_ACCELERATOR_TYPE`	UmN이 WbI에서 지원되지 않는 가속기 유형을 사용합니다. 가속기 없이 마이그레이션됩니다. 사용자는 마이그레이션 후 가속기를 연결할 수 있습니다.
`UNSUPPORTED_OS`	UmN이 WbI에서 지원되지 않는 운영체제 (예: Debian 10, Ubuntu)를 사용합니다. WbI에서는 Debian 11로 대체됩니다.
`NO_REMOVE_DATA_DISK`	이 UmN은 WbI에서 더 이상 사용할 수 없는 noRemoveDataDisk로 구성되어 있습니다.
`GCS_BACKUP`	이 UmN은 더 이상 WbI에서 사용할 수 없는 Cloud Storage 백업 기능으로 구성되어 있습니다.
`POST_STARTUP_SCRIPT`	이 UmN은 시작 스크립트 후 스크립트로 구성됩니다. 선택적으로 마이그레이션의 `postStartupScriptOption`를 제공하세요.

오류

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

열거형
`ERROR_UNSPECIFIED`	기본 유형입니다.
`DATAPROC_HUB`	UmN은 Dataproc Hub를 사용하며 이전할 수 없습니다.

메서드
`create`	특정 프로젝트 및 위치에 새 인스턴스를 만듭니다.
`delete`	단일 인스턴스를 삭제합니다.
`diagnose`	인스턴스가 주어지면 진단 파일을 만들고 진단 도구를 실행합니다.
`get`	단일 인스턴스의 세부정보를 가져옵니다.
`getIamPolicy`	리소스의 액세스 제어 정책을 가져옵니다.
`getInstanceHealth`	노트북 인스턴스가 정상인지 확인합니다.
`isUpgradeable`	노트북 인스턴스를 업그레이드할 수 있는지 확인합니다.
`list`	특정 프로젝트 및 위치의 인스턴스를 나열합니다.
`migrate`	기존 사용자 관리 노트북을 Workbench 인스턴스로 마이그레이션합니다.
`register`	기존 기존 노트북 인스턴스를 Notebooks API 서버에 등록합니다.
`report`	노트북 인스턴스가 최신 인스턴스 정보를 Notebooks API 서버에 보고하도록 허용합니다.
`reset`	노트북 인스턴스를 재설정합니다.
`rollback`	노트북 인스턴스를 이전 버전으로 롤백합니다.
`setAccelerator`	단일 인스턴스의 게스트 액셀러레이터를 업데이트합니다.
`setIamPolicy`	지정된 리소스의 액세스 제어 정책을 설정합니다.
`setLabels`	인스턴스의 모든 라벨을 바꿉니다.
`setMachineType`	단일 인스턴스의 머신 유형을 업데이트합니다.
`start`	노트북 인스턴스를 시작합니다.
`stop`	노트북 인스턴스를 중지합니다.
`testIamPermissions`	지정된 리소스에 대해 호출자가 보유한 권한을 반환합니다.
`updateConfig`	노트북 인스턴스 구성을 업데이트합니다.
`updateMetadataItems`	인스턴스의 메타데이터 항목을 추가/업데이트합니다.
`updateShieldedInstanceConfig`	단일 인스턴스의 보안 인스턴스 구성을 업데이트합니다.
`upgrade`	노트북 인스턴스를 최신 버전으로 업그레이드합니다.

REST Resource: projects.locations.instances

리소스: 인스턴스

AcceleratorConfig

AcceleratorType

주

DiskType

DiskEncryption

디스크

GuestOsFeature

ShieldedInstanceConfig

UpgradeHistoryEntry

주

작업

NicType

ReservationAffinity

유형

InstanceMigrationEligibility

경고

오류

메서드