google-cloud-billing-v1 0.3.1 → 0.4.0
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/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:
|