Class CloudBuildClient (1.0.0)

Version 1.0.0

• 3.28.0 (latest)
• 3.27.1
• 3.26.0
• 3.25.0
• 3.24.2
• 3.23.3
• 3.22.0
• 3.21.0
• 3.20.1
• 3.19.0
• 3.18.0
• 3.17.1
• 3.16.0
• 3.15.0
• 3.14.0
• 3.13.0
• 3.12.0
• 3.11.1
• 3.10.0
• 3.9.3
• 3.8.3
• 3.7.1
• 3.6.0
• 3.5.2
• 3.4.0
• 3.3.2
• 3.2.1
• 3.1.1
• 3.0.2
• 2.0.2
• 1.1.2
• 1.0.0
• 0.1.0

CloudBuildClient(
    transport=None,
    channel=None,
    credentials=None,
    client_config=None,
    client_info=None,
    client_options=None,
)

Creates and manages builds on Google Cloud Platform.

The main concept used by this API is a Build, which describes the location of the source to build, how to build the source, and where to store the built artifacts, if any.

A user can list previously-requested builds or get builds by their ID to determine the status of the build.

Methods

CloudBuildClient

CloudBuildClient(
    transport=None,
    channel=None,
    credentials=None,
    client_config=None,
    client_info=None,
    client_options=None,
)

Constructor.

Parameters

Name	Description
channel	grpc.Channel DEPRECATED. A Channel instance through which to make calls. This argument is mutually exclusive with credentials; providing both will raise an exception.
credentials	google.auth.credentials.Credentials The authorization credentials to attach to requests. These credentials identify this application to the service. If none are specified, the client will attempt to ascertain the credentials from the environment. This argument is mutually exclusive with providing a transport instance to transport; doing so will raise an exception.
client_config	dict DEPRECATED. A dictionary of call options for each method. If not specified, the default configuration is used.
client_info	google.api_core.gapic_v1.client_info.ClientInfo The client info used to send a user-agent string along with API requests. If None, then default info will be used. Generally, you only need to set this if you're developing your own client library.
client_options	Union[dict, google.api_core.client_options.ClientOptions] Client options used to set user options on the client. API Endpoint should be set through client_options.

cancel_build

cancel_build(project_id, id_, retry=<_MethodDefault._DEFAULT_VALUE: <object object>>, timeout=<_MethodDefault._DEFAULT_VALUE: <object object>>, metadata=None)

Cancels a build in progress.

.. rubric:: Example

from google.cloud.devtools import cloudbuild_v1

client = cloudbuild_v1.CloudBuildClient()

TODO: Initialize project_id:

project_id = ''

TODO: Initialize id_:

id_ = ''

response = client.cancel_build(project_id, id_)

Parameters

Name	Description
project_id	str Required. ID of the project.
id_	str Required. ID of the build.
retry	Optional[google.api_core.retry.Retry] A retry object used to retry requests. If None is specified, requests will be retried using a default configuration.
timeout	Optional[float] The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata	Optional[Sequence[Tuple[str, str]]] Additional metadata that is provided to the method.

Exceptions

Type	Description
google.api_core.exceptions.GoogleAPICallError	If the request failed for any reason.
google.api_core.exceptions.RetryError	If the request failed due to a retryable error and retry attempts failed.
ValueError	If the parameters are invalid.

create_build

create_build(project_id, build, retry=<_MethodDefault._DEFAULT_VALUE: <object object>>, timeout=<_MethodDefault._DEFAULT_VALUE: <object object>>, metadata=None)

Starts a build with the specified configuration.

This method returns a long-running Operation, which includes the build ID. Pass the build ID to GetBuild to determine the build status (such as SUCCESS or FAILURE).

.. rubric:: Example

from google.cloud.devtools import cloudbuild_v1

client = cloudbuild_v1.CloudBuildClient()

TODO: Initialize project_id:

project_id = ''

TODO: Initialize build:

build = {}

