google-api-client 0.27.2 → 0.27.3

Sign up to get free protection for your applications and to get access to all the features.
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