Interface InstanceGroupManagerUpdatePolicyOrBuilder (1.24.0)

public interface InstanceGroupManagerUpdatePolicyOrBuilder extends MessageOrBuilder

Implements

MessageOrBuilder

Methods

getInstanceRedistributionType()

public abstract String getInstanceRedistributionType()

The instance redistribution policy for regional managed instance groups. Valid values are: - PROACTIVE (default): The group attempts to maintain an even distribution of VM instances across zones in the region. - NONE: For non-autoscaled groups, proactive redistribution is disabled. Check the InstanceRedistributionType enum for the list of possible values.

optional string instance_redistribution_type = 292630424;

Returns
TypeDescription
String

The instanceRedistributionType.

getInstanceRedistributionTypeBytes()

public abstract ByteString getInstanceRedistributionTypeBytes()

The instance redistribution policy for regional managed instance groups. Valid values are: - PROACTIVE (default): The group attempts to maintain an even distribution of VM instances across zones in the region. - NONE: For non-autoscaled groups, proactive redistribution is disabled. Check the InstanceRedistributionType enum for the list of possible values.

optional string instance_redistribution_type = 292630424;

Returns
TypeDescription
ByteString

The bytes for instanceRedistributionType.

getMaxSurge()

public abstract FixedOrPercent getMaxSurge()

The maximum number of instances that can be created above the specified targetSize during the update process. This value can be either a fixed number or, if the group has 10 or more instances, a percentage. If you set a percentage, the number of instances is rounded if necessary. The default value for maxSurge is a fixed value equal to the number of zones in which the managed instance group operates. At least one of either maxSurge or maxUnavailable must be greater than 0. Learn more about maxSurge.

optional .google.cloud.compute.v1.FixedOrPercent max_surge = 302572691;

Returns
TypeDescription
FixedOrPercent

The maxSurge.

getMaxSurgeOrBuilder()

public abstract FixedOrPercentOrBuilder getMaxSurgeOrBuilder()

The maximum number of instances that can be created above the specified targetSize during the update process. This value can be either a fixed number or, if the group has 10 or more instances, a percentage. If you set a percentage, the number of instances is rounded if necessary. The default value for maxSurge is a fixed value equal to the number of zones in which the managed instance group operates. At least one of either maxSurge or maxUnavailable must be greater than 0. Learn more about maxSurge.

optional .google.cloud.compute.v1.FixedOrPercent max_surge = 302572691;

Returns
TypeDescription
FixedOrPercentOrBuilder

getMaxUnavailable()

public abstract FixedOrPercent getMaxUnavailable()

The maximum number of instances that can be unavailable during the update process. An instance is considered available if all of the following conditions are satisfied: - The instance's status is RUNNING. - If there is a health check on the instance group, the instance's health check status must be HEALTHY at least once. If there is no health check on the group, then the instance only needs to have a status of RUNNING to be considered available. This value can be either a fixed number or, if the group has 10 or more instances, a percentage. If you set a percentage, the number of instances is rounded if necessary. The default value for maxUnavailable is a fixed value equal to the number of zones in which the managed instance group operates. At least one of either maxSurge or maxUnavailable must be greater than 0. Learn more about maxUnavailable.

optional .google.cloud.compute.v1.FixedOrPercent max_unavailable = 404940277;

Returns
TypeDescription
FixedOrPercent

The maxUnavailable.

getMaxUnavailableOrBuilder()

public abstract FixedOrPercentOrBuilder getMaxUnavailableOrBuilder()

The maximum number of instances that can be unavailable during the update process. An instance is considered available if all of the following conditions are satisfied: - The instance's status is RUNNING. - If there is a health check on the instance group, the instance's health check status must be HEALTHY at least once. If there is no health check on the group, then the instance only needs to have a status of RUNNING to be considered available. This value can be either a fixed number or, if the group has 10 or more instances, a percentage. If you set a percentage, the number of instances is rounded if necessary. The default value for maxUnavailable is a fixed value equal to the number of zones in which the managed instance group operates. At least one of either maxSurge or maxUnavailable must be greater than 0. Learn more about maxUnavailable.

optional .google.cloud.compute.v1.FixedOrPercent max_unavailable = 404940277;

