Package Classes (0.17.17)

Summary of entries of Classes for batch.

Classes

BatchServiceAsyncClient

Google Batch Service. The service manages user submitted batch jobs and allocates Google Compute Engine VM instances to run the jobs.

BatchServiceClient

Google Batch Service. The service manages user submitted batch jobs and allocates Google Compute Engine VM instances to run the jobs.

ListJobsAsyncPager

A pager for iterating through list_jobs requests.

This class thinly wraps an initial ListJobsResponse object, and provides an __aiter__ method to iterate through its jobs field.

If there are more pages, the __aiter__ method will make additional ListJobs requests and continue to iterate through the jobs field on the corresponding responses.

All the usual ListJobsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListJobsPager

A pager for iterating through list_jobs requests.

This class thinly wraps an initial ListJobsResponse object, and provides an __iter__ method to iterate through its jobs field.

If there are more pages, the __iter__ method will make additional ListJobs requests and continue to iterate through the jobs field on the corresponding responses.

All the usual ListJobsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListTasksAsyncPager

A pager for iterating through list_tasks requests.

This class thinly wraps an initial ListTasksResponse object, and provides an __aiter__ method to iterate through its tasks field.

If there are more pages, the __aiter__ method will make additional ListTasks requests and continue to iterate through the tasks field on the corresponding responses.

All the usual ListTasksResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListTasksPager

A pager for iterating through list_tasks requests.

This class thinly wraps an initial ListTasksResponse object, and provides an __iter__ method to iterate through its tasks field.

If there are more pages, the __iter__ method will make additional ListTasks requests and continue to iterate through the tasks field on the corresponding responses.

All the usual ListTasksResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

AllocationPolicy

A Job's resource allocation policy describes when, where, and how compute resources should be allocated for the Job.

Accelerator

Accelerator describes Compute Engine accelerators to be attached to the VM.

AttachedDisk

A new or an existing persistent disk (PD) or a local ssd attached to a VM instance.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Disk

A new persistent disk or a local ssd. A VM can only have one local SSD setting but multiple local SSD partitions. See https://cloud.google.com/compute/docs/disks#pdspecs and https://cloud.google.com/compute/docs/disks#localssds.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

InstancePolicy

InstancePolicy describes an instance type and resources attached to each VM created by this InstancePolicy.

InstancePolicyOrTemplate

InstancePolicyOrTemplate lets you define the type of resources to use for this job either with an InstancePolicy or an instance template. If undefined, Batch picks the type of VM to use and doesn't include optional VM resources such as GPUs and extra disks.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

LabelsEntry

The abstract base class for a message.

LocationPolicy

NetworkInterface

A network interface.

NetworkPolicy

NetworkPolicy describes VM instance network configurations.

PlacementPolicy

PlacementPolicy describes a group placement policy for the VMs controlled by this AllocationPolicy.

ProvisioningModel

Compute Engine VM instance provisioning model.

Values: PROVISIONING_MODEL_UNSPECIFIED (0): Unspecified. STANDARD (1): Standard VM. SPOT (2): SPOT VM. PREEMPTIBLE (3): Preemptible VM (PVM).

    Above SPOT VM is the preferable model for
    preemptible VM instances: the old preemptible VM
    model (indicated by this field) is the older
    model, and has been migrated to use the SPOT
    model as the underlying technology. This old
    model will still be supported.

ComputeResource

Compute resource requirements.

ComputeResource defines the amount of resources required for each task. Make sure your tasks have enough resources to successfully run. If you also define the types of resources for a job to use with the InstancePolicyOrTemplate <https://cloud.google.com/batch/docs/reference/rest/v1/projects.locations.jobs#instancepolicyortemplate>__ field, make sure both fields are compatible with each other.

CreateJobRequest

CreateJob Request.

DeleteJobRequest

DeleteJob Request.

Environment

An Environment describes a collection of environment variables to set when executing Tasks.

KMSEnvMap

SecretVariablesEntry

The abstract base class for a message.

VariablesEntry

The abstract base class for a message.

GCS

Represents a Google Cloud Storage volume.

GetJobRequest

GetJob Request.

GetTaskRequest

Request for a single Task by name.

