Class CloudBuildClient (3.6.0)

CloudBuildClient(*, credentials: Optional[google.auth.credentials.Credentials] = None, transport: Optional[Union[str, google.cloud.devtools.cloudbuild_v1.services.cloud_build.transports.base.CloudBuildTransport]] = None, client_options: Optional[google.api_core.client_options.ClientOptions] = None, client_info: google.api_core.gapic_v1.client_info.ClientInfo = <google.api_core.gapic_v1.client_info.ClientInfo object>)

Type Description

CloudBuildTransport The transport used by the client instance.

CloudBuildClient(*, credentials: Optional[google.auth.credentials.Credentials] = None, transport: Optional[Union[str, google.cloud.devtools.cloudbuild_v1.services.cloud_build.transports.base.CloudBuildTransport]] = None, client_options: Optional[google.api_core.client_options.ClientOptions] = None, client_info: google.api_core.gapic_v1.client_info.ClientInfo = <google.api_core.gapic_v1.client_info.ClientInfo object>)

Name Description

credentials Optional[google.auth.credentials.Credentials]

The authorization credentials to attach to requests. These credentials identify the application to the service; if none are specified, the client will attempt to ascertain the credentials from the environment.

transport Union[str, CloudBuildTransport]

The transport to use. If set to None, a transport is chosen automatically.

client_options google.api_core.client_options.ClientOptions

Custom options for the client. It won't take effect if a transport instance is provided. (1) The api_endpoint property can be used to override the default endpoint provided by the client. GOOGLE_API_USE_MTLS_ENDPOINT environment variable can also be used to override the endpoint: "always" (always use the default mTLS endpoint), "never" (always use the default regular endpoint) and "auto" (auto switch to the default mTLS endpoint if client certificate is present, this is the default value). However, the api_endpoint property takes precedence if provided. (2) If GOOGLE_API_USE_CLIENT_CERTIFICATE environment variable is "true", then the client_cert_source property can be used to provide client certificate for mutual TLS transport. If not provided, the default SSL client certificate will be used if present. If GOOGLE_API_USE_CLIENT_CERTIFICATE is "false" or not set, no client certificate will be 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.

Type Description

google.auth.exceptions.MutualTLSChannelError If mutual TLS transport creation failed for any reason.

__exit__(type, value, traceback)

