Compute V1 Client - Class InsertInstanceRequest (2.5.0)
Reference documentation and code samples for the Compute V1 Client class InsertInstanceRequest.
A request message for Instances.Insert. See the method description for details.
Generated from protobuf messagegoogle.cloud.compute.v1.InsertInstanceRequest
Namespace
Google \ Cloud \ Compute \ V1Methods
__construct
Constructor.
| Parameters | |
|---|---|
| Name | Description |
data | arrayOptional. Data for populating the Message object. |
↳ instance_resource | InstanceThe body resource for this request |
↳ project | stringProject ID for this request. |
↳ request_id | stringAn optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). |
↳ source_instance_template | stringSpecifies instance template to create the instance. This field is optional. It can be a full or partial URL. For example, the following are all valid URLs to an instance template: -https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate - projects/project/global/instanceTemplates/instanceTemplate - global/instanceTemplates/instanceTemplate |
↳ source_machine_image | stringSpecifies the machine image to use to create the instance. This field is optional. It can be a full or partial URL. For example, the following are all valid URLs to a machine image: -https://www.googleapis.com/compute/v1/projects/project/global/global/machineImages/machineImage - projects/project/global/global/machineImages/machineImage - global/machineImages/machineImage |
↳ zone | stringThe name of the zone for this request. |
getInstanceResource
The body resource for this request
| Returns | |
|---|---|
| Type | Description |
Instance|null | |
hasInstanceResource
clearInstanceResource
setInstanceResource
The body resource for this request
| Parameter | |
|---|---|
| Name | Description |
var | Instance |
| Returns | |
|---|---|
| Type | Description |
$this | |
getProject
Project ID for this request.
| Returns | |
|---|---|
| Type | Description |
string | |
setProject
Project ID for this request.
| Parameter | |
|---|---|
| Name | Description |
var | string |
| Returns | |
|---|---|
| Type | Description |
$this | |
getRequestId
An optional request ID to identify requests. Specify a unique request ID sothat if you must retry your request, the server will know to ignore therequest if it has already been completed.
For example, consider a situation where you make an initial request andthe request times out. If you make the request again with the samerequest ID, the server can check if original operation with the samerequest ID was received, and if so, will ignore the second request. Thisprevents clients from accidentally creating duplicate commitments.The request ID must bea valid UUID with the exception that zero UUID is not supported(00000000-0000-0000-0000-000000000000).
| Returns | |
|---|---|
| Type | Description |
string | |
hasRequestId
clearRequestId
setRequestId
An optional request ID to identify requests. Specify a unique request ID sothat if you must retry your request, the server will know to ignore therequest if it has already been completed.
For example, consider a situation where you make an initial request andthe request times out. If you make the request again with the samerequest ID, the server can check if original operation with the samerequest ID was received, and if so, will ignore the second request. Thisprevents clients from accidentally creating duplicate commitments.The request ID must bea valid UUID with the exception that zero UUID is not supported(00000000-0000-0000-0000-000000000000).
| Parameter | |
|---|---|
| Name | Description |
var | string |
| Returns | |
|---|---|
| Type | Description |
$this | |
getSourceInstanceTemplate
Specifies instance template to create the instance.
This field is optional. It can be a full or partial URL. For example, thefollowing are all valid URLs to an instance template:
- https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate
- projects/project/global/instanceTemplates/instanceTemplate
- global/instanceTemplates/instanceTemplate
| Returns | |
|---|---|
| Type | Description |
string | |
hasSourceInstanceTemplate
clearSourceInstanceTemplate
setSourceInstanceTemplate
Specifies instance template to create the instance.
This field is optional. It can be a full or partial URL. For example, thefollowing are all valid URLs to an instance template:
- https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate
- projects/project/global/instanceTemplates/instanceTemplate
- global/instanceTemplates/instanceTemplate
| Parameter | |
|---|---|
| Name | Description |
var | string |
| Returns | |
|---|---|
| Type | Description |
$this | |
getSourceMachineImage
Specifies the machine image to use to create the instance.
This field is optional. It can be a full or partial URL. For example, thefollowing are all valid URLs to a machine image:
- https://www.googleapis.com/compute/v1/projects/project/global/global/machineImages/machineImage
- projects/project/global/global/machineImages/machineImage
- global/machineImages/machineImage
| Returns | |
|---|---|
| Type | Description |
string | |
hasSourceMachineImage
clearSourceMachineImage
setSourceMachineImage
Specifies the machine image to use to create the instance.
This field is optional. It can be a full or partial URL. For example, thefollowing are all valid URLs to a machine image:
- https://www.googleapis.com/compute/v1/projects/project/global/global/machineImages/machineImage
- projects/project/global/global/machineImages/machineImage
- global/machineImages/machineImage
| Parameter | |
|---|---|
| Name | Description |
var | string |
| Returns | |
|---|---|
| Type | Description |
$this | |
getZone
The name of the zone for this request.
| Returns | |
|---|---|
| Type | Description |
string | |
setZone
The name of the zone for this request.
| Parameter | |
|---|---|
| Name | Description |
var | string |
| Returns | |
|---|---|
| Type | Description |
$this | |
static::build
| Parameters | |
|---|---|
| Name | Description |
project | stringProject ID for this request. |
zone | stringThe name of the zone for this request. |
instanceResource | InstanceThe body resource for this request |
| Returns | |
|---|---|
| Type | Description |
InsertInstanceRequest | |
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-01-23 UTC.