Version history

Version 1.0.0-alpha31, released 2024-09-16

New features

• A new value CANCELLATION_IN_PROGRESS is added to enum State ( commit 7fbb002 )
• A new value CANCELLED is added to enum State ( commit 7fbb002 )

Documentation improvements

• Clarify tasks success criteria for background runnable ( commit 3b490fe )
• Batch CentOS images and HPC CentOS images are EOS ( commit 5cbb834 )

Version 1.0.0-alpha30, released 2024-08-13

New features

• Add block_project_ssh_keys field to the v1alpha job API to block project level ssh keys access to Batch created VMs ( commit 3a1b85f )
• Remove visibility restriction of cancel job api, allow in v1alpha ( commit 3a1b85f )
• Update Go Datastore import path ( commit 3a1b85f )
• Update Go Bigtable import path ( commit 3a1b85f )

Documentation improvements

• Refine usage scope for field task_execution and task_state in status_events ( commit 3a1b85f )
• Add instructions on how to configure cross-project pubsub publisher ( commit 5e272cf )
• Document default disk type: pd-standard for non boot disk, pd-balanced for boot disk ( commit 5e272cf )
• Update list of volume.mount_options field ( commit 5e272cf )
• Update GCS description of volume.mount_options field ( commit 5e272cf )
• Update links in the description of volume.mount_options field ( commit 5e272cf )

Version 1.0.0-alpha29, released 2024-06-04

New features

• Add a install_ops_agent field to InstancePolicyOrTemplate for Ops Agent support ( commit 81aaa3d )

Documentation improvements

• A comment for field max_run_duration in message google.cloud.batch.v1alpha.TaskSpec is changed ( commit 81aaa3d )
• Refine doc for the update_mask field in message google.cloud.batch.v1alpha.UpdateJobRequest ( commit 81aaa3d )
• Refine description for field task_execution ( commit f2e7e66 )

Version 1.0.0-alpha28, released 2024-05-13

New features

• Update description on allowed_locations in LocationPolicy field ( commit fb760fc )
• Add UpdateJob API to update the job spec, only task_count is supported now ( commit fb760fc )

Documentation improvements

• Updated comments ( commit fb760fc )

Version 1.0.0-alpha27, released 2024-05-08

New features

• Add IServiceCollection extension methods for client registration where an IServiceProvider is required. ( commit 022fab2 )

Version 1.0.0-alpha26, released 2024-04-19

Bug fixes

• BREAKING CHANGEAdded optional flag of an existing field limit , consumed , carryover in ResourceAllowance ( commit c3a0f2a )

New features

• Remove GOOGLE_INTERNAL restriction of update job api ( commit c3a0f2a )
• Add a service_account field to taskGroup for service account support ( commit c3a0f2a )

Documentation improvements

• State one Resource Allowance per region per project limitation on v1alpha ( commit 807a215 )
• A comment for field max_run_duration in message .google.cloud.batch.v1alpha.TaskSpec and .google.cloud.batch.v1.TaskSpec is changed ( commit 807a215 )
• Add non-negative restriction comment for usage_resource_allowance.spec.limit.limit exposed on v1alpha ( commit 807a215 )

Version 1.0.0-alpha25, released 2024-03-28

New features

• Onboard Resource Allowance API methods on v1alpha ( commit 7591fca )

Version 1.0.0-alpha24, released 2024-03-27

New features

• Two new proto files added to the build ( commit 605583b )

Version 1.0.0-alpha23, released 2024-03-26

New features

• Change netstandard2.1 target to netstandard2.0 ( commit 82bea85 )

Version 1.0.0-alpha22, released 2024-02-28

Documentation improvements

• Remove UUID specification in comment ( commit 8951fe6 )
• Add caution messages for container runnable username and password fields ( commit 7377638 )
• Refine proto comment for run_as_non_root ( commit 7377638 )

Version 1.0.0-alpha21, released 2024-02-08

Bug fixes

• BREAKING CHANGERemove deprecated field enableOslogin ( commit 1531c7e )

Documentation improvements

• Polish the field descriptions for enableImageStreaming and CloudLoggingOptions ( commit 5570490 )

Version 1.0.0-alpha20, released 2024-01-16

New features

• Add tags field in Job's AllocationPolicy field in v1alpha ( commit c6fb071 )
• Add a run_as_non_root field and deprecate enable_oslogin for non-root execution ( commit c6fb071 )

Documentation improvements

• Updated comments ( commit c6fb071 )

Version 1.0.0-alpha19, released 2023-12-04

New features

• Add TaskGroup.enable_oslogin to give the Batch job submitter the ability to run runnables as non-root controlled by IAM ( commit 05eda0b )
• Add a CloudLoggingOption and use_generic_task_monitored_resource fields for users to opt out new batch monitored resource in cloud logging ( commit eecc6fa )

Documentation improvements

• Update documentation for the network field of AllocationPolicy ( commit 05eda0b )
• Add clarification for TaskGroup.parallelism ( commit cbd5658 )

Version 1.0.0-alpha18, released 2023-10-30

New features

• Add the support for the batch hpc rocky linux image ( commit 2821fdb )
• Add InstancePolicy.reservation field for restricting jobs to a specific reservation ( commit 2821fdb )

