Batch v1 API - Class TaskGroup (2.5.0)

public sealed class TaskGroup : IMessage<TaskGroup>, IEquatable<TaskGroup>, IDeepCloneable<TaskGroup>, IBufferMessage, IMessage

Reference documentation and code samples for the Batch v1 API class TaskGroup.

A TaskGroup defines one or more Tasks that all share the same TaskSpec.

Inheritance

object > TaskGroup

Namespace

Google.Cloud.Batch.V1

Assembly

Google.Cloud.Batch.V1.dll

Constructors

TaskGroup()

public TaskGroup()

TaskGroup(TaskGroup)

public TaskGroup(TaskGroup other)
Parameter
Name Description
other TaskGroup

Properties

Name

public string Name { get; set; }

Output only. TaskGroup name. The system generates this field based on parent Job name. For example: "projects/123456/locations/us-west1/jobs/job01/taskGroups/group01".

Property Value
Type Description
string

Parallelism

public long Parallelism { get; set; }

Max number of tasks that can run in parallel. Default to min(task_count, 1000). Field parallelism must be 1 if the scheduling_policy is IN_ORDER.

Property Value
Type Description
long

PermissiveSsh

public bool PermissiveSsh { get; set; }

When true, Batch will configure SSH to allow passwordless login between VMs running the Batch tasks in the same TaskGroup.

Property Value
Type Description
bool

RequireHostsFile

public bool RequireHostsFile { get; set; }

When true, Batch will populate a file with a list of all VMs assigned to the TaskGroup and set the BATCH_HOSTS_FILE environment variable to the path of that file. Defaults to false.

Property Value
Type Description
bool

SchedulingPolicy

public TaskGroup.Types.SchedulingPolicy SchedulingPolicy { get; set; }

Scheduling policy for Tasks in the TaskGroup. The default value is AS_SOON_AS_POSSIBLE.

Property Value
Type Description
TaskGroup Types SchedulingPolicy

TaskCount

public long TaskCount { get; set; }

Number of Tasks in the TaskGroup. Default is 1.

Property Value
Type Description
long

TaskCountPerNode

public long TaskCountPerNode { get; set; }

Max number of tasks that can be run on a VM at the same time. If not specified, the system will decide a value based on available compute resources on a VM and task requirements.

Property Value
Type Description
long

TaskEnvironments

public RepeatedField<Environment> TaskEnvironments { get; }

An array of environment variable mappings, which are passed to Tasks with matching indices. If task_environments is used then task_count should not be specified in the request (and will be ignored). Task count will be the length of task_environments.

Tasks get a BATCH_TASK_INDEX and BATCH_TASK_COUNT environment variable, in addition to any environment variables set in task_environments, specifying the number of Tasks in the Task's parent TaskGroup, and the specific Task's index in the TaskGroup (0 through BATCH_TASK_COUNT - 1).

Property Value
Type Description
RepeatedField Environment

TaskGroupName

public TaskGroupName TaskGroupName { get; set; }

TaskGroupName-typed view over the Name resource name property.

Property Value
Type Description
TaskGroupName

TaskSpec

public TaskSpec TaskSpec { get; set; }

Required. Tasks in the group share the same task spec.

Property Value
Type Description
TaskSpec

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025年11月05日 UTC.