(::Google::Cloud::OsConfig::V1::FixedOrPercent) — The maximum number (or percentage) of VMs per zone to disrupt at any given
moment. The number of VMs calculated from multiplying the percentage by the
total number of VMs in a zone is rounded up.
During patching, a VM is considered disrupted from the time the agent is
notified to begin until patching has completed. This disruption time
includes the time to complete reboot and any post-patch steps.
A VM contributes to the disruption budget if its patching operation fails
either when applying the patches, running pre or post patch steps, or if it
fails to respond with a success notification before timing out. VMs that
are not running or do not have an active agent do not count toward this
disruption budget.
For zone-by-zone rollouts, if the disruption budget in a zone is exceeded,
the patch job stops, because continuing to the next zone requires
completion of the patch process in the previous zone.
For example, if the disruption budget has a fixed value of 10, and 8 VMs
fail to patch in the current zone, the patch job continues to patch 2 VMs
at a time until the zone is completed. When that zone is completed
successfully, patching begins with 10 VMs at a time in the next zone. If 10
VMs in the next zone fail to patch, the patch job stops.
value (::Google::Cloud::OsConfig::V1::FixedOrPercent) — The maximum number (or percentage) of VMs per zone to disrupt at any given
moment. The number of VMs calculated from multiplying the percentage by the
total number of VMs in a zone is rounded up.
During patching, a VM is considered disrupted from the time the agent is
notified to begin until patching has completed. This disruption time
includes the time to complete reboot and any post-patch steps.
A VM contributes to the disruption budget if its patching operation fails
either when applying the patches, running pre or post patch steps, or if it
fails to respond with a success notification before timing out. VMs that
are not running or do not have an active agent do not count toward this
disruption budget.
For zone-by-zone rollouts, if the disruption budget in a zone is exceeded,
the patch job stops, because continuing to the next zone requires
completion of the patch process in the previous zone.
For example, if the disruption budget has a fixed value of 10, and 8 VMs
fail to patch in the current zone, the patch job continues to patch 2 VMs
at a time until the zone is completed. When that zone is completed
successfully, patching begins with 10 VMs at a time in the next zone. If 10
VMs in the next zone fail to patch, the patch job stops.
Returns
(::Google::Cloud::OsConfig::V1::FixedOrPercent) — The maximum number (or percentage) of VMs per zone to disrupt at any given
moment. The number of VMs calculated from multiplying the percentage by the
total number of VMs in a zone is rounded up.
During patching, a VM is considered disrupted from the time the agent is
notified to begin until patching has completed. This disruption time
includes the time to complete reboot and any post-patch steps.
A VM contributes to the disruption budget if its patching operation fails
either when applying the patches, running pre or post patch steps, or if it
fails to respond with a success notification before timing out. VMs that
are not running or do not have an active agent do not count toward this
disruption budget.
For zone-by-zone rollouts, if the disruption budget in a zone is exceeded,
the patch job stops, because continuing to the next zone requires
completion of the patch process in the previous zone.
For example, if the disruption budget has a fixed value of 10, and 8 VMs
fail to patch in the current zone, the patch job continues to patch 2 VMs
at a time until the zone is completed. When that zone is completed
successfully, patching begins with 10 VMs at a time in the next zone. If 10
VMs in the next zone fail to patch, the patch job stops.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-09 UTC."],[],[],null,["# Cloud OS Config V1 API - Class Google::Cloud::OsConfig::V1::PatchRollout (v1.4.0)\n\nVersion latestkeyboard_arrow_down\n\n- [1.4.0 (latest)](/ruby/docs/reference/google-cloud-os_config-v1/latest/Google-Cloud-OsConfig-V1-PatchRollout)\n- [1.3.0](/ruby/docs/reference/google-cloud-os_config-v1/1.3.0/Google-Cloud-OsConfig-V1-PatchRollout)\n- [1.2.1](/ruby/docs/reference/google-cloud-os_config-v1/1.2.1/Google-Cloud-OsConfig-V1-PatchRollout)\n- [1.1.0](/ruby/docs/reference/google-cloud-os_config-v1/1.1.0/Google-Cloud-OsConfig-V1-PatchRollout)\n- [1.0.1](/ruby/docs/reference/google-cloud-os_config-v1/1.0.1/Google-Cloud-OsConfig-V1-PatchRollout)\n- [0.16.0](/ruby/docs/reference/google-cloud-os_config-v1/0.16.0/Google-Cloud-OsConfig-V1-PatchRollout)\n- [0.15.2](/ruby/docs/reference/google-cloud-os_config-v1/0.15.2/Google-Cloud-OsConfig-V1-PatchRollout)\n- [0.14.0](/ruby/docs/reference/google-cloud-os_config-v1/0.14.0/Google-Cloud-OsConfig-V1-PatchRollout)\n- [0.13.0](/ruby/docs/reference/google-cloud-os_config-v1/0.13.0/Google-Cloud-OsConfig-V1-PatchRollout)\n- [0.12.0](/ruby/docs/reference/google-cloud-os_config-v1/0.12.0/Google-Cloud-OsConfig-V1-PatchRollout)\n- [0.11.0](/ruby/docs/reference/google-cloud-os_config-v1/0.11.0/Google-Cloud-OsConfig-V1-PatchRollout)\n- [0.10.0](/ruby/docs/reference/google-cloud-os_config-v1/0.10.0/Google-Cloud-OsConfig-V1-PatchRollout)\n- [0.9.1](/ruby/docs/reference/google-cloud-os_config-v1/0.9.1/Google-Cloud-OsConfig-V1-PatchRollout) \nReference documentation and code samples for the Cloud OS Config V1 API class Google::Cloud::OsConfig::V1::PatchRollout.\n\nPatch rollout configuration specifications. Contains details on the\nconcurrency control when applying patch(es) to all targeted VMs. \n\nInherits\n--------\n\n- Object \n\nExtended By\n-----------\n\n- Google::Protobuf::MessageExts::ClassMethods \n\nIncludes\n--------\n\n- Google::Protobuf::MessageExts\n\nMethods\n-------\n\n### #disruption_budget\n\n def disruption_budget() -\u003e ::Google::Cloud::OsConfig::V1::FixedOrPercent\n\n**Returns**\n\n- ([::Google::Cloud::OsConfig::V1::FixedOrPercent](./Google-Cloud-OsConfig-V1-FixedOrPercent)) --- The maximum number (or percentage) of VMs per zone to disrupt at any given moment. The number of VMs calculated from multiplying the percentage by the total number of VMs in a zone is rounded up.\n\n\n During patching, a VM is considered disrupted from the time the agent is\n notified to begin until patching has completed. This disruption time\n includes the time to complete reboot and any post-patch steps.\n\n A VM contributes to the disruption budget if its patching operation fails\n either when applying the patches, running pre or post patch steps, or if it\n fails to respond with a success notification before timing out. VMs that\n are not running or do not have an active agent do not count toward this\n disruption budget.\n\n For zone-by-zone rollouts, if the disruption budget in a zone is exceeded,\n the patch job stops, because continuing to the next zone requires\n completion of the patch process in the previous zone.\n\n For example, if the disruption budget has a fixed value of `10`, and 8 VMs\n fail to patch in the current zone, the patch job continues to patch 2 VMs\n at a time until the zone is completed. When that zone is completed\n successfully, patching begins with 10 VMs at a time in the next zone. If 10\n VMs in the next zone fail to patch, the patch job stops.\n\n### #disruption_budget=\n\n def disruption_budget=(value) -\u003e ::Google::Cloud::OsConfig::V1::FixedOrPercent\n\n**Parameter**\n\n- **value** ([::Google::Cloud::OsConfig::V1::FixedOrPercent](./Google-Cloud-OsConfig-V1-FixedOrPercent)) --- The maximum number (or percentage) of VMs per zone to disrupt at any given moment. The number of VMs calculated from multiplying the percentage by the total number of VMs in a zone is rounded up.\n\n\n During patching, a VM is considered disrupted from the time the agent is\n notified to begin until patching has completed. This disruption time\n includes the time to complete reboot and any post-patch steps.\n\n A VM contributes to the disruption budget if its patching operation fails\n either when applying the patches, running pre or post patch steps, or if it\n fails to respond with a success notification before timing out. VMs that\n are not running or do not have an active agent do not count toward this\n disruption budget.\n\n For zone-by-zone rollouts, if the disruption budget in a zone is exceeded,\n the patch job stops, because continuing to the next zone requires\n completion of the patch process in the previous zone.\n\n For example, if the disruption budget has a fixed value of `10`, and 8 VMs\n fail to patch in the current zone, the patch job continues to patch 2 VMs\n at a time until the zone is completed. When that zone is completed\n successfully, patching begins with 10 VMs at a time in the next zone. If 10\nVMs in the next zone fail to patch, the patch job stops. \n**Returns**\n\n- ([::Google::Cloud::OsConfig::V1::FixedOrPercent](./Google-Cloud-OsConfig-V1-FixedOrPercent)) --- The maximum number (or percentage) of VMs per zone to disrupt at any given moment. The number of VMs calculated from multiplying the percentage by the total number of VMs in a zone is rounded up.\n\n\n During patching, a VM is considered disrupted from the time the agent is\n notified to begin until patching has completed. This disruption time\n includes the time to complete reboot and any post-patch steps.\n\n A VM contributes to the disruption budget if its patching operation fails\n either when applying the patches, running pre or post patch steps, or if it\n fails to respond with a success notification before timing out. VMs that\n are not running or do not have an active agent do not count toward this\n disruption budget.\n\n For zone-by-zone rollouts, if the disruption budget in a zone is exceeded,\n the patch job stops, because continuing to the next zone requires\n completion of the patch process in the previous zone.\n\n For example, if the disruption budget has a fixed value of `10`, and 8 VMs\n fail to patch in the current zone, the patch job continues to patch 2 VMs\n at a time until the zone is completed. When that zone is completed\n successfully, patching begins with 10 VMs at a time in the next zone. If 10\n VMs in the next zone fail to patch, the patch job stops.\n\n### #mode\n\n def mode() -\u003e ::Google::Cloud::OsConfig::V1::PatchRollout::Mode\n\n**Returns**\n\n- ([::Google::Cloud::OsConfig::V1::PatchRollout::Mode](./Google-Cloud-OsConfig-V1-PatchRollout-Mode)) --- Mode of the patch rollout.\n\n### #mode=\n\n def mode=(value) -\u003e ::Google::Cloud::OsConfig::V1::PatchRollout::Mode\n\n**Parameter**\n\n- **value** ([::Google::Cloud::OsConfig::V1::PatchRollout::Mode](./Google-Cloud-OsConfig-V1-PatchRollout-Mode)) --- Mode of the patch rollout. \n**Returns**\n\n- ([::Google::Cloud::OsConfig::V1::PatchRollout::Mode](./Google-Cloud-OsConfig-V1-PatchRollout-Mode)) --- Mode of the patch rollout."]]
