google-api-client 0.42.2 → 0.45.0

data/generated/google/apis/cloudbilling_v1/service.rb

@@ -48,16 +48,13 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Creates a billing account.
-        # This method can only be used to create
-        # [billing subaccounts](https://cloud.google.com/billing/docs/concepts)
-        # by GCP resellers.
-        # When creating a subaccount, the current authenticated user must have the
-        # `billing.accounts.update` IAM permission on the master account, which is
-        # typically given to billing account
-        # [administrators](https://cloud.google.com/billing/docs/how-to/billing-access).
-        # This method will return an error if the master account has not been
-        # provisioned as a reseller account.
+        # Creates a billing account. This method can only be used to create [billing
+        # subaccounts](https://cloud.google.com/billing/docs/concepts) by Google Cloud
+        # resellers. When creating a subaccount, the current authenticated user must
+        # have the `billing.accounts.update` IAM permission on the master account, which
+        # is typically given to billing account [administrators](https://cloud.google.
+        # com/billing/docs/how-to/billing-access). This method will return an error if
+        # the master account has not been provisioned as a reseller account.
         # @param [Google::Apis::CloudbillingV1::BillingAccount] billing_account_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -87,12 +84,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets information about a billing account. The current authenticated user
-        # must be a [viewer of the billing
-        # account](https://cloud.google.com/billing/docs/how-to/billing-access).
+        # Gets information about a billing account. The current authenticated user must
+        # be a [viewer of the billing account](https://cloud.google.com/billing/docs/how-
+        # to/billing-access).
         # @param [String] name
-        #   Required. The resource name of the billing account to retrieve. For example,
-        #   `billingAccounts/012345-567890-ABCDEF`.
+        #   Required. The resource name of the billing account to retrieve. For example, `
+        #   billingAccounts/012345-567890-ABCDEF`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -120,23 +117,21 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the access control policy for a billing account.
-        # The caller must have the `billing.accounts.getIamPolicy` permission on the
-        # account, which is often given to billing account
-        # [viewers](https://cloud.google.com/billing/docs/how-to/billing-access).
+        # Gets the access control policy for a billing account. The caller must have the
+        # `billing.accounts.getIamPolicy` permission on the account, which is often
+        # given to billing account [viewers](https://cloud.google.com/billing/docs/how-
+        # to/billing-access).
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being requested.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy is being requested. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Fixnum] options_requested_policy_version
-        #   Optional. The policy format version to be returned.
-        #   Valid values are 0, 1, and 3. Requests specifying an invalid value will be
-        #   rejected.
-        #   Requests for policies with any conditional bindings must specify version 3.
-        #   Policies without any conditional bindings may specify any valid value or
-        #   leave the field unset.
-        #   To learn which resources support conditions in their IAM policies, see the
-        #   [IAM
-        #   documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+        #   Optional. The policy format version to be returned. Valid values are 0, 1, and
+        #   3. Requests specifying an invalid value will be rejected. Requests for
+        #   policies with any conditional bindings must specify version 3. Policies
+        #   without any conditional bindings may specify any valid value or leave the
+        #   field unset. To learn which resources support conditions in their IAM policies,
+        #   see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
+        #   resource-policies).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -165,23 +160,20 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the billing accounts that the current authenticated user has
-        # permission to
-        # [view](https://cloud.google.com/billing/docs/how-to/billing-access).
+        # Lists the billing accounts that the current authenticated user has permission
+        # to [view](https://cloud.google.com/billing/docs/how-to/billing-access).
         # @param [String] filter
-        #   Options for how to filter the returned billing accounts.
-        #   Currently this only supports filtering for
-        #   [subaccounts](https://cloud.google.com/billing/docs/concepts) under a
-        #   single provided reseller billing account.
-        #   (e.g. "master_billing_account=billingAccounts/012345-678901-ABCDEF").
-        #   Boolean algebra and other fields are not currently supported.
+        #   Options for how to filter the returned billing accounts. Currently this only
+        #   supports filtering for [subaccounts](https://cloud.google.com/billing/docs/
+        #   concepts) under a single provided reseller billing account. (e.g. "
+        #   master_billing_account=billingAccounts/012345-678901-ABCDEF"). Boolean algebra
+        #   and other fields are not currently supported.
         # @param [Fixnum] page_size
-        #   Requested page size. The maximum page size is 100; this is also the
-        #   default.
+        #   Requested page size. The maximum page size is 100; this is also the default.
         # @param [String] page_token
-        #   A token identifying a page of results to return. This should be a
-        #   `next_page_token` value returned from a previous `ListBillingAccounts`
-        #   call. If unspecified, the first page of results is returned.
+        #   A token identifying a page of results to return. This should be a `
+        #   next_page_token` value returned from a previous `ListBillingAccounts` call. If
+        #   unspecified, the first page of results is returned.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -211,18 +203,17 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates a billing account's fields.
-        # Currently the only field that can be edited is `display_name`.
-        # The current authenticated user must have the `billing.accounts.update`
-        # IAM permission, which is typically given to the
-        # [administrator](https://cloud.google.com/billing/docs/how-to/billing-access)
-        # of the billing account.
+        # Updates a billing account's fields. Currently the only field that can be
+        # edited is `display_name`. The current authenticated user must have the `
+        # billing.accounts.update` IAM permission, which is typically given to the [
+        # administrator](https://cloud.google.com/billing/docs/how-to/billing-access) of
+        # the billing account.
         # @param [String] name
         #   Required. The name of the billing account resource to be updated.
         # @param [Google::Apis::CloudbillingV1::BillingAccount] billing_account_object
         # @param [String] update_mask
-        #   The update mask applied to the resource.
-        #   Only "display_name" is currently supported.
+        #   The update mask applied to the resource. Only "display_name" is currently
+        #   supported.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -254,13 +245,12 @@ module Google
         end
         
         # Sets the access control policy for a billing account. Replaces any existing
-        # policy.
-        # The caller must have the `billing.accounts.setIamPolicy` permission on the
-        # account, which is often given to billing account
-        # [administrators](https://cloud.google.com/billing/docs/how-to/billing-access).
+        # policy. The caller must have the `billing.accounts.setIamPolicy` permission on
+        # the account, which is often given to billing account [administrators](https://
+        # cloud.google.com/billing/docs/how-to/billing-access).
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being specified.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy is being specified. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::CloudbillingV1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -291,12 +281,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Tests the access control policy for a billing account. This method takes
-        # the resource and a set of permissions as input and returns the subset of
-        # the input permissions that the caller is allowed for that resource.
+        # Tests the access control policy for a billing account. This method takes the
+        # resource and a set of permissions as input and returns the subset of the input
+        # permissions that the caller is allowed for that resource.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy detail is being requested.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy detail is being requested. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::CloudbillingV1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -329,19 +319,18 @@ module Google
         
         # Lists the projects associated with a billing account. The current
         # authenticated user must have the `billing.resourceAssociations.list` IAM
-        # permission, which is often given to billing account
-        # [viewers](https://cloud.google.com/billing/docs/how-to/billing-access).
+        # permission, which is often given to billing account [viewers](https://cloud.
+        # google.com/billing/docs/how-to/billing-access).
         # @param [String] name
         #   Required. The resource name of the billing account associated with the
-        #   projects that
-        #   you want to list. For example, `billingAccounts/012345-567890-ABCDEF`.
+        #   projects that you want to list. For example, `billingAccounts/012345-567890-
+        #   ABCDEF`.
         # @param [Fixnum] page_size
-        #   Requested page size. The maximum page size is 100; this is also the
-        #   default.
+        #   Requested page size. The maximum page size is 100; this is also the default.
         # @param [String] page_token
-        #   A token identifying a page of results to be returned. This should be a
-        #   `next_page_token` value returned from a previous `ListProjectBillingInfo`
-        #   call. If unspecified, the first page of results is returned.
+        #   A token identifying a page of results to be returned. This should be a `
+        #   next_page_token` value returned from a previous `ListProjectBillingInfo` call.
+        #   If unspecified, the first page of results is returned.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -372,9 +361,8 @@ module Google
         end
         
         # Gets the billing information for a project. The current authenticated user
-        # must have [permission to view the
-        # project](https://cloud.google.com/docs/permissions-overview#h.bgs0oxofvnoo
-        # ).
+        # must have [permission to view the project](https://cloud.google.com/docs/
+        # permissions-overview#h.bgs0oxofvnoo ).
         # @param [String] name
         #   Required. The resource name of the project for which billing information is
         #   retrieved. For example, `projects/tokyo-rain-123`.
@@ -405,37 +393,32 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Sets or updates the billing account associated with a project. You specify
-        # the new billing account by setting the `billing_account_name` in the
-        # `ProjectBillingInfo` resource to the resource name of a billing account.
+        # Sets or updates the billing account associated with a project. You specify the
+        # new billing account by setting the `billing_account_name` in the `
+        # ProjectBillingInfo` resource to the resource name of a billing account.
         # Associating a project with an open billing account enables billing on the
         # project and allows charges for resource usage. If the project already had a
         # billing account, this method changes the billing account used for resource
-        # usage charges.
-        # *Note:* Incurred charges that have not yet been reported in the transaction
-        # history of the GCP Console might be billed to the new billing
-        # account, even if the charge occurred before the new billing account was
-        # assigned to the project.
-        # The current authenticated user must have ownership privileges for both the
-        # [project](https://cloud.google.com/docs/permissions-overview#h.bgs0oxofvnoo
-        # ) and the [billing
-        # account](https://cloud.google.com/billing/docs/how-to/billing-access).
-        # You can disable billing on the project by setting the
-        # `billing_account_name` field to empty. This action disassociates the
-        # current billing account from the project. Any billable activity of your
-        # in-use services will stop, and your application could stop functioning as
-        # expected. Any unbilled charges to date will be billed to the previously
-        # associated account. The current authenticated user must be either an owner
-        # of the project or an owner of the billing account for the project.
-        # Note that associating a project with a *closed* billing account will have
-        # much the same effect as disabling billing on the project: any paid
-        # resources used by the project will be shut down. Thus, unless you wish to
-        # disable billing, you should always call this method with the name of an
-        # *open* billing account.
+        # usage charges. *Note:* Incurred charges that have not yet been reported in the
+        # transaction history of the Google Cloud Console might be billed to the new
+        # billing account, even if the charge occurred before the new billing account
+        # was assigned to the project. The current authenticated user must have
+        # ownership privileges for both the [project](https://cloud.google.com/docs/
+        # permissions-overview#h.bgs0oxofvnoo ) and the [billing account](https://cloud.
+        # google.com/billing/docs/how-to/billing-access). You can disable billing on the
+        # project by setting the `billing_account_name` field to empty. This action
+        # disassociates the current billing account from the project. Any billable
+        # activity of your in-use services will stop, and your application could stop
+        # functioning as expected. Any unbilled charges to date will be billed to the
+        # previously associated account. The current authenticated user must be either
+        # an owner of the project or an owner of the billing account for the project.
+        # Note that associating a project with a *closed* billing account will have much
+        # the same effect as disabling billing on the project: any paid resources used
+        # by the project will be shut down. Thus, unless you wish to disable billing,
+        # you should always call this method with the name of an *open* billing account.
         # @param [String] name
         #   Required. The resource name of the project associated with the billing
-        #   information
-        #   that you want to update. For example, `projects/tokyo-rain-123`.
+        #   information that you want to update. For example, `projects/tokyo-rain-123`.
         # @param [Google::Apis::CloudbillingV1::ProjectBillingInfo] project_billing_info_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -470,9 +453,9 @@ module Google
         # @param [Fixnum] page_size
         #   Requested page size. Defaults to 5000.
         # @param [String] page_token
-        #   A token identifying a page of results to return. This should be a
-        #   `next_page_token` value returned from a previous `ListServices`
-        #   call. If unspecified, the first page of results is returned.
+        #   A token identifying a page of results to return. This should be a `
+        #   next_page_token` value returned from a previous `ListServices` call. If
+        #   unspecified, the first page of results is returned.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -503,32 +486,29 @@ module Google
         
         # Lists all publicly available SKUs for a given cloud service.
         # @param [String] parent
-        #   Required. The name of the service.
-        #   Example: "services/DA34-426B-A397"
+        #   Required. The name of the service. Example: "services/DA34-426B-A397"
         # @param [String] currency_code
-        #   The ISO 4217 currency code for the pricing info in the response proto.
-        #   Will use the conversion rate as of start_time.
-        #   Optional. If not specified USD will be used.
+        #   The ISO 4217 currency code for the pricing info in the response proto. Will
+        #   use the conversion rate as of start_time. Optional. If not specified USD will
+        #   be used.
         # @param [String] end_time
-        #   Optional exclusive end time of the time range for which the pricing
-        #   versions will be returned. Timestamps in the future are not allowed.
-        #   The time range has to be within a single calendar month in
-        #   America/Los_Angeles timezone. Time range as a whole is optional. If not
-        #   specified, the latest pricing will be returned (up to 12 hours old at
-        #   most).
+        #   Optional exclusive end time of the time range for which the pricing versions
+        #   will be returned. Timestamps in the future are not allowed. The time range has
+        #   to be within a single calendar month in America/Los_Angeles timezone. Time
+        #   range as a whole is optional. If not specified, the latest pricing will be
+        #   returned (up to 12 hours old at most).
         # @param [Fixnum] page_size
         #   Requested page size. Defaults to 5000.
         # @param [String] page_token
-        #   A token identifying a page of results to return. This should be a
-        #   `next_page_token` value returned from a previous `ListSkus`
-        #   call. If unspecified, the first page of results is returned.
+        #   A token identifying a page of results to return. This should be a `
+        #   next_page_token` value returned from a previous `ListSkus` call. If
+        #   unspecified, the first page of results is returned.
         # @param [String] start_time
-        #   Optional inclusive start time of the time range for which the pricing
-        #   versions will be returned. Timestamps in the future are not allowed.
-        #   The time range has to be within a single calendar month in
-        #   America/Los_Angeles timezone. Time range as a whole is optional. If not
-        #   specified, the latest pricing will be returned (up to 12 hours old at
-        #   most).
+        #   Optional inclusive start time of the time range for which the pricing versions
+        #   will be returned. Timestamps in the future are not allowed. The time range has
+        #   to be within a single calendar month in America/Los_Angeles timezone. Time
+        #   range as a whole is optional. If not specified, the latest pricing will be
+        #   returned (up to 12 hours old at most).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user

data/generated/google/apis/cloudbuild_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/cloud-build/docs/
     module CloudbuildV1
       VERSION = 'V1'
-      REVISION = '20200720'
+      REVISION = '20200910'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/cloudbuild_v1/classes.rb

@@ -22,17 +22,15 @@ module Google
   module Apis
     module CloudbuildV1
       
-      # Files in the workspace to upload to Cloud Storage upon successful
-      # completion of all build steps.
+      # Files in the workspace to upload to Cloud Storage upon successful completion
+      # of all build steps.
       class ArtifactObjects
         include Google::Apis::Core::Hashable
       
-        # Cloud Storage bucket and optional object path, in the form
-        # "gs://bucket/path/to/somewhere/". (see [Bucket Name
-        # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)
-        # ).
-        # Files in the workspace matching any path pattern will be uploaded to
-        # Cloud Storage with this location as a prefix.
+        # Cloud Storage bucket and optional object path, in the form "gs://bucket/path/
+        # to/somewhere/". (see [Bucket Name Requirements](https://cloud.google.com/
+        # storage/docs/bucket-naming#requirements)). Files in the workspace matching any
+        # path pattern will be uploaded to Cloud Storage with this location as a prefix.
         # Corresponds to the JSON property `location`
         # @return [String]
         attr_accessor :location