Job

The Cloud Batch Job description.

LabelsEntry

The abstract base class for a message.

JobNotification

Notification configurations.

Message

Message details. Describe the conditions under which messages will be sent. If no attribute is defined, no message will be sent by default. One message should specify either the job or the task level attributes, but not both. For example, job level: JOB_STATE_CHANGED and/or a specified new_job_state; task level: TASK_STATE_CHANGED and/or a specified new_task_state.

Type

The message type.

Values: TYPE_UNSPECIFIED (0): Unspecified. JOB_STATE_CHANGED (1): Notify users that the job state has changed. TASK_STATE_CHANGED (2): Notify users that the task state has changed.

JobStatus

Job status.

InstanceStatus

VM instance status.

State

Valid Job states.

Values: STATE_UNSPECIFIED (0): Job state unspecified. QUEUED (1): Job is admitted (validated and persisted) and waiting for resources. SCHEDULED (2): Job is scheduled to run as soon as resource allocation is ready. The resource allocation may happen at a later time but with a high chance to succeed. RUNNING (3): Resource allocation has been successful. At least one Task in the Job is RUNNING. SUCCEEDED (4): All Tasks in the Job have finished successfully. FAILED (5): At least one Task in the Job has failed. DELETION_IN_PROGRESS (6): The Job will be deleted, but has not been deleted yet. Typically this is because resources used by the Job are still being cleaned up.

TaskGroupStatus

Aggregated task status for a TaskGroup.

CountsEntry

The abstract base class for a message.

TaskGroupsEntry

The abstract base class for a message.

LifecyclePolicy

LifecyclePolicy describes how to deal with task failures based on different conditions.

Action

Action on task failures based on different conditions.

Values: ACTION_UNSPECIFIED (0): Action unspecified. RETRY_TASK (1): Action that tasks in the group will be scheduled to re-execute. FAIL_TASK (2): Action that tasks in the group will be stopped immediately.

ActionCondition

Conditions for actions to deal with task failures.

ListJobsRequest

ListJob Request.

ListJobsResponse

ListJob Response.

ListTasksRequest

ListTasks Request.

ListTasksResponse

ListTasks Response.

LogsPolicy

LogsPolicy describes how outputs from a Job's Tasks (stdout/stderr) will be preserved.

CloudLoggingOption

CloudLoggingOption contains additional settings for Cloud Logging logs generated by Batch job.

Destination

The destination (if any) for logs.

Values: DESTINATION_UNSPECIFIED (0): Logs are not preserved. CLOUD_LOGGING (1): Logs are streamed to Cloud Logging. PATH (2): Logs are saved to a file path.

NFS

Represents an NFS volume.

OperationMetadata

Represents the metadata of the long-running operation.

Runnable

Runnable describes instructions for executing a specific script or container as part of a Task.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Barrier

Barrier runnable blocks until all tasks in a taskgroup reach it.

Container

Container runnable.

LabelsEntry

The abstract base class for a message.

Script

Script runnable.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ServiceAccount

Carries information about a Google Cloud service account.

StatusEvent

Status event

Task

A Cloud Batch task.

TaskExecution

This Task Execution field includes detail information for task execution procedures, based on StatusEvent types.

TaskGroup

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

SchedulingPolicy

How Tasks in the TaskGroup should be scheduled relative to each other.

Values: SCHEDULING_POLICY_UNSPECIFIED (0): Unspecified. AS_SOON_AS_POSSIBLE (1): Run Tasks as soon as resources are available.

    Tasks might be executed in parallel depending on parallelism
    and task_count values.
IN_ORDER (2):
    Run Tasks sequentially with increased task
    index.

TaskSpec

Spec of a task

EnvironmentsEntry

The abstract base class for a message.

TaskStatus

Status of a task

State

Task states.

Values: STATE_UNSPECIFIED (0): Unknown state. PENDING (1): The Task is created and waiting for resources. ASSIGNED (2): The Task is assigned to at least one VM. RUNNING (3): The Task is running. FAILED (4): The Task has failed. SUCCEEDED (5): The Task has succeeded. UNEXECUTED (6): The Task has not been executed when the Job finishes.

Volume