response = client.create_build(project_id, build)

Parameters

Name	Description
project_id	str Required. ID of the project.
build	Union[dict, Build] Required. Build resource to create. If a dict is provided, it must be of the same form as the protobuf message Build
retry	Optional[google.api_core.retry.Retry] A retry object used to retry requests. If None is specified, requests will be retried using a default configuration.
timeout	Optional[float] The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata	Optional[Sequence[Tuple[str, str]]] Additional metadata that is provided to the method.

Exceptions

Type	Description
google.api_core.exceptions.GoogleAPICallError	If the request failed for any reason.
google.api_core.exceptions.RetryError	If the request failed due to a retryable error and retry attempts failed.
ValueError	If the parameters are invalid.

create_build_trigger

create_build_trigger(project_id, trigger, retry=<_MethodDefault._DEFAULT_VALUE: <object object>>, timeout=<_MethodDefault._DEFAULT_VALUE: <object object>>, metadata=None)

Creates a new BuildTrigger.

This API is experimental.

.. rubric:: Example

from google.cloud.devtools import cloudbuild_v1

client = cloudbuild_v1.CloudBuildClient()

TODO: Initialize project_id:

project_id = ''

TODO: Initialize trigger:

trigger = {}

response = client.create_build_trigger(project_id, trigger)

Parameters

Name	Description
project_id	str Required. ID of the project for which to configure automatic builds.
trigger	Union[dict, BuildTrigger] Required. BuildTrigger to create. If a dict is provided, it must be of the same form as the protobuf message BuildTrigger
retry	Optional[google.api_core.retry.Retry] A retry object used to retry requests. If None is specified, requests will be retried using a default configuration.
timeout	Optional[float] The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata	Optional[Sequence[Tuple[str, str]]] Additional metadata that is provided to the method.

Exceptions

Type	Description
google.api_core.exceptions.GoogleAPICallError	If the request failed for any reason.
google.api_core.exceptions.RetryError	If the request failed due to a retryable error and retry attempts failed.
ValueError	If the parameters are invalid.

create_worker_pool

create_worker_pool(parent=None, worker_pool=None, retry=<_MethodDefault._DEFAULT_VALUE: <object object>>, timeout=<_MethodDefault._DEFAULT_VALUE: <object object>>, metadata=None)

Creates a WorkerPool to run the builds, and returns the new worker pool.

This API is experimental.

.. rubric:: Example

from google.cloud.devtools import cloudbuild_v1

client = cloudbuild_v1.CloudBuildClient()

response = client.create_worker_pool()

Parameters

Name	Description
parent	str ID of the parent project.
worker_pool	Union[dict, WorkerPool] WorkerPool resource to create. If a dict is provided, it must be of the same form as the protobuf message WorkerPool
retry	Optional[google.api_core.retry.Retry] A retry object used to retry requests. If None is specified, requests will be retried using a default configuration.
timeout	Optional[float] The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata	Optional[Sequence[Tuple[str, str]]] Additional metadata that is provided to the method.

Exceptions

Type	Description
google.api_core.exceptions.GoogleAPICallError	If the request failed for any reason.
google.api_core.exceptions.RetryError	If the request failed due to a retryable error and retry attempts failed.
ValueError	If the parameters are invalid.

delete_build_trigger

delete_build_trigger(project_id, trigger_id, retry=<_MethodDefault._DEFAULT_VALUE: <object object>>, timeout=<_MethodDefault._DEFAULT_VALUE: <object object>>, metadata=None)

Deletes a BuildTrigger by its project ID and trigger ID.

This API is experimental.

.. rubric:: Example

from google.cloud.devtools import cloudbuild_v1

client = cloudbuild_v1.CloudBuildClient()

TODO: Initialize project_id:

project_id = ''

TODO: Initialize trigger_id:

trigger_id = ''

client.delete_build_trigger(project_id, trigger_id)

Parameters