@@ -59,8 +57,8 @@ module Google
         end
       end
       
-      # An artifact that was uploaded during a build. This
-      # is a single record in the artifact manifest JSON file.
+      # An artifact that was uploaded during a build. This is a single record in the
+      # artifact manifest JSON file.
       class ArtifactResult
         include Google::Apis::Core::Hashable
       
@@ -69,9 +67,8 @@ module Google
         # @return [Array<Google::Apis::CloudbuildV1::FileHashes>]
         attr_accessor :file_hash
       
-        # The path of an artifact in a Google Cloud Storage bucket, with the
-        # generation number. For example,
-        # `gs://mybucket/path/to/output.jar#generation`.
+        # The path of an artifact in a Google Cloud Storage bucket, with the generation
+        # number. For example, `gs://mybucket/path/to/output.jar#generation`.
         # Corresponds to the JSON property `location`
         # @return [String]
         attr_accessor :location
@@ -87,23 +84,22 @@ module Google
         end
       end
       
-      # Artifacts produced by a build that should be uploaded upon
-      # successful completion of all build steps.
+      # Artifacts produced by a build that should be uploaded upon successful
+      # completion of all build steps.
       class Artifacts
         include Google::Apis::Core::Hashable
       
         # A list of images to be pushed upon the successful completion of all build
-        # steps.
-        # The images will be pushed using the builder service account's credentials.
-        # The digests of the pushed images will be stored in the Build resource's
-        # results field.
-        # If any of the images fail to be pushed, the build is marked FAILURE.
+        # steps. The images will be pushed using the builder service account's
+        # credentials. The digests of the pushed images will be stored in the Build
+        # resource's results field. If any of the images fail to be pushed, the build is
+        # marked FAILURE.
         # Corresponds to the JSON property `images`
         # @return [Array<String>]
         attr_accessor :images
       
-        # Files in the workspace to upload to Cloud Storage upon successful
-        # completion of all build steps.
+        # Files in the workspace to upload to Cloud Storage upon successful completion
+        # of all build steps.
         # Corresponds to the JSON property `objects`
         # @return [Google::Apis::CloudbuildV1::ArtifactObjects]
         attr_accessor :objects
@@ -119,31 +115,27 @@ module Google
         end
       end
       
-      # 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.
-      # - $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.
+      # 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. - $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.
       class Build
         include Google::Apis::Core::Hashable
       
-        # Artifacts produced by a build that should be uploaded upon
-        # successful completion of all build steps.
+        # Artifacts produced by a build that should be uploaded upon successful
+        # completion of all build steps.
         # Corresponds to the JSON property `artifacts`
         # @return [Google::Apis::CloudbuildV1::Artifacts]
         attr_accessor :artifacts
       
-        # Output only. The ID of the `BuildTrigger` that triggered this build, if it
-        # was triggered automatically.
+        # Output only. The ID of the `BuildTrigger` that triggered this build, if it was
+        # triggered automatically.
         # Corresponds to the JSON property `buildTriggerId`
         # @return [String]
         attr_accessor :build_trigger_id
@@ -153,9 +145,8 @@ module Google
         # @return [String]
         attr_accessor :create_time
       
-        # Output only. Time at which execution of the build was finished.
-        # The difference between finish_time and start_time is the duration of the
-        # build's execution.
+        # Output only. Time at which execution of the build was finished. The difference
+        # between finish_time and start_time is the duration of the build's execution.
         # Corresponds to the JSON property `finishTime`
         # @return [String]
         attr_accessor :finish_time
@@ -166,12 +157,10 @@ module Google
         attr_accessor :id
       
         # A list of images to be pushed upon the successful completion of all build
-        # steps.
-        # The images are pushed using the builder service account's credentials.
+        # steps. The images are pushed using the builder service account's credentials.
         # The digests of the pushed images will be stored in the `Build` resource's
-        # results field.
-        # If any of the images fail to be pushed, the build status is marked
-        # `FAILURE`.
+        # results field. If any of the images fail to be pushed, the build status is
+        # marked `FAILURE`.
         # Corresponds to the JSON property `images`
         # @return [Array<String>]
         attr_accessor :images
@@ -181,15 +170,20 @@ module Google
         # @return [String]
         attr_accessor :log_url
       
-        # Google Cloud Storage bucket where logs should be written (see
-        # [Bucket Name
+        # Google Cloud Storage bucket where logs should be written (see [Bucket Name
         # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)
-        # ).
-        # Logs file names will be of the format `$`logs_bucket`/log-$`build_id`.txt`.
+        # ). Logs file names will be of the format `$`logs_bucket`/log-$`build_id`.txt`.
         # Corresponds to the JSON property `logsBucket`
         # @return [String]
         attr_accessor :logs_bucket
       
+        # Output only. The 'Build' name with format: `projects/`project`/locations/`
+        # location`/builds/`build``, where `build` is a unique identifier generated by
+        # the service.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
         # Optional arguments to enable specific features of builds.
         # Corresponds to the JSON property `options`
         # @return [Google::Apis::CloudbuildV1::BuildOptions]
@@ -200,10 +194,9 @@ module Google
         # @return [String]
         attr_accessor :project_id
       
-        # TTL in queue for this build. If provided and the build is enqueued longer
-        # than this value, the build will expire and the build status will be
-        # `EXPIRED`.
-        # The TTL starts ticking from create_time.
+        # TTL in queue for this build. If provided and the build is enqueued longer than
+        # this value, the build will expire and the build status will be `EXPIRED`. The
+        # TTL starts ticking from create_time.
         # Corresponds to the JSON property `queueTtl`
         # @return [String]
         attr_accessor :queue_ttl
@@ -218,6 +211,14 @@ module Google
         # @return [Array<Google::Apis::CloudbuildV1::Secret>]
         attr_accessor :secrets
       
+        # IAM service account whose credentials will be used at build runtime. Must be
+        # of the format `projects/`PROJECT_ID`/serviceAccounts/`ACCOUNT``. ACCOUNT can
+        # be email address or uniqueId of the service account. This field is in alpha
+        # and is not publicly available.
+        # Corresponds to the JSON property `serviceAccount`
+        # @return [String]
+        attr_accessor :service_account
+      
         # Location of the source in a supported storage service.
         # Corresponds to the JSON property `source`
         # @return [Google::Apis::CloudbuildV1::Source]
@@ -259,22 +260,18 @@ module Google
         # @return [Array<String>]
         attr_accessor :tags
       
-        # Amount of time that this build should be allowed to run, to second
-        # granularity. If this amount of time elapses, work on the build will cease
-        # and the build status will be `TIMEOUT`.
-        # `timeout` starts ticking from `startTime`.
-        # Default time is ten minutes.
+        # Amount of time that this build should be allowed to run, to second granularity.
+        # If this amount of time elapses, work on the build will cease and the build
+        # status will be `TIMEOUT`. `timeout` starts ticking from `startTime`. Default
+        # time is ten minutes.
         # Corresponds to the JSON property `timeout`
         # @return [String]
         attr_accessor :timeout
       
-        # Output only. Stores timing information for phases of the build. Valid keys
-        # are:
-        # * BUILD: time to execute all build steps
-        # * PUSH: time to push all specified images.
-        # * FETCHSOURCE: time to fetch source.
-        # If the build does not specify source or images,
-        # these keys will not be included.
+        # Output only. Stores timing information for phases of the build. Valid keys are:
+        # * BUILD: time to execute all build steps * PUSH: time to push all specified
+        # images. * FETCHSOURCE: time to fetch source. If the build does not specify
+        # source or images, these keys will not be included.
         # Corresponds to the JSON property `timing`
         # @return [Hash<String,Google::Apis::CloudbuildV1::TimeSpan>]
         attr_accessor :timing