Volume describes a volume and parameters for it to be mounted to a VM.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

BatchServiceAsyncClient

Google Batch Service. The service manages user submitted batch jobs and allocates Google Compute Engine VM instances to run the jobs.

BatchServiceClient

Google Batch Service. The service manages user submitted batch jobs and allocates Google Compute Engine VM instances to run the jobs.

ListJobsAsyncPager

A pager for iterating through list_jobs requests.

This class thinly wraps an initial ListJobsResponse object, and provides an __aiter__ method to iterate through its jobs field.

If there are more pages, the __aiter__ method will make additional ListJobs requests and continue to iterate through the jobs field on the corresponding responses.

All the usual ListJobsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListJobsPager

A pager for iterating through list_jobs requests.

This class thinly wraps an initial ListJobsResponse object, and provides an __iter__ method to iterate through its jobs field.

If there are more pages, the __iter__ method will make additional ListJobs requests and continue to iterate through the jobs field on the corresponding responses.

All the usual ListJobsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListResourceAllowancesAsyncPager

A pager for iterating through list_resource_allowances requests.

This class thinly wraps an initial ListResourceAllowancesResponse object, and provides an __aiter__ method to iterate through its resource_allowances field.

If there are more pages, the __aiter__ method will make additional ListResourceAllowances requests and continue to iterate through the resource_allowances field on the corresponding responses.

All the usual ListResourceAllowancesResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListResourceAllowancesPager

A pager for iterating through list_resource_allowances requests.

This class thinly wraps an initial ListResourceAllowancesResponse object, and provides an __iter__ method to iterate through its resource_allowances field.

If there are more pages, the __iter__ method will make additional ListResourceAllowances requests and continue to iterate through the resource_allowances field on the corresponding responses.

All the usual ListResourceAllowancesResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListTasksAsyncPager

A pager for iterating through list_tasks requests.

This class thinly wraps an initial ListTasksResponse object, and provides an __aiter__ method to iterate through its tasks field.

If there are more pages, the __aiter__ method will make additional ListTasks requests and continue to iterate through the tasks field on the corresponding responses.

All the usual ListTasksResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListTasksPager

A pager for iterating through list_tasks requests.

This class thinly wraps an initial ListTasksResponse object, and provides an __iter__ method to iterate through its tasks field.

If there are more pages, the __iter__ method will make additional ListTasks requests and continue to iterate through the tasks field on the corresponding responses.

All the usual ListTasksResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

AllocationPolicy

A Job's resource allocation policy describes when, where, and how compute resources should be allocated for the Job.

Accelerator

Accelerator describes Compute Engine accelerators to be attached to the VM.

AttachedDisk

A new or an existing persistent disk (PD) or a local ssd attached to a VM instance.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Disk

A new persistent disk or a local ssd. A VM can only have one local SSD setting but multiple local SSD partitions. See https://cloud.google.com/compute/docs/disks#pdspecs and https://cloud.google.com/compute/docs/disks#localssds.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

InstancePolicy

InstancePolicy describes an instance type and resources attached to each VM created by this InstancePolicy.

InstancePolicyOrTemplate

InstancePolicyOrTemplate lets you define the type of resources to use for this job either with an InstancePolicy or an instance template. If undefined, Batch picks the type of VM to use and doesn't include optional VM resources such as GPUs and extra disks.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

LabelsEntry

The abstract base class for a message.

LocationPolicy

NetworkInterface

A network interface.

NetworkPolicy

NetworkPolicy describes VM instance network configurations.

PlacementPolicy

PlacementPolicy describes a group placement policy for the VMs controlled by this AllocationPolicy.

ProvisioningModel

Compute Engine VM instance provisioning model.

Values: PROVISIONING_MODEL_UNSPECIFIED (0): Unspecified. STANDARD (1): Standard VM. SPOT (2): SPOT VM. PREEMPTIBLE (3): Preemptible VM (PVM).

    Above SPOT VM is the preferable model for
    preemptible VM instances: the old preemptible VM
    model (indicated by this field) is the older
    model, and has been migrated to use the SPOT
    model as the underlying technology. This old
    model will still be supported.

CalendarPeriod

