public sealed class UpdateSettings : IMessage<UpdateSettings>, IEquatable<UpdateSettings>, IDeepCloneable<UpdateSettings>, IBufferMessage, IMessage
Reference documentation and code samples for the Anthos Multi-Cloud v1 API class UpdateSettings.
UpdateSettings control the level of parallelism and the level of
disruption caused during the update of a node pool.
These settings are applicable when the node pool update requires replacing
the existing node pool nodes with the updated ones.
UpdateSettings are optional. When UpdateSettings are not specified during the
node pool creation, a default is chosen based on the parent cluster's
version. For clusters with minor version 1.27 and later, a default
surge_settings configuration with max_surge = 1 and max_unavailable = 0 is
used. For clusters with older versions, node pool updates use the traditional
rolling update mechanism of updating one node at a time in a
"terminate before create" fashion and update_settings is not applicable.
Set the surge_settings parameter to use the Surge Update mechanism for
the rolling update of node pool nodes.
max_surge controls the number of additional nodes that can be created
beyond the current size of the node pool temporarily for the time of the
update to increase the number of available nodes.
max_unavailable controls the number of nodes that can be simultaneously
unavailable during the update.
(max_surge + max_unavailable) determines the level of parallelism (i.e.,
the number of nodes being updated at the same time).
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eUpdateSettings\u003c/code\u003e class in the Anthos Multi-Cloud v1 API controls the parallelism and disruption level during node pool updates.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eUpdateSettings\u003c/code\u003e is optional; without it, default settings are used based on the parent cluster's version, with the new default for 1.27 and later being surge_settings with max_surge = 1 and max_unavailable = 0.\u003c/p\u003e\n"],["\u003cp\u003eThe Surge Update mechanism, configurable via the \u003ccode\u003esurge_settings\u003c/code\u003e parameter, allows for a more flexible rolling update by controlling the number of additional and unavailable nodes.\u003c/p\u003e\n"],["\u003cp\u003eThe degree of parallelism during updates is determined by the sum of \u003ccode\u003emax_surge\u003c/code\u003e (additional nodes created) and \u003ccode\u003emax_unavailable\u003c/code\u003e (nodes simultaneously unavailable).\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eUpdateSettings\u003c/code\u003e class implements multiple interfaces including \u003ccode\u003eIMessage\u003c/code\u003e, \u003ccode\u003eIEquatable\u003c/code\u003e, \u003ccode\u003eIDeepCloneable\u003c/code\u003e, and \u003ccode\u003eIBufferMessage\u003c/code\u003e, it has properties like \u003ccode\u003eSurgeSettings\u003c/code\u003e, and can be constructed with no parameters, or another \u003ccode\u003eUpdateSettings\u003c/code\u003e object.\u003c/p\u003e\n"]]],[],null,[]]