Name	Description
project_id	str Required. ID of the project that owns the trigger.
trigger_id	str Required. ID of the BuildTrigger to delete.
retry	Optional[google.api_core.retry.Retry] A retry object used to retry requests. If None is specified, requests will be retried using a default configuration.
timeout	Optional[float] The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata	Optional[Sequence[Tuple[str, str]]] Additional metadata that is provided to the method.

Exceptions

Type	Description
google.api_core.exceptions.GoogleAPICallError	If the request failed for any reason.
google.api_core.exceptions.RetryError	If the request failed due to a retryable error and retry attempts failed.
ValueError	If the parameters are invalid.

delete_worker_pool

delete_worker_pool(name=None, retry=<_MethodDefault._DEFAULT_VALUE: <object object>>, timeout=<_MethodDefault._DEFAULT_VALUE: <object object>>, metadata=None)

Deletes a WorkerPool by its project ID and WorkerPool name.

This API is experimental.

.. rubric:: Example

from google.cloud.devtools import cloudbuild_v1

client = cloudbuild_v1.CloudBuildClient()

client.delete_worker_pool()

Parameters

Name	Description
name	str The field will contain name of the resource requested, for example: "projects/project-1/workerPools/workerpool-name"
retry	Optional[google.api_core.retry.Retry] A retry object used to retry requests. If None is specified, requests will be retried using a default configuration.
timeout	Optional[float] The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata	Optional[Sequence[Tuple[str, str]]] Additional metadata that is provided to the method.

Exceptions

Type	Description
google.api_core.exceptions.GoogleAPICallError	If the request failed for any reason.
google.api_core.exceptions.RetryError	If the request failed due to a retryable error and retry attempts failed.
ValueError	If the parameters are invalid.

from_service_account_file

from_service_account_file(filename, *args, **kwargs)

Creates an instance of this client using the provided credentials file.

Parameter

Name	Description
filename	str The path to the service account private key json file.

Returns

Type	Description
CloudBuildClient	The constructed client.

from_service_account_json

from_service_account_json(filename, *args, **kwargs)

Creates an instance of this client using the provided credentials file.

Parameter

Name	Description
filename	str The path to the service account private key json file.

Returns

Type	Description
CloudBuildClient	The constructed client.

get_build

get_build(project_id, id_, retry=<_MethodDefault._DEFAULT_VALUE: <object object>>, timeout=<_MethodDefault._DEFAULT_VALUE: <object object>>, metadata=None)

Returns information about a previously requested build.

The Build that is returned includes its status (such as SUCCESS, FAILURE, or WORKING), and timing information.

.. rubric:: Example

from google.cloud.devtools import cloudbuild_v1

client = cloudbuild_v1.CloudBuildClient()

TODO: Initialize project_id:

project_id = ''

TODO: Initialize id_:

id_ = ''

response = client.get_build(project_id, id_)

Parameters

Name	Description
project_id	str Required. ID of the project.
id_	str Required. ID of the build.
retry	Optional[google.api_core.retry.Retry] A retry object used to retry requests. If None is specified, requests will be retried using a default configuration.
timeout	Optional[float] The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata	Optional[Sequence[Tuple[str, str]]] Additional metadata that is provided to the method.

Exceptions

Type	Description
google.api_core.exceptions.GoogleAPICallError	If the request failed for any reason.
google.api_core.exceptions.RetryError	If the request failed due to a retryable error and retry attempts failed.
ValueError	If the parameters are invalid.

get_build_trigger

get_build_trigger(project_id, trigger_id, retry=<_MethodDefault._DEFAULT_VALUE: <object object>>, timeout=<_MethodDefault._DEFAULT_VALUE: <object object>>, metadata=None)

Returns information about a BuildTrigger.

This API is experimental.

.. rubric:: Example

from google.cloud.devtools import cloudbuild_v1

client = cloudbuild_v1.CloudBuildClient()

TODO: Initialize project_id:

project_id = ''

TODO: Initialize trigger_id:

trigger_id = ''

response = client.get_build_trigger(project_id, trigger_id)

Parameters

Name	Description
project_id	str Required. ID of the project that owns the trigger.
trigger_id	str Required. ID of the BuildTrigger to get.
retry	Optional[google.api_core.retry.Retry] A retry object used to retry requests. If None is specified, requests will be retried using a default configuration.
timeout	Optional[float] The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata	Optional[Sequence[Tuple[str, str]]] Additional metadata that is provided to the method.

Exceptions

Type	Description
google.api_core.exceptions.GoogleAPICallError	If the request failed for any reason.
google.api_core.exceptions.RetryError	If the request failed due to a retryable error and retry attempts failed.
ValueError	If the parameters are invalid.

get_worker_pool

get_worker_pool(name=None, retry=<_MethodDefault._DEFAULT_VALUE: <object object>>, timeout=<_MethodDefault._DEFAULT_VALUE: <object object>>, metadata=None)

Returns information about a WorkerPool.

This API is experimental.

.. rubric:: Example

from google.cloud.devtools import cloudbuild_v1

client = cloudbuild_v1.CloudBuildClient()

response = client.get_worker_pool()

Parameters

Name	Description
name	str The field will contain name of the resource requested, for example: "projects/project-1/workerPools/workerpool-name"
retry	Optional[google.api_core.retry.Retry] A retry object used to retry requests. If None is specified, requests will be retried using a default configuration.
timeout	Optional[float] The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata	Optional[Sequence[Tuple[str, str]]] Additional metadata that is provided to the method.

Exceptions

Type	Description
google.api_core.exceptions.GoogleAPICallError	If the request failed for any reason.
google.api_core.exceptions.RetryError	If the request failed due to a retryable error and retry attempts failed.
ValueError	If the parameters are invalid.

list_build_triggers

list_build_triggers(project_id, page_size=None, page_token=None, retry=<_MethodDefault._DEFAULT_VALUE: <object object>>, timeout=<_MethodDefault._DEFAULT_VALUE: <object object>>, metadata=None)

Lists existing BuildTrigger\ s.

This API is experimental.

.. rubric:: Example

from google.cloud.devtools import cloudbuild_v1

client = cloudbuild_v1.CloudBuildClient()

TODO: Initialize project_id:

project_id = ''

response = client.list_build_triggers(project_id)

Parameters

Name	Description
project_id	str Required. ID of the project for which to list BuildTriggers.
page_size	int Number of results to return in the list.
page_token	str Token to provide to skip to a particular spot in the list.
retry	Optional[google.api_core.retry.Retry] A retry object used to retry requests. If None is specified, requests will be retried using a default configuration.
timeout	Optional[float] The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata	Optional[Sequence[Tuple[str, str]]] Additional metadata that is provided to the method.

Exceptions

Type	Description
google.api_core.exceptions.GoogleAPICallError	If the request failed for any reason.
google.api_core.exceptions.RetryError	If the request failed due to a retryable error and retry attempts failed.
ValueError	If the parameters are invalid.

list_builds

list_builds(project_id, page_size=None, filter_=None, retry=<_MethodDefault._DEFAULT_VALUE: <object object>>, timeout=<_MethodDefault._DEFAULT_VALUE: <object object>>, metadata=None)

Lists previously requested builds.

Previously requested builds may still be in-progress, or may have finished successfully or unsuccessfully.

.. rubric:: Example

from google.cloud.devtools import cloudbuild_v1

client = cloudbuild_v1.CloudBuildClient()

TODO: Initialize project_id:

project_id = ''

Iterate over all results

for element in client.list_builds(project_id): ... # process element ... pass

Alternatively:

Iterate over results one page at a time

for page in client.list_builds(project_id).pages: ... for element in page: ... # process element ... pass

Parameters

