Skip to main content

instance_group_manager_resize_requests

Creates, updates, deletes, gets or lists an instance_group_manager_resize_requests resource.

Overview​

Nameinstance_group_manager_resize_requests
TypeResource
Idgoogle.compute.instance_group_manager_resize_requests

Fields​

The following fields are returned by SELECT queries:

Successful response

NameDatatypeDescription
idstring (uint64)[Output Only] A unique identifier for this resource type. The server generates this identifier.
namestringThe name of this resize request. The name must be 1-63 characters long, and comply with RFC1035. (pattern: a-z?)
creationTimestampstring[Output Only] The creation timestamp for this resize request in RFC3339 text format.
descriptionstringAn optional description of this resource.
kindstring[Output Only] The resource type, which is always compute#instanceGroupManagerResizeRequest for resize requests. (default: compute#instanceGroupManagerResizeRequest)
requestedRunDurationobjectRequested run duration for instances that will be created by this request. At the end of the run duration instance will be deleted. (id: Duration)
resizeByinteger (int32)The number of instances to be created by this resize request. The group's target size will be increased by this number. This field cannot be used together with 'instances'.
selfLinkstring[Output Only] The URL for this resize request. The server defines this URL.
selfLinkWithIdstring[Output Only] Server-defined URL for this resource with the resource id.
statestring[Output only] Current state of the request.
statusobject[Output only] Status of the request. (id: InstanceGroupManagerResizeRequestStatus)
zonestring[Output Only] The URL of a zone where the resize request is located. Populated only for zonal resize requests.

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectproject, zone, instanceGroupManager, resizeRequestReturns all of the details about the specified resize request.
listselectproject, zone, instanceGroupManagerfilter, maxResults, orderBy, pageToken, returnPartialSuccessRetrieves a list of resize requests that are contained in the managed instance group.
insertinsertproject, zone, instanceGroupManagerrequestIdCreates a new resize request that starts provisioning VMs immediately or queues VM creation.
deletedeleteproject, zone, instanceGroupManager, resizeRequestrequestIdDeletes the specified, inactive resize request. Requests that are still active cannot be deleted. Deleting request does not delete instances that were provisioned previously.
cancelexecproject, zone, instanceGroupManager, resizeRequestrequestIdCancels the specified resize request and removes it from the queue. Cancelled resize request does no longer wait for the resources to be provisioned. Cancel is only possible for requests that are accepted in the queue.

Parameters​

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
instanceGroupManagerstring
projectstring
resizeRequeststring
zonestring
filterstring
maxResultsinteger (uint32)
orderBystring
pageTokenstring
requestIdstring
returnPartialSuccessboolean

SELECT examples​

Returns all of the details about the specified resize request.

SELECT
id,
name,
creationTimestamp,
description,
kind,
requestedRunDuration,
resizeBy,
selfLink,
selfLinkWithId,
state,
status,
zone
FROM google.compute.instance_group_manager_resize_requests
WHERE project = '{{ project }}' -- required
AND zone = '{{ zone }}' -- required
AND instanceGroupManager = '{{ instanceGroupManager }}' -- required
AND resizeRequest = '{{ resizeRequest }}' -- required;

INSERT examples​

Creates a new resize request that starts provisioning VMs immediately or queues VM creation.

INSERT INTO google.compute.instance_group_manager_resize_requests (
data__kind,
data__id,
data__creationTimestamp,
data__name,
data__description,
data__zone,
data__resizeBy,
data__requestedRunDuration,
data__state,
data__status,
data__selfLink,
data__selfLinkWithId,
project,
zone,
instanceGroupManager,
requestId
)
SELECT 
'{{ kind }}',
'{{ id }}',
'{{ creationTimestamp }}',
'{{ name }}',
'{{ description }}',
'{{ zone }}',
{{ resizeBy }},
'{{ requestedRunDuration }}',
'{{ state }}',
'{{ status }}',
'{{ selfLink }}',
'{{ selfLinkWithId }}',
'{{ project }}',
'{{ zone }}',
'{{ instanceGroupManager }}',
'{{ requestId }}'
RETURNING
id,
name,
clientOperationId,
creationTimestamp,
description,
endTime,
error,
httpErrorMessage,
httpErrorStatusCode,
insertTime,
instancesBulkInsertOperationMetadata,
kind,
operationGroupId,
operationType,
progress,
region,
selfLink,
setCommonInstanceMetadataOperationMetadata,
startTime,
status,
statusMessage,
targetId,
targetLink,
user,
warnings,
zone
;

DELETE examples​

Deletes the specified, inactive resize request. Requests that are still active cannot be deleted. Deleting request does not delete instances that were provisioned previously.

DELETE FROM google.compute.instance_group_manager_resize_requests
WHERE project = '{{ project }}' --required
AND zone = '{{ zone }}' --required
AND instanceGroupManager = '{{ instanceGroupManager }}' --required
AND resizeRequest = '{{ resizeRequest }}' --required
AND requestId = '{{ requestId }}';

Lifecycle Methods​

Cancels the specified resize request and removes it from the queue. Cancelled resize request does no longer wait for the resources to be provisioned. Cancel is only possible for requests that are accepted in the queue.

EXEC google.compute.instance_group_manager_resize_requests.cancel 
@project='{{ project }}' --required, 
@zone='{{ zone }}' --required, 
@instanceGroupManager='{{ instanceGroupManager }}' --required, 
@resizeRequest='{{ resizeRequest }}' --required, 
@requestId='{{ requestId }}';