google-apis-cloudbilling_v1 0.28.0 → 0.29.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c7928f56780dd536b066a60b9cf96164d9bf0fa30d36fc0793fe6034dcecfdb7
-  data.tar.gz: d8dcd5fd9e8f3149a62c1854943a0f2e2c7e7a6edfcafab0148f434b4fa41be7
+  metadata.gz: 2a615bbc81ce4720fd95425af455b815eeb6abbf7acce5d44af686723451fec9
+  data.tar.gz: e9184a3eb61c690cea49126eaa5ff0ea73bf37f14416331e806d6c743771c51e
 SHA512:
-  metadata.gz: dfe4540e8b450d6dac07ab828a83df1a48c9ef34c91d001cb110ec5caa11b58bdf7804a045e6336dc158febc55a0e1bb1db1cc56bfa683d73aca61b69439b468
-  data.tar.gz: 8c1c2322cb2b30940497a787fced530bbd6c047a3efd75eb42138582888b2657c87ece2812204ac92fa297acbf5dc74a4fa33d4231d4ca11422d4f6b13be53cf
+  metadata.gz: 2c6d5fcec8a4d1c6b7161fa1434a6c2903f89e55300cf1b4ad7f54dc1430dd6b992aef7c0aa8e8bea1e39d177335d5e20313e68d24c069d8f832d8aa5542a983
+  data.tar.gz: 0b21add8b98565786e2ab69dc70a58e177aba09a75caacb3b63a5a25812e4b5b0f39d3725f8eeaf3ad8ff16d0f9bab5f80caa4e2869c523b0281aab91434650e

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-cloudbilling_v1
 
+### v0.29.0 (2023-10-29)
+
+* Regenerated from discovery document revision 20231025
+
 ### v0.28.0 (2023-08-27)
 
 * Regenerated from discovery document revision 20230813

data/lib/google/apis/cloudbilling_v1/classes.rb

@@ -514,6 +514,26 @@ module Google
         end
       end
       
+      # Request message for `MoveBillingAccount` RPC.
+      class MoveBillingAccountRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. The resource name of the Organization to reparent the billing
+        # account under. Must be of the form `organizations/`organization_id``.
+        # Corresponds to the JSON property `destinationParent`
+        # @return [String]
+        attr_accessor :destination_parent
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @destination_parent = args[:destination_parent] if args.key?(:destination_parent)
+        end
+      end
+      
       # An Identity and Access Management (IAM) policy, which specifies access
       # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
       # A `binding` binds one or more `members`, or principals, to a single `role`.

data/lib/google/apis/cloudbilling_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module CloudbillingV1
       # Version of the google-apis-cloudbilling_v1 gem
-      GEM_VERSION = "0.28.0"
+      GEM_VERSION = "0.29.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.12.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20230813"
+      REVISION = "20231025"
     end
   end
 end

data/lib/google/apis/cloudbilling_v1/representations.rb

@@ -100,6 +100,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class MoveBillingAccountRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Policy
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -279,6 +285,13 @@ module Google
         end
       end
       
+      class MoveBillingAccountRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :destination_parent, as: 'destinationParent'
+        end
+      end
+      
       class Policy
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/lib/google/apis/cloudbilling_v1/service.rb

@@ -62,6 +62,10 @@ module Google
         # This method will return an error if the parent account has not been
         # provisioned for subaccounts.
         # @param [Google::Apis::CloudbillingV1::BillingAccount] billing_account_object
+        # @param [String] parent
+        #   Optional. The parent to create a billing account from. Format: - organizations/
+        #   `organization_id` eg organizations/12345678 - billingAccounts/`
+        #   billing_account_id` eg `billingAccounts/012345-567890-ABCDEF`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -79,12 +83,13 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def create_billing_account(billing_account_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+        def create_billing_account(billing_account_object = nil, parent: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:post, 'v1/billingAccounts', options)
           command.request_representation = Google::Apis::CloudbillingV1::BillingAccount::Representation
           command.request_object = billing_account_object
           command.response_representation = Google::Apis::CloudbillingV1::BillingAccount::Representation
           command.response_class = Google::Apis::CloudbillingV1::BillingAccount
+          command.query['parent'] = parent unless parent.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -184,6 +189,10 @@ module Google
         #   A token identifying a page of results to return. This should be a `
         #   next_page_token` value returned from a previous `ListBillingAccounts` call. If
         #   unspecified, the first page of results is returned.
