update all APIs

Like documented in the README

```
rm -f .api.deps .cli.deps && FETCH_APIS=1 make update-json -j8
```
This commit is contained in:
Sebastian Thiel
2024-03-05 18:54:36 +01:00
parent 8a12e9d47e
commit ca974aa0a5
347 changed files with 202580 additions and 50157 deletions

View File

@@ -395,7 +395,7 @@
],
"parameters": {
"filter": {
"description": "Filter applied to resulting executions. Currently only supports filtering executions by a specified schedule_id. Format: `schedule_id=`",
"description": "Filter applied to resulting executions. Currently only supports filtering executions by a specified `schedule_id`. Format: `schedule_id=`",
"location": "query",
"type": "string"
},
@@ -578,7 +578,7 @@
]
},
"getInstanceHealth": {
"description": "Check if a notebook instance is healthy.",
"description": "Checks whether a notebook instance is healthy.",
"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:getInstanceHealth",
"httpMethod": "GET",
"id": "notebooks.projects.locations.instances.getInstanceHealth",
@@ -603,7 +603,7 @@
]
},
"isUpgradeable": {
"description": "Check if a notebook instance is upgradable.",
"description": "Checks whether a notebook instance is upgradable.",
"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:isUpgradeable",
"httpMethod": "GET",
"id": "notebooks.projects.locations.instances.isUpgradeable",
@@ -655,6 +655,16 @@
"parent"
],
"parameters": {
"filter": {
"description": "Optional. List filter.",
"location": "query",
"type": "string"
},
"orderBy": {
"description": "Optional. Sort results. Supported values are \"name\", \"name desc\" or \"\" (unsorted).",
"location": "query",
"type": "string"
},
"pageSize": {
"description": "Maximum return size of the list call.",
"format": "int32",
@@ -682,6 +692,34 @@
"https://www.googleapis.com/auth/cloud-platform"
]
},
"migrate": {
"description": "Migrates an existing User-Managed Notebook to Workbench Instances.",
"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:migrate",
"httpMethod": "POST",
"id": "notebooks.projects.locations.instances.migrate",
"parameterOrder": [
"name"
],
"parameters": {
"name": {
"description": "Required. Format: `projects/{project_id}/locations/{location}/instances/{instance_id}`",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v1/{+name}:migrate",
"request": {
"$ref": "MigrateInstanceRequest"
},
"response": {
"$ref": "Operation"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
},
"register": {
"description": "Registers an existing legacy notebook instance to the Notebooks API server. Legacy instances are instances created with the legacy Compute Engine calls. They are not manageable by the Notebooks API out of the box. This call makes these instances manageable by the Notebooks API.",
"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/instances:register",
@@ -738,6 +776,34 @@
"https://www.googleapis.com/auth/cloud-platform"
]
},
"reportEvent": {
"description": "Reports and processes an instance event.",
"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:reportEvent",
"httpMethod": "POST",
"id": "notebooks.projects.locations.instances.reportEvent",
"parameterOrder": [
"name"
],
"parameters": {
"name": {
"description": "Required. Format: `projects/{project_id}/locations/{location}/instances/{instance_id}`",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v1/{+name}:reportEvent",
"request": {
"$ref": "ReportInstanceEventRequest"
},
"response": {
"$ref": "Operation"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
},
"reset": {
"description": "Resets a notebook instance.",
"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:reset",
@@ -1213,7 +1279,7 @@
]
},
"list": {
"description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name` binding allows API services to override the binding to use different resource name schemes, such as `users/*/operations`. To override the binding, API services can add a binding such as `\"/v1/{name=users/*}/operations\"` to their service configuration. For backwards compatibility, the default name includes the operations collection id, however overriding users must ensure the name binding is the parent resource, without the operations collection id.",
"description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.",
"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations",
"httpMethod": "GET",
"id": "notebooks.projects.locations.operations.list",
@@ -1418,6 +1484,16 @@
"parent"
],
"parameters": {
"filter": {
"description": "Optional. List filter.",
"location": "query",
"type": "string"
},
"orderBy": {
"description": "Optional. Sort results. Supported values are \"name\", \"name desc\" or \"\" (unsorted).",
"location": "query",
"type": "string"
},
"pageSize": {
"description": "Maximum return size of the list call.",
"format": "int32",
@@ -1445,6 +1521,34 @@
"https://www.googleapis.com/auth/cloud-platform"
]
},
"migrate": {
"description": "Migrate an existing Runtime to a new Workbench Instance.",
"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/runtimes/{runtimesId}:migrate",
"httpMethod": "POST",
"id": "notebooks.projects.locations.runtimes.migrate",
"parameterOrder": [
"name"
],
"parameters": {
"name": {
"description": "Required. Format: `projects/{project_id}/locations/{location}/runtimes/{runtime_id}`",
"location": "path",
"pattern": "^projects/[^/]+/locations/[^/]+/runtimes/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v1/{+name}:migrate",
"request": {
"$ref": "MigrateRuntimeRequest"
},
"response": {
"$ref": "Operation"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
},
"patch": {
"description": "Update Notebook Runtime configuration.",
"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/runtimes/{runtimesId}",
@@ -1467,7 +1571,7 @@
"type": "string"
},
"updateMask": {
"description": "Required. Specifies the path, relative to `Runtime`, of the field to update. For example, to change the software configuration kernels, the `update_mask` parameter would be specified as `software_config.kernels`, and the `PATCH` request body would specify the new value, as follows: { \"software_config\":{ \"kernels\": [{ 'repository': 'gcr.io/deeplearning-platform-release/pytorch-gpu', 'tag': 'latest' }], } } Currently, only the following fields can be updated: - software_config.kernels - software_config.post_startup_script - software_config.custom_gpu_driver_path - software_config.idle_shutdown - software_config.idle_shutdown_timeout - software_config.disable_terminal",
"description": "Required. Specifies the path, relative to `Runtime`, of the field to update. For example, to change the software configuration kernels, the `update_mask` parameter would be specified as `software_config.kernels`, and the `PATCH` request body would specify the new value, as follows: { \"software_config\":{ \"kernels\": [{ 'repository': 'gcr.io/deeplearning-platform-release/pytorch-gpu', 'tag': 'latest' }], } } Currently, only the following fields can be updated: - `software_config.kernels` - `software_config.post_startup_script` - `software_config.custom_gpu_driver_path` - `software_config.idle_shutdown` - `software_config.idle_shutdown_timeout` - `software_config.disable_terminal` - `labels`",
"format": "google-fieldmask",
"location": "query",
"type": "string"
@@ -1513,7 +1617,7 @@
]
},
"reportEvent": {
"description": "Report and process a runtime event.",
"description": "Reports and processes a runtime event.",
"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/runtimes/{runtimesId}:reportEvent",
"httpMethod": "POST",
"id": "notebooks.projects.locations.runtimes.reportEvent",
@@ -1904,11 +2008,11 @@
}
}
},
"revision": "20221213",
"revision": "20231227",
"rootUrl": "https://notebooks.googleapis.com/",
"schemas": {
"AcceleratorConfig": {
"description": "Definition of a hardware accelerator. Note that not all combinations of `type` and `core_count` are valid. Check [GPUs on Compute Engine](/compute/docs/gpus/#gpus-list) to find a valid combination. TPUs are not supported.",
"description": "Definition of a hardware accelerator. Note that not all combinations of `type` and `core_count` are valid. See [GPUs on Compute Engine](https://cloud.google.com/compute/docs/gpus/#gpus-list) to find a valid combination. TPUs are not supported.",
"id": "AcceleratorConfig",
"properties": {
"coreCount": {
@@ -1926,6 +2030,7 @@
"NVIDIA_TESLA_P4",
"NVIDIA_TESLA_T4",
"NVIDIA_TESLA_A100",
"NVIDIA_L4",
"NVIDIA_TESLA_T4_VWS",
"NVIDIA_TESLA_P100_VWS",
"NVIDIA_TESLA_P4_VWS",
@@ -1940,6 +2045,7 @@
"Accelerator type is Nvidia Tesla P4.",
"Accelerator type is Nvidia Tesla T4.",
"Accelerator type is Nvidia Tesla A100.",
"Accelerator type is Nvidia Tesla L4.",
"Accelerator type is NVIDIA Tesla T4 Virtual Workstations.",
"Accelerator type is NVIDIA Tesla P100 Virtual Workstations.",
"Accelerator type is NVIDIA Tesla P4 Virtual Workstations.",
@@ -1960,7 +2066,7 @@
"description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)."
},
"members": {
"description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ",
"description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.",
"items": {
"type": "string"
},
@@ -2018,6 +2124,11 @@
"diagnosticConfig": {
"$ref": "DiagnosticConfig",
"description": "Required. Defines flags that are used to run the diagnostic tool"
},
"timeoutMinutes": {
"description": "Optional. Maxmium amount of time in minutes before the operation times out.",
"format": "int32",
"type": "integer"
}
},
"type": "object"
@@ -2029,6 +2140,11 @@
"diagnosticConfig": {
"$ref": "DiagnosticConfig",
"description": "Required. Defines flags that are used to run the diagnostic tool"
},
"timeoutMinutes": {
"description": "Optional. Maxmium amount of time in minutes before the operation times out.",
"format": "int32",
"type": "integer"
}
},
"type": "object"
@@ -2073,7 +2189,7 @@
"type": "boolean"
},
"deviceName": {
"description": "Indicates a unique device name of your choice that is reflected into the /dev/disk/by-id/google-* tree of a Linux operating system running within the instance. This name can be used to reference the device for mounting, resizing, and so on, from within the instance. If not specified, the server chooses a default device name to apply to this disk, in the form persistent-disk-x, where x is a number assigned by Google Compute Engine.This field is only applicable for persistent disks.",
"description": "Indicates a unique device name of your choice that is reflected into the `/dev/disk/by-id/google-*` tree of a Linux operating system running within the instance. This name can be used to reference the device for mounting, resizing, and so on, from within the instance. If not specified, the server chooses a default device name to apply to this disk, in the form persistent-disk-x, where x is a number assigned by Google Compute Engine.This field is only applicable for persistent disks.",
"type": "string"
},
"diskSizeGb": {
@@ -2094,7 +2210,7 @@
"type": "string"
},
"interface": {
"description": "Indicates the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance. Valid values: * NVME * SCSI",
"description": "Indicates the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance. Valid values: * `NVME` * `SCSI`",
"type": "string"
},
"kind": {
@@ -2109,7 +2225,7 @@
"type": "array"
},
"mode": {
"description": "The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode. Valid values: * READ_ONLY * READ_WRITE",
"description": "The mode in which to attach this disk, either `READ_WRITE` or `READ_ONLY`. If not specified, the default is to attach the disk in `READ_WRITE` mode. Valid values: * `READ_ONLY` * `READ_WRITE`",
"type": "string"
},
"source": {
@@ -2117,7 +2233,7 @@
"type": "string"
},
"type": {
"description": "Indicates the type of the disk, either SCRATCH or PERSISTENT. Valid values: * PERSISTENT * SCRATCH",
"description": "Indicates the type of the disk, either `SCRATCH` or `PERSISTENT`. Valid values: * `PERSISTENT` * `SCRATCH`",
"type": "string"
}
},
@@ -2352,6 +2468,7 @@
"type": "string"
},
"scaleTier": {
"deprecated": true,
"description": "Required. Scale tier of the hardware used for notebook execution. DEPRECATED Will be discontinued. As right now only CUSTOM is supported.",
"enum": [
"SCALE_TIER_UNSPECIFIED",
@@ -2450,7 +2567,7 @@
"id": "GuestOsFeature",
"properties": {
"type": {
"description": "The ID of a supported feature. Read Enabling guest operating system features to see a list of available options. Valid values: * FEATURE_TYPE_UNSPECIFIED * MULTI_IP_SUBNET * SECURE_BOOT * UEFI_COMPATIBLE * VIRTIO_SCSI_MULTIQUEUE * WINDOWS",
"description": "The ID of a supported feature. Read Enabling guest operating system features to see a list of available options. Valid values: * `FEATURE_TYPE_UNSPECIFIED` * `MULTI_IP_SUBNET` * `SECURE_BOOT` * `UEFI_COMPATIBLE` * `VIRTIO_SCSI_MULTIQUEUE` * `WINDOWS`",
"type": "string"
}
},
@@ -2462,7 +2579,7 @@
"properties": {
"acceleratorConfig": {
"$ref": "AcceleratorConfig",
"description": "The hardware accelerator used on this instance. If you use accelerators, make sure that your configuration has [enough vCPUs and memory to support the `machine_type` you have selected](/compute/docs/gpus/#gpus-list)."
"description": "The hardware accelerator used on this instance. If you use accelerators, make sure that your configuration has [enough vCPUs and memory to support the `machine_type` you have selected](https://cloud.google.com/compute/docs/gpus/#gpus-list)."
},
"bootDiskSizeGb": {
"description": "Input only. The size of the boot disk in GB attached to this instance, up to a maximum of 64000 GB (64 TB). The minimum recommended value is 100 GB. If not specified, this defaults to 100.",
@@ -2559,6 +2676,11 @@
"description": "Whether the end user authorizes Google Cloud to install GPU driver on this instance. If this field is empty or set to false, the GPU driver won't be installed. Only applicable to instances with GPUs.",
"type": "boolean"
},
"instanceMigrationEligibility": {
"$ref": "InstanceMigrationEligibility",
"description": "Output only. Checks how feasible a migration from UmN to WbI is.",
"readOnly": true
},
"instanceOwners": {
"description": "Input only. The owner of this instance after creation. Format: `alias@example.com` Currently supports one owner only. If not specified, all of the service account users of your VM instance's service account can use the instance.",
"items": {
@@ -2578,16 +2700,21 @@
"type": "object"
},
"machineType": {
"description": "Required. The [Compute Engine machine type](/compute/docs/machine-types) of this instance.",
"description": "Required. The [Compute Engine machine type](https://cloud.google.com/compute/docs/machine-types) of this instance.",
"type": "string"
},
"metadata": {
"additionalProperties": {
"type": "string"
},
"description": "Custom metadata to apply to this instance.",
"description": "Custom metadata to apply to this instance. For example, to specify a Cloud Storage bucket for automatic backup, you can use the `gcs-data-bucket` metadata tag. Format: `\"--metadata=gcs-data-bucket=``BUCKET''\"`.",
"type": "object"
},
"migrated": {
"description": "Output only. Bool indicating whether this notebook has been migrated to a Workbench Instance",
"readOnly": true,
"type": "boolean"
},
"name": {
"description": "Output only. The name of this notebook instance. Format: `projects/{project_id}/locations/{location}/instances/{instance_id}`",
"readOnly": true,
@@ -2616,7 +2743,7 @@
"type": "boolean"
},
"noPublicIp": {
"description": "If true, no public IP will be assigned to this instance.",
"description": "If true, no external IP will be assigned to this instance.",
"type": "boolean"
},
"noRemoveDataDisk": {
@@ -2730,6 +2857,55 @@
},
"type": "object"
},
"InstanceMigrationEligibility": {
"description": "InstanceMigrationEligibility represents the feasibility information of a migration from UmN to WbI.",
"id": "InstanceMigrationEligibility",
"properties": {
"errors": {
"description": "Output only. Certain configurations make the UmN ineligible for an automatic migration. A manual migration is required.",
"items": {
"enum": [
"ERROR_UNSPECIFIED",
"DATAPROC_HUB"
],
"enumDescriptions": [
"Default type.",
"The UmN uses Dataproc Hub and cannot be migrated."
],
"type": "string"
},
"readOnly": true,
"type": "array"
},
"warnings": {
"description": "Output only. Certain configurations will be defaulted during the migration.",
"items": {
"enum": [
"WARNING_UNSPECIFIED",
"UNSUPPORTED_MACHINE_TYPE",
"UNSUPPORTED_ACCELERATOR_TYPE",
"UNSUPPORTED_OS",
"NO_REMOVE_DATA_DISK",
"GCS_BACKUP",
"POST_STARTUP_SCRIPT"
],
"enumDescriptions": [
"Default type.",
"The UmN uses an machine type that's unsupported in WbI. It will be migrated with the default machine type e2-standard-4. Users can change the machine type after the migration.",
"The UmN uses an accelerator type that's unsupported in WbI. It will be migrated without an accelerator. User can attach an accelerator after the migration.",
"The UmN uses an operating system that's unsupported in WbI (e.g. Debian 10, Ubuntu). It will be replaced with Debian 11 in WbI.",
"This UmN is configured with no_remove_data_disk, which is no longer available in WbI.",
"This UmN is configured with the Cloud Storage backup feature, which is no longer available in WbI.",
"This UmN is configured with a post startup script. Please optionally provide the `post_startup_script_option` for the migration."
],
"type": "string"
},
"readOnly": true,
"type": "array"
}
},
"type": "object"
},
"IsInstanceUpgradeableResponse": {
"description": "Response for checking if a notebook instance is upgradeable.",
"id": "IsInstanceUpgradeableResponse",
@@ -2819,7 +2995,7 @@
"type": "string"
},
"unreachable": {
"description": "Locations that could not be reached. For example, ['us-west1-a', 'us-central1-b']. A ListInstancesResponse will only contain either instances or unreachables,",
"description": "Locations that could not be reached. For example, `['us-west1-a', 'us-central1-b']`. A ListInstancesResponse will only contain either instances or unreachables,",
"items": {
"type": "string"
},
@@ -2880,7 +3056,7 @@
"type": "array"
},
"unreachable": {
"description": "Locations that could not be reached. For example, ['us-west1', 'us-central1']. A ListRuntimesResponse will only contain either runtimes or unreachables,",
"description": "Locations that could not be reached. For example, `['us-west1', 'us-central1']`. A ListRuntimesResponse will only contain either runtimes or unreachables,",
"items": {
"type": "string"
},
@@ -2929,7 +3105,7 @@
"type": "boolean"
},
"deviceName": {
"description": "Optional. Output only. Specifies a unique device name of your choice that is reflected into the /dev/disk/by-id/google-* tree of a Linux operating system running within the instance. This name can be used to reference the device for mounting, resizing, and so on, from within the instance. If not specified, the server chooses a default device name to apply to this disk, in the form persistent-disk-x, where x is a number assigned by Google Compute Engine. This field is only applicable for persistent disks.",
"description": "Optional. Output only. Specifies a unique device name of your choice that is reflected into the `/dev/disk/by-id/google-*` tree of a Linux operating system running within the instance. This name can be used to reference the device for mounting, resizing, and so on, from within the instance. If not specified, the server chooses a default device name to apply to this disk, in the form persistent-disk-x, where x is a number assigned by Google Compute Engine. This field is only applicable for persistent disks.",
"readOnly": true,
"type": "string"
},
@@ -2952,7 +3128,7 @@
"description": "Input only. Specifies the parameters for a new disk that will be created alongside the new instance. Use initialization parameters to create boot disks or local SSDs attached to the new instance. This property is mutually exclusive with the source property; you can only define one or the other, but not both."
},
"interface": {
"description": "Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance. Valid values: * NVME * SCSI",
"description": "Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance. Valid values: * `NVME` * `SCSI`",
"type": "string"
},
"kind": {
@@ -2969,7 +3145,7 @@
"type": "array"
},
"mode": {
"description": "The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode. Valid values: * READ_ONLY * READ_WRITE",
"description": "The mode in which to attach this disk, either `READ_WRITE` or `READ_ONLY`. If not specified, the default is to attach the disk in `READ_WRITE` mode. Valid values: * `READ_ONLY` * `READ_WRITE`",
"type": "string"
},
"source": {
@@ -2977,7 +3153,7 @@
"type": "string"
},
"type": {
"description": "Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT. Valid values: * PERSISTENT * SCRATCH",
"description": "Specifies the type of the disk, either `SCRATCH` or `PERSISTENT`. If not specified, the default is `PERSISTENT`. Valid values: * `PERSISTENT` * `SCRATCH`",
"type": "string"
}
},
@@ -3029,7 +3205,7 @@
"type": "object"
},
"Location": {
"description": "A resource that represents Google Cloud Platform location.",
"description": "A resource that represents a Google Cloud location.",
"id": "Location",
"properties": {
"displayName": {
@@ -3062,6 +3238,64 @@
},
"type": "object"
},
"MigrateInstanceRequest": {
"description": "Request for migrating a User-Managed Notebook to Workbench Instances.",
"id": "MigrateInstanceRequest",
"properties": {
"postStartupScriptOption": {
"description": "Optional. Specifies the behavior of post startup script during migration.",
"enum": [
"POST_STARTUP_SCRIPT_OPTION_UNSPECIFIED",
"POST_STARTUP_SCRIPT_OPTION_SKIP",
"POST_STARTUP_SCRIPT_OPTION_RERUN"
],
"enumDescriptions": [
"Post startup script option is not specified. Default is POST_STARTUP_SCRIPT_OPTION_SKIP.",
"Not migrate the post startup script to the new Workbench Instance.",
"Redownload and rerun the same post startup script as the User-Managed Notebook."
],
"type": "string"
}
},
"type": "object"
},
"MigrateRuntimeRequest": {
"description": "Request for migrating a Runtime to a Workbench Instance.",
"id": "MigrateRuntimeRequest",
"properties": {
"network": {
"description": "Optional. Name of the VPC that the new Instance is in. This is required if the Runtime uses google-managed network. If the Runtime uses customer-owned network, it will reuse the same VPC, and this field must be empty. Format: `projects/{project_id}/global/networks/{network_id}`",
"type": "string"
},
"postStartupScriptOption": {
"description": "Optional. Specifies the behavior of post startup script during migration.",
"enum": [
"POST_STARTUP_SCRIPT_OPTION_UNSPECIFIED",
"POST_STARTUP_SCRIPT_OPTION_SKIP",
"POST_STARTUP_SCRIPT_OPTION_RERUN"
],
"enumDescriptions": [
"Post startup script option is not specified. Default is POST_STARTUP_SCRIPT_OPTION_SKIP.",
"Not migrate the post startup script to the new Workbench Instance.",
"Redownload and rerun the same post startup script as the Google-Managed Notebook."
],
"type": "string"
},
"requestId": {
"description": "Optional. Idempotent request UUID.",
"type": "string"
},
"serviceAccount": {
"description": "Optional. The service account to be included in the Compute Engine instance of the new Workbench Instance when the Runtime uses \"single user only\" mode for permission. If not specified, the [Compute Engine default service account](https://cloud.google.com/compute/docs/access/service-accounts#default_service_account) is used. When the Runtime uses service account mode for permission, it will reuse the same service account, and this field must be empty.",
"type": "string"
},
"subnet": {
"description": "Optional. Name of the subnet that the new Instance is in. This is required if the Runtime uses google-managed network. If the Runtime uses customer-owned network, it will reuse the same subnet, and this field must be empty. Format: `projects/{project_id}/regions/{region}/subnetworks/{subnetwork_id}`",
"type": "string"
}
},
"type": "object"
},
"Operation": {
"description": "This resource represents a long-running operation that is the result of a network API call.",
"id": "Operation",
@@ -3091,7 +3325,7 @@
"description": "Properties of the object. Contains field @type with type URL.",
"type": "any"
},
"description": "The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.",
"description": "The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.",
"type": "object"
}
},
@@ -3139,7 +3373,7 @@
"type": "object"
},
"Policy": {
"description": "An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** { \"bindings\": [ { \"role\": \"roles/resourcemanager.organizationAdmin\", \"members\": [ \"user:mike@example.com\", \"group:admins@example.com\", \"domain:google.com\", \"serviceAccount:my-project-id@appspot.gserviceaccount.com\" ] }, { \"role\": \"roles/resourcemanager.organizationViewer\", \"members\": [ \"user:eve@example.com\" ], \"condition\": { \"title\": \"expirable access\", \"description\": \"Does not grant access after Sep 2020\", \"expression\": \"request.time < timestamp('2020-10-01T00:00:00.000Z')\", } } ], \"etag\": \"BwWWja0YfJA=\", \"version\": 3 } **YAML example:** bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/).",
"description": "An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { \"bindings\": [ { \"role\": \"roles/resourcemanager.organizationAdmin\", \"members\": [ \"user:mike@example.com\", \"group:admins@example.com\", \"domain:google.com\", \"serviceAccount:my-project-id@appspot.gserviceaccount.com\" ] }, { \"role\": \"roles/resourcemanager.organizationViewer\", \"members\": [ \"user:eve@example.com\" ], \"condition\": { \"title\": \"expirable access\", \"description\": \"Does not grant access after Sep 2020\", \"expression\": \"request.time < timestamp('2020-10-01T00:00:00.000Z')\", } } ], \"etag\": \"BwWWja0YfJA=\", \"version\": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/).",
"id": "Policy",
"properties": {
"bindings": {
@@ -3201,6 +3435,21 @@
},
"type": "object"
},
"ReportInstanceEventRequest": {
"description": "Request for reporting a Managed Notebook Event.",
"id": "ReportInstanceEventRequest",
"properties": {
"event": {
"$ref": "Event",
"description": "Required. The Event to be reported."
},
"vmId": {
"description": "Required. The VM hardware token for authenticating the VM. https://cloud.google.com/compute/docs/instances/verifying-instance-identity",
"type": "string"
}
},
"type": "object"
},
"ReportInstanceInfoRequest": {
"description": "Request for notebook instances to report information to Notebooks API.",
"id": "ReportInstanceInfoRequest",
@@ -3290,7 +3539,7 @@
"id": "RollbackInstanceRequest",
"properties": {
"targetSnapshot": {
"description": "Required. The snapshot for rollback. Example: \"projects/test-project/global/snapshots/krwlzipynril\".",
"description": "Required. The snapshot for rollback. Example: `projects/test-project/global/snapshots/krwlzipynril`.",
"type": "string"
}
},
@@ -3329,16 +3578,33 @@
"readOnly": true,
"type": "string"
},
"labels": {
"additionalProperties": {
"type": "string"
},
"description": "Optional. The labels to associate with this Managed Notebook or Runtime. Label **keys** must contain 1 to 63 characters, and must conform to [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt). Label **values** may be empty, but, if present, must contain 1 to 63 characters, and must conform to [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt). No more than 32 labels can be associated with a cluster.",
"type": "object"
},
"metrics": {
"$ref": "RuntimeMetrics",
"description": "Output only. Contains Runtime daemon metrics such as Service status and JupyterLab stats.",
"readOnly": true
},
"migrated": {
"description": "Output only. Bool indicating whether this notebook has been migrated to a Workbench Instance",
"readOnly": true,
"type": "boolean"
},
"name": {
"description": "Output only. The resource name of the runtime. Format: `projects/{project}/locations/{location}/runtimes/{runtimeId}`",
"readOnly": true,
"type": "string"
},
"runtimeMigrationEligibility": {
"$ref": "RuntimeMigrationEligibility",
"description": "Output only. Checks how feasible a migration from GmN to WbI is.",
"readOnly": true
},
"softwareConfig": {
"$ref": "RuntimeSoftwareConfig",
"description": "The config settings for software inside the runtime."
@@ -3384,7 +3650,7 @@
"type": "object"
},
"RuntimeAcceleratorConfig": {
"description": "Definition of the types of hardware accelerators that can be used. Definition of the types of hardware accelerators that can be used. See [Compute Engine AcceleratorTypes](https://cloud.google.com/compute/docs/reference/beta/acceleratorTypes). Examples: * `nvidia-tesla-k80` * `nvidia-tesla-p100` * `nvidia-tesla-v100` * `nvidia-tesla-p4` * `nvidia-tesla-t4` * `nvidia-tesla-a100`",
"description": "Definition of the types of hardware accelerators that can be used. See [Compute Engine AcceleratorTypes](https://cloud.google.com/compute/docs/reference/beta/acceleratorTypes). Examples: * `nvidia-tesla-k80` * `nvidia-tesla-p100` * `nvidia-tesla-v100` * `nvidia-tesla-p4` * `nvidia-tesla-t4` * `nvidia-tesla-a100`",
"id": "RuntimeAcceleratorConfig",
"properties": {
"coreCount": {
@@ -3402,12 +3668,28 @@
"NVIDIA_TESLA_P4",
"NVIDIA_TESLA_T4",
"NVIDIA_TESLA_A100",
"NVIDIA_L4",
"TPU_V2",
"TPU_V3",
"NVIDIA_TESLA_T4_VWS",
"NVIDIA_TESLA_P100_VWS",
"NVIDIA_TESLA_P4_VWS"
],
"enumDeprecated": [
false,
true,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false,
false
],
"enumDescriptions": [
"Accelerator type is not specified.",
"Accelerator type is Nvidia Tesla K80.",
@@ -3415,7 +3697,8 @@
"Accelerator type is Nvidia Tesla V100.",
"Accelerator type is Nvidia Tesla P4.",
"Accelerator type is Nvidia Tesla T4.",
"Accelerator type is Nvidia Tesla A100.",
"Accelerator type is Nvidia Tesla A100 - 40GB.",
"Accelerator type is Nvidia L4.",
"(Coming soon) Accelerator type is TPU V2.",
"(Coming soon) Accelerator type is TPU V3.",
"Accelerator type is NVIDIA Tesla T4 Virtual Workstations.",
@@ -3462,7 +3745,7 @@
"id": "RuntimeGuestOsFeature",
"properties": {
"type": {
"description": "The ID of a supported feature. Read [Enabling guest operating system features](https://cloud.google.com/compute/docs/images/create-delete-deprecate-private-images#guest-os-features) to see a list of available options. Valid values: * FEATURE_TYPE_UNSPECIFIED * MULTI_IP_SUBNET * SECURE_BOOT * UEFI_COMPATIBLE * VIRTIO_SCSI_MULTIQUEUE * WINDOWS",
"description": "The ID of a supported feature. Read [Enabling guest operating system features](https://cloud.google.com/compute/docs/images/create-delete-deprecate-private-images#guest-os-features) to see a list of available options. Valid values: * `FEATURE_TYPE_UNSPECIFIED` * `MULTI_IP_SUBNET` * `SECURE_BOOT` * `UEFI_COMPATIBLE` * `VIRTIO_SCSI_MULTIQUEUE` * `WINDOWS`",
"type": "string"
}
},
@@ -3483,8 +3766,57 @@
},
"type": "object"
},
"RuntimeMigrationEligibility": {
"description": "RuntimeMigrationEligibility represents the feasibility information of a migration from GmN to WbI.",
"id": "RuntimeMigrationEligibility",
"properties": {
"errors": {
"description": "Output only. Certain configurations make the GmN ineligible for an automatic migration. A manual migration is required.",
"items": {
"enum": [
"ERROR_UNSPECIFIED",
"CUSTOM_CONTAINER"
],
"enumDescriptions": [
"Default type.",
"The GmN is configured with custom container(s) and cannot be migrated."
],
"type": "string"
},
"readOnly": true,
"type": "array"
},
"warnings": {
"description": "Output only. Certain configurations will be defaulted during the migration.",
"items": {
"enum": [
"WARNING_UNSPECIFIED",
"UNSUPPORTED_ACCELERATOR_TYPE",
"UNSUPPORTED_OS",
"RESERVED_IP_RANGE",
"GOOGLE_MANAGED_NETWORK",
"POST_STARTUP_SCRIPT",
"SINGLE_USER"
],
"enumDescriptions": [
"Default type.",
"The GmN uses an accelerator type that's unsupported in WbI. It will be migrated without an accelerator. Users can attach an accelerator after the migration.",
"The GmN uses an operating system that's unsupported in WbI (e.g. Debian 10). It will be replaced with Debian 11 in WbI.",
"This GmN is configured with reserved IP range, which is no longer applicable in WbI.",
"This GmN is configured with a Google managed network. Please provide the `network` and `subnet` options for the migration.",
"This GmN is configured with a post startup script. Please optionally provide the `post_startup_script_option` for the migration.",
"This GmN is configured with single user mode. Please optionally provide the `service_account` option for the migration."
],
"type": "string"
},
"readOnly": true,
"type": "array"
}
},
"type": "object"
},
"RuntimeShieldedInstanceConfig": {
"description": "A set of Shielded Instance options. Check [Images using supported Shielded VM features](https://cloud.google.com/compute/docs/instances/modifying-shielded-vm). Not all combinations are valid.",
"description": "A set of Shielded Instance options. See [Images using supported Shielded VM features](https://cloud.google.com/compute/docs/instances/modifying-shielded-vm). Not all combinations are valid.",
"id": "RuntimeShieldedInstanceConfig",
"properties": {
"enableIntegrityMonitoring": {
@@ -3538,6 +3870,10 @@
},
"type": "array"
},
"mixerDisabled": {
"description": "Bool indicating whether mixer client should be disabled. Default: False",
"type": "boolean"
},
"notebookUpgradeSchedule": {
"description": "Cron expression in UTC timezone, used to schedule instance auto upgrade. Please follow the [cron format](https://en.wikipedia.org/wiki/Cron).",
"type": "string"
@@ -3584,7 +3920,7 @@
"type": "string"
},
"cronSchedule": {
"description": "Cron-tab formatted schedule by which the job will execute. Format: minute, hour, day of month, month, day of week, e.g. 0 0 * * WED = every Wednesday More examples: https://crontab.guru/examples.html",
"description": "Cron-tab formatted schedule by which the job will execute. Format: minute, hour, day of month, month, day of week, e.g. `0 0 * * WED` = every Wednesday More examples: https://crontab.guru/examples.html",
"type": "string"
},
"description": {
@@ -3592,7 +3928,7 @@
"type": "string"
},
"displayName": {
"description": "Output only. Display name used for UI purposes. Name can only contain alphanumeric characters, hyphens '-', and underscores '_'.",
"description": "Output only. Display name used for UI purposes. Name can only contain alphanumeric characters, hyphens `-`, and underscores `_`.",
"readOnly": true,
"type": "string"
},
@@ -3648,7 +3984,7 @@
"type": "object"
},
"SchedulerAcceleratorConfig": {
"description": "Definition of a hardware accelerator. Note that not all combinations of `type` and `core_count` are valid. Check [GPUs on Compute Engine](https://cloud.google.com/compute/docs/gpus) to find a valid combination. TPUs are not supported.",
"description": "Definition of a hardware accelerator. Note that not all combinations of `type` and `core_count` are valid. See [GPUs on Compute Engine](https://cloud.google.com/compute/docs/gpus) to find a valid combination. TPUs are not supported.",
"id": "SchedulerAcceleratorConfig",
"properties": {
"coreCount": {
@@ -3701,7 +4037,7 @@
"id": "SetInstanceAcceleratorRequest",
"properties": {
"coreCount": {
"description": "Required. Count of cores of this accelerator. Note that not all combinations of `type` and `core_count` are valid. Check [GPUs on Compute Engine](https://cloud.google.com/compute/docs/gpus/#gpus-list) to find a valid combination. TPUs are not supported.",
"description": "Required. Count of cores of this accelerator. Note that not all combinations of `type` and `core_count` are valid. See [GPUs on Compute Engine](https://cloud.google.com/compute/docs/gpus/#gpus-list) to find a valid combination. TPUs are not supported.",
"format": "int64",
"type": "string"
},
@@ -3715,6 +4051,7 @@
"NVIDIA_TESLA_P4",
"NVIDIA_TESLA_T4",
"NVIDIA_TESLA_A100",
"NVIDIA_L4",
"NVIDIA_TESLA_T4_VWS",
"NVIDIA_TESLA_P100_VWS",
"NVIDIA_TESLA_P4_VWS",
@@ -3729,6 +4066,7 @@
"Accelerator type is Nvidia Tesla P4.",
"Accelerator type is Nvidia Tesla T4.",
"Accelerator type is Nvidia Tesla A100.",
"Accelerator type is Nvidia Tesla L4.",
"Accelerator type is NVIDIA Tesla T4 Virtual Workstations.",
"Accelerator type is NVIDIA Tesla P100 Virtual Workstations.",
"Accelerator type is NVIDIA Tesla P4 Virtual Workstations.",
@@ -3766,7 +4104,7 @@
"type": "object"
},
"ShieldedInstanceConfig": {
"description": "A set of Shielded Instance options. Check [Images using supported Shielded VM features] Not all combinations are valid.",
"description": "A set of Shielded Instance options. See [Images using supported Shielded VM features](https://cloud.google.com/compute/docs/instances/modifying-shielded-vm). Not all combinations are valid.",
"id": "ShieldedInstanceConfig",
"properties": {
"enableIntegrityMonitoring": {
@@ -4000,7 +4338,8 @@
"type": "string"
},
"targetImage": {
"description": "Target VM Image. Format: ainotebooks-vm/project/image-name/name.",
"deprecated": true,
"description": "Target VM Image. Format: `ainotebooks-vm/project/image-name/name`.",
"type": "string"
},
"targetVersion": {
@@ -4091,11 +4430,11 @@
"additionalProperties": {
"type": "string"
},
"description": "Environment variables. At most 100 environment variables can be specified and unique. Example: GCP_BUCKET=gs://my-bucket/samples/",
"description": "Environment variables. At most 100 environment variables can be specified and unique. Example: `GCP_BUCKET=gs://my-bucket/samples/`",
"type": "object"
},
"network": {
"description": "The full name of the Compute Engine [network](/compute/docs/networks-and-firewalls#networks) to which the Job should be peered. For example, `projects/12345/global/networks/myVPC`. [Format](https://cloud.google.com/compute/docs/reference/rest/v1/networks/insert) is of the form `projects/{project}/global/networks/{network}`. Where {project} is a project number, as in `12345`, and {network} is a network name. Private services access must already be configured for the network. If left unspecified, the job is not peered with any network.",
"description": "The full name of the Compute Engine [network](https://cloud.google.com/compute/docs/networks-and-firewalls#networks) to which the Job should be peered. For example, `projects/12345/global/networks/myVPC`. [Format](https://cloud.google.com/compute/docs/reference/rest/v1/networks/insert) is of the form `projects/{project}/global/networks/{network}`. Where `{project}` is a project number, as in `12345`, and `{network}` is a network name. Private services access must already be configured for the network. If left unspecified, the job is not peered with any network.",
"type": "string"
}
},