A CalendarPeriod represents the abstract concept of a time period that has a canonical start. All calendar times begin at 12 AM US and Canadian Pacific Time (UTC-8).

Values: CALENDAR_PERIOD_UNSPECIFIED (0): Unspecified. MONTH (1): The month starts on the first date of the month and resets at the beginning of each month. QUARTER (2): The quarter starts on dates January 1, April 1, July 1, and October 1 of each year and resets at the beginning of the next quarter. YEAR (3): The year starts on January 1 and resets at the beginning of the next year. WEEK (4): The week period starts and resets every Monday. DAY (5): The day starts at 12:00am.

ComputeResource

Compute resource requirements.

ComputeResource defines the amount of resources required for each task. Make sure your tasks have enough resources to successfully run. If you also define the types of resources for a job to use with the InstancePolicyOrTemplate <https://cloud.google.com/batch/docs/reference/rest/v1/projects.locations.jobs#instancepolicyortemplate>__ field, make sure both fields are compatible with each other.

CreateJobRequest

CreateJob Request.

CreateResourceAllowanceRequest

CreateResourceAllowance Request.

DeleteJobRequest

DeleteJob Request.

DeleteResourceAllowanceRequest

DeleteResourceAllowance Request.

Environment

An Environment describes a collection of environment variables to set when executing Tasks.

KMSEnvMap

SecretVariablesEntry

The abstract base class for a message.

VariablesEntry

The abstract base class for a message.

GCS

Represents a Google Cloud Storage volume.

GetJobRequest

GetJob Request.

GetResourceAllowanceRequest

GetResourceAllowance Request.

GetTaskRequest

Request for a single Task by name.

Job

The Cloud Batch Job description.

LabelsEntry

The abstract base class for a message.

SchedulingPolicy

The order that TaskGroups are scheduled relative to each other. Not yet implemented.

Values: SCHEDULING_POLICY_UNSPECIFIED (0): Unspecified. AS_SOON_AS_POSSIBLE (1): Run all TaskGroups as soon as possible.

JobDependency

JobDependency describes the state of other Jobs that the start of this Job depends on. All dependent Jobs must have been submitted in the same region.

ItemsEntry

The abstract base class for a message.

Type

Dependency type.

Values: TYPE_UNSPECIFIED (0): Unspecified. SUCCEEDED (1): The dependent Job has succeeded. FAILED (2): The dependent Job has failed. FINISHED (3): SUCCEEDED or FAILED.

JobNotification

Notification configurations.

Message

Message details. Describe the conditions under which messages will be sent. If no attribute is defined, no message will be sent by default. One message should specify either the job or the task level attributes, but not both. For example, job level: JOB_STATE_CHANGED and/or a specified new_job_state; task level: TASK_STATE_CHANGED and/or a specified new_task_state.

Type

The message type.

Values: TYPE_UNSPECIFIED (0): Unspecified. JOB_STATE_CHANGED (1): Notify users that the job state has changed. TASK_STATE_CHANGED (2): Notify users that the task state has changed.

JobStatus

Job status.

InstanceStatus

VM instance status.

State

Valid Job states.

Values: STATE_UNSPECIFIED (0): Job state unspecified. QUEUED (1): Job is admitted (validated and persisted) and waiting for resources. SCHEDULED (2): Job is scheduled to run as soon as resource allocation is ready. The resource allocation may happen at a later time but with a high chance to succeed. RUNNING (3): Resource allocation has been successful. At least one Task in the Job is RUNNING. SUCCEEDED (4): All Tasks in the Job have finished successfully. FAILED (5): At least one Task in the Job has failed. DELETION_IN_PROGRESS (6): The Job will be deleted, but has not been deleted yet. Typically this is because resources used by the Job are still being cleaned up.

TaskGroupStatus

Aggregated task status for a TaskGroup.

CountsEntry

The abstract base class for a message.

TaskGroupsEntry

The abstract base class for a message.

LifecyclePolicy

LifecyclePolicy describes how to deal with task failures based on different conditions.

Action

Action on task failures based on different conditions.

