google-api-client 0.19.8 → 0.20.0

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

@@ -20,7 +20,7 @@ require 'google/apis/errors'
 module Google
   module Apis
     module CloudbillingV1
-      # Google Cloud Billing API
+      # Cloud Billing API
       #
       # Allows developers to manage billing for their Google Cloud Platform projects
       #  programmatically.
@@ -48,9 +48,47 @@ 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).
+        # 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 is currently in
+        # > [Beta](https://cloud.google.com/terms/launch-stages).
+        # @param [Google::Apis::CloudbillingV1::BillingAccount] billing_account_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudbillingV1::BillingAccount] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudbillingV1::BillingAccount]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def create_billing_account(billing_account_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/billingAccounts', options)
+          command.request_representation = Google::Apis::CloudbillingV1::BillingAccount::Representation
+          command.request_object = billing_account_object
+          command.response_representation = Google::Apis::CloudbillingV1::BillingAccount::Representation
+          command.response_class = Google::Apis::CloudbillingV1::BillingAccount
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Gets information about a billing account. The current authenticated user
-        # must be an [owner of the billing
-        # account](https://support.google.com/cloud/answer/4430947).
+        # must be a [viewer of the billing
+        # account](https://cloud.google.com/billing/docs/how-to/billing-access).
         # @param [String] name
         #   The resource name of the billing account to retrieve. For example,
         #   `billingAccounts/012345-567890-ABCDEF`.
@@ -81,8 +119,54 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the billing accounts that the current authenticated user
-        # [owns](https://support.google.com/cloud/answer/4430947).
+        # 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).
+        # > This method is currently in
+        # > [Beta](https://cloud.google.com/terms/launch-stages).
+        # @param [String] resource
+        #   REQUIRED: The resource for which the policy is being requested.
+        #   See the operation documentation for the appropriate value for this field.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudbillingV1::Policy] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudbillingV1::Policy]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_billing_account_iam_policy(resource, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1/{+resource}:getIamPolicy', options)
+          command.response_representation = Google::Apis::CloudbillingV1::Policy::Representation
+          command.response_class = Google::Apis::CloudbillingV1::Policy
+          command.params['resource'] = resource unless resource.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          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).
+        # @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.
+        #   > This field is currently in
+        #   > [Beta](https://cloud.google.com/terms/launch-stages).
         # @param [Fixnum] page_size
         #   Requested page size. The maximum page size is 100; this is also the
         #   default.
@@ -107,10 +191,11 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_billing_accounts(page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def list_billing_accounts(filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
           command =  make_simple_command(:get, 'v1/billingAccounts', options)
           command.response_representation = Google::Apis::CloudbillingV1::ListBillingAccountsResponse::Representation
           command.response_class = Google::Apis::CloudbillingV1::ListBillingAccountsResponse
+          command.query['filter'] = filter unless filter.nil?
           command.query['pageSize'] = page_size unless page_size.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
           command.query['fields'] = fields unless fields.nil?
@@ -118,10 +203,132 @@ 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.
+        # > This method is currently in
+        # > [Beta](https://cloud.google.com/terms/launch-stages).
+        # @param [String] name
+        #   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.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudbillingV1::BillingAccount] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudbillingV1::BillingAccount]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def patch_billing_account(name, billing_account_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:patch, 'v1/{+name}', options)
+          command.request_representation = Google::Apis::CloudbillingV1::BillingAccount::Representation
+          command.request_object = billing_account_object
+          command.response_representation = Google::Apis::CloudbillingV1::BillingAccount::Representation
+          command.response_class = Google::Apis::CloudbillingV1::BillingAccount
+          command.params['name'] = name unless name.nil?
+          command.query['updateMask'] = update_mask unless update_mask.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        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).
+        # > This method is currently in
+        # > [Beta](https://cloud.google.com/terms/launch-stages).
+        # @param [String] resource
+        #   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.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudbillingV1::Policy] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudbillingV1::Policy]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def set_billing_account_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/{+resource}:setIamPolicy', options)
+          command.request_representation = Google::Apis::CloudbillingV1::SetIamPolicyRequest::Representation
+          command.request_object = set_iam_policy_request_object
+          command.response_representation = Google::Apis::CloudbillingV1::Policy::Representation
+          command.response_class = Google::Apis::CloudbillingV1::Policy
+          command.params['resource'] = resource unless resource.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          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.
+        # > This method is currently in
+        # > [Beta](https://cloud.google.com/terms/launch-stages).
+        # @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.
+        # @param [Google::Apis::CloudbillingV1::TestIamPermissionsRequest] test_iam_permissions_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudbillingV1::TestIamPermissionsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudbillingV1::TestIamPermissionsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def test_billing_account_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/{+resource}:testIamPermissions', options)
+          command.request_representation = Google::Apis::CloudbillingV1::TestIamPermissionsRequest::Representation
+          command.request_object = test_iam_permissions_request_object
+          command.response_representation = Google::Apis::CloudbillingV1::TestIamPermissionsResponse::Representation
+          command.response_class = Google::Apis::CloudbillingV1::TestIamPermissionsResponse
+          command.params['resource'] = resource unless resource.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Lists the projects associated with a billing account. The current
-        # authenticated user must have the "billing.resourceAssociations.list" IAM
+        # authenticated user must have the `billing.resourceAssociations.list` IAM
         # permission, which is often given to billing account
-        # [viewers](https://support.google.com/cloud/answer/4430947).
+        # [viewers](https://cloud.google.com/billing/docs/how-to/billing-access).
         # @param [String] name
         #   The resource name of the billing account associated with the projects that
         #   you want to list. For example, `billingAccounts/012345-567890-ABCDEF`.
@@ -203,13 +410,13 @@ module Google
         # 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 Google Cloud Console may be billed to the new billing
+        # 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://support.google.com/cloud/answer/4430947).
+        # 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

data/generated/google/apis/cloudbuild_v1.rb

@@ -18,14 +18,14 @@ require 'google/apis/cloudbuild_v1/representations.rb'
 
 module Google
   module Apis
-    # Google Cloud Container Builder API
+    # Cloud Container Builder API
     #
     # Builds container images in the cloud.
     #
     # @see https://cloud.google.com/container-builder/docs/
     module CloudbuildV1
       VERSION = 'V1'
-      REVISION = '20180205'
+      REVISION = '20180327'
 
       # 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,11 +22,74 @@ module Google
   module Apis
     module CloudbuildV1
       
+      # 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.
+        # Corresponds to the JSON property `location`
+        # @return [String]
+        attr_accessor :location
+      
+        # Path globs used to match files in the build's workspace.
+        # Corresponds to the JSON property `paths`
+        # @return [Array<String>]
+        attr_accessor :paths
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @location = args[:location] if args.key?(:location)
+          @paths = args[:paths] if args.key?(:paths)
+        end
+      end
+      
+      # 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.
+        # 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.
+        # Corresponds to the JSON property `objects`
+        # @return [Google::Apis::CloudbuildV1::ArtifactObjects]
+        attr_accessor :objects
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @images = args[:images] if args.key?(:images)
+          @objects = args[:objects] if args.key?(:objects)
+        end
+      end
+      
       # A build resource in the Container Builder 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 what tag to
-      # apply to the built image when it is pushed to Google Container Registry.
-      # Fields can include the following variables which will be expanded when the
+      # 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.
@@ -39,7 +102,13 @@ module Google
       class Build
         include Google::Apis::Core::Hashable
       
-        # The ID of the BuildTrigger that triggered this build, if it was
+        # 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
+      
+        # The ID of the `BuildTrigger` that triggered this build, if it was
         # triggered automatically.
         # @OutputOnly
         # Corresponds to the JSON property `buildTriggerId`
@@ -68,10 +137,11 @@ module Google
       
         # 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
+        # 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 is marked FAILURE.
+        # 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
@@ -102,18 +172,17 @@ module Google
         # @return [String]
         attr_accessor :project_id
       
-        # Results describes the artifacts created by the build pipeline.
+        # Artifacts created by the build pipeline.
         # Corresponds to the JSON property `results`
         # @return [Google::Apis::CloudbuildV1::Results]
         attr_accessor :results
       
-        # Secrets to decrypt using Cloud KMS.
+        # Secrets to decrypt using Cloud Key Management Service.
         # Corresponds to the JSON property `secrets`
         # @return [Array<Google::Apis::CloudbuildV1::Secret>]
         attr_accessor :secrets
       
-        # Source describes the location of the source in a supported storage
-        # service.
+        # Location of the source in a supported storage service.
         # Corresponds to the JSON property `source`
         # @return [Google::Apis::CloudbuildV1::Source]
         attr_accessor :source
@@ -142,24 +211,24 @@ module Google
         # @return [String]
         attr_accessor :status_detail
       
-        # Describes the operations to be performed on the workspace.
+        # Required. The operations to be performed on the workspace.
         # Corresponds to the JSON property `steps`
         # @return [Array<Google::Apis::CloudbuildV1::BuildStep>]
         attr_accessor :steps
       
-        # Substitutions data for Build resource.
+        # Substitutions data for `Build` resource.
         # Corresponds to the JSON property `substitutions`
         # @return [Hash<String,String>]
         attr_accessor :substitutions
       
-        # Tags for annotation of a Build. These are not docker tags.
+        # Tags for annotation of a `Build`. These are not docker tags.
         # Corresponds to the JSON property `tags`
         # @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.
+        # and the build status will be `TIMEOUT`.
         # Default time is ten minutes.
         # Corresponds to the JSON property `timeout`
         # @return [String]
@@ -169,7 +238,7 @@ module Google
         # * 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 does not specify images,
+        # If the build does not specify source or images,
         # these keys will not be included.
         # @OutputOnly
         # Corresponds to the JSON property `timing`
@@ -182,6 +251,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @artifacts = args[:artifacts] if args.key?(:artifacts)
           @build_trigger_id = args[:build_trigger_id] if args.key?(:build_trigger_id)
           @create_time = args[:create_time] if args.key?(:create_time)
           @finish_time = args[:finish_time] if args.key?(:finish_time)
@@ -211,10 +281,10 @@ module Google
         include Google::Apis::Core::Hashable
       
         # A build resource in the Container Builder 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 what tag to
-        # apply to the built image when it is pushed to Google Container Registry.
-        # Fields can include the following variables which will be expanded when the
+        # 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.
@@ -252,7 +322,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :disk_size_gb
       
-        # LogStreamingOption to define build log streaming behavior to Google Cloud
+        # Option to define build log streaming behavior to Google Cloud
         # Storage.
         # Corresponds to the JSON property `logStreamingOption`
         # @return [String]
@@ -273,7 +343,8 @@ module Google
         # @return [Array<String>]
         attr_accessor :source_provenance_hash
       
-        # SubstitutionOption to allow unmatch substitutions.
+        # Option to specify behavior when there is an error in the substitution
+        # checks.
         # Corresponds to the JSON property `substitutionOption`
         # @return [String]
         attr_accessor :substitution_option
@@ -293,14 +364,14 @@ module Google
         end
       end
       
-      # BuildStep describes a step to perform in the build pipeline.
+      # A step in the build pipeline.
       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, these args
-        # will be used as arguments to that entrypoint. If the image does not define
-        # an entrypoint, the first element in args will be used as the entrypoint,
+        # 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>]
@@ -310,16 +381,16 @@ module Google
         # 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.
+        # 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
       
-        # Optional entrypoint to be used instead of the build step image's default
-        # If unset, the image's default will be 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
@@ -331,14 +402,15 @@ module Google
         # @return [Array<String>]
         attr_accessor :env
       
-        # Optional unique identifier for this build step, used in wait_for to
+        # 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
       
-        # The name of the container image that will run this particular build step.
-        # If the image is already available in the host's Docker daemon's cache, it
+        # 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
@@ -355,13 +427,29 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # A list of environment variables which are encrypted using a Cloud KMS
-        # crypto key. These values must be specified in the build's secrets.
+        # 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`.
         # Corresponds to the JSON property `secretEnv`
         # @return [Array<String>]
         attr_accessor :secret_env
       
-        # Stores start and end times for a build execution phase.
+        # 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.
+        # @OutputOnly
+        # 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.
+        # Corresponds to the JSON property `timeout`
+        # @return [String]
+        attr_accessor :timeout
+      
+        # Start and end times for a build execution phase.
         # Corresponds to the JSON property `timing`
         # @return [Google::Apis::CloudbuildV1::TimeSpan]
         attr_accessor :timing
@@ -377,10 +465,10 @@ module Google
         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.
+        # 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
@@ -398,6 +486,8 @@ module Google
           @id = args[:id] if args.key?(:id)
           @name = args[:name] if args.key?(:name)
           @secret_env = args[:secret_env] if args.key?(:secret_env)
+          @status = args[:status] if args.key?(:status)
+          @timeout = args[:timeout] if args.key?(:timeout)
           @timing = args[:timing] if args.key?(:timing)
           @volumes = args[:volumes] if args.key?(:volumes)
           @wait_for = args[:wait_for] if args.key?(:wait_for)
@@ -410,10 +500,10 @@ module Google
         include Google::Apis::Core::Hashable
       
         # A build resource in the Container Builder 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 what tag to
-        # apply to the built image when it is pushed to Google Container Registry.
-        # Fields can include the following variables which will be expanded when the
+        # 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.
@@ -461,8 +551,7 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :substitutions
       
-        # RepoSource describes the location of the source in a Google Cloud Source
-        # Repository.
+        # Location of the source in a Google Cloud Source Repository.
         # Corresponds to the JSON property `triggerTemplate`
         # @return [Google::Apis::CloudbuildV1::RepoSource]
         attr_accessor :trigger_template
@@ -484,7 +573,7 @@ module Google
         end
       end
       
-      # BuiltImage describes an image built by the pipeline.
+      # An image built by the pipeline.
       class BuiltImage
         include Google::Apis::Core::Hashable
       
@@ -499,7 +588,7 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # Stores start and end times for a build execution phase.
+        # Start and end times for a build execution phase.
         # Corresponds to the JSON property `pushTiming`
         # @return [Google::Apis::CloudbuildV1::TimeSpan]
         attr_accessor :push_timing
@@ -607,11 +696,11 @@ module Google
         end
       end
       
-      # Response containing existing BuildTriggers.
+      # Response containing existing `BuildTriggers`.
       class ListBuildTriggersResponse
         include Google::Apis::Core::Hashable
       
-        # BuildTriggers for the project, sorted by create_time descending.
+        # `BuildTriggers` for the project, sorted by `create_time` descending.
         # Corresponds to the JSON property `triggers`
         # @return [Array<Google::Apis::CloudbuildV1::BuildTrigger>]
         attr_accessor :triggers
@@ -630,7 +719,7 @@ module Google
       class ListBuildsResponse
         include Google::Apis::Core::Hashable
       
-        # Builds will be sorted by create_time, descending.
+        # Builds will be sorted by `create_time`, descending.
         # Corresponds to the JSON property `builds`
         # @return [Array<Google::Apis::CloudbuildV1::Build>]
         attr_accessor :builds
@@ -773,8 +862,7 @@ module Google
         end
       end
       
-      # RepoSource describes the location of the source in a Google Cloud Source
-      # Repository.
+      # Location of the source in a Google Cloud Source Repository.
       class RepoSource
         include Google::Apis::Core::Hashable
       
@@ -789,19 +877,20 @@ module Google
         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
+        # 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
       
-        # ID of the project that owns the repo. If omitted, the project ID requesting
-        # the build is assumed.
+        # ID of the project that owns the Cloud Source Repository. If omitted, the
+        # project ID requesting the build is assumed.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id
       
-        # Name of the repo. If omitted, the name "default" is assumed.
+        # Name of the Cloud Source Repository. If omitted, the name "default" is
+        # assumed.
         # Corresponds to the JSON property `repoName`
         # @return [String]
         attr_accessor :repo_name
@@ -826,32 +915,45 @@ module Google
         end
       end
       
-      # Results describes the artifacts created by the build pipeline.
+      # Artifacts created by the build pipeline.
       class Results
         include Google::Apis::Core::Hashable
       
-        # List of build step digests, in order corresponding to build step indices.
+        # Path to the artifact manifest. Only populated when artifacts are uploaded.
+        # Corresponds to the JSON property `artifactManifest`
+        # @return [String]
+        attr_accessor :artifact_manifest
+      
+        # 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
       
-        # Images that were built as a part of the build.
+        # Container images that were built as a part of the build.
         # Corresponds to the JSON property `images`
         # @return [Array<Google::Apis::CloudbuildV1::BuiltImage>]
         attr_accessor :images
       
+        # Number of artifacts uploaded. Only populated when artifacts are uploaded.
+        # Corresponds to the JSON property `numArtifacts`
+        # @return [Fixnum]
+        attr_accessor :num_artifacts
+      
         def initialize(**args)
            update!(**args)
         end
       
         # Update properties of this object
         def update!(**args)
+          @artifact_manifest = args[:artifact_manifest] if args.key?(:artifact_manifest)
           @build_step_images = args[:build_step_images] if args.key?(:build_step_images)
           @images = args[:images] if args.key?(:images)
+          @num_artifacts = args[:num_artifacts] if args.key?(:num_artifacts)
         end
       end
       
-      # RetryBuildRequest specifies a build to retry.
+      # Specifies a build to retry.
       class RetryBuildRequest
         include Google::Apis::Core::Hashable
       
@@ -864,7 +966,7 @@ module Google
         end
       end
       
-      # Secret pairs a set of secret environment variables containing encrypted
+      # 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
@@ -894,19 +996,16 @@ module Google
         end
       end
       
-      # Source describes the location of the source in a supported storage
-      # service.
+      # Location of the source in a supported storage service.
       class Source
         include Google::Apis::Core::Hashable
       
-        # RepoSource describes the location of the source in a Google Cloud Source
-        # Repository.
+        # Location of the source in a Google Cloud Source Repository.
         # Corresponds to the JSON property `repoSource`
         # @return [Google::Apis::CloudbuildV1::RepoSource]
         attr_accessor :repo_source
       
-        # StorageSource describes the location of the source in an archive file in
-        # Google Cloud Storage.
+        # Location of the source in an archive file in Google Cloud Storage.
         # Corresponds to the JSON property `storageSource`
         # @return [Google::Apis::CloudbuildV1::StorageSource]
         attr_accessor :storage_source
@@ -928,25 +1027,23 @@ module Google
         include Google::Apis::Core::Hashable
       
         # 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.
+        # 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.
+        # (`.tar.gz`), the `FileHash` will be for the single path to that file.
         # @OutputOnly
         # Corresponds to the JSON property `fileHashes`
         # @return [Hash<String,Google::Apis::CloudbuildV1::FileHashes>]
         attr_accessor :file_hashes
       
-        # RepoSource describes the location of the source in a Google Cloud Source
-        # Repository.
+        # Location of the source in a Google Cloud Source Repository.
         # Corresponds to the JSON property `resolvedRepoSource`
         # @return [Google::Apis::CloudbuildV1::RepoSource]
         attr_accessor :resolved_repo_source
       
-        # StorageSource describes the location of the source in an archive file in
-        # Google Cloud Storage.
+        # Location of the source in an archive file in Google Cloud Storage.
         # Corresponds to the JSON property `resolvedStorageSource`
         # @return [Google::Apis::CloudbuildV1::StorageSource]
         attr_accessor :resolved_storage_source
@@ -1035,12 +1132,11 @@ module Google
         end
       end
       
-      # StorageSource describes the location of the source in an archive file in
-      # Google Cloud Storage.
+      # Location of the source in an archive file in Google Cloud Storage.
       class StorageSource
         include Google::Apis::Core::Hashable
       
-        # Google Cloud Storage bucket containing source (see
+        # Google Cloud Storage bucket containing the source (see
         # [Bucket Name
         # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)
         # ).
@@ -1054,8 +1150,8 @@ module Google
         # @return [Fixnum]
         attr_accessor :generation
       
-        # Google Cloud Storage object containing source.
-        # This object must be a gzipped archive file (.tar.gz) containing source to
+        # 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]
@@ -1073,7 +1169,7 @@ module Google
         end
       end
       
-      # Stores start and end times for a build execution phase.
+      # Start and end times for a build execution phase.
       class TimeSpan
         include Google::Apis::Core::Hashable