Returns
TypeDescription
FixedOrPercentOrBuilder

getMinimalAction()

public abstract String getMinimalAction()

Minimal action to be taken on an instance. Use this option to minimize disruption as much as possible or to apply a more disruptive action than is necessary. - To limit disruption as much as possible, set the minimal action to REFRESH. If your update requires a more disruptive action, Compute Engine performs the necessary action to execute the update. - To apply a more disruptive action than is strictly necessary, set the minimal action to RESTART or REPLACE. For example, Compute Engine does not need to restart a VM to change its metadata. But if your application reads instance metadata only when a VM is restarted, you can set the minimal action to RESTART in order to pick up metadata changes. Check the MinimalAction enum for the list of possible values.

optional string minimal_action = 270567060;

Returns
TypeDescription
String

The minimalAction.

getMinimalActionBytes()

public abstract ByteString getMinimalActionBytes()

Minimal action to be taken on an instance. Use this option to minimize disruption as much as possible or to apply a more disruptive action than is necessary. - To limit disruption as much as possible, set the minimal action to REFRESH. If your update requires a more disruptive action, Compute Engine performs the necessary action to execute the update. - To apply a more disruptive action than is strictly necessary, set the minimal action to RESTART or REPLACE. For example, Compute Engine does not need to restart a VM to change its metadata. But if your application reads instance metadata only when a VM is restarted, you can set the minimal action to RESTART in order to pick up metadata changes. Check the MinimalAction enum for the list of possible values.

optional string minimal_action = 270567060;

Returns
TypeDescription
ByteString

The bytes for minimalAction.

getMostDisruptiveAllowedAction()

public abstract String getMostDisruptiveAllowedAction()

Most disruptive action that is allowed to be taken on an instance. You can specify either NONE to forbid any actions, REFRESH to allow actions that do not need instance restart, RESTART to allow actions that can be applied without instance replacing or REPLACE to allow all possible actions. If the Updater determines that the minimal update action needed is more disruptive than most disruptive allowed action you specify it will not perform the update at all. Check the MostDisruptiveAllowedAction enum for the list of possible values.

optional string most_disruptive_allowed_action = 66103053;

Returns
TypeDescription
String

The mostDisruptiveAllowedAction.

getMostDisruptiveAllowedActionBytes()

public abstract ByteString getMostDisruptiveAllowedActionBytes()

Most disruptive action that is allowed to be taken on an instance. You can specify either NONE to forbid any actions, REFRESH to allow actions that do not need instance restart, RESTART to allow actions that can be applied without instance replacing or REPLACE to allow all possible actions. If the Updater determines that the minimal update action needed is more disruptive than most disruptive allowed action you specify it will not perform the update at all. Check the MostDisruptiveAllowedAction enum for the list of possible values.

optional string most_disruptive_allowed_action = 66103053;

Returns
TypeDescription
ByteString

The bytes for mostDisruptiveAllowedAction.

getReplacementMethod()

public abstract String getReplacementMethod()

What action should be used to replace instances. See minimal_action.REPLACE Check the ReplacementMethod enum for the list of possible values.

optional string replacement_method = 505931694;

Returns
TypeDescription
String

The replacementMethod.

getReplacementMethodBytes()

public abstract ByteString getReplacementMethodBytes()

What action should be used to replace instances. See minimal_action.REPLACE Check the ReplacementMethod enum for the list of possible values.

optional string replacement_method = 505931694;

Returns
TypeDescription
ByteString

The bytes for replacementMethod.

getType()

public abstract String getType()

The type of update process. You can specify either PROACTIVE so that the instance group manager proactively executes actions in order to bring instances to their target versions or OPPORTUNISTIC so that no action is proactively executed but the update will be performed as part of other actions (for example, resizes or recreateInstances calls). Check the Type enum for the list of possible values.

optional string type = 3575610;

Returns
TypeDescription
String

The type.

getTypeBytes()

public abstract ByteString getTypeBytes()

The type of update process. You can specify either PROACTIVE so that the instance group manager proactively executes actions in order to bring instances to their target versions or OPPORTUNISTIC so that no action is proactively executed but the update will be performed as part of other actions (for example, resizes or recreateInstances calls). Check the Type enum for the list of possible values.

