google-cloud-asset-v1beta1 0.1.1 → 0.1.2
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.
- 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
|