google-api-client 0.27.2 → 0.27.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (122) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +45 -0
  3. data/generated/google/apis/bigtableadmin_v2.rb +1 -1
  4. data/generated/google/apis/bigtableadmin_v2/classes.rb +45 -0
  5. data/generated/google/apis/bigtableadmin_v2/representations.rb +17 -0
  6. data/generated/google/apis/cloudbuild_v1alpha1.rb +1 -1
  7. data/generated/google/apis/cloudkms_v1.rb +4 -1
  8. data/generated/google/apis/cloudtrace_v2.rb +1 -1
  9. data/generated/google/apis/cloudtrace_v2/classes.rb +2 -2
  10. data/generated/google/apis/compute_alpha.rb +1 -1
  11. data/generated/google/apis/compute_alpha/classes.rb +1198 -13
  12. data/generated/google/apis/compute_alpha/representations.rb +406 -0
  13. data/generated/google/apis/compute_alpha/service.rb +200 -4
  14. data/generated/google/apis/compute_beta.rb +1 -1
  15. data/generated/google/apis/compute_beta/classes.rb +23 -9
  16. data/generated/google/apis/compute_beta/representations.rb +2 -0
  17. data/generated/google/apis/compute_beta/service.rb +41 -4
  18. data/generated/google/apis/compute_v1.rb +1 -1
  19. data/generated/google/apis/compute_v1/classes.rb +65 -6
  20. data/generated/google/apis/compute_v1/representations.rb +19 -0
  21. data/generated/google/apis/compute_v1/service.rb +4 -4
  22. data/generated/google/apis/container_v1.rb +1 -1
  23. data/generated/google/apis/container_v1/classes.rb +145 -0
  24. data/generated/google/apis/container_v1/representations.rb +54 -0
  25. data/generated/google/apis/container_v1/service.rb +69 -0
  26. data/generated/google/apis/container_v1beta1.rb +1 -1
  27. data/generated/google/apis/container_v1beta1/classes.rb +177 -0
  28. data/generated/google/apis/container_v1beta1/representations.rb +70 -0
  29. data/generated/google/apis/container_v1beta1/service.rb +69 -0
  30. data/generated/google/apis/containeranalysis_v1alpha1.rb +35 -0
  31. data/generated/google/apis/containeranalysis_v1alpha1/classes.rb +2780 -0
  32. data/generated/google/apis/containeranalysis_v1alpha1/representations.rb +1106 -0
  33. data/generated/google/apis/containeranalysis_v1alpha1/service.rb +1329 -0
  34. data/generated/google/apis/containeranalysis_v1beta1.rb +35 -0
  35. data/generated/google/apis/containeranalysis_v1beta1/classes.rb +2702 -0
  36. data/generated/google/apis/containeranalysis_v1beta1/representations.rb +1152 -0
  37. data/generated/google/apis/containeranalysis_v1beta1/service.rb +932 -0
  38. data/generated/google/apis/content_v2.rb +1 -1
  39. data/generated/google/apis/content_v2/classes.rb +84 -14
  40. data/generated/google/apis/content_v2/representations.rb +24 -0
  41. data/generated/google/apis/content_v2_1.rb +1 -1
  42. data/generated/google/apis/content_v2_1/classes.rb +70 -11
  43. data/generated/google/apis/content_v2_1/representations.rb +25 -3
  44. data/generated/google/apis/dialogflow_v2.rb +1 -1
  45. data/generated/google/apis/dialogflow_v2/classes.rb +20 -20
  46. data/generated/google/apis/dialogflow_v2/service.rb +6 -6
  47. data/generated/google/apis/dialogflow_v2beta1.rb +1 -1
  48. data/generated/google/apis/dialogflow_v2beta1/classes.rb +20 -20
  49. data/generated/google/apis/dialogflow_v2beta1/service.rb +6 -6
  50. data/generated/google/apis/dns_v1.rb +1 -1
  51. data/generated/google/apis/dns_v1/classes.rb +19 -10
  52. data/generated/google/apis/dns_v1beta2.rb +1 -1
  53. data/generated/google/apis/dns_v1beta2/classes.rb +31 -22
  54. data/generated/google/apis/dns_v2beta1.rb +1 -1
  55. data/generated/google/apis/dns_v2beta1/classes.rb +19 -10
  56. data/generated/google/apis/doubleclickbidmanager_v1.rb +1 -1
  57. data/generated/google/apis/doubleclickbidmanager_v1/classes.rb +9 -2
  58. data/generated/google/apis/doubleclickbidmanager_v1/representations.rb +1 -0
  59. data/generated/google/apis/firebasedynamiclinks_v1.rb +1 -1
  60. data/generated/google/apis/firebasedynamiclinks_v1/classes.rb +7 -0
  61. data/generated/google/apis/firebasedynamiclinks_v1/representations.rb +1 -0
  62. data/generated/google/apis/firestore_v1.rb +1 -1
  63. data/generated/google/apis/firestore_v1/classes.rb +18 -0
  64. data/generated/google/apis/firestore_v1/representations.rb +6 -0
  65. data/generated/google/apis/firestore_v1beta1.rb +1 -1
  66. data/generated/google/apis/firestore_v1beta1/classes.rb +18 -0
  67. data/generated/google/apis/firestore_v1beta1/representations.rb +6 -0
  68. data/generated/google/apis/fitness_v1.rb +1 -1
  69. data/generated/google/apis/fitness_v1/classes.rb +2 -1
  70. data/generated/google/apis/jobs_v3p1beta1.rb +1 -1
  71. data/generated/google/apis/jobs_v3p1beta1/classes.rb +169 -0
  72. data/generated/google/apis/jobs_v3p1beta1/representations.rb +33 -0
  73. data/generated/google/apis/jobs_v3p1beta1/service.rb +32 -0
  74. data/generated/google/apis/libraryagent_v1.rb +34 -0
  75. data/generated/google/apis/libraryagent_v1/classes.rb +151 -0
  76. data/generated/google/apis/libraryagent_v1/representations.rb +86 -0
  77. data/generated/google/apis/libraryagent_v1/service.rb +265 -0
  78. data/generated/google/apis/oslogin_v1.rb +2 -2
  79. data/generated/google/apis/oslogin_v1/service.rb +1 -1
  80. data/generated/google/apis/oslogin_v1alpha.rb +2 -2
  81. data/generated/google/apis/oslogin_v1alpha/service.rb +1 -1
  82. data/generated/google/apis/oslogin_v1beta.rb +2 -2
  83. data/generated/google/apis/oslogin_v1beta/service.rb +1 -1
  84. data/generated/google/apis/remotebuildexecution_v1.rb +34 -0
  85. data/generated/google/apis/remotebuildexecution_v1/classes.rb +3858 -0
  86. data/generated/google/apis/remotebuildexecution_v1/representations.rb +1196 -0
  87. data/generated/google/apis/remotebuildexecution_v1/service.rb +374 -0
  88. data/generated/google/apis/remotebuildexecution_v1alpha.rb +34 -0
  89. data/generated/google/apis/remotebuildexecution_v1alpha/classes.rb +3709 -0
  90. data/generated/google/apis/remotebuildexecution_v1alpha/representations.rb +1113 -0
  91. data/generated/google/apis/remotebuildexecution_v1alpha/service.rb +400 -0
  92. data/generated/google/apis/remotebuildexecution_v2.rb +34 -0
  93. data/generated/google/apis/remotebuildexecution_v2/classes.rb +4460 -0
  94. data/generated/google/apis/remotebuildexecution_v2/representations.rb +1431 -0
  95. data/generated/google/apis/remotebuildexecution_v2/service.rb +542 -0
  96. data/generated/google/apis/serviceconsumermanagement_v1.rb +1 -1
  97. data/generated/google/apis/serviceconsumermanagement_v1/classes.rb +12 -0
  98. data/generated/google/apis/serviceconsumermanagement_v1/representations.rb +2 -0
  99. data/generated/google/apis/servicenetworking_v1beta.rb +1 -1
  100. data/generated/google/apis/servicenetworking_v1beta/classes.rb +12 -0
  101. data/generated/google/apis/servicenetworking_v1beta/representations.rb +2 -0
  102. data/generated/google/apis/serviceusage_v1.rb +1 -1
  103. data/generated/google/apis/serviceusage_v1/classes.rb +12 -0
  104. data/generated/google/apis/serviceusage_v1/representations.rb +2 -0
  105. data/generated/google/apis/serviceusage_v1beta1.rb +1 -1
  106. data/generated/google/apis/serviceusage_v1beta1/classes.rb +12 -0
  107. data/generated/google/apis/serviceusage_v1beta1/representations.rb +2 -0
  108. data/generated/google/apis/sheets_v4.rb +1 -1
  109. data/generated/google/apis/sheets_v4/classes.rb +4 -4
  110. data/generated/google/apis/slides_v1.rb +1 -1
  111. data/generated/google/apis/slides_v1/classes.rb +5 -5
  112. data/generated/google/apis/speech_v1.rb +1 -1
  113. data/generated/google/apis/speech_v1p1beta1.rb +1 -1
  114. data/generated/google/apis/testing_v1.rb +1 -1
  115. data/generated/google/apis/testing_v1/classes.rb +9 -0
  116. data/generated/google/apis/testing_v1/representations.rb +1 -0
  117. data/generated/google/apis/websecurityscanner_v1alpha.rb +1 -1
  118. data/generated/google/apis/websecurityscanner_v1alpha/classes.rb +7 -0
  119. data/generated/google/apis/websecurityscanner_v1alpha/representations.rb +2 -0
  120. data/generated/google/apis/youtube_partner_v1.rb +1 -1
  121. data/lib/google/apis/version.rb +1 -1
  122. metadata +26 -2