@@ -293,11 +290,13 @@ module Google
           @images = args[:images] if args.key?(:images)
           @log_url = args[:log_url] if args.key?(:log_url)
           @logs_bucket = args[:logs_bucket] if args.key?(:logs_bucket)
+          @name = args[:name] if args.key?(:name)
           @options = args[:options] if args.key?(:options)
           @project_id = args[:project_id] if args.key?(:project_id)
           @queue_ttl = args[:queue_ttl] if args.key?(:queue_ttl)
           @results = args[:results] if args.key?(:results)
           @secrets = args[:secrets] if args.key?(:secrets)
+          @service_account = args[:service_account] if args.key?(:service_account)
           @source = args[:source] if args.key?(:source)
           @source_provenance = args[:source_provenance] if args.key?(:source_provenance)
           @start_time = args[:start_time] if args.key?(:start_time)
@@ -315,20 +314,16 @@ module Google
       class BuildOperationMetadata
         include Google::Apis::Core::Hashable
       
-        # 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.
-        # - $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.
+        # 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. - $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.
         # Corresponds to the JSON property `build`
         # @return [Google::Apis::CloudbuildV1::Build]
         attr_accessor :build
@@ -347,19 +342,18 @@ module Google
       class BuildOptions
         include Google::Apis::Core::Hashable
       
-        # Requested disk size for the VM that runs the build. Note that this is *NOT*
-        # "disk free"; some of the space will be used by the operating system and
-        # build utilities. Also note that this is the minimum disk size that will be
-        # allocated for the build -- the build may run with a larger disk than
-        # requested. At present, the maximum disk size is 1000GB; builds that request
-        # more than the maximum are rejected with an error.
+        # Requested disk size for the VM that runs the build. Note that this is *NOT* "
+        # disk free"; some of the space will be used by the operating system and build
+        # utilities. Also note that this is the minimum disk size that will be allocated
+        # for the build -- the build may run with a larger disk than requested. At
+        # present, the maximum disk size is 1000GB; builds that request more than the
+        # maximum are rejected with an error.
         # Corresponds to the JSON property `diskSizeGb`
         # @return [Fixnum]
         attr_accessor :disk_size_gb
       
-        # Option to specify whether or not to apply bash style string
-        # operations to the substitutions.
-        # NOTE: this is always enabled for triggered builds and cannot be
+        # Option to specify whether or not to apply bash style string operations to the
+        # substitutions. NOTE: this is always enabled for triggered builds and cannot be
         # overridden in the build configuration file.
         # Corresponds to the JSON property `dynamicSubstitutions`
         # @return [Boolean]
@@ -367,22 +361,21 @@ module Google
         alias_method :dynamic_substitutions?, :dynamic_substitutions
       
         # A list of global environment variable definitions that will exist for all
-        # build steps in this build. If a variable is defined in both globally and in
-        # a build step, the variable will use the build step value.
-        # The elements are of the form "KEY=VALUE" for the environment variable "KEY"
-        # being given the value "VALUE".
+        # build steps in this build. If a variable is defined in both globally and in a
+        # build step, the variable will use the build step value. The elements are of
+        # the form "KEY=VALUE" for the environment variable "KEY" being given the value "
+        # VALUE".
         # Corresponds to the JSON property `env`
         # @return [Array<String>]
         attr_accessor :env
       
-        # Option to define build log streaming behavior to Google Cloud
-        # Storage.
+        # Option to define build log streaming behavior to Google Cloud Storage.
         # Corresponds to the JSON property `logStreamingOption`
         # @return [String]
         attr_accessor :log_streaming_option
       
-        # Option to specify the logging mode, which determines if and where build
-        # logs are stored.
+        # Option to specify the logging mode, which determines if and where build logs
+        # are stored.
         # Corresponds to the JSON property `logging`
         # @return [String]
         attr_accessor :logging
@@ -397,10 +390,9 @@ module Google
         # @return [String]
         attr_accessor :requested_verify_option
       
-        # A list of global environment variables, which are encrypted using a Cloud
-        # Key Management Service crypto key. These values must be specified in the
-        # build's `Secret`. These variables will be available to all build steps
-        # in this build.
+        # A list of global environment variables, which are encrypted using a Cloud Key
+        # Management Service crypto key. These values must be specified in the build's `
+        # Secret`. These variables will be available to all build steps in this build.
         # Corresponds to the JSON property `secretEnv`
         # @return [Array<String>]
         attr_accessor :secret_env
@@ -410,28 +402,25 @@ module Google
         # @return [Array<String>]
         attr_accessor :source_provenance_hash
       
-        # Option to specify behavior when there is an error in the substitution
-        # checks.
-        # NOTE: this is always set to ALLOW_LOOSE for triggered builds and cannot
-        # be overridden in the build configuration file.
+        # Option to specify behavior when there is an error in the substitution checks.
+        # NOTE: this is always set to ALLOW_LOOSE for triggered builds and cannot be
+        # overridden in the build configuration file.
         # Corresponds to the JSON property `substitutionOption`
         # @return [String]
         attr_accessor :substitution_option
       
-        # Global list of volumes to mount for ALL build steps
-        # Each volume is created as an empty volume prior to starting the build
-        # process. Upon completion of the build, volumes and their contents are
-        # discarded. Global volume names and paths cannot conflict with the volumes
-        # defined a build step.
-        # Using a global volume in a build with only one step is not valid as
-        # it is indicative of a build request with an incorrect configuration.
+        # Global list of volumes to mount for ALL build steps Each volume is created as
+        # an empty volume prior to starting the build process. Upon completion of the
+        # build, volumes and their contents are discarded. Global volume names and paths
+        # cannot conflict with the volumes defined a build step. Using a global volume
+        # in a build with only one step is not valid as it is indicative of a build
+        # request with an incorrect configuration.
         # Corresponds to the JSON property `volumes`
         # @return [Array<Google::Apis::CloudbuildV1::Volume>]
         attr_accessor :volumes
       
-        # Option to specify a `WorkerPool` for the build.
-        # Format: projects/`project`/workerPools/`workerPool`
-        # This field is experimental.
+        # Option to specify a `WorkerPool` for the build. Format: projects/`project`/
+        # locations/`location`/workerPools/`workerPool` This field is experimental.
         # Corresponds to the JSON property `workerPool`
         # @return [String]
         attr_accessor :worker_pool
@@ -461,61 +450,56 @@ module Google
       class BuildStep
         include Google::Apis::Core::Hashable
       
-        # A list of arguments that will be presented to the step when it is started.
-        # If the image used to run the step's container has an entrypoint, the `args`
-        # are used as arguments to that entrypoint. If the image does not define
-        # an entrypoint, the first element in args is used as the entrypoint,
-        # and the remainder will be used as arguments.
+        # A list of arguments that will be presented to the step when it is started. If
+        # the image used to run the step's container has an entrypoint, the `args` are
+        # used as arguments to that entrypoint. If the image does not define an
+        # entrypoint, the first element in args is used as the entrypoint, and the
+        # remainder will be used as arguments.
         # Corresponds to the JSON property `args`
         # @return [Array<String>]
         attr_accessor :args
       
-        # Working directory to use when running this step's container.
-        # If this value is a relative path, it is relative to the build's working
-        # directory. If this value is absolute, it may be outside the build's working
-        # directory, in which case the contents of the path may not be persisted
-        # across build step executions, unless a `volume` for that path is specified.
-        # If the build specifies a `RepoSource` with `dir` and a step with a `dir`,
-        # which specifies an absolute path, the `RepoSource` `dir` is ignored for
-        # the step's execution.
+        # Working directory to use when running this step's container. If this value is
+        # a relative path, it is relative to the build's working directory. If this
+        # value is absolute, it may be outside the build's working directory, in which
+        # case the contents of the path may not be persisted across build step
+        # executions, unless a `volume` for that path is specified. If the build
+        # specifies a `RepoSource` with `dir` and a step with a `dir`, which specifies
+        # an absolute path, the `RepoSource` `dir` is ignored for the step's execution.
         # Corresponds to the JSON property `dir`
         # @return [String]
         attr_accessor :dir
       