approve_build(request: Optional[Union[google.cloud.devtools.cloudbuild_v1.types.cloudbuild.ApproveBuildRequest, dict]] = None, *, name: Optional[str] = None, approval_result: Optional[google.cloud.devtools.cloudbuild_v1.types.cloudbuild.ApprovalResult] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request Union[google.cloud.devtools.cloudbuild_v1.types.ApproveBuildRequest, dict]

The request object. Request to approve or reject a pending build.

name str

Required. Name of the target build. For example: "projects/{$project_id}/builds/{$build_id}" This corresponds to the name field on the request instance; if request is provided, this should not be set.

approval_result google.cloud.devtools.cloudbuild_v1.types.ApprovalResult

Approval decision and metadata. This corresponds to the approval_result field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.api_core.operation.Operation An object representing a long-running operation. The result type for the operation will be Build A build resource in the Cloud Build API. At a high level, a Build describes where to find source code, how to build it (for example, the builder image to run on the source), and where to store the built artifacts. Fields can include the following variables, which will be expanded when the build is created: - $PROJECT_ID: the project ID of the build. - $PROJECT_NUMBER: the project number of the build. - $BUILD_ID: the autogenerated ID of the build. - $REPO_NAME: the source repository name specified by RepoSource. - $BRANCH_NAME: the branch name specified by RepoSource. - $TAG_NAME: the tag name specified by RepoSource. - $REVISION_ID or $COMMIT_SHA: the commit SHA specified by RepoSource or resolved from the specified branch or tag. - $SHORT_SHA: first 7 characters of $REVISION_ID or $COMMIT_SHA.

build_path(project: str, build: str)

build_trigger_path(project: str, trigger: str)

cancel_build(request: Optional[Union[google.cloud.devtools.cloudbuild_v1.types.cloudbuild.CancelBuildRequest, dict]] = None, *, project_id: Optional[str] = None, id: Optional[str] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request Union[google.cloud.devtools.cloudbuild_v1.types.CancelBuildRequest, dict]

The request object. Request to cancel an ongoing build.

project_id str

Required. ID of the project. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

id str

Required. ID of the build. This corresponds to the id field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.cloud.devtools.cloudbuild_v1.types.Build A build resource in the Cloud Build API. At a high level, a Build describes where to find source code, how to build it (for example, the builder image to run on the source), and where to store the built artifacts. Fields can include the following variables, which will be expanded when the build is created: - $PROJECT_ID: the project ID of the build. - $PROJECT_NUMBER: the project number of the build. - $BUILD_ID: the autogenerated ID of the build. - $REPO_NAME: the source repository name specified by RepoSource. - $BRANCH_NAME: the branch name specified by RepoSource. - $TAG_NAME: the tag name specified by RepoSource. - $REVISION_ID or $COMMIT_SHA: the commit SHA specified by RepoSource or resolved from the specified branch or tag. - $SHORT_SHA: first 7 characters of $REVISION_ID or $COMMIT_SHA.

common_billing_account_path(billing_account: str)

common_folder_path(folder: str)

common_location_path(project: str, location: str)

common_organization_path(organization: str)

common_project_path(project: str)

create_build(request: Optional[Union[google.cloud.devtools.cloudbuild_v1.types.cloudbuild.CreateBuildRequest, dict]] = None, *, project_id: Optional[str] = None, build: Optional[google.cloud.devtools.cloudbuild_v1.types.cloudbuild.Build] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request Union[google.cloud.devtools.cloudbuild_v1.types.CreateBuildRequest, dict]

The request object. Request to create a new build.

project_id str

Required. ID of the project. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

build google.cloud.devtools.cloudbuild_v1.types.Build

Required. Build resource to create. This corresponds to the build field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.api_core.operation.Operation An object representing a long-running operation. The result type for the operation will be Build A build resource in the Cloud Build API. At a high level, a Build describes where to find source code, how to build it (for example, the builder image to run on the source), and where to store the built artifacts. Fields can include the following variables, which will be expanded when the build is created: - $PROJECT_ID: the project ID of the build. - $PROJECT_NUMBER: the project number of the build. - $BUILD_ID: the autogenerated ID of the build. - $REPO_NAME: the source repository name specified by RepoSource. - $BRANCH_NAME: the branch name specified by RepoSource. - $TAG_NAME: the tag name specified by RepoSource. - $REVISION_ID or $COMMIT_SHA: the commit SHA specified by RepoSource or resolved from the specified branch or tag. - $SHORT_SHA: first 7 characters of $REVISION_ID or $COMMIT_SHA.

create_build_trigger(request: Optional[Union[google.cloud.devtools.cloudbuild_v1.types.cloudbuild.CreateBuildTriggerRequest, dict]] = None, *, project_id: Optional[str] = None, trigger: Optional[google.cloud.devtools.cloudbuild_v1.types.cloudbuild.BuildTrigger] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request Union[google.cloud.devtools.cloudbuild_v1.types.CreateBuildTriggerRequest, dict]

The request object. Request to create a new BuildTrigger.

project_id str

Required. ID of the project for which to configure automatic builds. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

trigger google.cloud.devtools.cloudbuild_v1.types.BuildTrigger

Required. BuildTrigger to create. This corresponds to the trigger field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.cloud.devtools.cloudbuild_v1.types.BuildTrigger Configuration for an automated build in response to source repository changes.

create_worker_pool(request: Optional[Union[google.cloud.devtools.cloudbuild_v1.types.cloudbuild.CreateWorkerPoolRequest, dict]] = None, *, parent: Optional[str] = None, worker_pool: Optional[google.cloud.devtools.cloudbuild_v1.types.cloudbuild.WorkerPool] = None, worker_pool_id: Optional[str] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request Union[google.cloud.devtools.cloudbuild_v1.types.CreateWorkerPoolRequest, dict]

The request object. Request to create a new WorkerPool.

parent str

Required. The parent resource where this worker pool will be created. Format: projects/{project}/locations/{location}. This corresponds to the parent field on the request instance; if request is provided, this should not be set.

worker_pool google.cloud.devtools.cloudbuild_v1.types.WorkerPool

Required. WorkerPool resource to create. This corresponds to the worker_pool field on the request instance; if request is provided, this should not be set.

worker_pool_id str

Required. Immutable. The ID to use for the WorkerPool, which will become the final component of the resource name. This value should be 1-63 characters, and valid characters are /a-z][0-9]-/. This corresponds to the worker_pool_id field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.api_core.operation.Operation An object representing a long-running operation. The result type for the operation will be WorkerPool Configuration for a WorkerPool. Cloud Build owns and maintains a pool of workers for general use and have no access to a project's private network. By default, builds submitted to Cloud Build will use a worker from this pool. If your build needs access to resources on a private network, create and use a WorkerPool to run your builds. Private WorkerPools give your builds access to any single VPC network that you administer, including any on-prem resources connected to that VPC network. For an overview of private pools, see [Private pools overview](\ https://cloud.google.com/build/docs/private-pools/private-pools-overview).

crypto_key_path(project: str, location: str, keyring: str, key: str)

delete_build_trigger(request: Optional[Union[google.cloud.devtools.cloudbuild_v1.types.cloudbuild.DeleteBuildTriggerRequest, dict]] = None, *, project_id: Optional[str] = None, trigger_id: Optional[str] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request Union[google.cloud.devtools.cloudbuild_v1.types.DeleteBuildTriggerRequest, dict]

The request object. Request to delete a BuildTrigger.

project_id str

Required. ID of the project that owns the trigger. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

trigger_id str

Required. ID of the BuildTrigger to delete. This corresponds to the trigger_id field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

delete_worker_pool(request: Optional[Union[google.cloud.devtools.cloudbuild_v1.types.cloudbuild.DeleteWorkerPoolRequest, dict]] = None, *, name: Optional[str] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request Union[google.cloud.devtools.cloudbuild_v1.types.DeleteWorkerPoolRequest, dict]

The request object. Request to delete a WorkerPool.

name str

Required. The name of the WorkerPool to delete. Format: projects/{project}/locations/{workerPool}/workerPools/{workerPool}. This corresponds to the name field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.api_core.operation.Operation An object representing a long-running operation. The result type for the operation will be google.protobuf.empty_pb2.Empty A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for Empty is empty JSON object {}.

from_service_account_file(filename: str, *args, **kwargs)

Name Description

filename str

The path to the service account private key json file.

Type Description

CloudBuildClient The constructed client.

from_service_account_info(info: dict, *args, **kwargs)

Name Description

info dict

The service account private key info.

Type Description

CloudBuildClient The constructed client.

from_service_account_json(filename: str, *args, **kwargs)

Name Description

filename str

The path to the service account private key json file.

Type Description

CloudBuildClient The constructed client.

get_build(request: Optional[Union[google.cloud.devtools.cloudbuild_v1.types.cloudbuild.GetBuildRequest, dict]] = None, *, project_id: Optional[str] = None, id: Optional[str] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request Union[google.cloud.devtools.cloudbuild_v1.types.GetBuildRequest, dict]

The request object. Request to get a build.

project_id str

Required. ID of the project. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

id str

Required. ID of the build. This corresponds to the id field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.cloud.devtools.cloudbuild_v1.types.Build A build resource in the Cloud Build API. At a high level, a Build describes where to find source code, how to build it (for example, the builder image to run on the source), and where to store the built artifacts. Fields can include the following variables, which will be expanded when the build is created: - $PROJECT_ID: the project ID of the build. - $PROJECT_NUMBER: the project number of the build. - $BUILD_ID: the autogenerated ID of the build. - $REPO_NAME: the source repository name specified by RepoSource. - $BRANCH_NAME: the branch name specified by RepoSource. - $TAG_NAME: the tag name specified by RepoSource. - $REVISION_ID or $COMMIT_SHA: the commit SHA specified by RepoSource or resolved from the specified branch or tag. - $SHORT_SHA: first 7 characters of $REVISION_ID or $COMMIT_SHA.

get_build_trigger(request: Optional[Union[google.cloud.devtools.cloudbuild_v1.types.cloudbuild.GetBuildTriggerRequest, dict]] = None, *, project_id: Optional[str] = None, trigger_id: Optional[str] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request Union[google.cloud.devtools.cloudbuild_v1.types.GetBuildTriggerRequest, dict]

The request object. Returns the BuildTrigger with the specified ID.

project_id str

Required. ID of the project that owns the trigger. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

trigger_id str

Required. Identifier (id or name) of the BuildTrigger to get. This corresponds to the trigger_id field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.cloud.devtools.cloudbuild_v1.types.BuildTrigger Configuration for an automated build in response to source repository changes.

get_worker_pool(request: Optional[Union[google.cloud.devtools.cloudbuild_v1.types.cloudbuild.GetWorkerPoolRequest, dict]] = None, *, name: Optional[str] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request Union[google.cloud.devtools.cloudbuild_v1.types.GetWorkerPoolRequest, dict]

The request object. Request to get a WorkerPool with the specified name.

name str

Required. The name of the WorkerPool to retrieve. Format: projects/{project}/locations/{location}/workerPools/{workerPool}. This corresponds to the name field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.cloud.devtools.cloudbuild_v1.types.WorkerPool Configuration for a WorkerPool. Cloud Build owns and maintains a pool of workers for general use and have no access to a project's private network. By default, builds submitted to Cloud Build will use a worker from this pool. If your build needs access to resources on a private network, create and use a WorkerPool to run your builds. Private WorkerPools give your builds access to any single VPC network that you administer, including any on-prem resources connected to that VPC network. For an overview of private pools, see [Private pools overview](\ https://cloud.google.com/build/docs/private-pools/private-pools-overview).

list_build_triggers(request: Optional[Union[google.cloud.devtools.cloudbuild_v1.types.cloudbuild.ListBuildTriggersRequest, dict]] = None, *, project_id: Optional[str] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request Union[google.cloud.devtools.cloudbuild_v1.types.ListBuildTriggersRequest, dict]

The request object. Request to list existing BuildTriggers.

project_id str

Required. ID of the project for which to list BuildTriggers. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.cloud.devtools.cloudbuild_v1.services.cloud_build.pagers.ListBuildTriggersPager Response containing existing BuildTriggers. Iterating over this object will yield results and resolve additional pages automatically.

list_builds(request: Optional[Union[google.cloud.devtools.cloudbuild_v1.types.cloudbuild.ListBuildsRequest, dict]] = None, *, project_id: Optional[str] = None, filter: Optional[str] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request Union[google.cloud.devtools.cloudbuild_v1.types.ListBuildsRequest, dict]

The request object. Request to list builds.

project_id str

Required. ID of the project. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

filter str

The raw filter text to constrain the results. This corresponds to the filter field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.cloud.devtools.cloudbuild_v1.services.cloud_build.pagers.ListBuildsPager Response including listed builds. Iterating over this object will yield results and resolve additional pages automatically.

list_worker_pools(request: Optional[Union[google.cloud.devtools.cloudbuild_v1.types.cloudbuild.ListWorkerPoolsRequest, dict]] = None, *, parent: Optional[str] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request Union[google.cloud.devtools.cloudbuild_v1.types.ListWorkerPoolsRequest, dict]

The request object. Request to list WorkerPool\s.

parent str

Required. The parent of the collection of WorkerPools. Format: projects/{project}/locations/{location}. This corresponds to the parent field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.cloud.devtools.cloudbuild_v1.services.cloud_build.pagers.ListWorkerPoolsPager Response containing existing WorkerPools. Iterating over this object will yield results and resolve additional pages automatically.

network_path(project: str, network: str)

parse_build_path(path: str)

parse_build_trigger_path(path: str)

parse_common_billing_account_path(path: str)

parse_common_folder_path(path: str)

parse_common_location_path(path: str)

parse_common_organization_path(path: str)

parse_common_project_path(path: str)

parse_crypto_key_path(path: str)

parse_network_path(path: str)

parse_secret_version_path(path: str)

parse_service_account_path(path: str)

parse_subscription_path(path: str)

parse_topic_path(path: str)

parse_worker_pool_path(path: str)

receive_trigger_webhook(request: Optional[Union[google.cloud.devtools.cloudbuild_v1.types.cloudbuild.ReceiveTriggerWebhookRequest, dict]] = None, *, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request Union[google.cloud.devtools.cloudbuild_v1.types.ReceiveTriggerWebhookRequest, dict]

The request object. ReceiveTriggerWebhookRequest [Experimental] is the request object accepted by the ReceiveTriggerWebhook method.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.cloud.devtools.cloudbuild_v1.types.ReceiveTriggerWebhookResponse ReceiveTriggerWebhookResponse [Experimental] is the response object for the ReceiveTriggerWebhook method.

retry_build(request: Optional[Union[google.cloud.devtools.cloudbuild_v1.types.cloudbuild.RetryBuildRequest, dict]] = None, *, project_id: Optional[str] = None, id: Optional[str] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request Union[google.cloud.devtools.cloudbuild_v1.types.RetryBuildRequest, dict]

The request object. Specifies a build to retry.

project_id str

Required. ID of the project. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

id str

Required. Build ID of the original build. This corresponds to the id field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.api_core.operation.Operation An object representing a long-running operation. The result type for the operation will be Build A build resource in the Cloud Build API. At a high level, a Build describes where to find source code, how to build it (for example, the builder image to run on the source), and where to store the built artifacts. Fields can include the following variables, which will be expanded when the build is created: - $PROJECT_ID: the project ID of the build. - $PROJECT_NUMBER: the project number of the build. - $BUILD_ID: the autogenerated ID of the build. - $REPO_NAME: the source repository name specified by RepoSource. - $BRANCH_NAME: the branch name specified by RepoSource. - $TAG_NAME: the tag name specified by RepoSource. - $REVISION_ID or $COMMIT_SHA: the commit SHA specified by RepoSource or resolved from the specified branch or tag. - $SHORT_SHA: first 7 characters of $REVISION_ID or $COMMIT_SHA.

run_build_trigger(request: Optional[Union[google.cloud.devtools.cloudbuild_v1.types.cloudbuild.RunBuildTriggerRequest, dict]] = None, *, project_id: Optional[str] = None, trigger_id: Optional[str] = None, source: Optional[google.cloud.devtools.cloudbuild_v1.types.cloudbuild.RepoSource] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request Union[google.cloud.devtools.cloudbuild_v1.types.RunBuildTriggerRequest, dict]

The request object. Specifies a build trigger to run and the source to use.

project_id str

Required. ID of the project. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

trigger_id str

Required. ID of the trigger. This corresponds to the trigger_id field on the request instance; if request is provided, this should not be set.

source google.cloud.devtools.cloudbuild_v1.types.RepoSource

Source to build against this trigger. This corresponds to the source field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.api_core.operation.Operation An object representing a long-running operation. The result type for the operation will be Build A build resource in the Cloud Build API. At a high level, a Build describes where to find source code, how to build it (for example, the builder image to run on the source), and where to store the built artifacts. Fields can include the following variables, which will be expanded when the build is created: - $PROJECT_ID: the project ID of the build. - $PROJECT_NUMBER: the project number of the build. - $BUILD_ID: the autogenerated ID of the build. - $REPO_NAME: the source repository name specified by RepoSource. - $BRANCH_NAME: the branch name specified by RepoSource. - $TAG_NAME: the tag name specified by RepoSource. - $REVISION_ID or $COMMIT_SHA: the commit SHA specified by RepoSource or resolved from the specified branch or tag. - $SHORT_SHA: first 7 characters of $REVISION_ID or $COMMIT_SHA.

secret_version_path(project: str, secret: str, version: str)

service_account_path(project: str, service_account: str)

subscription_path(project: str, subscription: str)

topic_path(project: str, topic: str)

update_build_trigger(request: Optional[Union[google.cloud.devtools.cloudbuild_v1.types.cloudbuild.UpdateBuildTriggerRequest, dict]] = None, *, project_id: Optional[str] = None, trigger_id: Optional[str] = None, trigger: Optional[google.cloud.devtools.cloudbuild_v1.types.cloudbuild.BuildTrigger] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request Union[google.cloud.devtools.cloudbuild_v1.types.UpdateBuildTriggerRequest, dict]

The request object. Request to update an existing BuildTrigger.

project_id str

Required. ID of the project that owns the trigger. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

trigger_id str

Required. ID of the BuildTrigger to update. This corresponds to the trigger_id field on the request instance; if request is provided, this should not be set.

trigger google.cloud.devtools.cloudbuild_v1.types.BuildTrigger

Required. BuildTrigger to update. This corresponds to the trigger field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.cloud.devtools.cloudbuild_v1.types.BuildTrigger Configuration for an automated build in response to source repository changes.

update_worker_pool(request: Optional[Union[google.cloud.devtools.cloudbuild_v1.types.cloudbuild.UpdateWorkerPoolRequest, dict]] = None, *, worker_pool: Optional[google.cloud.devtools.cloudbuild_v1.types.cloudbuild.WorkerPool] = None, update_mask: Optional[google.protobuf.field_mask_pb2.FieldMask] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())

Name Description

request Union[google.cloud.devtools.cloudbuild_v1.types.UpdateWorkerPoolRequest, dict]

The request object. Request to update a WorkerPool.

worker_pool google.cloud.devtools.cloudbuild_v1.types.WorkerPool

Required. The WorkerPool to update. The name field is used to identify the WorkerPool to update. Format: projects/{project}/locations/{location}/workerPools/{workerPool}. This corresponds to the worker_pool field on the request instance; if request is provided, this should not be set.

update_mask google.protobuf.field_mask_pb2.FieldMask

A mask specifying which fields in worker_pool to update. This corresponds to the update_mask field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Type Description

google.api_core.operation.Operation An object representing a long-running operation. The result type for the operation will be WorkerPool Configuration for a WorkerPool. Cloud Build owns and maintains a pool of workers for general use and have no access to a project's private network. By default, builds submitted to Cloud Build will use a worker from this pool. If your build needs access to resources on a private network, create and use a WorkerPool to run your builds. Private WorkerPools give your builds access to any single VPC network that you administer, including any on-prem resources connected to that VPC network. For an overview of private pools, see [Private pools overview](\ https://cloud.google.com/build/docs/private-pools/private-pools-overview).

worker_pool_path(project: str, location: str, worker_pool: str)