Name	Description
project_id	str Required. ID of the project.
page_size	int The maximum number of resources contained in the underlying API response. If page streaming is performed per- resource, this parameter does not affect the return value. If page streaming is performed per-page, this determines the maximum number of resources in a page.
filter_	str The raw filter text to constrain the results.
retry	Optional[google.api_core.retry.Retry] A retry object used to retry requests. If None is specified, requests will be retried using a default configuration.
timeout	Optional[float] The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata	Optional[Sequence[Tuple[str, str]]] Additional metadata that is provided to the method.

Exceptions

Type	Description
google.api_core.exceptions.GoogleAPICallError	If the request failed for any reason.
google.api_core.exceptions.RetryError	If the request failed due to a retryable error and retry attempts failed.
ValueError	If the parameters are invalid.

list_worker_pools

list_worker_pools(parent=None, retry=<_MethodDefault._DEFAULT_VALUE: <object object>>, timeout=<_MethodDefault._DEFAULT_VALUE: <object object>>, metadata=None)

List project's WorkerPool\ s.

This API is experimental.

.. rubric:: Example

from google.cloud.devtools import cloudbuild_v1

client = cloudbuild_v1.CloudBuildClient()

response = client.list_worker_pools()

Parameters

Name	Description
parent	str ID of the parent project.
retry	Optional[google.api_core.retry.Retry] A retry object used to retry requests. If None is specified, requests will be retried using a default configuration.
timeout	Optional[float] The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata	Optional[Sequence[Tuple[str, str]]] Additional metadata that is provided to the method.

Exceptions

Type	Description
google.api_core.exceptions.GoogleAPICallError	If the request failed for any reason.
google.api_core.exceptions.RetryError	If the request failed due to a retryable error and retry attempts failed.
ValueError	If the parameters are invalid.

retry_build

retry_build(project_id, id_, retry=<_MethodDefault._DEFAULT_VALUE: <object object>>, timeout=<_MethodDefault._DEFAULT_VALUE: <object object>>, metadata=None)

Creates a new build based on the specified build.

This method creates a new build using the original build request, which may or may not result in an identical build.

For triggered builds:

• Triggered builds resolve to a precise revision; therefore a retry of a triggered build will result in a build that uses the same revision.

For non-triggered builds that specify RepoSource:

• If the original build built from the tip of a branch, the retried build will build from the tip of that branch, which may not be the same revision as the original build.
• If the original build specified a commit sha or revision ID, the retried build will use the identical source.

For builds that specify StorageSource:

• If the original build pulled source from Google Cloud Storage without specifying the generation of the object, the new build will use the current object, which may be different from the original build source.
• If the original build pulled source from Cloud Storage and specified the generation of the object, the new build will attempt to use the same object, which may or may not be available depending on the bucket's lifecycle management settings.

.. rubric:: Example

from google.cloud.devtools import cloudbuild_v1

client = cloudbuild_v1.CloudBuildClient()

TODO: Initialize project_id:

project_id = ''

TODO: Initialize id_:

id_ = ''

response = client.retry_build(project_id, id_)

Parameters

Name	Description
project_id	str Required. ID of the project.
id_	str Required. Build ID of the original build.
retry	Optional[google.api_core.retry.Retry] A retry object used to retry requests. If None is specified, requests will be retried using a default configuration.
timeout	Optional[float] The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata	Optional[Sequence[Tuple[str, str]]] Additional metadata that is provided to the method.

Exceptions

Type	Description
google.api_core.exceptions.GoogleAPICallError	If the request failed for any reason.
google.api_core.exceptions.RetryError	If the request failed due to a retryable error and retry attempts failed.
ValueError	If the parameters are invalid.

run_build_trigger

run_build_trigger(project_id, trigger_id, source, retry=<_MethodDefault._DEFAULT_VALUE: <object object>>, timeout=<_MethodDefault._DEFAULT_VALUE: <object object>>, metadata=None)

Runs a BuildTrigger at a particular source revision.

.. rubric:: Example