+        # @param [String] parent
+        #   Optional. The parent resource to list billing accounts from. Format: -
+        #   organizations/`organization_id` eg organizations/12345678 - billingAccounts/`
+        #   billing_account_id` eg `billingAccounts/012345-567890-ABCDEF`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -201,13 +210,50 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_billing_accounts(filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def list_billing_accounts(filter: nil, page_size: nil, page_token: nil, parent: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v1/billingAccounts', options)
           command.response_representation = Google::Apis::CloudbillingV1::ListBillingAccountsResponse::Representation
           command.response_class = Google::Apis::CloudbillingV1::ListBillingAccountsResponse
           command.query['filter'] = filter unless filter.nil?
           command.query['pageSize'] = page_size unless page_size.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Changes which parent organization a billing account belongs to.
+        # @param [String] name
+        #   Required. The resource name of the billing account to move. Must be of the
+        #   form `billingAccounts/`billing_account_id``. The specified billing account
+        #   cannot be a subaccount, since a subaccount always belongs to the same
+        #   organization as its parent account.
+        # @param [Google::Apis::CloudbillingV1::MoveBillingAccountRequest] move_billing_account_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudbillingV1::BillingAccount] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudbillingV1::BillingAccount]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def move_billing_account(name, move_billing_account_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:move', options)
+          command.request_representation = Google::Apis::CloudbillingV1::MoveBillingAccountRequest::Representation
+          command.request_object = move_billing_account_request_object
+          command.response_representation = Google::Apis::CloudbillingV1::BillingAccount::Representation
+          command.response_class = Google::Apis::CloudbillingV1::BillingAccount
+          command.params['name'] = name unless name.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -372,6 +418,229 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # This method creates [billing subaccounts](https://cloud.google.com/billing/
+        # docs/concepts#subaccounts). Google Cloud resellers should use the Channel
+        # Services APIs, [accounts.customers.create](https://cloud.google.com/channel/
+        # docs/reference/rest/v1/accounts.customers/create) and [accounts.customers.
+        # entitlements.create](https://cloud.google.com/channel/docs/reference/rest/v1/
+        # accounts.customers.entitlements/create). When creating a subaccount, the
+        # current authenticated user must have the `billing.accounts.update` IAM
+        # permission on the parent account, which is typically given to billing account [
+        # administrators](https://cloud.google.com/billing/docs/how-to/billing-access).
+        # This method will return an error if the parent account has not been
+        # provisioned for subaccounts.
+        # @param [String] parent
+        #   Optional. The parent to create a billing account from. Format: - organizations/
+        #   `organization_id` eg organizations/12345678 - billingAccounts/`
+        #   billing_account_id` eg `billingAccounts/012345-567890-ABCDEF`
+        # @param [Google::Apis::CloudbillingV1::BillingAccount] billing_account_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudbillingV1::BillingAccount] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudbillingV1::BillingAccount]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def create_billing_account_sub_account(parent, billing_account_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+parent}/subAccounts', options)
+          command.request_representation = Google::Apis::CloudbillingV1::BillingAccount::Representation
+          command.request_object = billing_account_object
+          command.response_representation = Google::Apis::CloudbillingV1::BillingAccount::Representation
+          command.response_class = Google::Apis::CloudbillingV1::BillingAccount
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists the billing accounts that the current authenticated user has permission
+        # to [view](https://cloud.google.com/billing/docs/how-to/billing-access).
+        # @param [String] parent
+        #   Optional. The parent resource to list billing accounts from. Format: -
+        #   organizations/`organization_id` eg organizations/12345678 - billingAccounts/`
+        #   billing_account_id` eg `billingAccounts/012345-567890-ABCDEF`
+        # @param [String] filter
+        #   Options for how to filter the returned billing accounts. This only supports
+        #   filtering for [subaccounts](https://cloud.google.com/billing/docs/concepts)
+        #   under a single provided parent billing account. (e.g. "master_billing_account=
+        #   billingAccounts/012345-678901-ABCDEF"). Boolean algebra and other fields are
+        #   not currently supported.
+        # @param [Fixnum] page_size
+        #   Requested page size. The maximum page size is 100; this is also the default.
+        # @param [String] page_token
+        #   A token identifying a page of results to return. This should be a `
+        #   next_page_token` value returned from a previous `ListBillingAccounts` call. If
+        #   unspecified, the first page of results is returned.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudbillingV1::ListBillingAccountsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudbillingV1::ListBillingAccountsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_billing_account_sub_accounts(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+parent}/subAccounts', options)
+          command.response_representation = Google::Apis::CloudbillingV1::ListBillingAccountsResponse::Representation
+          command.response_class = Google::Apis::CloudbillingV1::ListBillingAccountsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # This method creates [billing subaccounts](https://cloud.google.com/billing/
+        # docs/concepts#subaccounts). Google Cloud resellers should use the Channel
+        # Services APIs, [accounts.customers.create](https://cloud.google.com/channel/
+        # docs/reference/rest/v1/accounts.customers/create) and [accounts.customers.
+        # entitlements.create](https://cloud.google.com/channel/docs/reference/rest/v1/
+        # accounts.customers.entitlements/create). When creating a subaccount, the
+        # current authenticated user must have the `billing.accounts.update` IAM
+        # permission on the parent account, which is typically given to billing account [
+        # administrators](https://cloud.google.com/billing/docs/how-to/billing-access).
+        # This method will return an error if the parent account has not been
+        # provisioned for subaccounts.
+        # @param [String] parent
+        #   Optional. The parent to create a billing account from. Format: - organizations/
+        #   `organization_id` eg organizations/12345678 - billingAccounts/`
+        #   billing_account_id` eg `billingAccounts/012345-567890-ABCDEF`
+        # @param [Google::Apis::CloudbillingV1::BillingAccount] billing_account_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudbillingV1::BillingAccount] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudbillingV1::BillingAccount]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def create_organization_billing_account(parent, billing_account_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+parent}/billingAccounts', options)
+          command.request_representation = Google::Apis::CloudbillingV1::BillingAccount::Representation
+          command.request_object = billing_account_object
+          command.response_representation = Google::Apis::CloudbillingV1::BillingAccount::Representation
+          command.response_class = Google::Apis::CloudbillingV1::BillingAccount
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists the billing accounts that the current authenticated user has permission
+        # to [view](https://cloud.google.com/billing/docs/how-to/billing-access).
+        # @param [String] parent
+        #   Optional. The parent resource to list billing accounts from. Format: -
+        #   organizations/`organization_id` eg organizations/12345678 - billingAccounts/`
+        #   billing_account_id` eg `billingAccounts/012345-567890-ABCDEF`
+        # @param [String] filter
+        #   Options for how to filter the returned billing accounts. This only supports
+        #   filtering for [subaccounts](https://cloud.google.com/billing/docs/concepts)
+        #   under a single provided parent billing account. (e.g. "master_billing_account=
+        #   billingAccounts/012345-678901-ABCDEF"). Boolean algebra and other fields are
+        #   not currently supported.
+        # @param [Fixnum] page_size
+        #   Requested page size. The maximum page size is 100; this is also the default.
+        # @param [String] page_token
+        #   A token identifying a page of results to return. This should be a `
+        #   next_page_token` value returned from a previous `ListBillingAccounts` call. If
+        #   unspecified, the first page of results is returned.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudbillingV1::ListBillingAccountsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudbillingV1::ListBillingAccountsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_organization_billing_accounts(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+parent}/billingAccounts', options)
+          command.response_representation = Google::Apis::CloudbillingV1::ListBillingAccountsResponse::Representation
+          command.response_class = Google::Apis::CloudbillingV1::ListBillingAccountsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Changes which parent organization a billing account belongs to.
+        # @param [String] destination_parent
+        #   Required. The resource name of the Organization to reparent the billing
+        #   account under. Must be of the form `organizations/`organization_id``.
+        # @param [String] name
+        #   Required. The resource name of the billing account to move. Must be of the
+        #   form `billingAccounts/`billing_account_id``. The specified billing account
+        #   cannot be a subaccount, since a subaccount always belongs to the same
+        #   organization as its parent account.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudbillingV1::BillingAccount] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudbillingV1::BillingAccount]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def move_organization_billing_account(destination_parent, name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+destinationParent}/{+name}:move', options)
+          command.response_representation = Google::Apis::CloudbillingV1::BillingAccount::Representation
+          command.response_class = Google::Apis::CloudbillingV1::BillingAccount
+          command.params['destinationParent'] = destination_parent unless destination_parent.nil?
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Gets the billing information for a project. The current authenticated user
         # must have the `resourcemanager.projects.get` permission for the project, which
         # can be granted by assigning the [Project Viewer](https://cloud.google.com/iam/

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-cloudbilling_v1
 version: !ruby/object:Gem::Version
-  version: 0.28.0
+  version: 0.29.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-08-27 00:00:00.000000000 Z
+date: 2023-10-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudbilling_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-cloudbilling_v1/v0.28.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-cloudbilling_v1/v0.29.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-cloudbilling_v1
 post_install_message: 
 rdoc_options: []