google-cloud-billing-v1 0.3.1 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml 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: