google-api-client 0.39.4 → 0.41.0

data/generated/google/apis/cloudasset_v1p1beta1/representations.rb

@@ -189,8 +189,10 @@ module Google
           property :asset_type, as: 'assetType'
           property :description, as: 'description'
           property :display_name, as: 'displayName'
+          hash :labels, as: 'labels'
           property :location, as: 'location'
           property :name, as: 'name'
+          collection :network_tags, as: 'networkTags'
           property :project, as: 'project'
         end
       end

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

@@ -47,12 +47,12 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Searches all the IAM policies under a given accessible CRM scope
-        # (project/folder/organization). This RPC gives callers
-        # especially admins the ability to search all the IAM policies under a scope,
-        # even if they don't have .getIamPolicy permission of all the IAM policies.
-        # Callers should have cloud.assets.SearchAllIamPolicies permission on the
-        # requested scope, otherwise it will be rejected.
+        # Searches all the IAM policies within a given accessible CRM scope
+        # (project/folder/organization). This RPC gives callers especially
+        # administrators the ability to search all the IAM policies within a scope,
+        # even if they don't have `.getIamPolicy` permission of all the IAM policies.
+        # Callers should have `cloud.assets.SearchAllIamPolicies` permission on the
+        # requested scope, otherwise the request will be rejected.
         # @param [String] scope
         #   Required. The relative name of an asset. The search is limited to the
         #   resources
@@ -74,8 +74,7 @@ module Google
         #   previous response. The values of all other method parameters must be
         #   identical to those in the previous call.
         # @param [String] query
-        #   Optional. The query statement.
-        #   Examples:
+        #   Optional. The query statement. Examples:
         #   * "policy:myuser@mydomain.com"
         #   * "policy:(myuser@mydomain.com viewer)"
         # @param [String] fields
@@ -108,12 +107,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Searches all the resources under a given accessible CRM scope
-        # (project/folder/organization). This RPC gives callers
-        # especially admins the ability to search all the resources under a scope,
-        # even if they don't have .get permission of all the resources. Callers
-        # should have cloud.assets.SearchAllResources permission on the requested
-        # scope, otherwise it will be rejected.
+        # Searches all the resources within a given accessible CRM scope
+        # (project/folder/organization). This RPC gives callers especially
+        # administrators the ability to search all the resources within a scope, even
+        # if they don't have `.get` permission of all the resources. Callers should
+        # have `cloud.assets.SearchAllResources` permission on the requested scope,
+        # otherwise the request will be rejected.
         # @param [String] scope
         #   Required. The relative name of an asset. The search is limited to the
         #   resources
@@ -128,9 +127,9 @@ module Google
         #   search all the supported asset types.
         # @param [String] order_by
         #   Optional. A comma separated list of fields specifying the sorting order of the
-        #   results. The default order is ascending. Add " desc" after the field name
+        #   results. The default order is ascending. Add ` DESC` after the field name
         #   to indicate descending order. Redundant space characters are ignored. For
-        #   example, "  foo ,  bar  desc  ".
+        #   example, `  location DESC ,  name  `.
         # @param [Fixnum] page_size
         #   Optional. The page size for search result pagination. Page size is capped at
         #   500 even

data/generated/google/apis/cloudasset_v1p4beta1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/asset-inventory/docs/quickstart
     module CloudassetV1p4beta1
       VERSION = 'V1p4beta1'
-      REVISION = '20200403'
+      REVISION = '20200613'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -294,12 +294,12 @@ module Google
         end
       end
       
-      # A role or permission that appears in an access control list.
+      # An IAM role or permission under analysis.
       class GoogleCloudAssetV1p4beta1Access
         include Google::Apis::Core::Hashable
       
-        # Represents analysis state of each node in the result graph or non-critical
-        # errors in the response.
+        # Represents the detailed state of an entity under analysis, such as a
+        # resource, an identity or an access.
         # Corresponds to the JSON property `analysisState`
         # @return [Google::Apis::CloudassetV1p4beta1::GoogleCloudAssetV1p4beta1AnalysisState]
         attr_accessor :analysis_state
@@ -376,8 +376,8 @@ module Google
         end
       end
       
-      # Represents analysis state of each node in the result graph or non-critical
-      # errors in the response.
+      # Represents the detailed state of an entity under analysis, such as a
+      # resource, an identity or an access.
       class GoogleCloudAssetV1p4beta1AnalysisState
         include Google::Apis::Core::Hashable
       
@@ -388,9 +388,10 @@ module Google
       
         # The Google standard error code that best describes the state.
         # For example:
-        # - OK means the node has been successfully explored;
+        # - OK means the analysis on this entity has been successfully finished;
         # - PERMISSION_DENIED means an access denied error is encountered;
-        # - DEADLINE_EXCEEDED means the node hasn't been explored in time;
+        # - DEADLINE_EXCEEDED means the analysis on this entity hasn't been started
+        # in time;
         # Corresponds to the JSON property `code`
         # @return [String]
         attr_accessor :code
@@ -431,12 +432,12 @@ module Google
         end
       end
       
-      # An identity that appears in an access control list.
+      # An identity under analysis.
       class GoogleCloudAssetV1p4beta1Identity
         include Google::Apis::Core::Hashable
       
-        # Represents analysis state of each node in the result graph or non-critical
-        # errors in the response.
+        # Represents the detailed state of an entity under analysis, such as a
+        # resource, an identity or an access.
         # Corresponds to the JSON property `analysisState`
         # @return [Google::Apis::CloudassetV1p4beta1::GoogleCloudAssetV1p4beta1AnalysisState]
         attr_accessor :analysis_state
@@ -501,17 +502,18 @@ module Google
         end
       end
       
-      # A GCP resource that appears in an access control list.
+      # A Google Cloud resource under analysis.
       class GoogleCloudAssetV1p4beta1Resource
         include Google::Apis::Core::Hashable
       
-        # Represents analysis state of each node in the result graph or non-critical
-        # errors in the response.
+        # Represents the detailed state of an entity under analysis, such as a
+        # resource, an identity or an access.
         # Corresponds to the JSON property `analysisState`
         # @return [Google::Apis::CloudassetV1p4beta1::GoogleCloudAssetV1p4beta1AnalysisState]
         attr_accessor :analysis_state
       
-        # The [full resource name](https://aip.dev/122#full-resource-names).
+        # The [full resource
+        # name](https://cloud.google.com/asset-inventory/docs/resource-name-format)
         # Corresponds to the JSON property `fullResourceName`
         # @return [String]
         attr_accessor :full_resource_name
@@ -603,14 +605,19 @@ module Google
         # within
         # the parent will be analyzed. This can only be an organization number (such
         # as "organizations/123") or a folder number (such as "folders/123").
+        # To know how to get organization id, visit [here
+        # ](https://cloud.google.com/resource-manager/docs/creating-managing-
+        # organization#retrieving_your_organization_id).
+        # To know how to get folder id, visit [here
+        # ](https://cloud.google.com/resource-manager/docs/creating-managing-folders#
+        # viewing_or_listing_folders_and_projects).
         # Corresponds to the JSON property `parent`
         # @return [String]
         attr_accessor :parent
       
         # Specifies the resource to analyze for access policies, which may be set
         # directly on the resource, or on ancestors such as organizations, folders or
-        # projects. At least one of ResourceSelector, IdentitySelector or
-        # AccessSelector must be specified in a request.
+        # projects.
         # Corresponds to the JSON property `resourceSelector`
         # @return [Google::Apis::CloudassetV1p4beta1::ResourceSelector]
         attr_accessor :resource_selector
@@ -639,13 +646,15 @@ module Google
         # @return [Array<Google::Apis::CloudassetV1p4beta1::GoogleCloudAssetV1p4beta1AccessControlList>]
         attr_accessor :access_control_lists
       
-        # The full name of the resource to which the iam_binding policy attaches.
+        # The [full resource
+        # name](https://cloud.google.com/asset-inventory/docs/resource-name-format)
+        # of the resource to which the iam_binding policy attaches.
         # Corresponds to the JSON property `attachedResourceFullName`
         # @return [String]
         attr_accessor :attached_resource_full_name
       
-        # Represents whether all nodes in the transitive closure of the
-        # iam_binding node have been explored.
+        # Represents whether all analyses on the iam_binding have successfully
+        # finished.
         # Corresponds to the JSON property `fullyExplored`
         # @return [Boolean]
         attr_accessor :fully_explored
@@ -685,6 +694,13 @@ module Google
         # Required. The identity appear in the form of members in
         # [IAM policy
         # binding](https://cloud.google.com/iam/reference/rest/v1/Binding).
+        # The examples of supported forms are:
+        # "user:mike@example.com",
+        # "group:admins@example.com",
+        # "domain:google.com",
+        # "serviceAccount:my-project-id@appspot.gserviceaccount.com".
+        # Notice that wildcard characters (such as * and ?) are not supported.
+        # You must give a specific identity.
         # Corresponds to the JSON property `identity`
         # @return [String]
         attr_accessor :identity
@@ -859,14 +875,15 @@ module Google
       
       # Specifies the resource to analyze for access policies, which may be set
       # directly on the resource, or on ancestors such as organizations, folders or
-      # projects. At least one of ResourceSelector, IdentitySelector or
-      # AccessSelector must be specified in a request.
+      # projects.
       class ResourceSelector
         include Google::Apis::Core::Hashable
       
         # Required. The [full resource
-        # name](https://cloud.google.com/apis/design/resource_names#full_resource_name)
-        # .
+        # name](https://cloud.google.com/asset-inventory/docs/resource-name-format)
+        # of a resource of [supported resource
+        # types](https://cloud.google.com/asset-inventory/docs/supported-asset-types#
+        # analyzable_asset_types).
         # Corresponds to the JSON property `fullResourceName`
         # @return [String]
         attr_accessor :full_resource_name

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

@@ -47,13 +47,19 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Analyzes IAM policies based on the specified request. Returns
-        # a list of IamPolicyAnalysisResult matching the request.
+        # Analyzes IAM policies to answer which identities have what accesses on
+        # which resources.
         # @param [String] parent
         #   Required. The relative name of the root asset. Only resources and IAM policies
         #   within
         #   the parent will be analyzed. This can only be an organization number (such
         #   as "organizations/123") or a folder number (such as "folders/123").
+        #   To know how to get organization id, visit [here
+        #   ](https://cloud.google.com/resource-manager/docs/creating-managing-
+        #   organization#retrieving_your_organization_id).
+        #   To know how to get folder id, visit [here
+        #   ](https://cloud.google.com/resource-manager/docs/creating-managing-folders#
+        #   viewing_or_listing_folders_and_projects).
         # @param [Array<String>, String] analysis_query_access_selector_permissions
         #   Optional. The permissions to appear in result.
         # @param [Array<String>, String] analysis_query_access_selector_roles
@@ -62,16 +68,25 @@ module Google
         #   Required. The identity appear in the form of members in
         #   [IAM policy
         #   binding](https://cloud.google.com/iam/reference/rest/v1/Binding).
+        #   The examples of supported forms are:
+        #   "user:mike@example.com",
+        #   "group:admins@example.com",
+        #   "domain:google.com",
+        #   "serviceAccount:my-project-id@appspot.gserviceaccount.com".
+        #   Notice that wildcard characters (such as * and ?) are not supported.
+        #   You must give a specific identity.
         # @param [String] analysis_query_resource_selector_full_resource_name
         #   Required. The [full resource
-        #   name](https://cloud.google.com/apis/design/resource_names#full_resource_name)
-        #   .
+        #   name](https://cloud.google.com/asset-inventory/docs/resource-name-format)
+        #   of a resource of [supported resource
+        #   types](https://cloud.google.com/asset-inventory/docs/supported-asset-types#
+        #   analyzable_asset_types).
         # @param [Boolean] options_analyze_service_account_impersonation
         #   Optional. If true, the response will include access analysis from identities
         #   to
         #   resources via service account impersonation. This is a very expensive
         #   operation, because many derived queries will be executed. We highly