@@ -0,0 +1,542 @@
1
+ # Copyright 2015 Google Inc.
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+ require 'google/apis/core/base_service'
16
+ require 'google/apis/core/json_representation'
17
+ require 'google/apis/core/hashable'
18
+ require 'google/apis/errors'
19
+
20
+ module Google
21
+ module Apis
22
+ module RemotebuildexecutionV2
23
+ # Remote Build Execution API
24
+ #
25
+ # Supplies a Remote Execution API service for tools such as bazel.
26
+ #
27
+ # @example
28
+ # require 'google/apis/remotebuildexecution_v2'
29
+ #
30
+ # Remotebuildexecution = Google::Apis::RemotebuildexecutionV2 # Alias the module
31
+ # service = Remotebuildexecution::RemoteBuildExecutionService.new
32
+ #
33
+ # @see https://cloud.google.com/remote-build-execution/docs/
34
+ class RemoteBuildExecutionService < Google::Apis::Core::BaseService
35
+ # @return [String]
36
+ # API key. Your API key identifies your project and provides you with API access,
37
+ # quota, and reports. Required unless you provide an OAuth 2.0 token.
38
+ attr_accessor :key
39
+
40
+ # @return [String]
41
+ # Available to use for quota purposes for server-side applications. Can be any
42
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
43
+ attr_accessor :quota_user
44
+
45
+ def initialize
46
+ super('https://remotebuildexecution.googleapis.com/', '')
47
+ @batch_path = 'batch'
48
+ end
49
+
50
+ # Retrieve a cached execution result.
51
+ # Errors:
52
+ # * `NOT_FOUND`: The requested `ActionResult` is not in the cache.
53
+ # @param [String] instance_name
54
+ # The instance of the execution system to operate against. A server may
55
+ # support multiple instances of the execution system (with their own workers,
56
+ # storage, caches, etc.). The server MAY require use of this field to select
57
+ # between them in an implementation-defined fashion, otherwise it can be
58
+ # omitted.
59
+ # @param [String] hash_
60
+ # The hash. In the case of SHA-256, it will always be a lowercase hex string
61
+ # exactly 64 characters long.
62
+ # @param [Fixnum] size_bytes
63
+ # The size of the blob, in bytes.
64
+ # @param [String] fields
65
+ # Selector specifying which fields to include in a partial response.
66
+ # @param [String] quota_user
67
+ # Available to use for quota purposes for server-side applications. Can be any
68
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
69
+ # @param [Google::Apis::RequestOptions] options
70
+ # Request-specific options
71
+ #
72
+ # @yield [result, err] Result & error if block supplied
73
+ # @yieldparam result [Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2ActionResult] parsed result object
74
+ # @yieldparam err [StandardError] error object if request failed
75
+ #
76
+ # @return [Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2ActionResult]
77
+ #
78
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
79
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
80
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
81
+ def get_action_result(instance_name, hash_, size_bytes, fields: nil, quota_user: nil, options: nil, &block)
82
+ command = make_simple_command(:get, 'v2/{+instanceName}/actionResults/{hash}/{sizeBytes}', options)
83
+ command.response_representation = Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2ActionResult::Representation
84
+ command.response_class = Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2ActionResult
85
+ command.params['instanceName'] = instance_name unless instance_name.nil?
86
+ command.params['hash'] = hash_ unless hash_.nil?
87
+ command.params['sizeBytes'] = size_bytes unless size_bytes.nil?
88
+ command.query['fields'] = fields unless fields.nil?
89
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
90
+ execute_or_queue_command(command, &block)
91
+ end
92
+
93
+ # Upload a new execution result.
94
+ # This method is intended for servers which implement the distributed cache
95
+ # independently of the
96
+ # Execution API. As a
97
+ # result, it is OPTIONAL for servers to implement.
98
+ # In order to allow the server to perform access control based on the type of
99
+ # action, and to assist with client debugging, the client MUST first upload
100
+ # the Action that produced the
101
+ # result, along with its
102
+ # Command, into the
103
+ # `ContentAddressableStorage`.
104
+ # Errors:
105
+ # * `UNIMPLEMENTED`: This method is not supported by the server.
106
+ # * `RESOURCE_EXHAUSTED`: There is insufficient storage space to add the
107
+ # entry to the cache.
108
+ # @param [String] instance_name
109
+ # The instance of the execution system to operate against. A server may
110
+ # support multiple instances of the execution system (with their own workers,
111
+ # storage, caches, etc.). The server MAY require use of this field to select
112
+ # between them in an implementation-defined fashion, otherwise it can be
113
+ # omitted.
114
+ # @param [String] hash_
115
+ # The hash. In the case of SHA-256, it will always be a lowercase hex string
116
+ # exactly 64 characters long.
117
+ # @param [Fixnum] size_bytes
118
+ # The size of the blob, in bytes.
119
+ # @param [Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2ActionResult] build_bazel_remote_execution_v2_action_result_object
120
+ # @param [Fixnum] results_cache_policy_priority
121
+ # The priority (relative importance) of this content in the overall cache.
122
+ # Generally, a lower value means a longer retention time or other advantage,
123
+ # but the interpretation of a given value is server-dependent. A priority of
124
+ # 0 means a *default* value, decided by the server.
125
+ # The particular semantics of this field is up to the server. In particular,
126
+ # every server will have their own supported range of priorities, and will
127
+ # decide how these map into retention/eviction policy.
128
+ # @param [String] fields
129
+ # Selector specifying which fields to include in a partial response.
130
+ # @param [String] quota_user
131
+ # Available to use for quota purposes for server-side applications. Can be any
132
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
133
+ # @param [Google::Apis::RequestOptions] options
134
+ # Request-specific options
135
+ #
136
+ # @yield [result, err] Result & error if block supplied
137
+ # @yieldparam result [Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2ActionResult] parsed result object
138
+ # @yieldparam err [StandardError] error object if request failed
139
+ #
140
+ # @return [Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2ActionResult]
141
+ #
142
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
143
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
144
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
145
+ def update_action_result(instance_name, hash_, size_bytes, build_bazel_remote_execution_v2_action_result_object = nil, results_cache_policy_priority: nil, fields: nil, quota_user: nil, options: nil, &block)
146
+ command = make_simple_command(:put, 'v2/{+instanceName}/actionResults/{hash}/{sizeBytes}', options)
147
+ command.request_representation = Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2ActionResult::Representation
148
+ command.request_object = build_bazel_remote_execution_v2_action_result_object
149
+ command.response_representation = Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2ActionResult::Representation
150
+ command.response_class = Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2ActionResult
151
+ command.params['instanceName'] = instance_name unless instance_name.nil?
152
+ command.params['hash'] = hash_ unless hash_.nil?
153
+ command.params['sizeBytes'] = size_bytes unless size_bytes.nil?
154
+ command.query['resultsCachePolicy.priority'] = results_cache_policy_priority unless results_cache_policy_priority.nil?
155
+ command.query['fields'] = fields unless fields.nil?
156
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
157
+ execute_or_queue_command(command, &block)
158
+ end
159
+
160
+ # Execute an action remotely.
161
+ # In order to execute an action, the client must first upload all of the
162
+ # inputs, the
163
+ # Command to run, and the
164
+ # Action into the
165
+ # ContentAddressableStorage.
166
+ # It then calls `Execute` with an `action_digest` referring to them. The
167
+ # server will run the action and eventually return the result.
168
+ # The input `Action`'s fields MUST meet the various canonicalization
169
+ # requirements specified in the documentation for their types so that it has
170
+ # the same digest as other logically equivalent `Action`s. The server MAY
171
+ # enforce the requirements and return errors if a non-canonical input is
172
+ # received. It MAY also proceed without verifying some or all of the
173
+ # requirements, such as for performance reasons. If the server does not
174
+ # verify the requirement, then it will treat the `Action` as distinct from
175
+ # another logically equivalent action if they hash differently.
176
+ # Returns a stream of
177
+ # google.longrunning.Operation messages
178
+ # describing the resulting execution, with eventual `response`
179
+ # ExecuteResponse. The
180
+ # `metadata` on the operation is of type
181
+ # ExecuteOperationMetadata.
182
+ # If the client remains connected after the first response is returned after
183
+ # the server, then updates are streamed as if the client had called
184
+ # WaitExecution
185
+ # until the execution completes or the request reaches an error. The
186
+ # operation can also be queried using Operations
187
+ # API.
188
+ # The server NEED NOT implement other methods or functionality of the
189
+ # Operations API.
190
+ # Errors discovered during creation of the `Operation` will be reported
191
+ # as gRPC Status errors, while errors that occurred while running the
192
+ # action will be reported in the `status` field of the `ExecuteResponse`. The
193
+ # server MUST NOT set the `error` field of the `Operation` proto.
194
+ # The possible errors include:
195
+ # * `INVALID_ARGUMENT`: One or more arguments are invalid.
196
+ # * `FAILED_PRECONDITION`: One or more errors occurred in setting up the
197
+ # action requested, such as a missing input or command or no worker being
198
+ # available. The client may be able to fix the errors and retry.
199
+ # * `RESOURCE_EXHAUSTED`: There is insufficient quota of some resource to run
200
+ # the action.
201
+ # * `UNAVAILABLE`: Due to a transient condition, such as all workers being
202
+ # occupied (and the server does not support a queue), the action could not
203
+ # be started. The client should retry.
204
+ # * `INTERNAL`: An internal error occurred in the execution engine or the
205
+ # worker.
206
+ # * `DEADLINE_EXCEEDED`: The execution timed out.
207
+ # In the case of a missing input or command, the server SHOULD additionally
208
+ # send a PreconditionFailure error detail
209
+ # where, for each requested blob not present in the CAS, there is a
210
+ # `Violation` with a `type` of `MISSING` and a `subject` of
211
+ # `"blobs/`hash`/`size`"` indicating the digest of the missing blob.
212
+ # @param [String] instance_name
213
+ # The instance of the execution system to operate against. A server may
214
+ # support multiple instances of the execution system (with their own workers,
215
+ # storage, caches, etc.). The server MAY require use of this field to select
216
+ # between them in an implementation-defined fashion, otherwise it can be
217
+ # omitted.
218
+ # @param [Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2ExecuteRequest] build_bazel_remote_execution_v2_execute_request_object
219
+ # @param [String] fields
220
+ # Selector specifying which fields to include in a partial response.
221
+ # @param [String] quota_user
222
+ # Available to use for quota purposes for server-side applications. Can be any
223
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
224
+ # @param [Google::Apis::RequestOptions] options
225
+ # Request-specific options
226
+ #
227
+ # @yield [result, err] Result & error if block supplied
228
+ # @yieldparam result [Google::Apis::RemotebuildexecutionV2::GoogleLongrunningOperation] parsed result object
229
+ # @yieldparam err [StandardError] error object if request failed
230
+ #
231
+ # @return [Google::Apis::RemotebuildexecutionV2::GoogleLongrunningOperation]
232
+ #
233
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
234
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
235
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
236
+ def execute_action(instance_name, build_bazel_remote_execution_v2_execute_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
237
+ command = make_simple_command(:post, 'v2/{+instanceName}/actions:execute', options)
238
+ command.request_representation = Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2ExecuteRequest::Representation
239
+ command.request_object = build_bazel_remote_execution_v2_execute_request_object
240
+ command.response_representation = Google::Apis::RemotebuildexecutionV2::GoogleLongrunningOperation::Representation
241
+ command.response_class = Google::Apis::RemotebuildexecutionV2::GoogleLongrunningOperation
242
+ command.params['instanceName'] = instance_name unless instance_name.nil?
243
+ command.query['fields'] = fields unless fields.nil?
244
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
245
+ execute_or_queue_command(command, &block)
246
+ end
247
+
248
+ # Download many blobs at once.
249
+ # The server may enforce a limit of the combined total size of blobs
250
+ # to be downloaded using this API. This limit may be obtained using the
251
+ # Capabilities API.
252
+ # Requests exceeding the limit should either be split into smaller
253
+ # chunks or downloaded using the
254
+ # ByteStream API, as appropriate.
255
+ # This request is equivalent to calling a Bytestream `Read` request
256
+ # on each individual blob, in parallel. The requests may succeed or fail
257
+ # independently.
258
+ # Errors:
259
+ # * `INVALID_ARGUMENT`: The client attempted to read more than the
260
+ # server supported limit.
261
+ # Every error on individual read will be returned in the corresponding digest
262
+ # status.
263
+ # @param [String] instance_name
264
+ # The instance of the execution system to operate against. A server may
265
+ # support multiple instances of the execution system (with their own workers,
266
+ # storage, caches, etc.). The server MAY require use of this field to select
267
+ # between them in an implementation-defined fashion, otherwise it can be
268
+ # omitted.
269
+ # @param [Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2BatchReadBlobsRequest] build_bazel_remote_execution_v2_batch_read_blobs_request_object
270
+ # @param [String] fields
271
+ # Selector specifying which fields to include in a partial response.
272
+ # @param [String] quota_user
273
+ # Available to use for quota purposes for server-side applications. Can be any
274
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
275
+ # @param [Google::Apis::RequestOptions] options
276
+ # Request-specific options
277
+ #
278
+ # @yield [result, err] Result & error if block supplied
279
+ # @yieldparam result [Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2BatchReadBlobsResponse] parsed result object
280
+ # @yieldparam err [StandardError] error object if request failed
281
+ #
282
+ # @return [Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2BatchReadBlobsResponse]
283
+ #
284
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
285
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
286
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
287
+ def batch_blob_read(instance_name, build_bazel_remote_execution_v2_batch_read_blobs_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
288
+ command = make_simple_command(:post, 'v2/{+instanceName}/blobs:batchRead', options)
289
+ command.request_representation = Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2BatchReadBlobsRequest::Representation
290
+ command.request_object = build_bazel_remote_execution_v2_batch_read_blobs_request_object
291
+ command.response_representation = Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2BatchReadBlobsResponse::Representation
292
+ command.response_class = Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2BatchReadBlobsResponse
293
+ command.params['instanceName'] = instance_name unless instance_name.nil?
294
+ command.query['fields'] = fields unless fields.nil?
295
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
296
+ execute_or_queue_command(command, &block)
297
+ end
298
+
299
+ # Upload many blobs at once.
300
+ # The server may enforce a limit of the combined total size of blobs
301
+ # to be uploaded using this API. This limit may be obtained using the
302
+ # Capabilities API.
303
+ # Requests exceeding the limit should either be split into smaller
304
+ # chunks or uploaded using the
305
+ # ByteStream API, as appropriate.
306
+ # This request is equivalent to calling a Bytestream `Write` request
307
+ # on each individual blob, in parallel. The requests may succeed or fail
308
+ # independently.
309
+ # Errors:
310
+ # * `INVALID_ARGUMENT`: The client attempted to upload more than the
311
+ # server supported limit.
312
+ # Individual requests may return the following errors, additionally:
313
+ # * `RESOURCE_EXHAUSTED`: There is insufficient disk quota to store the blob.
314
+ # * `INVALID_ARGUMENT`: The
315
+ # Digest does not match the
316
+ # provided data.
317
+ # @param [String] instance_name
318
+ # The instance of the execution system to operate against. A server may
319
+ # support multiple instances of the execution system (with their own workers,
320
+ # storage, caches, etc.). The server MAY require use of this field to select
321
+ # between them in an implementation-defined fashion, otherwise it can be
322
+ # omitted.
323
+ # @param [Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2BatchUpdateBlobsRequest] build_bazel_remote_execution_v2_batch_update_blobs_request_object
324
+ # @param [String] fields
325
+ # Selector specifying which fields to include in a partial response.
326
+ # @param [String] quota_user
327
+ # Available to use for quota purposes for server-side applications. Can be any
328
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
329
+ # @param [Google::Apis::RequestOptions] options
330
+ # Request-specific options
331
+ #
332
+ # @yield [result, err] Result & error if block supplied
333
+ # @yieldparam result [Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2BatchUpdateBlobsResponse] parsed result object
334
+ # @yieldparam err [StandardError] error object if request failed
335
+ #
336
+ # @return [Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2BatchUpdateBlobsResponse]
337
+ #
338
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
339
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
340
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
341
+ def batch_blob_update(instance_name, build_bazel_remote_execution_v2_batch_update_blobs_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
342
+ command = make_simple_command(:post, 'v2/{+instanceName}/blobs:batchUpdate', options)
343
+ command.request_representation = Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2BatchUpdateBlobsRequest::Representation
344
+ command.request_object = build_bazel_remote_execution_v2_batch_update_blobs_request_object
345
+ command.response_representation = Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2BatchUpdateBlobsResponse::Representation
346
+ command.response_class = Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2BatchUpdateBlobsResponse
347
+ command.params['instanceName'] = instance_name unless instance_name.nil?
348
+ command.query['fields'] = fields unless fields.nil?
349
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
350
+ execute_or_queue_command(command, &block)
351
+ end
352
+
353
+ # Determine if blobs are present in the CAS.
354
+ # Clients can use this API before uploading blobs to determine which ones are
355
+ # already present in the CAS and do not need to be uploaded again.
356
+ # There are no method-specific errors.
357
+ # @param [String] instance_name
358
+ # The instance of the execution system to operate against. A server may
359
+ # support multiple instances of the execution system (with their own workers,
360
+ # storage, caches, etc.). The server MAY require use of this field to select
361
+ # between them in an implementation-defined fashion, otherwise it can be
362
+ # omitted.
363
+ # @param [Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2FindMissingBlobsRequest] build_bazel_remote_execution_v2_find_missing_blobs_request_object
364
+ # @param [String] fields
365
+ # Selector specifying which fields to include in a partial response.
366
+ # @param [String] quota_user
367
+ # Available to use for quota purposes for server-side applications. Can be any
368
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
369
+ # @param [Google::Apis::RequestOptions] options
370
+ # Request-specific options
371
+ #
372
+ # @yield [result, err] Result & error if block supplied
373
+ # @yieldparam result [Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2FindMissingBlobsResponse] parsed result object
374
+ # @yieldparam err [StandardError] error object if request failed
375
+ #
376
+ # @return [Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2FindMissingBlobsResponse]
377
+ #
378
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
379
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
380
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
381
+ def find_blob_missing(instance_name, build_bazel_remote_execution_v2_find_missing_blobs_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
382
+ command = make_simple_command(:post, 'v2/{+instanceName}/blobs:findMissing', options)
383
+ command.request_representation = Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2FindMissingBlobsRequest::Representation
384
+ command.request_object = build_bazel_remote_execution_v2_find_missing_blobs_request_object
385
+ command.response_representation = Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2FindMissingBlobsResponse::Representation
386
+ command.response_class = Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2FindMissingBlobsResponse
387
+ command.params['instanceName'] = instance_name unless instance_name.nil?
388
+ command.query['fields'] = fields unless fields.nil?
389
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
390
+ execute_or_queue_command(command, &block)
391
+ end
392
+
393
+ # Fetch the entire directory tree rooted at a node.
394
+ # This request must be targeted at a
395
+ # Directory stored in the
396
+ # ContentAddressableStorage
397
+ # (CAS). The server will enumerate the `Directory` tree recursively and
398
+ # return every node descended from the root.
399
+ # The GetTreeRequest.page_token parameter can be used to skip ahead in
400
+ # the stream (e.g. when retrying a partially completed and aborted request),
401
+ # by setting it to a value taken from GetTreeResponse.next_page_token of the
402
+ # last successfully processed GetTreeResponse).
403
+ # The exact traversal order is unspecified and, unless retrieving subsequent
404
+ # pages from an earlier request, is not guaranteed to be stable across
405
+ # multiple invocations of `GetTree`.
406
+ # If part of the tree is missing from the CAS, the server will return the
407
+ # portion present and omit the rest.
408
+ # * `NOT_FOUND`: The requested tree root is not present in the CAS.
409
+ # @param [String] instance_name
410
+ # The instance of the execution system to operate against. A server may
411
+ # support multiple instances of the execution system (with their own workers,
412
+ # storage, caches, etc.). The server MAY require use of this field to select
413
+ # between them in an implementation-defined fashion, otherwise it can be
414
+ # omitted.
415
+ # @param [String] hash_
416
+ # The hash. In the case of SHA-256, it will always be a lowercase hex string
417
+ # exactly 64 characters long.
418
+ # @param [Fixnum] size_bytes
419
+ # The size of the blob, in bytes.
420
+ # @param [Fixnum] page_size
421
+ # A maximum page size to request. If present, the server will request no more
422
+ # than this many items. Regardless of whether a page size is specified, the
423
+ # server may place its own limit on the number of items to be returned and
424
+ # require the client to retrieve more items using a subsequent request.
425
+ # @param [String] page_token
426
+ # A page token, which must be a value received in a previous
427
+ # GetTreeResponse.
428
+ # If present, the server will use it to return the following page of results.
429
+ # @param [String] fields
430
+ # Selector specifying which fields to include in a partial response.
431
+ # @param [String] quota_user
432
+ # Available to use for quota purposes for server-side applications. Can be any
433
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
434
+ # @param [Google::Apis::RequestOptions] options
435
+ # Request-specific options
436
+ #
437
+ # @yield [result, err] Result & error if block supplied
438
+ # @yieldparam result [Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2GetTreeResponse] parsed result object
439
+ # @yieldparam err [StandardError] error object if request failed
440
+ #
441
+ # @return [Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2GetTreeResponse]
442
+ #
443
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
444
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
445
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
446
+ def get_blob_tree(instance_name, hash_, size_bytes, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
447
+ command = make_simple_command(:get, 'v2/{+instanceName}/blobs/{hash}/{sizeBytes}:getTree', options)
448
+ command.response_representation = Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2GetTreeResponse::Representation
449
+ command.response_class = Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2GetTreeResponse
450
+ command.params['instanceName'] = instance_name unless instance_name.nil?
451
+ command.params['hash'] = hash_ unless hash_.nil?
452
+ command.params['sizeBytes'] = size_bytes unless size_bytes.nil?
453
+ command.query['pageSize'] = page_size unless page_size.nil?
454
+ command.query['pageToken'] = page_token unless page_token.nil?
455
+ command.query['fields'] = fields unless fields.nil?
456
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
457
+ execute_or_queue_command(command, &block)
458
+ end
459
+
460
+ # Wait for an execution operation to complete. When the client initially
461
+ # makes the request, the server immediately responds with the current status
462
+ # of the execution. The server will leave the request stream open until the
463
+ # operation completes, and then respond with the completed operation. The
464
+ # server MAY choose to stream additional updates as execution progresses,
465
+ # such as to provide an update as to the state of the execution.
466
+ # @param [String] name
467
+ # The name of the Operation
468
+ # returned by Execute.
469
+ # @param [Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2WaitExecutionRequest] build_bazel_remote_execution_v2_wait_execution_request_object
470
+ # @param [String] fields
471
+ # Selector specifying which fields to include in a partial response.
472
+ # @param [String] quota_user
473
+ # Available to use for quota purposes for server-side applications. Can be any
474
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
475
+ # @param [Google::Apis::RequestOptions] options
476
+ # Request-specific options
477
+ #
478
+ # @yield [result, err] Result & error if block supplied
479
+ # @yieldparam result [Google::Apis::RemotebuildexecutionV2::GoogleLongrunningOperation] parsed result object
480
+ # @yieldparam err [StandardError] error object if request failed
481
+ #
482
+ # @return [Google::Apis::RemotebuildexecutionV2::GoogleLongrunningOperation]
483
+ #
484
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
485
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
486
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
487
+ def wait_operation_execution(name, build_bazel_remote_execution_v2_wait_execution_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
488
+ command = make_simple_command(:post, 'v2/{+name}:waitExecution', options)
489
+ command.request_representation = Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2WaitExecutionRequest::Representation
490
+ command.request_object = build_bazel_remote_execution_v2_wait_execution_request_object
491
+ command.response_representation = Google::Apis::RemotebuildexecutionV2::GoogleLongrunningOperation::Representation
492
+ command.response_class = Google::Apis::RemotebuildexecutionV2::GoogleLongrunningOperation
493
+ command.params['name'] = name unless name.nil?
494
+ command.query['fields'] = fields unless fields.nil?
495
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
496
+ execute_or_queue_command(command, &block)
497
+ end
498
+
499
+ # GetCapabilities returns the server capabilities configuration.
500
+ # @param [String] instance_name
501
+ # The instance of the execution system to operate against. A server may
502
+ # support multiple instances of the execution system (with their own workers,
503
+ # storage, caches, etc.). The server MAY require use of this field to select
504
+ # between them in an implementation-defined fashion, otherwise it can be
505
+ # omitted.
506
+ # @param [String] fields
507
+ # Selector specifying which fields to include in a partial response.
508
+ # @param [String] quota_user
509
+ # Available to use for quota purposes for server-side applications. Can be any
510
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
511
+ # @param [Google::Apis::RequestOptions] options
512
+ # Request-specific options
513
+ #
514
+ # @yield [result, err] Result & error if block supplied
515
+ # @yieldparam result [Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2ServerCapabilities] parsed result object
516
+ # @yieldparam err [StandardError] error object if request failed
517
+ #
518
+ # @return [Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2ServerCapabilities]
519
+ #
520
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
521
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
522
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
523
+ def get_capabilities(instance_name, fields: nil, quota_user: nil, options: nil, &block)
524
+ command = make_simple_command(:get, 'v2/{+instanceName}/capabilities', options)
525
+ command.response_representation = Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2ServerCapabilities::Representation
526
+ command.response_class = Google::Apis::RemotebuildexecutionV2::BuildBazelRemoteExecutionV2ServerCapabilities
527
+ command.params['instanceName'] = instance_name unless instance_name.nil?
528
+ command.query['fields'] = fields unless fields.nil?
529
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
530
+ execute_or_queue_command(command, &block)
531
+ end
532
+
533
+ protected
534
+
535
+ def apply_command_defaults(command)
536
+ command.query['key'] = key unless key.nil?
537
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
538
+ end
539
+ end
540
+ end
541
+ end
542
+ end