-        # Entrypoint to be used instead of the build step image's default entrypoint.
-        # If unset, the image's default entrypoint is used.
+        # Entrypoint to be used instead of the build step image's default entrypoint. If
+        # unset, the image's default entrypoint is used.
         # Corresponds to the JSON property `entrypoint`
         # @return [String]
         attr_accessor :entrypoint
       
-        # A list of environment variable definitions to be used when running a step.
-        # The elements are of the form "KEY=VALUE" for the environment variable "KEY"
-        # being given the value "VALUE".
+        # A list of environment variable definitions to be used when running a step. The
+        # elements are of the form "KEY=VALUE" for the environment variable "KEY" being
+        # given the value "VALUE".
         # Corresponds to the JSON property `env`
         # @return [Array<String>]
         attr_accessor :env
       
-        # Unique identifier for this build step, used in `wait_for` to
-        # reference this build step as a dependency.
+        # Unique identifier for this build step, used in `wait_for` to reference this
+        # build step as a dependency.
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
       
-        # Required. The name of the container image that will run this particular
-        # build step.
-        # If the image is available in the host's Docker daemon's cache, it
-        # will be run directly. If not, the host will attempt to pull the image
-        # first, using the builder service account's credentials if necessary.
-        # The Docker daemon's cache will already have the latest versions of all of
-        # the officially supported build steps
-        # ([https://github.com/GoogleCloudPlatform/cloud-builders](https://github.com/
-        # GoogleCloudPlatform/cloud-builders)).
-        # The Docker daemon will also have cached many of the layers for some popular
-        # images, like "ubuntu", "debian", but they will be refreshed at the time you
-        # attempt to use them.
-        # If you built an image in a previous build step, it will be stored in the
-        # host's Docker daemon's cache and is available to use as the name for a
-        # later build step.
+        # Required. The name of the container image that will run this particular build
+        # step. If the image is available in the host's Docker daemon's cache, it will
+        # be run directly. If not, the host will attempt to pull the image first, using
+        # the builder service account's credentials if necessary. The Docker daemon's
+        # cache will already have the latest versions of all of the officially supported
+        # build steps ([https://github.com/GoogleCloudPlatform/cloud-builders](https://
+        # github.com/GoogleCloudPlatform/cloud-builders)). The Docker daemon will also
+        # have cached many of the layers for some popular images, like "ubuntu", "debian"
+        # , but they will be refreshed at the time you attempt to use them. If you built
+        # an image in a previous build step, it will be stored in the host's Docker
+        # daemon's cache and is available to use as the name for a later build step.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -526,22 +510,22 @@ module Google
         attr_accessor :pull_timing
       
         # A list of environment variables which are encrypted using a Cloud Key
-        # Management Service crypto key. These values must be specified in the
-        # build's `Secret`.
+        # Management Service crypto key. These values must be specified in the build's `
+        # Secret`.
         # Corresponds to the JSON property `secretEnv`
         # @return [Array<String>]
         attr_accessor :secret_env
       
-        # Output only. Status of the build step. At this time, build step status is
-        # only updated on build completion; step status is not updated in real-time
-        # as the build progresses.
+        # Output only. Status of the build step. At this time, build step status is only
+        # updated on build completion; step status is not updated in real-time as the
+        # build progresses.
         # Corresponds to the JSON property `status`
         # @return [String]
         attr_accessor :status
       
-        # Time limit for executing this build step. If not defined, the step has no
-        # time limit and will be allowed to continue to run until either it completes
-        # or the build itself times out.
+        # Time limit for executing this build step. If not defined, the step has no time
+        # limit and will be allowed to continue to run until either it completes or the
+        # build itself times out.
         # Corresponds to the JSON property `timeout`
         # @return [String]
         attr_accessor :timeout
@@ -551,21 +535,19 @@ module Google
         # @return [Google::Apis::CloudbuildV1::TimeSpan]
         attr_accessor :timing
       
-        # List of volumes to mount into the build step.
-        # Each volume is created as an empty volume prior to execution of the
-        # build step. Upon completion of the build, volumes and their contents are
-        # discarded.
-        # Using a named volume in only one step is not valid as it is indicative
-        # of a build request with an incorrect configuration.
+        # List of volumes to mount into the build step. Each volume is created as an
+        # empty volume prior to execution of the build step. Upon completion of the
+        # build, volumes and their contents are discarded. Using a named volume in only
+        # one step is not valid as it is indicative of a build request with an incorrect
+        # configuration.
         # Corresponds to the JSON property `volumes`
         # @return [Array<Google::Apis::CloudbuildV1::Volume>]
         attr_accessor :volumes
       
-        # The ID(s) of the step(s) that this build step depends on.
-        # This build step will not start until all the build steps in `wait_for`
-        # have completed successfully. If `wait_for` is empty, this build step will
-        # start when all previous build steps in the `Build.Steps` list have
-        # completed successfully.
+        # The ID(s) of the step(s) that this build step depends on. This build step will
+        # not start until all the build steps in `wait_for` have completed successfully.
+        # If `wait_for` is empty, this build step will start when all previous build
+        # steps in the `Build.Steps` list have completed successfully.
         # Corresponds to the JSON property `waitFor`
         # @return [Array<String>]
         attr_accessor :wait_for
@@ -592,25 +574,20 @@ module Google
         end
       end
       
-      # Configuration for an automated build in response to source repository
-      # changes.
+      # Configuration for an automated build in response to source repository changes.
       class BuildTrigger
         include Google::Apis::Core::Hashable
       
-        # 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.
-        # - $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.
+        # 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. - $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.
         # Corresponds to the JSON property `build`
         # @return [Google::Apis::CloudbuildV1::Build]
         attr_accessor :build
@@ -631,15 +608,13 @@ module Google
         attr_accessor :disabled
         alias_method :disabled?, :disabled
       
-        # Path, from the source root, to a file whose contents is used for the
-        # template.
+        # Path, from the source root, to a file whose contents is used for the template.
         # Corresponds to the JSON property `filename`
         # @return [String]
         attr_accessor :filename
       
         # GitHubEventsConfig describes the configuration of a trigger that creates a
-        # build whenever a GitHub event is received.
-        # This message is experimental.
+        # build whenever a GitHub event is received. This message is experimental.
         # Corresponds to the JSON property `github`
         # @return [Google::Apis::CloudbuildV1::GitHubEventsConfig]
         attr_accessor :github
@@ -649,40 +624,36 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # ignored_files and included_files are file glob matches using
-        # https://golang.org/pkg/path/filepath/#Match extended with support for "**".
-        # If ignored_files and changed files are both empty, then they are
-        # not used to determine whether or not to trigger a build.
-        # If ignored_files is not empty, then we ignore any files that match
-        # any of the ignored_file globs. If the change has no files that are
-        # outside of the ignored_files globs, then we do not trigger a build.
+        # ignored_files and included_files are file glob matches using https://golang.
+        # org/pkg/path/filepath/#Match extended with support for "**". If ignored_files
+        # and changed files are both empty, then they are not used to determine whether
+        # or not to trigger a build. If ignored_files is not empty, then we ignore any
+        # files that match any of the ignored_file globs. If the change has no files
+        # that are outside of the ignored_files globs, then we do not trigger a build.
         # Corresponds to the JSON property `ignoredFiles`
         # @return [Array<String>]
         attr_accessor :ignored_files
       
