Reference documentation and code samples for the Compute Engine v1 API enum DistributionPolicy.Types.TargetShape.
The distribution shape to which the group converges either proactively or on resize events (depending on the value set in updatePolicy.instanceRedistributionType).
The group picks zones for creating VM instances to fulfill the requested number of VMs within present resource constraints and to maximize utilization of unused zonal reservations. Recommended for batch workloads that do not require high availability.
AnySingleZone
The group creates all VM instances within a single zone. The zone is selected based on the present resource constraints and to maximize utilization of unused zonal reservations. Recommended for batch workloads with heavy interprocess communication.
Balanced
The group prioritizes acquisition of resources, scheduling VMs in zones where resources are available while distributing VMs as evenly as possible across selected zones to minimize the impact of zonal failure. Recommended for highly available serving workloads.
Even
The group schedules VM instance creation and deletion to achieve and maintain an even number of managed instances across the selected zones. The distribution is even when the number of managed instances does not differ by more than 1 between any two zones. Recommended for highly available serving workloads.
UndefinedTargetShape
A value indicating that the enum field is not set.
[[["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-08 UTC."],[[["\u003cp\u003eThe latest version of the \u003ccode\u003eGoogle.Cloud.Compute.V1.DistributionPolicy.Types.TargetShape\u003c/code\u003e is 3.6.0, and there are several previous versions available, ranging from 1.0.0 to 3.5.0.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eDistributionPolicy.Types.TargetShape\u003c/code\u003e is an enum in the Compute Engine v1 API, which determines the distribution shape for a group of virtual machine instances.\u003c/p\u003e\n"],["\u003cp\u003eThe enum \u003ccode\u003eDistributionPolicy.Types.TargetShape\u003c/code\u003e offers five possible fields: \u003ccode\u003eAny\u003c/code\u003e, \u003ccode\u003eAnySingleZone\u003c/code\u003e, \u003ccode\u003eBalanced\u003c/code\u003e, \u003ccode\u003eEven\u003c/code\u003e, and \u003ccode\u003eUndefinedTargetShape\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eEach field of \u003ccode\u003eDistributionPolicy.Types.TargetShape\u003c/code\u003e offers different instance zone priorities and utilization, such as \u003ccode\u003eAny\u003c/code\u003e being recommended for batch workloads and \u003ccode\u003eBalanced\u003c/code\u003e for highly available serving workloads.\u003c/p\u003e\n"],["\u003cp\u003eDocumentation and code samples for each version of the \u003ccode\u003eGoogle.Cloud.Compute.V1.DistributionPolicy.Types.TargetShape\u003c/code\u003e are provided and can be accessed via the given links.\u003c/p\u003e\n"]]],[],null,[]]