-        #   recommend you use ExportIamPolicyAnalysis rpc instead.
+        #   recommend you use AssetService.ExportIamPolicyAnalysis rpc instead.
         #   For example, if the request analyzes for which resources user A has
         #   permission P, and there's an IAM policy states user A has
         #   iam.serviceAccounts.getAccessToken permission to a service account SA,
@@ -166,15 +181,25 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Exports IAM policy analysis based on the specified request. This API
-        # implements the google.longrunning.Operation API allowing you to keep
-        # track of the export. The metadata contains the request to help callers to
-        # map responses to requests.
+        # Exports the answers of which identities have what accesses on which
+        # resources to a Google Cloud Storage destination. The output format is
+        # the JSON format that represents a AnalyzeIamPolicyResponse
+        # in the JSON format.
+        # This method implements the google.longrunning.Operation, which allows
+        # you to keep track of the export. We recommend intervals of at least 2
+        # seconds with exponential retry to poll the export operation result. The
+        # metadata contains the request to help callers to map responses to requests.
         # @param [String] parent
         #   Required. The relative name of the root asset. Only resources and IAM policies
         #   within
         #   the parent will be analyzed. This can only be an organization number (such
         #   as "organizations/123") or a folder number (such as "folders/123").
+        #   To know how to get organization id, visit [here
+        #   ](https://cloud.google.com/resource-manager/docs/creating-managing-
+        #   organization#retrieving_your_organization_id).
+        #   To know how to get folder id, visit [here
+        #   ](https://cloud.google.com/resource-manager/docs/creating-managing-folders#
+        #   viewing_or_listing_folders_and_projects).
         # @param [Google::Apis::CloudassetV1p4beta1::ExportIamPolicyAnalysisRequest] export_iam_policy_analysis_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

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 = '20200505'
+      REVISION = '20200606'
 
       # 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

@@ -262,6 +262,7 @@ module Google
         # 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]
@@ -356,6 +357,15 @@ module Google
         # @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
+        # overridden in the build configuration file.
+        # Corresponds to the JSON property `dynamicSubstitutions`
+        # @return [Boolean]
+        attr_accessor :dynamic_substitutions
+        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.
@@ -371,8 +381,8 @@ module Google
         # @return [String]
         attr_accessor :log_streaming_option
       
-        # Option to specify the logging mode, which determines where the 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
@@ -402,6 +412,8 @@ module Google
       
         # 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
@@ -431,6 +443,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @disk_size_gb = args[:disk_size_gb] if args.key?(:disk_size_gb)
+          @dynamic_substitutions = args[:dynamic_substitutions] if args.key?(:dynamic_substitutions)
           @env = args[:env] if args.key?(:env)
           @log_streaming_option = args[:log_streaming_option] if args.key?(:log_streaming_option)
           @logging = args[:logging] if args.key?(:logging)
@@ -1029,8 +1042,8 @@ module Google
         # @return [String]
         attr_accessor :branch
       
-        # Configure builds to run only when a repository owner or collaborator
-        # comments `/gcbrun`.
+        # Configure builds to run whether a repository owner or collaborator need to
+        # comment `/gcbrun`.
         # Corresponds to the JSON property `commentControl`
         # @return [String]
         attr_accessor :comment_control

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

@@ -285,6 +285,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :disk_size_gb, :numeric_string => true, as: 'diskSizeGb'
+          property :dynamic_substitutions, as: 'dynamicSubstitutions'
           collection :env, as: 'env'
           property :log_streaming_option, as: 'logStreamingOption'
           property :logging, as: 'logging'

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

