Skip to main content

node_groups

Overview

Namenode_groups
TypeResource
Idgoogle.compute.node_groups

Fields

NameDatatypeDescription
idstring[Output Only] The unique identifier for the resource. This identifier is defined by the server.
namestringThe name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
descriptionstringAn optional description of this resource. Provide this property when you create the resource.
autoscalingPolicyobject
fingerprintstring
locationHintstringAn opaque location hint used to place the Node close to other resources. This field is for use by internal tools that use the public API. The location hint here on the NodeGroup overrides any location_hint present in the NodeTemplate.
maintenancePolicystringSpecifies how to handle instances when a node in the group undergoes maintenance. Set to one of: DEFAULT, RESTART_IN_PLACE, or MIGRATE_WITHIN_NODE_GROUP. The default value is DEFAULT. For more information, see Maintenance policies.
zonestring[Output Only] The name of the zone where the node group resides, such as us-central1-a.
sizeinteger[Output Only] The total number of nodes in the node group.
maintenanceWindowobjectTime window specified for daily maintenance operations. GCE's internal maintenance will be performed within this window.
kindstring[Output Only] The type of the resource. Always compute#nodeGroup for node group.
nodeTemplatestringURL of the node template to create the node group from.
shareSettingsobjectThe share setting for reservations and sole tenancy node groups.
statusstring
selfLinkstring[Output Only] Server-defined URL for the resource.
creationTimestampstring[Output Only] Creation timestamp in RFC3339 text format.

Methods

NameAccessible byRequired ParamsDescription
aggregated_listSELECTprojectRetrieves an aggregated list of node groups. Note: use nodeGroups.listNodes for more details about each group.
getSELECTnodeGroup, project, zoneReturns the specified NodeGroup. Get a list of available NodeGroups by making a list() request. Note: the "nodes" field should not be used. Use nodeGroups.listNodes instead.
listSELECTproject, zoneRetrieves a list of node groups available to the specified project. Note: use nodeGroups.listNodes for more details about each group.
insertINSERTinitialNodeCount, project, zoneCreates a NodeGroup resource in the specified project using the data included in the request.
deleteDELETEnodeGroup, project, zoneDeletes the specified NodeGroup resource.
_aggregated_listEXECprojectRetrieves an aggregated list of node groups. Note: use nodeGroups.listNodes for more details about each group.
patchEXECnodeGroup, project, zoneUpdates the specified node group.
set_node_templateEXECnodeGroup, project, zoneUpdates the node template of the node group.
simulate_maintenance_eventEXECnodeGroup, project, zoneSimulates maintenance event on specified nodes from the node group.