As of January 1, 2020 this library no longer supports Python 2 on the latest released version. Library versions released prior to that date will continue to be available. For more information please visit Python 2 support on Google Cloud.

Changelog

0.17.31 (2024-10-31)

Bug Fixes

  • disable universe-domain validation (4ed4108)

0.17.30 (2024-10-24)

Features

0.17.29 (2024-10-08)

Documentation

  • Clarify Batch only supports global custom instance template now (023d099)

0.17.28 (2024-09-16)

Features

  • [google-cloud-batch] A new value CANCELLATION_IN_PROGRESS is added to enum State (#13074) (76267b2)

0.17.27 (2024-09-03)

Features

  • v1: promote block_project_ssh_keys support to batch v1 API (63a6de0)

0.17.26 (2024-08-20)

Documentation

  • [google-cloud-batch] clarify tasks success criteria for background (e3a6b17)

  • [google-cloud-batch] clarify tasks success criteria for background runnable (#13023) (e3a6b17)

0.17.25 (2024-08-19)

Documentation

  • Batch CentOS images and HPC CentOS images are EOS (5f179b9)

  • Clarify required fields for Runnable.Container (5f179b9)

  • Clarify required oneof fields for Runnable.Script (5f179b9)

  • Clarify TaskSpec requires one or more runnables (5f179b9)

0.17.24 (2024-08-08)

Features

  • add block_project_ssh_keys field to the v1alpha job API to block project level ssh keys access to Batch created VMs (56ec4fc)

  • remove visibility restriction of cancel job api, allow in v1alpha (56ec4fc)

Documentation

  • Refine usage scope for field task_execution and task_state in status_events (56ec4fc)

0.17.23 (2024-07-30)

Bug Fixes

  • Retry and timeout values do not propagate in requests during pagination (6e83a37)

0.17.22 (2024-07-08)

Bug Fixes

0.17.21 (2024-06-05)

Documentation

  • Documentation improvements (7e19b0e)

0.17.20 (2024-05-16)

Features

  • Add UpdateJob API to update the job spec, only task_count is supported now (b855629)

  • Update description on allowed_locations in LocationPolicy field (b855629)

Documentation

  • [google-cloud-batch] Refine description for field task_execution (f149fb8)

  • [google-cloud-batch] Refine description for field task_execution (#12693) (f149fb8)

  • updated comments (b855629)

0.17.19 (2024-05-07)

Documentation

  • Update description on allowed_locations in LocationPolicy field (ae30a4e)

0.17.18 (2024-04-15)

Features

  • Add a service_account field to taskGroup for service account support (93b90df)

Bug Fixes

  • Add optional flag of existing fields limit and consumed in ResourceAllowance (93b90df)

Documentation

  • Update comments for ServiceAccount email and scopes fields (93b90df)

0.17.17 (2024-04-04)

Documentation

  • A comment for field max_run_duration in message .google.cloud.batch.v1alpha.TaskSpec and .google.cloud.batch.v1.TaskSpec is changed (3d35d8b)

  • add non-negative restriction comment for usage_resource_allowance.spec.limit.limit exposed on v1alpha (3d35d8b)

  • state one Resource Allowance per region per project limitation on v1alpha (3d35d8b)

0.17.16 (2024-04-03)

Documentation

  • add non-negative restriction comment for usage_resource_allowance.spec.limit.limit exposed on v1alpha (4be4f8d)

  • state one Resource Allowance per region per project limitation on v1alpha (4be4f8d)

0.17.15 (2024-03-28)

Features

  • [google-cloud-batch] onboard Resource Allowance API methods on v1alpha (#12524) (3092827)

0.17.14 (2024-03-05)

Bug Fixes

0.17.13 (2024-03-04)

Documentation

  • [google-cloud-batch] Remove UUID specification in comment (#12366) (13c7f8f)

  • [google-cloud-batch] update description of Job uid field (13c7f8f)

0.17.12 (2024-02-22)

Bug Fixes

  • [Many APIs] fix ValueError in test__validate_universe_domain (#12280) (2d75d0e)

  • deps: [Many APIs] Require google-api-core>=1.34.1 (#12304) (c52e0cd)

Documentation

  • add caution messages for container runnable username and password fields (9379366)

  • refine proto comment for run_as_non_root (9379366)

0.17.11 (2024-02-06)

Bug Fixes

  • Add google-auth as a direct dependency (8465244)

  • Add staticmethod decorator to _get_client_cert_source and _get_api_endpoint (8465244)

  • Resolve AttributeError ‘Credentials’ object has no attribute ‘universe_domain’ (8465244)

0.17.10 (2024-02-01)

Features

  • Allow users to explicitly configure universe domain (a0392ee)

0.17.9 (2024-01-24)

Features

  • Add run_as_non_root field to allow user’s runnable be executed as non root (7d78274)

  • Add tags field in Job’s AllocationPolicy field in v1 (7d78274)

  • Add Batch Image Streaming support for v1 (7d78274)

Documentation

  • [google-cloud-batch] Polish the field descriptions for enableImageStreaming and CloudLoggingOptions (#12216) (d23ec54)

0.17.8 (2024-01-22)

Bug Fixes

  • v1alpha: [google-cloud-batch] remove deprecated field enableOslogin (#12210) (527862b)

0.17.7 (2024-01-12)

Features

  • Add run_as_non_root field and deprecate enable_oslogin for non-root execution (ce7ddbf)

  • Add tags field in Job’s AllocationPolicy field in v1alpha (ce7ddbf)

Documentation

0.17.6 (2023-12-07)

Features

  • Add support for python 3.12 (ea6cfc2)

  • Introduce compatibility with native namespace packages (ea6cfc2)

Bug Fixes

  • Require proto-plus >= 1.22.3 (ea6cfc2)

  • Use retry_async instead of retry in async client (ea6cfc2)

0.17.5 (2023-11-29)

Features

  • Add a CloudLoggingOption to configure additional settings for Cloud Logging (9c53819)

  • v1alpha: Add TaskGroup.enable_oslogin to give the Batch job submitter the ability to run runnables as non-root controlled by IAM (5392065)

Documentation

  • Update comment for AllocationPolicy.network (9c53819)

  • v1alpha: Update documentation for the network field of AllocationPolicy (5392065)

0.17.4 (2023-11-14)

Features

  • [google-cloud-batch] add a CloudLoggingOption and use_generic_task_monitored_resource fields for users to opt out new batch monitored resource in cloud logging (#12019) (13fd2e1)

0.17.3 (2023-11-02)

Documentation

  • Add clarification for TaskGroup.parallelism (9cd9608)

  • update default max parallel tasks per job (#11940) (9cd9608)

0.17.2 (2023-10-19)

Features

  • expose display_name to batch v1 API (8235ef6)

0.17.1 (2023-09-30)

Documentation

  • update batch PD interface support (a300b07)

0.17.0 (2023-08-31)

Features

  • add Batch Managed Container support for v1alpha (37e457c)

  • Add more compute resource API descriptions to match with VM’s machine type field (37e457c)

  • add stderr_snippet to indicate the real stderr output by runnables to the execution field of status event (1a8670d)

  • Clarify Batch API proto doc about pubsub notifications (37e457c)

Documentation

  • Clarify Batch API proto doc about pubsub notifications (1a8670d)

  • Expand compute resource API docs to match with VM’s machine type field (1a8670d)

  • Update description on size_gb in disk field (#11615) (d46f714)

0.16.0 (2023-08-09)

Features

  • Add Batch Managed Container support for v1alpha (0e7f0b0)

  • Clarify Batch API proto doc about pubsub notifications (0e7f0b0)

Documentation

  • Clarify Batch API proto doc about pubsub notifications (#11550) (4a8107a)

0.15.0 (2023-08-03)

Features

  • allow order_by for v1 ListJobs (f5f6d35)

  • Enable gpu driver version field on v1 (f5f6d35)

Documentation

  • Add comment to the unsupported order_by field of ListTasksRequest (f5f6d35)

  • Improve url examples formats on Batch API comments (f5f6d35)

0.14.0 (2023-07-25)

Features

  • v1alpha: Enable gpu driver version field (2528a8e)

Documentation

  • v1alpha: Improve url examples in comments (2528a8e)

  • v1alpha: Mark order_by field in ListTasksRequest as not implemented. (2528a8e)

0.13.0 (2023-07-04)

Features

  • v1alpha: Add gpu driver version field (fa1e00b)

Bug Fixes

  • Add async context manager return types (#122) (57f49cc)

Documentation

  • v1: Add image shortcut example for Batch HPC CentOS Image (#119) (cc9d65a)

  • v1alpha: Add image shortcut example for Batch HPC CentOS Image (fa1e00b)

0.12.0 (2023-06-14)

Features

  • v1: Add support for scheduling_policy (23d3a5e)

Documentation

  • Minor clarifications for TaskGroup and min_cpu_platform (23d3a5e)

0.11.0 (2023-05-25)

Features

  • v1: Add support for per-Runnable labels (977ce57)

  • v1: Add support for placement policies (977ce57)

  • v1alpha: Add support for placement policies (be22675)

  • v1alpha: Support order_by in ListJobs and ListTasks requests (be22675)

0.10.0 (2023-03-16)

Features

  • Added StatusEvent.task_state (de68b7c)

Bug Fixes

Documentation

0.9.0 (2023-02-04)

Features

  • Add boot disk field in InstancePolicy (3a73b21)

  • Add boot disk field in InstanceStatus (3a73b21)

  • Support custom scopes for service account (3a73b21)

0.8.1 (2023-01-20)

Bug Fixes

  • Add context manager return types (695d075)

Documentation

  • Add documentation for enums (695d075)

0.8.0 (2023-01-10)

Features

0.7.0 (2023-01-04)

Features

  • Support secret and encrypted environment variables in v1 (711e132)

Documentation

  • Updated documentation for message NetworkInterface (711e132)

0.6.0 (2022-12-15)

Features

  • Add InstancePolicy.boot_disk (7e275de)

Bug Fixes

  • Removed unused endpoints for IAM methods (7e275de)

  • rest: Remove unsupported HTTP bindings for IAMPolicy RPCs (7e275de)

  • ServiceAccount.scopes is no longer deprecated (7e275de)

0.5.0 (2022-12-07)

Features

  • add support for google.cloud.batch.__version__ (2f6bdca)

  • Add typing to proto.Message based class attributes (2f6bdca)

  • Adds named reservation to InstancePolicy (9414457)

Bug Fixes

  • Add dict typing for client_options (2f6bdca)

  • deps: Require google-api-core >=1.34.0, >=2.11.0 (1b70819)

  • Drop usage of pkg_resources (1b70819)

  • Fix timeout default values (1b70819)

Documentation

  • Remove “not yet implemented” for Accelerator & Refine Volume API docs (9414457)

  • samples: Snippetgen handling of repeated enum field (2f6bdca)

  • samples: Snippetgen should call await on the operation coroutine before calling result (1b70819)

  • update the job id format requirement (9414457)

0.4.1 (2022-10-27)

Documentation

  • samples: Adding code samples for log reading (#56) (9b44e35)

0.4.0 (2022-10-18)

Features

  • Enable install_gpu_drivers flag in v1 proto (e7b8681)

Documentation

  • Refine comments for deprecated proto fields (e7b8681)

  • Refine comments for deprecated proto fields (e7b8681)

  • Refine GPU drivers installation proto description (e7b8681)

  • Refine GPU drivers installation proto description (#57) (e7b8681)

  • Update the API comments about the device_name (e7b8681)

  • Update the API comments about the device_name (e7b8681)

0.3.2 (2022-10-10)

Bug Fixes

  • deps: Allow protobuf 3.19.5 (#53) (db79e36)

  • deps: require google-api-core>=1.33.2 (db79e36)

0.3.1 (2022-10-03)

Bug Fixes

  • deps: Require protobuf >= 3.20.2 (#47) (aa83e55)

Documentation

  • samples: Adding sample for bucket mounting (#43) (af33ed9)

  • samples: Adding samples for list and get tasks (#50) (9401da1)

  • samples: Adding samples for template usage (#41) (7376708)

0.3.0 (2022-09-16)

Features

Bug Fixes

  • deps: require google-api-core>=1.33.1,>=2.8.0 (e48b9ba)

  • deps: require protobuf >= 3.20.1 (e48b9ba)

Documentation

  • samples: Adding first sample code + tests (#22) (d8a4864)

0.2.0 (2022-08-31)

Features

0.1.2 (2022-08-11)

Bug Fixes

  • deps: allow protobuf < 5.0.0 (#12) (2e7628d)

  • deps: require proto-plus >= 1.22.0 (2e7628d)

0.1.1 (2022-07-18)

Bug Fixes

  • deps: require google-api-core>=1.32.0,>=2.8.0 (#5) (2c70ad2)

0.1.0 (2022-07-08)

Features