optional string type = 3575610;

Returns
TypeDescription
ByteString

The bytes for type.

hasInstanceRedistributionType()

public abstract boolean hasInstanceRedistributionType()

The instance redistribution policy for regional managed instance groups. Valid values are: - PROACTIVE (default): The group attempts to maintain an even distribution of VM instances across zones in the region. - NONE: For non-autoscaled groups, proactive redistribution is disabled. Check the InstanceRedistributionType enum for the list of possible values.

optional string instance_redistribution_type = 292630424;

Returns
TypeDescription
boolean

Whether the instanceRedistributionType field is set.

hasMaxSurge()

public abstract boolean hasMaxSurge()

The maximum number of instances that can be created above the specified targetSize during the update process. This value can be either a fixed number or, if the group has 10 or more instances, a percentage. If you set a percentage, the number of instances is rounded if necessary. The default value for maxSurge is a fixed value equal to the number of zones in which the managed instance group operates. At least one of either maxSurge or maxUnavailable must be greater than 0. Learn more about maxSurge.

optional .google.cloud.compute.v1.FixedOrPercent max_surge = 302572691;

Returns
TypeDescription
boolean

Whether the maxSurge field is set.

hasMaxUnavailable()

public abstract boolean hasMaxUnavailable()

The maximum number of instances that can be unavailable during the update process. An instance is considered available if all of the following conditions are satisfied: - The instance's status is RUNNING. - If there is a health check on the instance group, the instance's health check status must be HEALTHY at least once. If there is no health check on the group, then the instance only needs to have a status of RUNNING to be considered available. This value can be either a fixed number or, if the group has 10 or more instances, a percentage. If you set a percentage, the number of instances is rounded if necessary. The default value for maxUnavailable is a fixed value equal to the number of zones in which the managed instance group operates. At least one of either maxSurge or maxUnavailable must be greater than 0. Learn more about maxUnavailable.

optional .google.cloud.compute.v1.FixedOrPercent max_unavailable = 404940277;

Returns
TypeDescription
boolean

Whether the maxUnavailable field is set.

hasMinimalAction()

public abstract boolean hasMinimalAction()

Minimal action to be taken on an instance. Use this option to minimize disruption as much as possible or to apply a more disruptive action than is necessary. - To limit disruption as much as possible, set the minimal action to REFRESH. If your update requires a more disruptive action, Compute Engine performs the necessary action to execute the update. - To apply a more disruptive action than is strictly necessary, set the minimal action to RESTART or REPLACE. For example, Compute Engine does not need to restart a VM to change its metadata. But if your application reads instance metadata only when a VM is restarted, you can set the minimal action to RESTART in order to pick up metadata changes. Check the MinimalAction enum for the list of possible values.

optional string minimal_action = 270567060;

Returns
TypeDescription
boolean

Whether the minimalAction field is set.

hasMostDisruptiveAllowedAction()

public abstract boolean hasMostDisruptiveAllowedAction()

Most disruptive action that is allowed to be taken on an instance. You can specify either NONE to forbid any actions, REFRESH to allow actions that do not need instance restart, RESTART to allow actions that can be applied without instance replacing or REPLACE to allow all possible actions. If the Updater determines that the minimal update action needed is more disruptive than most disruptive allowed action you specify it will not perform the update at all. Check the MostDisruptiveAllowedAction enum for the list of possible values.

optional string most_disruptive_allowed_action = 66103053;

Returns
TypeDescription
boolean

Whether the mostDisruptiveAllowedAction field is set.

hasReplacementMethod()

public abstract boolean hasReplacementMethod()

What action should be used to replace instances. See minimal_action.REPLACE Check the ReplacementMethod enum for the list of possible values.

optional string replacement_method = 505931694;

Returns
TypeDescription
boolean

Whether the replacementMethod field is set.

hasType()

public abstract boolean hasType()

The type of update process. You can specify either PROACTIVE so that the instance group manager proactively executes actions in order to bring instances to their target versions or OPPORTUNISTIC so that no action is proactively executed but the update will be performed as part of other actions (for example, resizes or recreateInstances calls). Check the Type enum for the list of possible values.

optional string type = 3575610;

Returns
TypeDescription
boolean

Whether the type field is set.