-        # If any of the files altered in the commit pass the ignored_files
-        # filter and included_files is empty, then as far as this filter is
-        # concerned, we should trigger the build.
-        # If any of the files altered in the commit pass the ignored_files
-        # filter and included_files is not empty, then we make sure that at
-        # least one of those files matches a included_files glob. If not,
-        # then we do not trigger a build.
+        # If any of the files altered in the commit pass the ignored_files filter and
+        # included_files is empty, then as far as this filter is concerned, we should
+        # trigger the build. If any of the files altered in the commit pass the
+        # ignored_files filter and included_files is not empty, then we make sure that
+        # at least one of those files matches a included_files glob. If not, then we do
+        # not trigger a build.
         # Corresponds to the JSON property `includedFiles`
         # @return [Array<String>]
         attr_accessor :included_files
       
-        # User-assigned name of the trigger. Must be unique within the project.
-        # Trigger names must meet the following requirements:
-        # + They must contain only alphanumeric characters and dashes.
-        # + They can be 1-64 characters long.
-        # + They must begin and end with an alphanumeric character.
+        # User-assigned name of the trigger. Must be unique within the project. Trigger
+        # names must meet the following requirements: + They must contain only
+        # alphanumeric characters and dashes. + They can be 1-64 characters long. + They
+        # must begin and end with an alphanumeric character.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Substitutions for Build resource. The keys must match the following
-        # regular expression: `^_[A-Z0-9_]+$`.The keys cannot conflict with the
-        # keys in bindings.
+        # Substitutions for Build resource. The keys must match the following regular
+        # expression: `^_[A-Z0-9_]+$`.
         # Corresponds to the JSON property `substitutions`
         # @return [Hash<String,String>]
         attr_accessor :substitutions
@@ -755,12 +726,31 @@ module Google
       class CancelBuildRequest
         include Google::Apis::Core::Hashable
       
+        # Required. ID of the build.
+        # Corresponds to the JSON property `id`
+        # @return [String]
+        attr_accessor :id
+      
+        # The name of the `Build` to retrieve. Format: `projects/`project`/locations/`
+        # location`/builds/`build``
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Required. ID of the project.
+        # Corresponds to the JSON property `projectId`
+        # @return [String]
+        attr_accessor :project_id
+      
         def initialize(**args)
            update!(**args)
         end
       
         # Update properties of this object
         def update!(**args)
+          @id = args[:id] if args.key?(:id)
+          @name = args[:name] if args.key?(:name)
+          @project_id = args[:project_id] if args.key?(:project_id)
         end
       end
       
@@ -777,13 +767,45 @@ module Google
         end
       end
       
-      # 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 ````.
+      # Request to create a new build.
+      class CreateBuildRequest
+        include Google::Apis::Core::Hashable
+      
+        # 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. - $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.
+        # Corresponds to the JSON property `build`
+        # @return [Google::Apis::CloudbuildV1::Build]
+        attr_accessor :build
+      
+        # Required. ID of the project.
+        # Corresponds to the JSON property `projectId`
+        # @return [String]
+        attr_accessor :project_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @build = args[:build] if args.key?(:build)
+          @project_id = args[:project_id] if args.key?(:project_id)
+        end
+      end
+      
+      # 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 ````.
       class Empty
         include Google::Apis::Core::Hashable
       
@@ -817,8 +839,7 @@ module Google
       end
       
       # GitHubEventsConfig describes the configuration of a trigger that creates a
-      # build whenever a GitHub event is received.
-      # This message is experimental.
+      # build whenever a GitHub event is received. This message is experimental.
       class GitHubEventsConfig
         include Google::Apis::Core::Hashable
       
@@ -827,21 +848,19 @@ module Google
         # @return [Fixnum]
         attr_accessor :installation_id
       
-        # Name of the repository. For example: The name for
-        # https://github.com/googlecloudplatform/cloud-builders is "cloud-builders".
+        # Name of the repository. For example: The name for https://github.com/
+        # googlecloudplatform/cloud-builders is "cloud-builders".
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Owner of the repository. For example: The owner for
-        # https://github.com/googlecloudplatform/cloud-builders is
-        # "googlecloudplatform".
+        # Owner of the repository. For example: The owner for https://github.com/
+        # googlecloudplatform/cloud-builders is "googlecloudplatform".
         # Corresponds to the JSON property `owner`
         # @return [String]
         attr_accessor :owner
       
-        # PullRequestFilter contains filter properties for matching GitHub Pull
-        # Requests.
+        # PullRequestFilter contains filter properties for matching GitHub Pull Requests.
         # Corresponds to the JSON property `pullRequest`
         # @return [Google::Apis::CloudbuildV1::PullRequestFilter]
         attr_accessor :pull_request
@@ -965,9 +984,9 @@ module Google
       class Notification
         include Google::Apis::Core::Hashable
       
-        # The filter string to use for notification filtering.
-        # Currently, this is assumed to be a CEL program.
-        # See https://opensource.google/projects/cel for more.
+        # The filter string to use for notification filtering. Currently, this is
+        # assumed to be a CEL program. See https://opensource.google/projects/cel for
+        # more.
         # Corresponds to the JSON property `filter`
         # @return [String]
         attr_accessor :filter
@@ -978,8 +997,8 @@ module Google
         attr_accessor :http_delivery
       
         # SlackDelivery is the delivery configuration for delivering Slack messages via
-        # webhooks. See Slack webhook documentation at:
-        # https://api.slack.com/messaging/webhooks.
+        # webhooks. See Slack webhook documentation at: https://api.slack.com/messaging/
+        # webhooks.
         # Corresponds to the JSON property `slackDelivery`
         # @return [Google::Apis::CloudbuildV1::SlackDelivery]
         attr_accessor :slack_delivery
@@ -1051,15 +1070,15 @@ module Google
       class NotifierMetadata
         include Google::Apis::Core::Hashable
       
-        # The human-readable and user-given name for the notifier.
-        # For example: "repo-merge-email-notifier".
+        # The human-readable and user-given name for the notifier. For example: "repo-
+        # merge-email-notifier".
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The string representing the name and version of notifier to deploy.
-        # Expected to be of the form of "<registry-path>/<name>:<version>".
-        # For example: "gcr.io/my-project/notifiers/smtp:1.2.34".
+        # The string representing the name and version of notifier to deploy. Expected
+        # to be of the form of "/:". For example: "gcr.io/my-project/notifiers/smtp:1.2.
+        # 34".
         # Corresponds to the JSON property `notifier`
         # @return [String]
         attr_accessor :notifier
@@ -1080,16 +1099,16 @@ module Google
       class NotifierSecret
         include Google::Apis::Core::Hashable
       
-        # Name is the local name of the secret, such as the verbatim string
-        # "my-smtp-password".
+        # Name is the local name of the secret, such as the verbatim string "my-smtp-
+        # password".
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Value is interpreted to be a resource path for fetching the actual
-        # (versioned) secret data for this secret. For example, this would be a
-        # Google Cloud Secret Manager secret version resource path like:
-        # "projects/my-project/secrets/my-secret/versions/latest".
+        # Value is interpreted to be a resource path for fetching the actual (versioned)
+        # secret data for this secret. For example, this would be a Google Cloud Secret
+        # Manager secret version resource path like: "projects/my-project/secrets/my-
+        # secret/versions/latest".
         # Corresponds to the JSON property `value`
         # @return [String]
         attr_accessor :value
@@ -1110,8 +1129,8 @@ module Google
       class NotifierSecretRef
         include Google::Apis::Core::Hashable
       
-        # The value of `secret_ref` should be a `name` that is registered in a
-        # `Secret` in the `secrets` list of the `Spec`.
+        # The value of `secret_ref` should be a `name` that is registered in a `Secret`
+        # in the `secrets` list of the `Spec`.
         # Corresponds to the JSON property `secretRef`
         # @return [String]
         attr_accessor :secret_ref
@@ -1157,47 +1176,45 @@ module Google
       class Operation
         include Google::Apis::Core::Hashable
       