from google.cloud.devtools import cloudbuild_v1

client = cloudbuild_v1.CloudBuildClient()

TODO: Initialize project_id:

project_id = ''

TODO: Initialize trigger_id:

trigger_id = ''

TODO: Initialize source:

source = {}

response = client.run_build_trigger(project_id, trigger_id, source)

Parameters

Name	Description
project_id	str Required. ID of the project.
trigger_id	str Required. ID of the trigger.
source	Union[dict, RepoSource] Required. Source to build against this trigger. If a dict is provided, it must be of the same form as the protobuf message RepoSource
retry	Optional[google.api_core.retry.Retry] A retry object used to retry requests. If None is specified, requests will be retried using a default configuration.
timeout	Optional[float] The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata	Optional[Sequence[Tuple[str, str]]] Additional metadata that is provided to the method.

Exceptions

Type	Description
google.api_core.exceptions.GoogleAPICallError	If the request failed for any reason.
google.api_core.exceptions.RetryError	If the request failed due to a retryable error and retry attempts failed.
ValueError	If the parameters are invalid.

update_build_trigger

update_build_trigger(project_id, trigger_id, trigger, retry=<_MethodDefault._DEFAULT_VALUE: <object object>>, timeout=<_MethodDefault._DEFAULT_VALUE: <object object>>, metadata=None)

Updates a BuildTrigger by its project ID and trigger ID.

This API is experimental.

.. rubric:: Example

from google.cloud.devtools import cloudbuild_v1

client = cloudbuild_v1.CloudBuildClient()

TODO: Initialize project_id:

project_id = ''

TODO: Initialize trigger_id:

trigger_id = ''

TODO: Initialize trigger:

trigger = {}

response = client.update_build_trigger(project_id, trigger_id, trigger)

Parameters

Name	Description
project_id	str Required. ID of the project that owns the trigger.
trigger_id	str Required. ID of the BuildTrigger to update.
trigger	Union[dict, BuildTrigger] Required. BuildTrigger to update. If a dict is provided, it must be of the same form as the protobuf message BuildTrigger
retry	Optional[google.api_core.retry.Retry] A retry object used to retry requests. If None is specified, requests will be retried using a default configuration.
timeout	Optional[float] The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata	Optional[Sequence[Tuple[str, str]]] Additional metadata that is provided to the method.

Exceptions

Type	Description
google.api_core.exceptions.GoogleAPICallError	If the request failed for any reason.
google.api_core.exceptions.RetryError	If the request failed due to a retryable error and retry attempts failed.
ValueError	If the parameters are invalid.

update_worker_pool

update_worker_pool(name=None, worker_pool=None, retry=<_MethodDefault._DEFAULT_VALUE: <object object>>, timeout=<_MethodDefault._DEFAULT_VALUE: <object object>>, metadata=None)

Update a WorkerPool.

This API is experimental.

.. rubric:: Example

from google.cloud.devtools import cloudbuild_v1

client = cloudbuild_v1.CloudBuildClient()

response = client.update_worker_pool()

Parameters

Name	Description
name	str The field will contain name of the resource requested, for example: "projects/project-1/workerPools/workerpool-name"
worker_pool	Union[dict, WorkerPool] WorkerPool resource to update. If a dict is provided, it must be of the same form as the protobuf message WorkerPool
retry	Optional[google.api_core.retry.Retry] A retry object used to retry requests. If None is specified, requests will be retried using a default configuration.
timeout	Optional[float] The amount of time, in seconds, to wait for the request to complete. Note that if retry is specified, the timeout applies to each individual attempt.
metadata	Optional[Sequence[Tuple[str, str]]] Additional metadata that is provided to the method.

Exceptions

Type	Description
google.api_core.exceptions.GoogleAPICallError	If the request failed for any reason.
google.api_core.exceptions.RetryError	If the request failed due to a retryable error and retry attempts failed.
ValueError	If the parameters are invalid.