@@ -371,6 +371,127 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Starts asynchronous cancellation on a long-running operation.  The server
+        # makes a best effort to cancel the operation, but success is not
+        # guaranteed.  If the server doesn't support this method, it returns
+        # `google.rpc.Code.UNIMPLEMENTED`.  Clients can use
+        # Operations.GetOperation or
+        # other methods to check whether the cancellation succeeded or whether the
+        # operation completed despite cancellation. On successful cancellation,
+        # the operation is not deleted; instead, it becomes an operation with
+        # an Operation.error value with a google.rpc.Status.code of 1,
+        # corresponding to `Code.CANCELLED`.
+        # @param [String] name
+        #   The name of the operation resource to be cancelled.
+        # @param [Google::Apis::CloudbuildV1::CancelOperationRequest] cancel_operation_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::CloudbuildV1::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudbuildV1::Empty]
+        #
+        # @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 cancel_project_location_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:cancel', options)
+          command.request_representation = Google::Apis::CloudbuildV1::CancelOperationRequest::Representation
+          command.request_object = cancel_operation_request_object
+          command.response_representation = Google::Apis::CloudbuildV1::Empty::Representation
+          command.response_class = Google::Apis::CloudbuildV1::Empty
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets the latest state of a long-running operation.  Clients can use this
+        # method to poll the operation result at intervals as recommended by the API
+        # service.
+        # @param [String] name
+        #   The name of the operation resource.
+        # @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::CloudbuildV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudbuildV1::Operation]
+        #
+        # @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_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::CloudbuildV1::Operation::Representation
+          command.response_class = Google::Apis::CloudbuildV1::Operation
+          command.params['name'] = name unless name.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 operations that match the specified filter in the request. If the
+        # server doesn't support this method, it returns `UNIMPLEMENTED`.
+        # NOTE: the `name` binding allows API services to override the binding
+        # to use different resource name schemes, such as `users/*/operations`. To
+        # override the binding, API services can add a binding such as
+        # `"/v1/`name=users/*`/operations"` to their service configuration.
+        # For backwards compatibility, the default name includes the operations
+        # collection id, however overriding users must ensure the name binding
+        # is the parent resource, without the operations collection id.
+        # @param [String] name
+        #   The name of the operation's parent resource.
+        # @param [String] filter
+        #   The standard list filter.
+        # @param [Fixnum] page_size
+        #   The standard list page size.
+        # @param [String] page_token
+        #   The standard list page token.
+        # @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::CloudbuildV1::ListOperationsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudbuildV1::ListOperationsResponse]
+        #
+        # @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_project_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+name}/operations', options)
+          command.response_representation = Google::Apis::CloudbuildV1::ListOperationsResponse::Representation
+          command.response_class = Google::Apis::CloudbuildV1::ListOperationsResponse
+          command.params['name'] = name unless name.nil?
+          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?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Creates a new `BuildTrigger`.
         # This API is experimental.
         # @param [String] project_id
@@ -582,6 +703,48 @@ module Google
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
+        
+        # Starts asynchronous cancellation on a long-running operation.  The server
+        # makes a best effort to cancel the operation, but success is not
+        # guaranteed.  If the server doesn't support this method, it returns
+        # `google.rpc.Code.UNIMPLEMENTED`.  Clients can use
+        # Operations.GetOperation or
+        # other methods to check whether the cancellation succeeded or whether the
+        # operation completed despite cancellation. On successful cancellation,
+        # the operation is not deleted; instead, it becomes an operation with
+        # an Operation.error value with a google.rpc.Status.code of 1,
+        # corresponding to `Code.CANCELLED`.
+        # @param [String] name
+        #   The name of the operation resource to be cancelled.
+        # @param [Google::Apis::CloudbuildV1::CancelOperationRequest] cancel_operation_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::CloudbuildV1::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudbuildV1::Empty]
+        #
+        # @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 cancel_vbeta1_project_location_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'vbeta1/{+name}:cancel', options)
+          command.request_representation = Google::Apis::CloudbuildV1::CancelOperationRequest::Representation
+          command.request_object = cancel_operation_request_object
+          command.response_representation = Google::Apis::CloudbuildV1::Empty::Representation
+          command.response_class = Google::Apis::CloudbuildV1::Empty
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
 
         protected