Values: ACTION_UNSPECIFIED (0): Action unspecified. RETRY_TASK (1): Action that tasks in the group will be scheduled to re-execute. FAIL_TASK (2): Action that tasks in the group will be stopped immediately.

ActionCondition

Conditions for actions to deal with task failures.

ListJobsRequest

ListJob Request.

ListJobsResponse

ListJob Response.

ListResourceAllowancesRequest

ListResourceAllowances Request.

ListResourceAllowancesResponse

ListResourceAllowances Response.

ListTasksRequest

ListTasks Request.

ListTasksResponse

ListTasks Response.

LogsPolicy

LogsPolicy describes how outputs from a Job's Tasks (stdout/stderr) will be preserved.

CloudLoggingOption

CloudLoggingOption contains additional settings for Cloud Logging logs generated by Batch job.

Destination

The destination (if any) for logs.

Values: DESTINATION_UNSPECIFIED (0): Logs are not preserved. CLOUD_LOGGING (1): Logs are streamed to Cloud Logging. PATH (2): Logs are saved to a file path.

NFS

Represents an NFS volume.

Notification

Notification on resource state change.

OperationMetadata

Represents the metadata of the long-running operation.

PD

Deprecated: please use device_name instead.

ResourceAllowance

The Resource Allowance description for Cloud Batch. Only one Resource Allowance is supported now under a specific location and project.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

LabelsEntry

The abstract base class for a message.

ResourceAllowanceState

ResourceAllowance valid state.

Values: RESOURCE_ALLOWANCE_STATE_UNSPECIFIED (0): Unspecified. RESOURCE_ALLOWANCE_ACTIVE (1): ResourceAllowance is active and in use. RESOURCE_ALLOWANCE_DEPLETED (2): ResourceAllowance limit is reached.

ResourceUsage

ResourceUsage describes the resource usage of the job.

Runnable

Runnable describes instructions for executing a specific script or container as part of a Task.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Barrier

Barrier runnable blocks until all tasks in a taskgroup reach it.

Container

Container runnable.

LabelsEntry

The abstract base class for a message.

Script

Script runnable.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ServiceAccount

Carries information about a Google Cloud service account.

StatusEvent

Status event

Task

A Cloud Batch task.

TaskExecution

This Task Execution field includes detail information for task execution procedures, based on StatusEvent types.

TaskGroup

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

LabelsEntry

The abstract base class for a message.

SchedulingPolicy

How Tasks in the TaskGroup should be scheduled relative to each other.

Values: SCHEDULING_POLICY_UNSPECIFIED (0): Unspecified. AS_SOON_AS_POSSIBLE (1): Run Tasks as soon as resources are available.

    Tasks might be executed in parallel depending on parallelism
    and task_count values.
IN_ORDER (2):
    Run Tasks sequentially with increased task
    index.

TaskResourceUsage

TaskResourceUsage describes the resource usage of the task.

TaskSpec

Spec of a task

EnvironmentsEntry

The abstract base class for a message.

TaskStatus

Status of a task

State

Task states.

Values: STATE_UNSPECIFIED (0): Unknown state. PENDING (1): The Task is created and waiting for resources. ASSIGNED (2): The Task is assigned to at least one VM. RUNNING (3): The Task is running. FAILED (4): The Task has failed. SUCCEEDED (5): The Task has succeeded. UNEXECUTED (6): The Task has not been executed when the Job finishes.

UpdateResourceAllowanceRequest

UpdateResourceAllowance Request.

UsageResourceAllowance

UsageResourceAllowance describes the detail of usage resource allowance.

UsageResourceAllowanceSpec

Spec of a usage ResourceAllowance.

Limit

UsageResourceAllowance limitation.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

UsageResourceAllowanceStatus

Status of a usage ResourceAllowance.

ConsumptionReport

ConsumptionReport is the report of ResourceAllowance consumptions in a time period.

LatestPeriodConsumptionsEntry

The abstract base class for a message.

LimitStatus

UsageResourceAllowanceStatus detail about usage consumption.

PeriodConsumption

Volume

Volume describes a volume and parameters for it to be mounted to a VM.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Modules

pagers

API documentation for batch_v1.services.batch_service.pagers module.

pagers

API documentation for batch_v1alpha.services.batch_service.pagers module.