-        # If the value is `false`, it means the operation is still in progress.
-        # If `true`, the operation is completed, and either `error` or `response` is
-        # available.
+        # If the value is `false`, it means the operation is still in progress. If `true`
+        # , the operation is completed, and either `error` or `response` is available.
         # Corresponds to the JSON property `done`
         # @return [Boolean]
         attr_accessor :done
         alias_method :done?, :done
       
-        # The `Status` type defines a logical error model that is suitable for
-        # different programming environments, including REST APIs and RPC APIs. It is
-        # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-        # three pieces of data: error code, error message, and error details.
-        # You can find out more about this error model and how to work with it in the
-        # [API Design Guide](https://cloud.google.com/apis/design/errors).
+        # The `Status` type defines a logical error model that is suitable for different
+        # programming environments, including REST APIs and RPC APIs. It is used by [
+        # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+        # data: error code, error message, and error details. You can find out more
+        # about this error model and how to work with it in the [API Design Guide](https:
+        # //cloud.google.com/apis/design/errors).
         # Corresponds to the JSON property `error`
         # @return [Google::Apis::CloudbuildV1::Status]
         attr_accessor :error
       
-        # Service-specific metadata associated with the operation.  It typically
-        # contains progress information and common metadata such as create time.
-        # Some services might not provide such metadata.  Any method that returns a
-        # long-running operation should document the metadata type, if any.
+        # Service-specific metadata associated with the operation. It typically contains
+        # progress information and common metadata such as create time. Some services
+        # might not provide such metadata. Any method that returns a long-running
+        # operation should document the metadata type, if any.
         # Corresponds to the JSON property `metadata`
         # @return [Hash<String,Object>]
         attr_accessor :metadata
       
         # The server-assigned name, which is only unique within the same service that
-        # originally returns it. If you use the default HTTP mapping, the
-        # `name` should be a resource name ending with `operations/`unique_id``.
+        # originally returns it. If you use the default HTTP mapping, the `name` should
+        # be a resource name ending with `operations/`unique_id``.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The normal response of the operation in case of success.  If the original
-        # method returns no data on success, such as `Delete`, the response is
-        # `google.protobuf.Empty`.  If the original method is standard
-        # `Get`/`Create`/`Update`, the response should be the resource.  For other
-        # methods, the response should have the type `XxxResponse`, where `Xxx`
-        # is the original method name.  For example, if the original method name
-        # is `TakeSnapshot()`, the inferred response type is
-        # `TakeSnapshotResponse`.
+        # The normal response of the operation in case of success. If the original
+        # method returns no data on success, such as `Delete`, the response is `google.
+        # protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`,
+        # the response should be the resource. For other methods, the response should
+        # have the type `XxxResponse`, where `Xxx` is the original method name. For
+        # example, if the original method name is `TakeSnapshot()`, the inferred
+        # response type is `TakeSnapshotResponse`.
         # Corresponds to the JSON property `response`
         # @return [Hash<String,Object>]
         attr_accessor :response
@@ -1216,14 +1233,13 @@ module Google
         end
       end
       
-      # PullRequestFilter contains filter properties for matching GitHub Pull
-      # Requests.
+      # PullRequestFilter contains filter properties for matching GitHub Pull Requests.
       class PullRequestFilter
         include Google::Apis::Core::Hashable
       
-        # Regex of branches to match.
-        # The syntax of the regular expressions accepted is the syntax accepted by
-        # RE2 and described at https://github.com/google/re2/wiki/Syntax
+        # Regex of branches to match. The syntax of the regular expressions accepted is
+        # the syntax accepted by RE2 and described at https://github.com/google/re2/wiki/
+        # Syntax
         # Corresponds to the JSON property `branch`
         # @return [String]
         attr_accessor :branch
@@ -1256,9 +1272,9 @@ module Google
       class PushFilter
         include Google::Apis::Core::Hashable
       
-        # Regexes matching branches to build.
-        # The syntax of the regular expressions accepted is the syntax accepted by
-        # RE2 and described at https://github.com/google/re2/wiki/Syntax
+        # Regexes matching branches to build. The syntax of the regular expressions
+        # accepted is the syntax accepted by RE2 and described at https://github.com/
+        # google/re2/wiki/Syntax
         # Corresponds to the JSON property `branch`
         # @return [String]
         attr_accessor :branch
@@ -1270,9 +1286,9 @@ module Google
         attr_accessor :invert_regex
         alias_method :invert_regex?, :invert_regex
       
-        # Regexes matching tags to build.
-        # The syntax of the regular expressions accepted is the syntax accepted by
-        # RE2 and described at https://github.com/google/re2/wiki/Syntax
+        # Regexes matching tags to build. The syntax of the regular expressions accepted
+        # is the syntax accepted by RE2 and described at https://github.com/google/re2/
+        # wiki/Syntax
         # Corresponds to the JSON property `tag`
         # @return [String]
         attr_accessor :tag
@@ -1293,9 +1309,9 @@ module Google
       class RepoSource
         include Google::Apis::Core::Hashable
       
-        # Regex matching branches to build.
-        # The syntax of the regular expressions accepted is the syntax accepted by
-        # RE2 and described at https://github.com/google/re2/wiki/Syntax
+        # Regex matching branches to build. The syntax of the regular expressions
+        # accepted is the syntax accepted by RE2 and described at https://github.com/
+        # google/re2/wiki/Syntax
         # Corresponds to the JSON property `branchName`
         # @return [String]
         attr_accessor :branch_name
@@ -1305,15 +1321,14 @@ module Google
         # @return [String]
         attr_accessor :commit_sha
       
-        # Directory, relative to the source root, in which to run the build.
-        # This must be a relative path. If a step's `dir` is specified and is an
-        # absolute path, this value is ignored for that step's execution.
+        # Directory, relative to the source root, in which to run the build. This must
+        # be a relative path. If a step's `dir` is specified and is an absolute path,
+        # this value is ignored for that step's execution.
         # Corresponds to the JSON property `dir`
         # @return [String]
         attr_accessor :dir
       
-        # Only trigger a build if the revision regex does NOT match the revision
-        # regex.
+        # Only trigger a build if the revision regex does NOT match the revision regex.
         # Corresponds to the JSON property `invertRegex`
         # @return [Boolean]
         attr_accessor :invert_regex
@@ -1330,15 +1345,15 @@ module Google
         # @return [String]
         attr_accessor :repo_name
       
-        # Substitutions to use in a triggered build.
-        # Should only be used with RunBuildTrigger
+        # Substitutions to use in a triggered build. Should only be used with
+        # RunBuildTrigger
         # Corresponds to the JSON property `substitutions`
         # @return [Hash<String,String>]
         attr_accessor :substitutions
       
-        # Regex matching tags to build.
-        # The syntax of the regular expressions accepted is the syntax accepted by
-        # RE2 and described at https://github.com/google/re2/wiki/Syntax
+        # Regex matching tags to build. The syntax of the regular expressions accepted
+        # is the syntax accepted by RE2 and described at https://github.com/google/re2/
+        # wiki/Syntax
         # Corresponds to the JSON property `tagName`
         # @return [String]
         attr_accessor :tag_name
@@ -1374,17 +1389,15 @@ module Google
         # @return [Google::Apis::CloudbuildV1::TimeSpan]
         attr_accessor :artifact_timing
       
-        # List of build step digests, in the order corresponding to build step
-        # indices.
+        # List of build step digests, in the order corresponding to build step indices.
         # Corresponds to the JSON property `buildStepImages`
         # @return [Array<String>]
         attr_accessor :build_step_images
       
         # List of build step outputs, produced by builder images, in the order
-        # corresponding to build step indices.
-        # [Cloud Builders](https://cloud.google.com/cloud-build/docs/cloud-builders)
-        # can produce this output by writing to `$BUILDER_OUTPUT/output`.
-        # Only the first 4KB of data is stored.
+        # corresponding to build step indices. [Cloud Builders](https://cloud.google.com/
+        # cloud-build/docs/cloud-builders) can produce this output by writing to `$
+        # BUILDER_OUTPUT/output`. Only the first 4KB of data is stored.
         # Corresponds to the JSON property `buildStepOutputs`
         # @return [Array<String>]
         attr_accessor :build_step_outputs
