google-cloud-asset-v1beta1 0.1.1 → 0.1.2
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.md +48 -1
- data/lib/google-cloud-asset-v1beta1.rb +21 -1
- data/lib/google/cloud/asset/v1beta1.rb +16 -0
- data/lib/google/cloud/asset/v1beta1/asset_service.rb +30 -2
- data/lib/google/cloud/asset/v1beta1/asset_service/client.rb +23 -36
- data/lib/google/cloud/asset/v1beta1/asset_service/operations.rb +39 -33
- data/lib/google/cloud/asset/v1beta1/version.rb +1 -1
- data/proto_docs/google/iam/v1/policy.rb +109 -17
- data/proto_docs/google/type/expr.rb +52 -0
- metadata +13 -6
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: c7097a03e3d0a49170b30f673176bdf6bff1b94db83d0c84db904cd0fbaacf75
|
4
|
+
data.tar.gz: 2f2bf2060e68a7473db2223f8a03bc2f149b472115b11cc5be236636528bcc09
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 8e1d81355c46e73709c965dd9dbae6e3d0a433b197b2eca98548c1f794c35d2e78751fd887fd56fa5ca2e0741a312f09f5a742778239fc2882857c2972137481
|
7
|
+
data.tar.gz: e9f9b345b0ecef1acab4f43777b6a547d708b0f66249e6e33442d6f6209393f334f9e4da18fe4d21f0936e32029afa14240c9ee68e152047004ec8e58e673899
|
data/README.md
CHANGED
@@ -1,4 +1,4 @@
|
|
1
|
-
# Cloud Asset V1beta1
|
1
|
+
# Ruby Client for the Cloud Asset V1beta1 API
|
2
2
|
|
3
3
|
API Client library for the Cloud Asset V1beta1 API
|
4
4
|
|
@@ -12,6 +12,53 @@ https://github.com/googleapis/google-cloud-ruby
|
|
12
12
|
$ gem install google-cloud-asset-v1beta1
|
13
13
|
```
|
14
14
|
|
15
|
+
## Before You Begin
|
16
|
+
|
17
|
+
In order to use this library, you first need to go through the following steps:
|
18
|
+
|
19
|
+
1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
|
20
|
+
1. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
|
21
|
+
1. {file:AUTHENTICATION.md Set up authentication.}
|
22
|
+
|
23
|
+
## Quick Start
|
24
|
+
|
25
|
+
```ruby
|
26
|
+
require "google/cloud/asset/v1beta1"
|
27
|
+
|
28
|
+
client = Google::Cloud::Asset::V1beta1::AssetService::Client.new
|
29
|
+
request = my_create_request
|
30
|
+
response = client.export_assets request
|
31
|
+
```
|
32
|
+
|
33
|
+
View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-asset-v1beta1/latest)
|
34
|
+
for class and method documentation.
|
35
|
+
|
36
|
+
## Enabling Logging
|
37
|
+
|
38
|
+
To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
|
39
|
+
The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib/libdoc/logger/rdoc/Logger.html) as shown below,
|
40
|
+
or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
|
41
|
+
that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
|
42
|
+
and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
|
43
|
+
|
44
|
+
Configuring a Ruby stdlib logger:
|
45
|
+
|
46
|
+
```ruby
|
47
|
+
require "logger"
|
48
|
+
|
49
|
+
module MyLogger
|
50
|
+
LOGGER = Logger.new $stderr, level: Logger::WARN
|
51
|
+
def logger
|
52
|
+
LOGGER
|
53
|
+
end
|
54
|
+
end
|
55
|
+
|
56
|
+
# Define a gRPC module-level logger method before grpc/logconfig.rb loads.
|
57
|
+
module GRPC
|
58
|
+
extend MyLogger
|
59
|
+
end
|
60
|
+
```
|
61
|
+
|
15
62
|
## Supported Ruby Versions
|
16
63
|
|
17
64
|
This library is supported on Ruby 2.4+.
|
@@ -1 +1,21 @@
|
|
1
|
-
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
# Copyright 2020 Google LLC
|
4
|
+
#
|
5
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
6
|
+
# you may not use this file except in compliance with the License.
|
7
|
+
# You may obtain a copy of the License at
|
8
|
+
#
|
9
|
+
# https://www.apache.org/licenses/LICENSE-2.0
|
10
|
+
#
|
11
|
+
# Unless required by applicable law or agreed to in writing, software
|
12
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
13
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
14
|
+
# See the License for the specific language governing permissions and
|
15
|
+
# limitations under the License.
|
16
|
+
|
17
|
+
# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
|
18
|
+
|
19
|
+
# This gem does not autoload during Bundler.require. To load this gem,
|
20
|
+
# issue explicit require statements for the packages desired, e.g.:
|
21
|
+
# require "google/cloud/asset/v1beta1"
|
@@ -17,3 +17,19 @@
|
|
17
17
|
# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
|
18
18
|
|
19
19
|
require "google/cloud/asset/v1beta1/asset_service"
|
20
|
+
require "google/cloud/asset/v1beta1/version"
|
21
|
+
|
22
|
+
module Google
|
23
|
+
module Cloud
|
24
|
+
module Asset
|
25
|
+
##
|
26
|
+
# To load this package, including all its services, and instantiate a client:
|
27
|
+
#
|
28
|
+
# require "google/cloud/asset/v1beta1"
|
29
|
+
# client = Google::Cloud::Asset::V1beta1::AssetService::Client.new
|
30
|
+
#
|
31
|
+
module V1beta1
|
32
|
+
end
|
33
|
+
end
|
34
|
+
end
|
35
|
+
end
|
@@ -16,6 +16,34 @@
|
|
16
16
|
|
17
17
|
# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
|
18
18
|
|
19
|
-
require "
|
20
|
-
require "
|
19
|
+
require "gapic/common"
|
20
|
+
require "gapic/config"
|
21
|
+
require "gapic/config/method"
|
22
|
+
|
23
|
+
require "google/cloud/asset/v1beta1/version"
|
24
|
+
|
21
25
|
require "google/cloud/asset/v1beta1/asset_service/credentials"
|
26
|
+
require "google/cloud/asset/v1beta1/asset_service/operations"
|
27
|
+
require "google/cloud/asset/v1beta1/asset_service/client"
|
28
|
+
|
29
|
+
module Google
|
30
|
+
module Cloud
|
31
|
+
module Asset
|
32
|
+
module V1beta1
|
33
|
+
##
|
34
|
+
# Asset service definition.
|
35
|
+
#
|
36
|
+
# To load this service and instantiate a client:
|
37
|
+
#
|
38
|
+
# require "google/cloud/asset/v1beta1/asset_service"
|
39
|
+
# client = Google::Cloud::Asset::V1beta1::AssetService::Client.new
|
40
|
+
#
|
41
|
+
module AssetService
|
42
|
+
end
|
43
|
+
end
|
44
|
+
end
|
45
|
+
end
|
46
|
+
end
|
47
|
+
|
48
|
+
helper_path = ::File.join __dir__, "asset_service", "helpers.rb"
|
49
|
+
require "google/cloud/asset/v1beta1/asset_service/helpers" if ::File.file? helper_path
|
@@ -16,15 +16,8 @@
|
|
16
16
|
|
17
17
|
# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
|
18
18
|
|
19
|
-
require "gapic/common"
|
20
|
-
require "gapic/config"
|
21
|
-
require "gapic/config/method"
|
22
|
-
|
23
19
|
require "google/cloud/errors"
|
24
|
-
require "google/cloud/asset/v1beta1/version"
|
25
20
|
require "google/cloud/asset/v1beta1/asset_service_pb"
|
26
|
-
require "google/cloud/asset/v1beta1/asset_service/credentials"
|
27
|
-
require "google/cloud/asset/v1beta1/asset_service/operations"
|
28
21
|
|
29
22
|
module Google
|
30
23
|
module Cloud
|
@@ -170,22 +163,26 @@ module Google
|
|
170
163
|
# you to keep track of the export.
|
171
164
|
#
|
172
165
|
# @overload export_assets(request, options = nil)
|
173
|
-
#
|
174
|
-
#
|
175
|
-
#
|
176
|
-
#
|
177
|
-
#
|
178
|
-
#
|
166
|
+
# Pass arguments to `export_assets` via a request object, either of type
|
167
|
+
# {Google::Cloud::Asset::V1beta1::ExportAssetsRequest} or an equivalent Hash.
|
168
|
+
#
|
169
|
+
# @param request [Google::Cloud::Asset::V1beta1::ExportAssetsRequest, Hash]
|
170
|
+
# A request object representing the call parameters. Required. To specify no
|
171
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
179
172
|
# @param options [Gapic::CallOptions, Hash]
|
180
173
|
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
181
174
|
#
|
182
175
|
# @overload export_assets(parent: nil, read_time: nil, asset_types: nil, content_type: nil, output_config: nil)
|
176
|
+
# Pass arguments to `export_assets` via keyword arguments. Note that at
|
177
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
178
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
179
|
+
#
|
183
180
|
# @param parent [String]
|
184
181
|
# Required. The relative name of the root asset. This can only be an
|
185
182
|
# organization number (such as "organizations/123"), a project ID (such as
|
186
183
|
# "projects/my-project-id"), a project number (such as "projects/12345"), or
|
187
184
|
# a folder number (such as "folders/123").
|
188
|
-
# @param read_time [Google::Protobuf::Timestamp
|
185
|
+
# @param read_time [Google::Protobuf::Timestamp, Hash]
|
189
186
|
# Timestamp to take an asset snapshot. This can only be set to a timestamp
|
190
187
|
# between 2018-10-02 UTC (inclusive) and the current time. If not specified,
|
191
188
|
# the current time will be used. Due to delays in resource data collection
|
@@ -200,11 +197,10 @@ module Google
|
|
200
197
|
# @param content_type [Google::Cloud::Asset::V1beta1::ContentType]
|
201
198
|
# Asset content type. If not specified, no content but the asset name will be
|
202
199
|
# returned.
|
203
|
-
# @param output_config [Google::Cloud::Asset::V1beta1::OutputConfig
|
200
|
+
# @param output_config [Google::Cloud::Asset::V1beta1::OutputConfig, Hash]
|
204
201
|
# Required. Output configuration indicating where the results will be output
|
205
202
|
# to. All results will be in newline delimited JSON format.
|
206
203
|
#
|
207
|
-
#
|
208
204
|
# @yield [response, operation] Access the result along with the RPC operation
|
209
205
|
# @yieldparam response [Gapic::Operation]
|
210
206
|
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
@@ -261,18 +257,20 @@ module Google
|
|
261
257
|
# error.
|
262
258
|
#
|
263
259
|
# @overload batch_get_assets_history(request, options = nil)
|
264
|
-
#
|
265
|
-
#
|
266
|
-
#
|
267
|
-
#
|
268
|
-
#
|
269
|
-
#
|
270
|
-
# If a specified asset does not exist, this API returns an INVALID_ARGUMENT
|
271
|
-
# error.
|
260
|
+
# Pass arguments to `batch_get_assets_history` via a request object, either of type
|
261
|
+
# {Google::Cloud::Asset::V1beta1::BatchGetAssetsHistoryRequest} or an equivalent Hash.
|
262
|
+
#
|
263
|
+
# @param request [Google::Cloud::Asset::V1beta1::BatchGetAssetsHistoryRequest, Hash]
|
264
|
+
# A request object representing the call parameters. Required. To specify no
|
265
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
272
266
|
# @param options [Gapic::CallOptions, Hash]
|
273
267
|
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
274
268
|
#
|
275
269
|
# @overload batch_get_assets_history(parent: nil, asset_names: nil, content_type: nil, read_time_window: nil)
|
270
|
+
# Pass arguments to `batch_get_assets_history` via keyword arguments. Note that at
|
271
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
272
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
273
|
+
#
|
276
274
|
# @param parent [String]
|
277
275
|
# Required. The relative name of the root asset. It can only be an
|
278
276
|
# organization number (such as "organizations/123"), a project ID (such as
|
@@ -288,7 +286,7 @@ module Google
|
|
288
286
|
# size of the asset name list is 100 in one request.
|
289
287
|
# @param content_type [Google::Cloud::Asset::V1beta1::ContentType]
|
290
288
|
# Optional. The content type.
|
291
|
-
# @param read_time_window [Google::Cloud::Asset::V1beta1::TimeWindow
|
289
|
+
# @param read_time_window [Google::Cloud::Asset::V1beta1::TimeWindow, Hash]
|
292
290
|
# Optional. The time window for the asset history. Both start_time and
|
293
291
|
# end_time are optional and if set, it must be after 2018-10-02 UTC. If
|
294
292
|
# end_time is not set, it is default to current timestamp. If start_time is
|
@@ -296,7 +294,6 @@ module Google
|
|
296
294
|
# returned results contain all temporal assets whose time window overlap with
|
297
295
|
# read_time_window.
|
298
296
|
#
|
299
|
-
#
|
300
297
|
# @yield [response, operation] Access the result along with the RPC operation
|
301
298
|
# @yieldparam response [Google::Cloud::Asset::V1beta1::BatchGetAssetsHistoryResponse]
|
302
299
|
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
@@ -502,13 +499,3 @@ module Google
|
|
502
499
|
end
|
503
500
|
end
|
504
501
|
end
|
505
|
-
|
506
|
-
# rubocop:disable Lint/HandleExceptions
|
507
|
-
|
508
|
-
# Once client is loaded, load helpers.rb if it exists.
|
509
|
-
begin
|
510
|
-
require "google/cloud/asset/v1beta1/asset_service/helpers"
|
511
|
-
rescue LoadError
|
512
|
-
end
|
513
|
-
|
514
|
-
# rubocop:enable Lint/HandleExceptions
|
@@ -16,11 +16,7 @@
|
|
16
16
|
|
17
17
|
# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
|
18
18
|
|
19
|
-
require "gapic/common"
|
20
19
|
require "gapic/operation"
|
21
|
-
|
22
|
-
require "google/cloud/asset/v1beta1/version"
|
23
|
-
require "google/cloud/asset/v1beta1/asset_service/client"
|
24
20
|
require "google/longrunning/operations_pb"
|
25
21
|
|
26
22
|
module Google
|
@@ -109,16 +105,20 @@ module Google
|
|
109
105
|
# to use different resource name schemes, such as `users/*/operations`.
|
110
106
|
#
|
111
107
|
# @overload list_operations(request, options = nil)
|
112
|
-
#
|
113
|
-
#
|
114
|
-
# server doesn't support this method, it returns `UNIMPLEMENTED`.
|
108
|
+
# Pass arguments to `list_operations` via a request object, either of type
|
109
|
+
# {Google::Longrunning::ListOperationsRequest} or an equivalent Hash.
|
115
110
|
#
|
116
|
-
#
|
117
|
-
#
|
111
|
+
# @param request [Google::Longrunning::ListOperationsRequest, Hash]
|
112
|
+
# A request object representing the call parameters. Required. To specify no
|
113
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
118
114
|
# @param options [Gapic::CallOptions, Hash]
|
119
115
|
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
120
116
|
#
|
121
117
|
# @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil)
|
118
|
+
# Pass arguments to `list_operations` via keyword arguments. Note that at
|
119
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
120
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
121
|
+
#
|
122
122
|
# @param name [String]
|
123
123
|
# The name of the operation collection.
|
124
124
|
# @param filter [String]
|
@@ -128,7 +128,6 @@ module Google
|
|
128
128
|
# @param page_token [String]
|
129
129
|
# The standard list page token.
|
130
130
|
#
|
131
|
-
#
|
132
131
|
# @yield [response, operation] Access the result along with the RPC operation
|
133
132
|
# @yieldparam response [Gapic::PagedEnumerable<Gapic::Operation>]
|
134
133
|
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
@@ -182,18 +181,23 @@ module Google
|
|
182
181
|
# service.
|
183
182
|
#
|
184
183
|
# @overload get_operation(request, options = nil)
|
185
|
-
#
|
186
|
-
#
|
187
|
-
#
|
188
|
-
#
|
184
|
+
# Pass arguments to `get_operation` via a request object, either of type
|
185
|
+
# {Google::Longrunning::GetOperationRequest} or an equivalent Hash.
|
186
|
+
#
|
187
|
+
# @param request [Google::Longrunning::GetOperationRequest, Hash]
|
188
|
+
# A request object representing the call parameters. Required. To specify no
|
189
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
189
190
|
# @param options [Gapic::CallOptions, Hash]
|
190
191
|
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
191
192
|
#
|
192
193
|
# @overload get_operation(name: nil)
|
194
|
+
# Pass arguments to `get_operation` via keyword arguments. Note that at
|
195
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
196
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
197
|
+
#
|
193
198
|
# @param name [String]
|
194
199
|
# The name of the operation resource.
|
195
200
|
#
|
196
|
-
#
|
197
201
|
# @yield [response, operation] Access the result along with the RPC operation
|
198
202
|
# @yieldparam response [Gapic::Operation]
|
199
203
|
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
@@ -247,19 +251,23 @@ module Google
|
|
247
251
|
# `google.rpc.Code.UNIMPLEMENTED`.
|
248
252
|
#
|
249
253
|
# @overload delete_operation(request, options = nil)
|
250
|
-
#
|
251
|
-
#
|
252
|
-
#
|
253
|
-
#
|
254
|
-
#
|
254
|
+
# Pass arguments to `delete_operation` via a request object, either of type
|
255
|
+
# {Google::Longrunning::DeleteOperationRequest} or an equivalent Hash.
|
256
|
+
#
|
257
|
+
# @param request [Google::Longrunning::DeleteOperationRequest, Hash]
|
258
|
+
# A request object representing the call parameters. Required. To specify no
|
259
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
255
260
|
# @param options [Gapic::CallOptions, Hash]
|
256
261
|
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
257
262
|
#
|
258
263
|
# @overload delete_operation(name: nil)
|
264
|
+
# Pass arguments to `delete_operation` via keyword arguments. Note that at
|
265
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
266
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
267
|
+
#
|
259
268
|
# @param name [String]
|
260
269
|
# The name of the operation resource to be deleted.
|
261
270
|
#
|
262
|
-
#
|
263
271
|
# @yield [response, operation] Access the result along with the RPC operation
|
264
272
|
# @yieldparam response [Google::Protobuf::Empty]
|
265
273
|
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
@@ -318,25 +326,23 @@ module Google
|
|
318
326
|
# corresponding to `Code.CANCELLED`.
|
319
327
|
#
|
320
328
|
# @overload cancel_operation(request, options = nil)
|
321
|
-
#
|
322
|
-
#
|
323
|
-
#
|
324
|
-
#
|
325
|
-
#
|
326
|
-
#
|
327
|
-
# other methods to check whether the cancellation succeeded or whether the
|
328
|
-
# operation completed despite cancellation. On successful cancellation,
|
329
|
-
# the operation is not deleted; instead, it becomes an operation with
|
330
|
-
# an {Google::Longrunning::Operation#error Operation.error} value with a {Google::Rpc::Status#code google.rpc.Status.code} of 1,
|
331
|
-
# corresponding to `Code.CANCELLED`.
|
329
|
+
# Pass arguments to `cancel_operation` via a request object, either of type
|
330
|
+
# {Google::Longrunning::CancelOperationRequest} or an equivalent Hash.
|
331
|
+
#
|
332
|
+
# @param request [Google::Longrunning::CancelOperationRequest, Hash]
|
333
|
+
# A request object representing the call parameters. Required. To specify no
|
334
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
332
335
|
# @param options [Gapic::CallOptions, Hash]
|
333
336
|
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
334
337
|
#
|
335
338
|
# @overload cancel_operation(name: nil)
|
339
|
+
# Pass arguments to `cancel_operation` via keyword arguments. Note that at
|
340
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
341
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
342
|
+
#
|
336
343
|
# @param name [String]
|
337
344
|
# The name of the operation resource to be cancelled.
|
338
345
|
#
|
339
|
-
#
|
340
346
|
# @yield [response, operation] Access the result along with the RPC operation
|
341
347
|
# @yieldparam response [Google::Protobuf::Empty]
|
342
348
|
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
@@ -24,40 +24,79 @@ module Google
|
|
24
24
|
# specify access control policies for Cloud Platform resources.
|
25
25
|
#
|
26
26
|
#
|
27
|
-
# A `Policy`
|
28
|
-
# `members` to a `role
|
29
|
-
# Google
|
30
|
-
# defined by IAM.
|
27
|
+
# A `Policy` is a collection of `bindings`. A `binding` binds one or more
|
28
|
+
# `members` to a single `role`. Members can be user accounts, service accounts,
|
29
|
+
# Google groups, and domains (such as G Suite). A `role` is a named list of
|
30
|
+
# permissions (defined by IAM or configured by users). A `binding` can
|
31
|
+
# optionally specify a `condition`, which is a logic expression that further
|
32
|
+
# constrains the role binding based on attributes about the request and/or
|
33
|
+
# target resource.
|
31
34
|
#
|
32
|
-
# **Example**
|
35
|
+
# **JSON Example**
|
33
36
|
#
|
34
37
|
# {
|
35
38
|
# "bindings": [
|
36
39
|
# {
|
37
|
-
# "role": "roles/
|
40
|
+
# "role": "roles/resourcemanager.organizationAdmin",
|
38
41
|
# "members": [
|
39
42
|
# "user:mike@example.com",
|
40
43
|
# "group:admins@example.com",
|
41
44
|
# "domain:google.com",
|
42
|
-
# "serviceAccount:my-
|
45
|
+
# "serviceAccount:my-project-id@appspot.gserviceaccount.com"
|
43
46
|
# ]
|
44
47
|
# },
|
45
48
|
# {
|
46
|
-
# "role": "roles/
|
47
|
-
# "members": ["user:
|
49
|
+
# "role": "roles/resourcemanager.organizationViewer",
|
50
|
+
# "members": ["user:eve@example.com"],
|
51
|
+
# "condition": {
|
52
|
+
# "title": "expirable access",
|
53
|
+
# "description": "Does not grant access after Sep 2020",
|
54
|
+
# "expression": "request.time <
|
55
|
+
# timestamp('2020-10-01T00:00:00.000Z')",
|
56
|
+
# }
|
48
57
|
# }
|
49
58
|
# ]
|
50
59
|
# }
|
51
60
|
#
|
61
|
+
# **YAML Example**
|
62
|
+
#
|
63
|
+
# bindings:
|
64
|
+
# - members:
|
65
|
+
# - user:mike@example.com
|
66
|
+
# - group:admins@example.com
|
67
|
+
# - domain:google.com
|
68
|
+
# - serviceAccount:my-project-id@appspot.gserviceaccount.com
|
69
|
+
# role: roles/resourcemanager.organizationAdmin
|
70
|
+
# - members:
|
71
|
+
# - user:eve@example.com
|
72
|
+
# role: roles/resourcemanager.organizationViewer
|
73
|
+
# condition:
|
74
|
+
# title: expirable access
|
75
|
+
# description: Does not grant access after Sep 2020
|
76
|
+
# expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
|
77
|
+
#
|
52
78
|
# For a description of IAM and its features, see the
|
53
|
-
# [IAM developer's guide](https://cloud.google.com/iam).
|
79
|
+
# [IAM developer's guide](https://cloud.google.com/iam/docs).
|
54
80
|
# @!attribute [rw] version
|
55
81
|
# @return [Integer]
|
56
|
-
#
|
82
|
+
# Specifies the format of the policy.
|
83
|
+
#
|
84
|
+
# Valid values are 0, 1, and 3. Requests specifying an invalid value will be
|
85
|
+
# rejected.
|
86
|
+
#
|
87
|
+
# Operations affecting conditional bindings must specify version 3. This can
|
88
|
+
# be either setting a conditional policy, modifying a conditional binding,
|
89
|
+
# or removing a binding (conditional or unconditional) from the stored
|
90
|
+
# conditional policy.
|
91
|
+
# Operations on non-conditional policies may specify any valid value or
|
92
|
+
# leave the field unset.
|
93
|
+
#
|
94
|
+
# If no etag is provided in the call to `setIamPolicy`, version compliance
|
95
|
+
# checks against the stored policy is skipped.
|
57
96
|
# @!attribute [rw] bindings
|
58
97
|
# @return [Array<Google::Iam::V1::Binding>]
|
59
|
-
# Associates a list of `members` to a `role`.
|
60
|
-
#
|
98
|
+
# Associates a list of `members` to a `role`. Optionally may specify a
|
99
|
+
# `condition` that determines when binding is in effect.
|
61
100
|
# `bindings` with no members will result in an error.
|
62
101
|
# @!attribute [rw] etag
|
63
102
|
# @return [String]
|
@@ -70,7 +109,9 @@ module Google
|
|
70
109
|
# ensure that their change will be applied to the same version of the policy.
|
71
110
|
#
|
72
111
|
# If no `etag` is provided in the call to `setIamPolicy`, then the existing
|
73
|
-
# policy is overwritten
|
112
|
+
# policy is overwritten. Due to blind-set semantics of an etag-less policy,
|
113
|
+
# 'setIamPolicy' will not fail even if the incoming policy version does not
|
114
|
+
# meet the requirements for modifying the stored policy.
|
74
115
|
class Policy
|
75
116
|
include Google::Protobuf::MessageExts
|
76
117
|
extend Google::Protobuf::MessageExts::ClassMethods
|
@@ -81,7 +122,6 @@ module Google
|
|
81
122
|
# @return [String]
|
82
123
|
# Role that is assigned to `members`.
|
83
124
|
# For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
|
84
|
-
# Required
|
85
125
|
# @!attribute [rw] members
|
86
126
|
# @return [Array<String>]
|
87
127
|
# Specifies the identities requesting access for a Cloud Platform resource.
|
@@ -94,7 +134,7 @@ module Google
|
|
94
134
|
# who is authenticated with a Google account or a service account.
|
95
135
|
#
|
96
136
|
# * `user:{emailid}`: An email address that represents a specific Google
|
97
|
-
# account. For example, `alice@
|
137
|
+
# account. For example, `alice@example.com` .
|
98
138
|
#
|
99
139
|
#
|
100
140
|
# * `serviceAccount:{emailid}`: An email address that represents a service
|
@@ -103,8 +143,15 @@ module Google
|
|
103
143
|
# * `group:{emailid}`: An email address that represents a Google group.
|
104
144
|
# For example, `admins@example.com`.
|
105
145
|
#
|
106
|
-
#
|
146
|
+
#
|
147
|
+
# * `domain:{domain}`: The G Suite domain (primary) that represents all the
|
107
148
|
# users of that domain. For example, `google.com` or `example.com`.
|
149
|
+
# @!attribute [rw] condition
|
150
|
+
# @return [Google::Type::Expr]
|
151
|
+
# The condition that is associated with this binding.
|
152
|
+
# NOTE: An unsatisfied condition will not allow user access via current
|
153
|
+
# binding. Different bindings, including their conditions, are examined
|
154
|
+
# independently.
|
108
155
|
class Binding
|
109
156
|
include Google::Protobuf::MessageExts
|
110
157
|
extend Google::Protobuf::MessageExts::ClassMethods
|
@@ -114,6 +161,9 @@ module Google
|
|
114
161
|
# @!attribute [rw] binding_deltas
|
115
162
|
# @return [Array<Google::Iam::V1::BindingDelta>]
|
116
163
|
# The delta for Bindings between two policies.
|
164
|
+
# @!attribute [rw] audit_config_deltas
|
165
|
+
# @return [Array<Google::Iam::V1::AuditConfigDelta>]
|
166
|
+
# The delta for AuditConfigs between two policies.
|
117
167
|
class PolicyDelta
|
118
168
|
include Google::Protobuf::MessageExts
|
119
169
|
extend Google::Protobuf::MessageExts::ClassMethods
|
@@ -135,6 +185,9 @@ module Google
|
|
135
185
|
# A single identity requesting access for a Cloud Platform resource.
|
136
186
|
# Follows the same format of Binding.members.
|
137
187
|
# Required
|
188
|
+
# @!attribute [rw] condition
|
189
|
+
# @return [Google::Type::Expr]
|
190
|
+
# The condition that is associated with this binding.
|
138
191
|
class BindingDelta
|
139
192
|
include Google::Protobuf::MessageExts
|
140
193
|
extend Google::Protobuf::MessageExts::ClassMethods
|
@@ -151,6 +204,45 @@ module Google
|
|
151
204
|
REMOVE = 2
|
152
205
|
end
|
153
206
|
end
|
207
|
+
|
208
|
+
# One delta entry for AuditConfig. Each individual change (only one
|
209
|
+
# exempted_member in each entry) to a AuditConfig will be a separate entry.
|
210
|
+
# @!attribute [rw] action
|
211
|
+
# @return [Google::Iam::V1::AuditConfigDelta::Action]
|
212
|
+
# The action that was performed on an audit configuration in a policy.
|
213
|
+
# Required
|
214
|
+
# @!attribute [rw] service
|
215
|
+
# @return [String]
|
216
|
+
# Specifies a service that was configured for Cloud Audit Logging.
|
217
|
+
# For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
|
218
|
+
# `allServices` is a special value that covers all services.
|
219
|
+
# Required
|
220
|
+
# @!attribute [rw] exempted_member
|
221
|
+
# @return [String]
|
222
|
+
# A single identity that is exempted from "data access" audit
|
223
|
+
# logging for the `service` specified above.
|
224
|
+
# Follows the same format of Binding.members.
|
225
|
+
# @!attribute [rw] log_type
|
226
|
+
# @return [String]
|
227
|
+
# Specifies the log_type that was be enabled. ADMIN_ACTIVITY is always
|
228
|
+
# enabled, and cannot be configured.
|
229
|
+
# Required
|
230
|
+
class AuditConfigDelta
|
231
|
+
include Google::Protobuf::MessageExts
|
232
|
+
extend Google::Protobuf::MessageExts::ClassMethods
|
233
|
+
|
234
|
+
# The type of action performed on an audit configuration in a policy.
|
235
|
+
module Action
|
236
|
+
# Unspecified.
|
237
|
+
ACTION_UNSPECIFIED = 0
|
238
|
+
|
239
|
+
# Addition of an audit configuration.
|
240
|
+
ADD = 1
|
241
|
+
|
242
|
+
# Removal of an audit configuration.
|
243
|
+
REMOVE = 2
|
244
|
+
end
|
245
|
+
end
|
154
246
|
end
|
155
247
|
end
|
156
248
|
end
|
@@ -0,0 +1,52 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
# Copyright 2020 Google LLC
|
4
|
+
#
|
5
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
6
|
+
# you may not use this file except in compliance with the License.
|
7
|
+
# You may obtain a copy of the License at
|
8
|
+
#
|
9
|
+
# https://www.apache.org/licenses/LICENSE-2.0
|
10
|
+
#
|
11
|
+
# Unless required by applicable law or agreed to in writing, software
|
12
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
13
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
14
|
+
# See the License for the specific language governing permissions and
|
15
|
+
# limitations under the License.
|
16
|
+
|
17
|
+
# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
|
18
|
+
|
19
|
+
|
20
|
+
module Google
|
21
|
+
module Type
|
22
|
+
# Represents an expression text. Example:
|
23
|
+
#
|
24
|
+
# title: "User account presence"
|
25
|
+
# description: "Determines whether the request has a user account"
|
26
|
+
# expression: "size(request.user) > 0"
|
27
|
+
# @!attribute [rw] expression
|
28
|
+
# @return [String]
|
29
|
+
# Textual representation of an expression in
|
30
|
+
# Common Expression Language syntax.
|
31
|
+
#
|
32
|
+
# The application context of the containing message determines which
|
33
|
+
# well-known feature set of CEL is supported.
|
34
|
+
# @!attribute [rw] title
|
35
|
+
# @return [String]
|
36
|
+
# An optional title for the expression, i.e. a short string describing
|
37
|
+
# its purpose. This can be used e.g. in UIs which allow to enter the
|
38
|
+
# expression.
|
39
|
+
# @!attribute [rw] description
|
40
|
+
# @return [String]
|
41
|
+
# An optional description of the expression. This is a longer text which
|
42
|
+
# describes the expression, e.g. when hovered over it in a UI.
|
43
|
+
# @!attribute [rw] location
|
44
|
+
# @return [String]
|
45
|
+
# An optional string indicating the location of the expression for error
|
46
|
+
# reporting, e.g. a file name and a position in the file.
|
47
|
+
class Expr
|
48
|
+
include Google::Protobuf::MessageExts
|
49
|
+
extend Google::Protobuf::MessageExts::ClassMethods
|
50
|
+
end
|
51
|
+
end
|
52
|
+
end
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: google-cloud-asset-v1beta1
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.1.
|
4
|
+
version: 0.1.2
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Google LLC
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date: 2020-04-
|
11
|
+
date: 2020-04-13 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: gapic-common
|
@@ -42,16 +42,22 @@ dependencies:
|
|
42
42
|
name: grpc-google-iam-v1
|
43
43
|
requirement: !ruby/object:Gem::Requirement
|
44
44
|
requirements:
|
45
|
-
- - "
|
45
|
+
- - ">="
|
46
|
+
- !ruby/object:Gem::Version
|
47
|
+
version: 0.6.10
|
48
|
+
- - "<"
|
46
49
|
- !ruby/object:Gem::Version
|
47
|
-
version: 0
|
50
|
+
version: '2.0'
|
48
51
|
type: :runtime
|
49
52
|
prerelease: false
|
50
53
|
version_requirements: !ruby/object:Gem::Requirement
|
51
54
|
requirements:
|
52
|
-
- - "
|
55
|
+
- - ">="
|
56
|
+
- !ruby/object:Gem::Version
|
57
|
+
version: 0.6.10
|
58
|
+
- - "<"
|
53
59
|
- !ruby/object:Gem::Version
|
54
|
-
version: 0
|
60
|
+
version: '2.0'
|
55
61
|
- !ruby/object:Gem::Dependency
|
56
62
|
name: google-style
|
57
63
|
requirement: !ruby/object:Gem::Requirement
|
@@ -172,6 +178,7 @@ files:
|
|
172
178
|
- proto_docs/google/protobuf/struct.rb
|
173
179
|
- proto_docs/google/protobuf/timestamp.rb
|
174
180
|
- proto_docs/google/rpc/status.rb
|
181
|
+
- proto_docs/google/type/expr.rb
|
175
182
|
homepage: https://github.com/googleapis/google-cloud-ruby
|
176
183
|
licenses:
|
177
184
|
- Apache-2.0
|