Documentation improvements

• Elaborate the usage of Container.volumes proto field ( commit 2821fdb )
• Update batch PD interface support ( commit cf83a21 )
• Update description on size_gb in disk field ( commit 1e2a648 )

Version 1.0.0-alpha17, released 2023-08-23

New features

• Add stderr_snippet to indicate the real stderr output by runnables to the execution field of status event ( commit db9f8f2 )

Documentation improvements

• Update comments ( commit db9f8f2 )

Version 1.0.0-alpha16, released 2023-08-22

New features

• Add more compute resource API descriptions to match with VM's machine type field ( commit 2a9340b )
• Clarify Batch API proto doc about pubsub notifications ( commit 2a9340b )
• Add Batch Managed Container support for v1alpha ( commit 2a9340b )

Version 1.0.0-alpha15, released 2023-08-16

New features

• Clarify Batch API proto doc about pubsub notifications ( commit a436f6c )
• Add Batch Managed Container support for v1alpha ( commit a436f6c )

Version 1.0.0-alpha14, released 2023-08-04

New features

• Enable gpu driver version field on v1 ( commit 08fd6c5 )

Documentation improvements

• Mark order_by field in ListTasksRequest as not implemented. ( commit 08fd6c5 )
• Improve url examples in comments ( commit 08fd6c5 )

Version 1.0.0-alpha13, released 2023-07-13

New features

• Add gpu driver version field ( commit 2836b1b )

Documentation improvements

• Add image shortcut example for Batch HPC CentOS Image ( commit 2836b1b )

Version 1.0.0-alpha12, released 2023-06-20

New features

• Implement minCpuPlatform ( commit 6fcb3d6 )
• Enable scheduling_policy in v1 ( commit 6fcb3d6 )
• Update TaskGroup doc ( commit 6fcb3d6 )

Version 1.0.0-alpha11, released 2023-05-26

Bug fixes

• Override HTTP URLs for LRO cancel/delete operations ( commit 82d9df4 )

New features

• Support order_by in ListJobs and ListTasks requests ( issue 21 ) ( commit 2890c2a )

Version 1.0.0-alpha10, released 2023-04-19

New features

• Add TaskStatus's new terminated state UNEXECUTED ( commit c721955 )
• Add scheduling_policy IN_ORDER enum to support sequential task executions ( commit c721955 )
• Add support for placement policies ( commit c721955 )

Documentation improvements

• Update comments on boot disk fields for clearer usage scope ( commit c721955 )
• Update block_external_network field comment to reduce confusion ( commit c721955 )
• Update disk and network field comment for better readability ( commit c721955 )
• Fix book disk typo ( commit c721955 )
• Update reservation field API doc ( commit c721955 )

Version 1.0.0-alpha09, released 2023-03-09

BREAKING CHANGE

BatchServiceClient no longer exposes an IAMPolicyClient . This was only exposed unintentionally, and has never worked. However, this is still a breaking change as application code may have referred to it.

New features

• Resource usage ( commit 80fe952 )

Documentation improvements

• Update comments ( commit 80fe952 )

Version 1.0.0-alpha08, released 2023-02-08

New features

• Support custom scopes for service account in v1 ( commit 7e2eb5a )
• Add boot disk field in InstanceStatus ( commit 7e2eb5a )
• Add boot disk and image source fields to v1 InstancePolicy ( commit 7e2eb5a )

Version 1.0.0-alpha07, released 2023-01-18

New features

• Enable REST transport in C# ( commit 0f8560c )

Version 1.0.0-alpha06, released 2023-01-16

Bug fixes

• ServiceAccount.scopes is no longer deprecated ( commit d15829b )
• Removed unused endpoints for IAM methods ( commit d15829b )

New features

• Add InstancePolicy.boot_disk ( commit d15829b )

Documentation improvements

• Updated documentation for message NetworkInterface ( commit acb6f8f )

Version 1.0.0-alpha05, released 2022-12-01

New features

• Adds named reservation to InstancePolicy ( commit 9072a1f )

Documentation improvements

• Fix minor docstring formatting ( commit 96622fc )
• Remove "not yet implemented" for Accelerator & Refine Volume API docs ( commit 9072a1f )
• Update the job id format requirement ( commit 9072a1f )
• Fix minor docstring formatting ( commit c976c7c )

Version 1.0.0-alpha04, released 2022-10-17

Documentation improvements

• Refine GPU drivers installation proto description ( commit 3fb17e8 )
• Refine comments for deprecated proto fields ( commit 3fb17e8 )
• Update the API comments about the device_name ( commit 3fb17e8 )

Version 1.0.0-alpha03, released 2022-09-05

Bug fixes

• Mark service_account_email as deprecated ( commit 28348ae )

Documentation improvements

• Removing comment from a deprecated field ( commit 28348ae )

Version 1.0.0-alpha02, released 2022-08-26

New features

• Environment variables, disk interfaces ( commit 981712a ) ## Version 1.0.0-alpha01, released 2022-07-14

No API surface changes; just dependency updates.

Version 1.0.0-alpha00, released 2022-06-24

Initial release.