@@ -1418,12 +1431,31 @@ module Google
       class RetryBuildRequest
         include Google::Apis::Core::Hashable
       
+        # Required. Build ID of the original build.
+        # Corresponds to the JSON property `id`
+        # @return [String]
+        attr_accessor :id
+      
+        # The name of the `Build` to retry. Format: `projects/`project`/locations/`
+        # location`/builds/`build``
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Required. ID of the project.
+        # Corresponds to the JSON property `projectId`
+        # @return [String]
+        attr_accessor :project_id
+      
         def initialize(**args)
            update!(**args)
         end
       
         # Update properties of this object
         def update!(**args)
+          @id = args[:id] if args.key?(:id)
+          @name = args[:name] if args.key?(:name)
+          @project_id = args[:project_id] if args.key?(:project_id)
         end
       end
       
@@ -1431,8 +1463,8 @@ module Google
       class SmtpDelivery
         include Google::Apis::Core::Hashable
       
-        # This is the SMTP account/email that appears in the `From:` of the email.
-        # If empty, it is assumed to be sender.
+        # This is the SMTP account/email that appears in the `From:` of the email. If
+        # empty, it is assumed to be sender.
         # Corresponds to the JSON property `fromAddress`
         # @return [String]
         attr_accessor :from_address
@@ -1448,8 +1480,8 @@ module Google
         # @return [String]
         attr_accessor :port
       
-        # This is the list of addresses to which we send the email (i.e. in the `To:`
-        # of the email).
+        # This is the list of addresses to which we send the email (i.e. in the `To:` of
+        # the email).
         # Corresponds to the JSON property `recipientAddresses`
         # @return [Array<String>]
         attr_accessor :recipient_addresses
@@ -1479,8 +1511,8 @@ module Google
         end
       end
       
-      # Pairs a set of secret environment variables containing encrypted
-      # values with the Cloud KMS key to use to decrypt the value.
+      # Pairs a set of secret environment variables containing encrypted values with
+      # the Cloud KMS key to use to decrypt the value.
       class Secret
         include Google::Apis::Core::Hashable
       
@@ -1489,11 +1521,10 @@ module Google
         # @return [String]
         attr_accessor :kms_key_name
       
-        # Map of environment variable name to its encrypted value.
-        # Secret environment variables must be unique across all of a build's
-        # secrets, and must be used by at least one build step. Values can be at most
-        # 64 KB in size. There can be at most 100 secret values across all of a
-        # build's secrets.
+        # Map of environment variable name to its encrypted value. Secret environment
+        # variables must be unique across all of a build's secrets, and must be used by
+        # at least one build step. Values can be at most 64 KB in size. There can be at
+        # most 100 secret values across all of a build's secrets.
         # Corresponds to the JSON property `secretEnv`
         # @return [Hash<String,String>]
         attr_accessor :secret_env
@@ -1510,8 +1541,8 @@ module Google
       end
       
       # SlackDelivery is the delivery configuration for delivering Slack messages via
-      # webhooks. See Slack webhook documentation at:
-      # https://api.slack.com/messaging/webhooks.
+      # webhooks. See Slack webhook documentation at: https://api.slack.com/messaging/
+      # webhooks.
       class SlackDelivery
         include Google::Apis::Core::Hashable
       
@@ -1562,13 +1593,12 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Output only. Hash(es) of the build source, which can be used to verify that
-        # the original source integrity was maintained in the build. Note that
-        # `FileHashes` will only be populated if `BuildOptions` has requested a
-        # `SourceProvenanceHash`.
-        # The keys to this map are file paths used as build source and the values
-        # contain the hash values for those files.
-        # If the build source came in a single package such as a gzipped tarfile
-        # (`.tar.gz`), the `FileHash` will be for the single path to that file.
+        # the original source integrity was maintained in the build. Note that `
+        # FileHashes` will only be populated if `BuildOptions` has requested a `
+        # SourceProvenanceHash`. The keys to this map are file paths used as build
+        # source and the values contain the hash values for those files. If the build
+        # source came in a single package such as a gzipped tarfile (`.tar.gz`), the `
+        # FileHash` will be for the single path to that file.
         # Corresponds to the JSON property `fileHashes`
         # @return [Hash<String,Google::Apis::CloudbuildV1::FileHashes>]
         attr_accessor :file_hashes
@@ -1595,12 +1625,12 @@ module Google
         end
       end
       
-      # The `Status` type defines a logical error model that is suitable for
-      # different programming environments, including REST APIs and RPC APIs. It is
-      # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-      # three pieces of data: error code, error message, and error details.
-      # You can find out more about this error model and how to work with it in the
-      # [API Design Guide](https://cloud.google.com/apis/design/errors).
+      # The `Status` type defines a logical error model that is suitable for different
+      # programming environments, including REST APIs and RPC APIs. It is used by [
+      # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+      # data: error code, error message, and error details. You can find out more
+      # about this error model and how to work with it in the [API Design Guide](https:
+      # //cloud.google.com/apis/design/errors).
       class Status
         include Google::Apis::Core::Hashable
       
@@ -1609,15 +1639,15 @@ module Google
         # @return [Fixnum]
         attr_accessor :code
       
-        # A list of messages that carry the error details.  There is a common set of
+        # A list of messages that carry the error details. There is a common set of
         # message types for APIs to use.
         # Corresponds to the JSON property `details`
         # @return [Array<Hash<String,Object>>]
         attr_accessor :details
       
-        # A developer-facing error message, which should be in English. Any
-        # user-facing error message should be localized and sent in the
-        # google.rpc.Status.details field, or localized by the client.
+        # A developer-facing error message, which should be in English. Any user-facing
+        # error message should be localized and sent in the google.rpc.Status.details
+        # field, or localized by the client.
         # Corresponds to the JSON property `message`
         # @return [String]
         attr_accessor :message
@@ -1638,23 +1668,21 @@ module Google
       class StorageSource
         include Google::Apis::Core::Hashable
       
-        # Google Cloud Storage bucket containing the source (see
-        # [Bucket Name
+        # Google Cloud Storage bucket containing the source (see [Bucket Name
         # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)
         # ).
         # Corresponds to the JSON property `bucket`
         # @return [String]
         attr_accessor :bucket
       
-        # Google Cloud Storage generation for the object. If the generation is
-        # omitted, the latest generation will be used.
+        # Google Cloud Storage generation for the object. If the generation is omitted,
+        # the latest generation will be used.
         # Corresponds to the JSON property `generation`
         # @return [Fixnum]
         attr_accessor :generation
       
-        # Google Cloud Storage object containing the source.
-        # This object must be a gzipped archive file (`.tar.gz`) containing source to
-        # build.
+        # Google Cloud Storage object containing the source. This object must be a
+        # gzipped archive file (`.tar.gz`) containing source to build.
         # Corresponds to the JSON property `object`
         # @return [String]
         attr_accessor :object
@@ -1701,16 +1729,16 @@ module Google
       class Volume
         include Google::Apis::Core::Hashable
       
-        # Name of the volume to mount.
-        # Volume names must be unique per build step and must be valid names for
-        # Docker volumes. Each named volume must be used by at least two build steps.
+        # Name of the volume to mount. Volume names must be unique per build step and
+        # must be valid names for Docker volumes. Each named volume must be used by at
+        # least two build steps.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Path at which to mount the volume.
-        # Paths must be absolute and cannot conflict with other volume paths on the
-        # same build step or with certain reserved volume paths.
+        # Path at which to mount the volume. Paths must be absolute and cannot conflict
+        # with other volume paths on the same build step or with certain reserved volume
+        # paths.
         # Corresponds to the JSON property `path`
         # @return [String]
         attr_accessor :path