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 CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: f18dc523e18393c7da46035dc046b8980af102a52212ab3bdcb04b3942f43480
4
- data.tar.gz: 5d6d892ef177d401e05c1e64986cc4cfabbae39452ded78196e6f1f536afb455
3
+ metadata.gz: 51a5fee4769dcdbc3bec23725feb7ef0699e4751fa0780e80a99448dc91184d2
4
+ data.tar.gz: 7fa3b0689fe1fbda27eee3e7837766a25f67dceca4f53fa2b3c35f97250e0a69
5
5
  SHA512:
6
- metadata.gz: 4803e33adbabb9e13bfc0f88515637e0b280907a9ba08224a11f5f8ff5b80906ecfd87f107e1376270c25dd1ed146a22df91df14ea639df9acd1b212bd4e83a7
7
- data.tar.gz: d60539546cb4be05d2a337d155f25fc08e6d99200cdd5b0303e4e6d7cbadd21d4e0a73a460c6911dfa84b509435a4866c0464ee60fd0fdf4f54dde226ad4f352
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
- # @param request [Google::Cloud::Billing::V1::GetBillingAccountRequest | Hash]
234
- # Gets information about a billing account. The current authenticated user
235
- # must be a [viewer of the billing
236
- # account](https://cloud.google.com/billing/docs/how-to/billing-access).
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
- # @param request [Google::Cloud::Billing::V1::ListBillingAccountsRequest | Hash]
298
- # Lists the billing accounts that the current authenticated user has
299
- # permission to
300
- # [view](https://cloud.google.com/billing/docs/how-to/billing-access).
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
- # @param request [Google::Cloud::Billing::V1::UpdateBillingAccountRequest | Hash]
371
- # Updates a billing account's fields.
372
- # Currently the only field that can be edited is `display_name`.
373
- # The current authenticated user must have the `billing.accounts.update`
374
- # IAM permission, which is typically given to the
375
- # [administrator](https://cloud.google.com/billing/docs/how-to/billing-access)
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 | Hash]
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 | Hash]
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
- # @param request [Google::Cloud::Billing::V1::CreateBillingAccountRequest | Hash]
449
- # Creates a billing account.
450
- # This method can only be used to create
451
- # [billing subaccounts](https://cloud.google.com/billing/docs/concepts)
452
- # by GCP resellers.
453
- # When creating a subaccount, the current authenticated user must have the
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
- # @param billing_account [Google::Cloud::Billing::V1::BillingAccount | Hash]
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
- # @param request [Google::Cloud::Billing::V1::ListProjectBillingInfoRequest | Hash]
517
- # Lists the projects associated with a billing account. The current
518
- # authenticated user must have the `billing.resourceAssociations.list` IAM
519
- # permission, which is often given to billing account
520
- # [viewers](https://cloud.google.com/billing/docs/how-to/billing-access).
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
- # @param request [Google::Cloud::Billing::V1::GetProjectBillingInfoRequest | Hash]
591
- # Gets the billing information for a project. The current authenticated user
592
- # must have [permission to view the
593
- # project](https://cloud.google.com/docs/permissions-overview#h.bgs0oxofvnoo
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
- # @param request [Google::Cloud::Billing::V1::UpdateProjectBillingInfoRequest | Hash]
684
- # Sets or updates the billing account associated with a project. You specify
685
- # the new billing account by setting the `billing_account_name` in the
686
- # `ProjectBillingInfo` resource to the resource name of a billing account.
687
- # Associating a project with an open billing account enables billing on the
688
- # project and allows charges for resource usage. If the project already had a
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 | Hash]
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
- # @param request [Google::Iam::V1::GetIamPolicyRequest | Hash]
780
- # Gets the access control policy for a billing account.
781
- # The caller must have the `billing.accounts.getIamPolicy` permission on the
782
- # account, which is often given to billing account
783
- # [viewers](https://cloud.google.com/billing/docs/how-to/billing-access).
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
- # `resource` is usually specified as a path. For example, a Project
791
- # resource is specified as `projects/{project}`.
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
- # @param request [Google::Iam::V1::SetIamPolicyRequest | Hash]
848
- # Sets the access control policy for a billing account. Replaces any existing
849
- # policy.
850
- # The caller must have the `billing.accounts.setIamPolicy` permission on the
851
- # account, which is often given to billing account
852
- # [administrators](https://cloud.google.com/billing/docs/how-to/billing-access).
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
- # `resource` is usually specified as a path. For example, a Project
860
- # resource is specified as `projects/{project}`.
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
- # @param request [Google::Iam::V1::TestIamPermissionsRequest | Hash]
920
- # Tests the access control policy for a billing account. This method takes
921
- # the resource and a set of permissions as input and returns the subset of
922
- # the input permissions that the caller is allowed for that resource.
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
- # `resource` is usually specified as a path. For example, a Project
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 "google/cloud/billing/v1/cloud_billing/client"
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
- # @param request [Google::Cloud::Billing::V1::ListServicesRequest | Hash]
164
- # Lists all public cloud services.
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
- # @param request [Google::Cloud::Billing::V1::ListSkusRequest | Hash]
222
- # Lists all publicly available SKUs for a given cloud service.
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 | Hash]
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 | Hash]
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 "google/cloud/billing/v1/cloud_catalog/client"
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
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Billing
23
23
  module V1
24
- VERSION = "0.3.1"
24
+ VERSION = "0.4.0"
25
25
  end
26
26
  end
27
27
  end
@@ -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
- require "google/cloud/billing/v1/version"
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
- # `resource` is usually specified as a path. For example, a Project
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
- # `resource` is usually specified as a path. For example, a Project
45
- # resource is specified as `projects/{project}`.
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
- # `resource` is usually specified as a path. For example, a Project
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` consists of a list of `bindings`. A `Binding` binds a list of
28
- # `members` to a `role`, where the members can be user accounts, Google groups,
29
- # Google domains, and service accounts. A `role` is a named list of permissions
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/owner",
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-other-app@appspot.gserviceaccount.com",
45
+ # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
43
46
  # ]
44
47
  # },
45
48
  # {
46
- # "role": "roles/viewer",
47
- # "members": ["user:sean@example.com"]
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
- # Version of the `Policy`. The default version is 0.
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
- # Multiple `bindings` must not be specified for the same `role`.
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 blindly.
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@gmail.com` or `joe@example.com`.
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
- # * `domain:{domain}`: A Google Apps domain name that represents all the
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.3.1
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-01 00:00:00.000000000 Z
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.6.9
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.6.9
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: