google-cloud-billing-v1 0.3.1 → 0.4.0
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/billing/v1/cloud_billing/client.rb +112 -122
- data/lib/google/cloud/billing/v1/cloud_billing.rb +30 -1
- data/lib/google/cloud/billing/v1/cloud_catalog/client.rb +22 -25
- data/lib/google/cloud/billing/v1/cloud_catalog.rb +32 -1
- data/lib/google/cloud/billing/v1/version.rb +1 -1
- data/lib/google/cloud/billing/v1.rb +16 -0
- data/lib/google-cloud-billing-v1.rb +21 -1
- data/proto_docs/google/iam/v1/iam_policy.rb +7 -6
- data/proto_docs/google/iam/v1/options.rb +40 -0
- data/proto_docs/google/iam/v1/policy.rb +109 -17
- data/proto_docs/google/type/expr.rb +52 -0
- metadata +14 -6
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 51a5fee4769dcdbc3bec23725feb7ef0699e4751fa0780e80a99448dc91184d2
|
4
|
+
data.tar.gz: 7fa3b0689fe1fbda27eee3e7837766a25f67dceca4f53fa2b3c35f97250e0a69
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: b68ed50284f329084142d03ec5f73efef6d651f2c22df1e9cd9ffdeeb228517c911a8c5aa21a7ad851cdfd10b2fe3755bba83b0754dd2f9ea4e5e868c16d2b57
|
7
|
+
data.tar.gz: 6f83a4a319b07f9f44d24e5c29e743fe10233275f5bf96ea6ac143a6159e6069672e9fe3730264db900308568f88101cbfb2157e258447154ded400fb3037a2c
|
data/README.md
CHANGED
@@ -1,4 +1,4 @@
|
|
1
|
-
# Billing V1
|
1
|
+
# Ruby Client for the Billing V1 API
|
2
2
|
|
3
3
|
API Client library for the Billing V1 API
|
4
4
|
|
@@ -12,6 +12,53 @@ https://github.com/googleapis/google-cloud-ruby
|
|
12
12
|
$ gem install google-cloud-billing-v1
|
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/billing/v1"
|
27
|
+
|
28
|
+
client = Google::Cloud::Billing::V1::CloudBilling::Client.new
|
29
|
+
request = my_create_request
|
30
|
+
response = client.get_billing_account request
|
31
|
+
```
|
32
|
+
|
33
|
+
View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-billing-v1/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+.
|
@@ -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/billing/v1/version"
|
25
20
|
require "google/cloud/billing/v1/cloud_billing_pb"
|
26
|
-
require "google/cloud/billing/v1/cloud_billing/credentials"
|
27
|
-
require "google/cloud/billing/v1/cloud_billing/paths"
|
28
21
|
|
29
22
|
module Google
|
30
23
|
module Cloud
|
@@ -230,19 +223,24 @@ module Google
|
|
230
223
|
# account](https://cloud.google.com/billing/docs/how-to/billing-access).
|
231
224
|
#
|
232
225
|
# @overload get_billing_account(request, options = nil)
|
233
|
-
#
|
234
|
-
#
|
235
|
-
#
|
236
|
-
#
|
226
|
+
# Pass arguments to `get_billing_account` via a request object, either of type
|
227
|
+
# {Google::Cloud::Billing::V1::GetBillingAccountRequest} or an equivalent Hash.
|
228
|
+
#
|
229
|
+
# @param request [Google::Cloud::Billing::V1::GetBillingAccountRequest, Hash]
|
230
|
+
# A request object representing the call parameters. Required. To specify no
|
231
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
237
232
|
# @param options [Gapic::CallOptions, Hash]
|
238
233
|
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
239
234
|
#
|
240
235
|
# @overload get_billing_account(name: nil)
|
236
|
+
# Pass arguments to `get_billing_account` via keyword arguments. Note that at
|
237
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
238
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
239
|
+
#
|
241
240
|
# @param name [String]
|
242
241
|
# Required. The resource name of the billing account to retrieve. For example,
|
243
242
|
# `billingAccounts/012345-567890-ABCDEF`.
|
244
243
|
#
|
245
|
-
#
|
246
244
|
# @yield [response, operation] Access the result along with the RPC operation
|
247
245
|
# @yieldparam response [Google::Cloud::Billing::V1::BillingAccount]
|
248
246
|
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
@@ -294,14 +292,20 @@ module Google
|
|
294
292
|
# [view](https://cloud.google.com/billing/docs/how-to/billing-access).
|
295
293
|
#
|
296
294
|
# @overload list_billing_accounts(request, options = nil)
|
297
|
-
#
|
298
|
-
#
|
299
|
-
#
|
300
|
-
#
|
295
|
+
# Pass arguments to `list_billing_accounts` via a request object, either of type
|
296
|
+
# {Google::Cloud::Billing::V1::ListBillingAccountsRequest} or an equivalent Hash.
|
297
|
+
#
|
298
|
+
# @param request [Google::Cloud::Billing::V1::ListBillingAccountsRequest, Hash]
|
299
|
+
# A request object representing the call parameters. Required. To specify no
|
300
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
301
301
|
# @param options [Gapic::CallOptions, Hash]
|
302
302
|
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
303
303
|
#
|
304
304
|
# @overload list_billing_accounts(page_size: nil, page_token: nil, filter: nil)
|
305
|
+
# Pass arguments to `list_billing_accounts` via keyword arguments. Note that at
|
306
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
307
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
308
|
+
#
|
305
309
|
# @param page_size [Integer]
|
306
310
|
# Requested page size. The maximum page size is 100; this is also the
|
307
311
|
# default.
|
@@ -317,7 +321,6 @@ module Google
|
|
317
321
|
# (e.g. "master_billing_account=billingAccounts/012345-678901-ABCDEF").
|
318
322
|
# Boolean algebra and other fields are not currently supported.
|
319
323
|
#
|
320
|
-
#
|
321
324
|
# @yield [response, operation] Access the result along with the RPC operation
|
322
325
|
# @yieldparam response [Gapic::PagedEnumerable<Google::Cloud::Billing::V1::BillingAccount>]
|
323
326
|
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
@@ -367,26 +370,28 @@ module Google
|
|
367
370
|
# of the billing account.
|
368
371
|
#
|
369
372
|
# @overload update_billing_account(request, options = nil)
|
370
|
-
#
|
371
|
-
#
|
372
|
-
#
|
373
|
-
#
|
374
|
-
#
|
375
|
-
#
|
376
|
-
# of the billing account.
|
373
|
+
# Pass arguments to `update_billing_account` via a request object, either of type
|
374
|
+
# {Google::Cloud::Billing::V1::UpdateBillingAccountRequest} or an equivalent Hash.
|
375
|
+
#
|
376
|
+
# @param request [Google::Cloud::Billing::V1::UpdateBillingAccountRequest, Hash]
|
377
|
+
# A request object representing the call parameters. Required. To specify no
|
378
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
377
379
|
# @param options [Gapic::CallOptions, Hash]
|
378
380
|
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
379
381
|
#
|
380
382
|
# @overload update_billing_account(name: nil, account: nil, update_mask: nil)
|
383
|
+
# Pass arguments to `update_billing_account` via keyword arguments. Note that at
|
384
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
385
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
386
|
+
#
|
381
387
|
# @param name [String]
|
382
388
|
# Required. The name of the billing account resource to be updated.
|
383
|
-
# @param account [Google::Cloud::Billing::V1::BillingAccount
|
389
|
+
# @param account [Google::Cloud::Billing::V1::BillingAccount, Hash]
|
384
390
|
# Required. The billing account resource to replace the resource on the server.
|
385
|
-
# @param update_mask [Google::Protobuf::FieldMask
|
391
|
+
# @param update_mask [Google::Protobuf::FieldMask, Hash]
|
386
392
|
# The update mask applied to the resource.
|
387
393
|
# Only "display_name" is currently supported.
|
388
394
|
#
|
389
|
-
#
|
390
395
|
# @yield [response, operation] Access the result along with the RPC operation
|
391
396
|
# @yieldparam response [Google::Cloud::Billing::V1::BillingAccount]
|
392
397
|
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
@@ -445,28 +450,26 @@ module Google
|
|
445
450
|
# provisioned as a reseller account.
|
446
451
|
#
|
447
452
|
# @overload create_billing_account(request, options = nil)
|
448
|
-
#
|
449
|
-
#
|
450
|
-
#
|
451
|
-
#
|
452
|
-
#
|
453
|
-
#
|
454
|
-
# `billing.accounts.update` IAM permission on the master account, which is
|
455
|
-
# typically given to billing account
|
456
|
-
# [administrators](https://cloud.google.com/billing/docs/how-to/billing-access).
|
457
|
-
# This method will return an error if the master account has not been
|
458
|
-
# provisioned as a reseller account.
|
453
|
+
# Pass arguments to `create_billing_account` via a request object, either of type
|
454
|
+
# {Google::Cloud::Billing::V1::CreateBillingAccountRequest} or an equivalent Hash.
|
455
|
+
#
|
456
|
+
# @param request [Google::Cloud::Billing::V1::CreateBillingAccountRequest, Hash]
|
457
|
+
# A request object representing the call parameters. Required. To specify no
|
458
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
459
459
|
# @param options [Gapic::CallOptions, Hash]
|
460
460
|
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
461
461
|
#
|
462
462
|
# @overload create_billing_account(billing_account: nil)
|
463
|
-
#
|
463
|
+
# Pass arguments to `create_billing_account` via keyword arguments. Note that at
|
464
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
465
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
466
|
+
#
|
467
|
+
# @param billing_account [Google::Cloud::Billing::V1::BillingAccount, Hash]
|
464
468
|
# Required. The billing account resource to create.
|
465
469
|
# Currently CreateBillingAccount only supports subaccount creation, so
|
466
470
|
# any created billing accounts must be under a provided master billing
|
467
471
|
# account.
|
468
472
|
#
|
469
|
-
#
|
470
473
|
# @yield [response, operation] Access the result along with the RPC operation
|
471
474
|
# @yieldparam response [Google::Cloud::Billing::V1::BillingAccount]
|
472
475
|
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
@@ -513,15 +516,20 @@ module Google
|
|
513
516
|
# [viewers](https://cloud.google.com/billing/docs/how-to/billing-access).
|
514
517
|
#
|
515
518
|
# @overload list_project_billing_info(request, options = nil)
|
516
|
-
#
|
517
|
-
#
|
518
|
-
#
|
519
|
-
#
|
520
|
-
#
|
519
|
+
# Pass arguments to `list_project_billing_info` via a request object, either of type
|
520
|
+
# {Google::Cloud::Billing::V1::ListProjectBillingInfoRequest} or an equivalent Hash.
|
521
|
+
#
|
522
|
+
# @param request [Google::Cloud::Billing::V1::ListProjectBillingInfoRequest, Hash]
|
523
|
+
# A request object representing the call parameters. Required. To specify no
|
524
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
521
525
|
# @param options [Gapic::CallOptions, Hash]
|
522
526
|
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
523
527
|
#
|
524
528
|
# @overload list_project_billing_info(name: nil, page_size: nil, page_token: nil)
|
529
|
+
# Pass arguments to `list_project_billing_info` via keyword arguments. Note that at
|
530
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
531
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
532
|
+
#
|
525
533
|
# @param name [String]
|
526
534
|
# Required. The resource name of the billing account associated with the projects that
|
527
535
|
# you want to list. For example, `billingAccounts/012345-567890-ABCDEF`.
|
@@ -533,7 +541,6 @@ module Google
|
|
533
541
|
# `next_page_token` value returned from a previous `ListProjectBillingInfo`
|
534
542
|
# call. If unspecified, the first page of results is returned.
|
535
543
|
#
|
536
|
-
#
|
537
544
|
# @yield [response, operation] Access the result along with the RPC operation
|
538
545
|
# @yieldparam response [Gapic::PagedEnumerable<Google::Cloud::Billing::V1::ProjectBillingInfo>]
|
539
546
|
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
@@ -587,20 +594,24 @@ module Google
|
|
587
594
|
# ).
|
588
595
|
#
|
589
596
|
# @overload get_project_billing_info(request, options = nil)
|
590
|
-
#
|
591
|
-
#
|
592
|
-
#
|
593
|
-
#
|
594
|
-
#
|
597
|
+
# Pass arguments to `get_project_billing_info` via a request object, either of type
|
598
|
+
# {Google::Cloud::Billing::V1::GetProjectBillingInfoRequest} or an equivalent Hash.
|
599
|
+
#
|
600
|
+
# @param request [Google::Cloud::Billing::V1::GetProjectBillingInfoRequest, Hash]
|
601
|
+
# A request object representing the call parameters. Required. To specify no
|
602
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
595
603
|
# @param options [Gapic::CallOptions, Hash]
|
596
604
|
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
597
605
|
#
|
598
606
|
# @overload get_project_billing_info(name: nil)
|
607
|
+
# Pass arguments to `get_project_billing_info` via keyword arguments. Note that at
|
608
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
609
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
610
|
+
#
|
599
611
|
# @param name [String]
|
600
612
|
# Required. The resource name of the project for which billing information is
|
601
613
|
# retrieved. For example, `projects/tokyo-rain-123`.
|
602
614
|
#
|
603
|
-
#
|
604
615
|
# @yield [response, operation] Access the result along with the RPC operation
|
605
616
|
# @yieldparam response [Google::Cloud::Billing::V1::ProjectBillingInfo]
|
606
617
|
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
@@ -680,50 +691,27 @@ module Google
|
|
680
691
|
# *open* billing account.
|
681
692
|
#
|
682
693
|
# @overload update_project_billing_info(request, options = nil)
|
683
|
-
#
|
684
|
-
#
|
685
|
-
#
|
686
|
-
#
|
687
|
-
#
|
688
|
-
#
|
689
|
-
# billing account, this method changes the billing account used for resource
|
690
|
-
# usage charges.
|
691
|
-
#
|
692
|
-
# *Note:* Incurred charges that have not yet been reported in the transaction
|
693
|
-
# history of the GCP Console might be billed to the new billing
|
694
|
-
# account, even if the charge occurred before the new billing account was
|
695
|
-
# assigned to the project.
|
696
|
-
#
|
697
|
-
# The current authenticated user must have ownership privileges for both the
|
698
|
-
# [project](https://cloud.google.com/docs/permissions-overview#h.bgs0oxofvnoo
|
699
|
-
# ) and the [billing
|
700
|
-
# account](https://cloud.google.com/billing/docs/how-to/billing-access).
|
701
|
-
#
|
702
|
-
# You can disable billing on the project by setting the
|
703
|
-
# `billing_account_name` field to empty. This action disassociates the
|
704
|
-
# current billing account from the project. Any billable activity of your
|
705
|
-
# in-use services will stop, and your application could stop functioning as
|
706
|
-
# expected. Any unbilled charges to date will be billed to the previously
|
707
|
-
# associated account. The current authenticated user must be either an owner
|
708
|
-
# of the project or an owner of the billing account for the project.
|
709
|
-
#
|
710
|
-
# Note that associating a project with a *closed* billing account will have
|
711
|
-
# much the same effect as disabling billing on the project: any paid
|
712
|
-
# resources used by the project will be shut down. Thus, unless you wish to
|
713
|
-
# disable billing, you should always call this method with the name of an
|
714
|
-
# *open* billing account.
|
694
|
+
# Pass arguments to `update_project_billing_info` via a request object, either of type
|
695
|
+
# {Google::Cloud::Billing::V1::UpdateProjectBillingInfoRequest} or an equivalent Hash.
|
696
|
+
#
|
697
|
+
# @param request [Google::Cloud::Billing::V1::UpdateProjectBillingInfoRequest, Hash]
|
698
|
+
# A request object representing the call parameters. Required. To specify no
|
699
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
715
700
|
# @param options [Gapic::CallOptions, Hash]
|
716
701
|
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
717
702
|
#
|
718
703
|
# @overload update_project_billing_info(name: nil, project_billing_info: nil)
|
704
|
+
# Pass arguments to `update_project_billing_info` via keyword arguments. Note that at
|
705
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
706
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
707
|
+
#
|
719
708
|
# @param name [String]
|
720
709
|
# Required. The resource name of the project associated with the billing information
|
721
710
|
# that you want to update. For example, `projects/tokyo-rain-123`.
|
722
|
-
# @param project_billing_info [Google::Cloud::Billing::V1::ProjectBillingInfo
|
711
|
+
# @param project_billing_info [Google::Cloud::Billing::V1::ProjectBillingInfo, Hash]
|
723
712
|
# The new billing information for the project. Read-only fields are ignored;
|
724
713
|
# thus, you can leave empty all fields except `billing_account_name`.
|
725
714
|
#
|
726
|
-
#
|
727
715
|
# @yield [response, operation] Access the result along with the RPC operation
|
728
716
|
# @yieldparam response [Google::Cloud::Billing::V1::ProjectBillingInfo]
|
729
717
|
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
@@ -776,20 +764,26 @@ module Google
|
|
776
764
|
# [viewers](https://cloud.google.com/billing/docs/how-to/billing-access).
|
777
765
|
#
|
778
766
|
# @overload get_iam_policy(request, options = nil)
|
779
|
-
#
|
780
|
-
#
|
781
|
-
#
|
782
|
-
#
|
783
|
-
#
|
767
|
+
# Pass arguments to `get_iam_policy` via a request object, either of type
|
768
|
+
# {Google::Iam::V1::GetIamPolicyRequest} or an equivalent Hash.
|
769
|
+
#
|
770
|
+
# @param request [Google::Iam::V1::GetIamPolicyRequest, Hash]
|
771
|
+
# A request object representing the call parameters. Required. To specify no
|
772
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
784
773
|
# @param options [Gapic::CallOptions, Hash]
|
785
774
|
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
786
775
|
#
|
787
|
-
# @overload get_iam_policy(resource: nil)
|
776
|
+
# @overload get_iam_policy(resource: nil, options: nil)
|
777
|
+
# Pass arguments to `get_iam_policy` via keyword arguments. Note that at
|
778
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
779
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
780
|
+
#
|
788
781
|
# @param resource [String]
|
789
782
|
# REQUIRED: The resource for which the policy is being requested.
|
790
|
-
#
|
791
|
-
#
|
792
|
-
#
|
783
|
+
# See the operation documentation for the appropriate value for this field.
|
784
|
+
# @param options [Google::Iam::V1::GetPolicyOptions, Hash]
|
785
|
+
# OPTIONAL: A `GetPolicyOptions` object for specifying options to
|
786
|
+
# `GetIamPolicy`. This field is only used by Cloud IAM.
|
793
787
|
#
|
794
788
|
# @yield [response, operation] Access the result along with the RPC operation
|
795
789
|
# @yieldparam response [Google::Iam::V1::Policy]
|
@@ -844,27 +838,29 @@ module Google
|
|
844
838
|
# [administrators](https://cloud.google.com/billing/docs/how-to/billing-access).
|
845
839
|
#
|
846
840
|
# @overload set_iam_policy(request, options = nil)
|
847
|
-
#
|
848
|
-
#
|
849
|
-
#
|
850
|
-
#
|
851
|
-
#
|
852
|
-
#
|
841
|
+
# Pass arguments to `set_iam_policy` via a request object, either of type
|
842
|
+
# {Google::Iam::V1::SetIamPolicyRequest} or an equivalent Hash.
|
843
|
+
#
|
844
|
+
# @param request [Google::Iam::V1::SetIamPolicyRequest, Hash]
|
845
|
+
# A request object representing the call parameters. Required. To specify no
|
846
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
853
847
|
# @param options [Gapic::CallOptions, Hash]
|
854
848
|
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
855
849
|
#
|
856
850
|
# @overload set_iam_policy(resource: nil, policy: nil)
|
851
|
+
# Pass arguments to `set_iam_policy` via keyword arguments. Note that at
|
852
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
853
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
854
|
+
#
|
857
855
|
# @param resource [String]
|
858
856
|
# REQUIRED: The resource for which the policy is being specified.
|
859
|
-
#
|
860
|
-
#
|
861
|
-
# @param policy [Google::Iam::V1::Policy | Hash]
|
857
|
+
# See the operation documentation for the appropriate value for this field.
|
858
|
+
# @param policy [Google::Iam::V1::Policy, Hash]
|
862
859
|
# REQUIRED: The complete policy to be applied to the `resource`. The size of
|
863
860
|
# the policy is limited to a few 10s of KB. An empty policy is a
|
864
861
|
# valid policy but certain Cloud Platform services (such as Projects)
|
865
862
|
# might reject them.
|
866
863
|
#
|
867
|
-
#
|
868
864
|
# @yield [response, operation] Access the result along with the RPC operation
|
869
865
|
# @yieldparam response [Google::Iam::V1::Policy]
|
870
866
|
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
@@ -916,25 +912,29 @@ module Google
|
|
916
912
|
# the input permissions that the caller is allowed for that resource.
|
917
913
|
#
|
918
914
|
# @overload test_iam_permissions(request, options = nil)
|
919
|
-
#
|
920
|
-
#
|
921
|
-
#
|
922
|
-
#
|
915
|
+
# Pass arguments to `test_iam_permissions` via a request object, either of type
|
916
|
+
# {Google::Iam::V1::TestIamPermissionsRequest} or an equivalent Hash.
|
917
|
+
#
|
918
|
+
# @param request [Google::Iam::V1::TestIamPermissionsRequest, Hash]
|
919
|
+
# A request object representing the call parameters. Required. To specify no
|
920
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
923
921
|
# @param options [Gapic::CallOptions, Hash]
|
924
922
|
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
925
923
|
#
|
926
924
|
# @overload test_iam_permissions(resource: nil, permissions: nil)
|
925
|
+
# Pass arguments to `test_iam_permissions` via keyword arguments. Note that at
|
926
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
927
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
928
|
+
#
|
927
929
|
# @param resource [String]
|
928
930
|
# REQUIRED: The resource for which the policy detail is being requested.
|
929
|
-
#
|
930
|
-
# resource is specified as `projects/{project}`.
|
931
|
+
# See the operation documentation for the appropriate value for this field.
|
931
932
|
# @param permissions [Array<String>]
|
932
933
|
# The set of permissions to check for the `resource`. Permissions with
|
933
934
|
# wildcards (such as '*' or 'storage.*') are not allowed. For more
|
934
935
|
# information see
|
935
936
|
# [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
|
936
937
|
#
|
937
|
-
#
|
938
938
|
# @yield [response, operation] Access the result along with the RPC operation
|
939
939
|
# @yieldparam response [Google::Iam::V1::TestIamPermissionsResponse]
|
940
940
|
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
@@ -1196,13 +1196,3 @@ module Google
|
|
1196
1196
|
end
|
1197
1197
|
end
|
1198
1198
|
end
|
1199
|
-
|
1200
|
-
# rubocop:disable Lint/HandleExceptions
|
1201
|
-
|
1202
|
-
# Once client is loaded, load helpers.rb if it exists.
|
1203
|
-
begin
|
1204
|
-
require "google/cloud/billing/v1/cloud_billing/helpers"
|
1205
|
-
rescue LoadError
|
1206
|
-
end
|
1207
|
-
|
1208
|
-
# rubocop:enable Lint/HandleExceptions
|
@@ -16,5 +16,34 @@
|
|
16
16
|
|
17
17
|
# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
|
18
18
|
|
19
|
-
require "
|
19
|
+
require "gapic/common"
|
20
|
+
require "gapic/config"
|
21
|
+
require "gapic/config/method"
|
22
|
+
|
23
|
+
require "google/cloud/billing/v1/version"
|
24
|
+
|
20
25
|
require "google/cloud/billing/v1/cloud_billing/credentials"
|
26
|
+
require "google/cloud/billing/v1/cloud_billing/paths"
|
27
|
+
require "google/cloud/billing/v1/cloud_billing/client"
|
28
|
+
|
29
|
+
module Google
|
30
|
+
module Cloud
|
31
|
+
module Billing
|
32
|
+
module V1
|
33
|
+
##
|
34
|
+
# Retrieves GCP Console billing accounts and associates them with projects.
|
35
|
+
#
|
36
|
+
# To load this service and instantiate a client:
|
37
|
+
#
|
38
|
+
# require "google/cloud/billing/v1/cloud_billing"
|
39
|
+
# client = Google::Cloud::Billing::V1::CloudBilling::Client.new
|
40
|
+
#
|
41
|
+
module CloudBilling
|
42
|
+
end
|
43
|
+
end
|
44
|
+
end
|
45
|
+
end
|
46
|
+
end
|
47
|
+
|
48
|
+
helper_path = ::File.join __dir__, "cloud_billing", "helpers.rb"
|
49
|
+
require "google/cloud/billing/v1/cloud_billing/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/billing/v1/version"
|
25
20
|
require "google/cloud/billing/v1/cloud_catalog_pb"
|
26
|
-
require "google/cloud/billing/v1/cloud_catalog/credentials"
|
27
|
-
require "google/cloud/billing/v1/cloud_catalog/paths"
|
28
21
|
|
29
22
|
module Google
|
30
23
|
module Cloud
|
@@ -160,12 +153,20 @@ module Google
|
|
160
153
|
# Lists all public cloud services.
|
161
154
|
#
|
162
155
|
# @overload list_services(request, options = nil)
|
163
|
-
#
|
164
|
-
#
|
156
|
+
# Pass arguments to `list_services` via a request object, either of type
|
157
|
+
# {Google::Cloud::Billing::V1::ListServicesRequest} or an equivalent Hash.
|
158
|
+
#
|
159
|
+
# @param request [Google::Cloud::Billing::V1::ListServicesRequest, Hash]
|
160
|
+
# A request object representing the call parameters. Required. To specify no
|
161
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
165
162
|
# @param options [Gapic::CallOptions, Hash]
|
166
163
|
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
167
164
|
#
|
168
165
|
# @overload list_services(page_size: nil, page_token: nil)
|
166
|
+
# Pass arguments to `list_services` via keyword arguments. Note that at
|
167
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
168
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
169
|
+
#
|
169
170
|
# @param page_size [Integer]
|
170
171
|
# Requested page size. Defaults to 5000.
|
171
172
|
# @param page_token [String]
|
@@ -173,7 +174,6 @@ module Google
|
|
173
174
|
# `next_page_token` value returned from a previous `ListServices`
|
174
175
|
# call. If unspecified, the first page of results is returned.
|
175
176
|
#
|
176
|
-
#
|
177
177
|
# @yield [response, operation] Access the result along with the RPC operation
|
178
178
|
# @yieldparam response [Gapic::PagedEnumerable<Google::Cloud::Billing::V1::Service>]
|
179
179
|
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
@@ -218,23 +218,31 @@ module Google
|
|
218
218
|
# Lists all publicly available SKUs for a given cloud service.
|
219
219
|
#
|
220
220
|
# @overload list_skus(request, options = nil)
|
221
|
-
#
|
222
|
-
#
|
221
|
+
# Pass arguments to `list_skus` via a request object, either of type
|
222
|
+
# {Google::Cloud::Billing::V1::ListSkusRequest} or an equivalent Hash.
|
223
|
+
#
|
224
|
+
# @param request [Google::Cloud::Billing::V1::ListSkusRequest, Hash]
|
225
|
+
# A request object representing the call parameters. Required. To specify no
|
226
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
223
227
|
# @param options [Gapic::CallOptions, Hash]
|
224
228
|
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
225
229
|
#
|
226
230
|
# @overload list_skus(parent: nil, start_time: nil, end_time: nil, currency_code: nil, page_size: nil, page_token: nil)
|
231
|
+
# Pass arguments to `list_skus` via keyword arguments. Note that at
|
232
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
233
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
234
|
+
#
|
227
235
|
# @param parent [String]
|
228
236
|
# Required. The name of the service.
|
229
237
|
# Example: "services/DA34-426B-A397"
|
230
|
-
# @param start_time [Google::Protobuf::Timestamp
|
238
|
+
# @param start_time [Google::Protobuf::Timestamp, Hash]
|
231
239
|
# Optional inclusive start time of the time range for which the pricing
|
232
240
|
# versions will be returned. Timestamps in the future are not allowed.
|
233
241
|
# The time range has to be within a single calendar month in
|
234
242
|
# America/Los_Angeles timezone. Time range as a whole is optional. If not
|
235
243
|
# specified, the latest pricing will be returned (up to 12 hours old at
|
236
244
|
# most).
|
237
|
-
# @param end_time [Google::Protobuf::Timestamp
|
245
|
+
# @param end_time [Google::Protobuf::Timestamp, Hash]
|
238
246
|
# Optional exclusive end time of the time range for which the pricing
|
239
247
|
# versions will be returned. Timestamps in the future are not allowed.
|
240
248
|
# The time range has to be within a single calendar month in
|
@@ -252,7 +260,6 @@ module Google
|
|
252
260
|
# `next_page_token` value returned from a previous `ListSkus`
|
253
261
|
# call. If unspecified, the first page of results is returned.
|
254
262
|
#
|
255
|
-
#
|
256
263
|
# @yield [response, operation] Access the result along with the RPC operation
|
257
264
|
# @yieldparam response [Gapic::PagedEnumerable<Google::Cloud::Billing::V1::Sku>]
|
258
265
|
# @yieldparam operation [GRPC::ActiveCall::Operation]
|
@@ -459,13 +466,3 @@ module Google
|
|
459
466
|
end
|
460
467
|
end
|
461
468
|
end
|
462
|
-
|
463
|
-
# rubocop:disable Lint/HandleExceptions
|
464
|
-
|
465
|
-
# Once client is loaded, load helpers.rb if it exists.
|
466
|
-
begin
|
467
|
-
require "google/cloud/billing/v1/cloud_catalog/helpers"
|
468
|
-
rescue LoadError
|
469
|
-
end
|
470
|
-
|
471
|
-
# rubocop:enable Lint/HandleExceptions
|
@@ -16,5 +16,36 @@
|
|
16
16
|
|
17
17
|
# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
|
18
18
|
|
19
|
-
require "
|
19
|
+
require "gapic/common"
|
20
|
+
require "gapic/config"
|
21
|
+
require "gapic/config/method"
|
22
|
+
|
23
|
+
require "google/cloud/billing/v1/version"
|
24
|
+
|
20
25
|
require "google/cloud/billing/v1/cloud_catalog/credentials"
|
26
|
+
require "google/cloud/billing/v1/cloud_catalog/paths"
|
27
|
+
require "google/cloud/billing/v1/cloud_catalog/client"
|
28
|
+
|
29
|
+
module Google
|
30
|
+
module Cloud
|
31
|
+
module Billing
|
32
|
+
module V1
|
33
|
+
##
|
34
|
+
# A catalog of Google Cloud Platform services and SKUs.
|
35
|
+
# Provides pricing information and metadata on Google Cloud Platform services
|
36
|
+
# and SKUs.
|
37
|
+
#
|
38
|
+
# To load this service and instantiate a client:
|
39
|
+
#
|
40
|
+
# require "google/cloud/billing/v1/cloud_catalog"
|
41
|
+
# client = Google::Cloud::Billing::V1::CloudCatalog::Client.new
|
42
|
+
#
|
43
|
+
module CloudCatalog
|
44
|
+
end
|
45
|
+
end
|
46
|
+
end
|
47
|
+
end
|
48
|
+
end
|
49
|
+
|
50
|
+
helper_path = ::File.join __dir__, "cloud_catalog", "helpers.rb"
|
51
|
+
require "google/cloud/billing/v1/cloud_catalog/helpers" if ::File.file? helper_path
|
@@ -18,3 +18,19 @@
|
|
18
18
|
|
19
19
|
require "google/cloud/billing/v1/cloud_billing"
|
20
20
|
require "google/cloud/billing/v1/cloud_catalog"
|
21
|
+
require "google/cloud/billing/v1/version"
|
22
|
+
|
23
|
+
module Google
|
24
|
+
module Cloud
|
25
|
+
module Billing
|
26
|
+
##
|
27
|
+
# To load this package, including all its services, and instantiate a client:
|
28
|
+
#
|
29
|
+
# require "google/cloud/billing/v1"
|
30
|
+
# client = Google::Cloud::Billing::V1::CloudBilling::Client.new
|
31
|
+
#
|
32
|
+
module V1
|
33
|
+
end
|
34
|
+
end
|
35
|
+
end
|
36
|
+
end
|
@@ -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/billing/v1"
|
@@ -24,8 +24,7 @@ module Google
|
|
24
24
|
# @!attribute [rw] resource
|
25
25
|
# @return [String]
|
26
26
|
# REQUIRED: The resource for which the policy is being specified.
|
27
|
-
#
|
28
|
-
# resource is specified as `projects/{project}`.
|
27
|
+
# See the operation documentation for the appropriate value for this field.
|
29
28
|
# @!attribute [rw] policy
|
30
29
|
# @return [Google::Iam::V1::Policy]
|
31
30
|
# REQUIRED: The complete policy to be applied to the `resource`. The size of
|
@@ -41,8 +40,11 @@ module Google
|
|
41
40
|
# @!attribute [rw] resource
|
42
41
|
# @return [String]
|
43
42
|
# REQUIRED: The resource for which the policy is being requested.
|
44
|
-
#
|
45
|
-
#
|
43
|
+
# See the operation documentation for the appropriate value for this field.
|
44
|
+
# @!attribute [rw] options
|
45
|
+
# @return [Google::Iam::V1::GetPolicyOptions]
|
46
|
+
# OPTIONAL: A `GetPolicyOptions` object for specifying options to
|
47
|
+
# `GetIamPolicy`. This field is only used by Cloud IAM.
|
46
48
|
class GetIamPolicyRequest
|
47
49
|
include Google::Protobuf::MessageExts
|
48
50
|
extend Google::Protobuf::MessageExts::ClassMethods
|
@@ -52,8 +54,7 @@ module Google
|
|
52
54
|
# @!attribute [rw] resource
|
53
55
|
# @return [String]
|
54
56
|
# REQUIRED: The resource for which the policy detail is being requested.
|
55
|
-
#
|
56
|
-
# resource is specified as `projects/{project}`.
|
57
|
+
# See the operation documentation for the appropriate value for this field.
|
57
58
|
# @!attribute [rw] permissions
|
58
59
|
# @return [Array<String>]
|
59
60
|
# The set of permissions to check for the `resource`. Permissions with
|
@@ -0,0 +1,40 @@
|
|
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 Iam
|
22
|
+
module V1
|
23
|
+
# Encapsulates settings provided to GetIamPolicy.
|
24
|
+
# @!attribute [rw] requested_policy_version
|
25
|
+
# @return [Integer]
|
26
|
+
# Optional. The policy format version to be returned.
|
27
|
+
#
|
28
|
+
# Valid values are 0, 1, and 3. Requests specifying an invalid value will be
|
29
|
+
# rejected.
|
30
|
+
#
|
31
|
+
# Requests for policies with any conditional bindings must specify version 3.
|
32
|
+
# Policies without any conditional bindings may specify any valid value or
|
33
|
+
# leave the field unset.
|
34
|
+
class GetPolicyOptions
|
35
|
+
include Google::Protobuf::MessageExts
|
36
|
+
extend Google::Protobuf::MessageExts::ClassMethods
|
37
|
+
end
|
38
|
+
end
|
39
|
+
end
|
40
|
+
end
|
@@ -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-billing-v1
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.
|
4
|
+
version: 0.4.0
|
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
|
@@ -169,9 +175,11 @@ files:
|
|
169
175
|
- proto_docs/google/cloud/billing/v1/cloud_billing.rb
|
170
176
|
- proto_docs/google/cloud/billing/v1/cloud_catalog.rb
|
171
177
|
- proto_docs/google/iam/v1/iam_policy.rb
|
178
|
+
- proto_docs/google/iam/v1/options.rb
|
172
179
|
- proto_docs/google/iam/v1/policy.rb
|
173
180
|
- proto_docs/google/protobuf/field_mask.rb
|
174
181
|
- proto_docs/google/protobuf/timestamp.rb
|
182
|
+
- proto_docs/google/type/expr.rb
|
175
183
|
- proto_docs/google/type/money.rb
|
176
184
|
homepage: https://github.com/googleapis/google-cloud-ruby
|
177
185
|
licenses:
|