google-api-client 0.44.1 → 0.46.1

data/generated/google/apis/billingbudgets_v1.rb

@@ -0,0 +1,38 @@
+# Copyright 2015 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'google/apis/billingbudgets_v1/service.rb'
+require 'google/apis/billingbudgets_v1/classes.rb'
+require 'google/apis/billingbudgets_v1/representations.rb'
+
+module Google
+  module Apis
+    # Cloud Billing Budget API
+    #
+    # The Cloud Billing Budget API stores Cloud Billing budgets, which define a
+    # budget plan and the rules to execute as spend is tracked against that plan.
+    #
+    # @see https://cloud.google.com/billing/docs/how-to/budget-api-overview
+    module BillingbudgetsV1
+      VERSION = 'V1'
+      REVISION = '20200919'
+
+      # View and manage your Google Cloud Platform billing accounts
+      AUTH_CLOUD_BILLING = 'https://www.googleapis.com/auth/cloud-billing'
+
+      # View and manage your data across Google Cloud Platform services
+      AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
+    end
+  end
+end

data/generated/google/apis/billingbudgets_v1/classes.rb

@@ -0,0 +1,362 @@
+# Copyright 2015 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'date'
+require 'google/apis/core/base_service'
+require 'google/apis/core/json_representation'
+require 'google/apis/core/hashable'
+require 'google/apis/errors'
+
+module Google
+  module Apis
+    module BillingbudgetsV1
+      
+      # A budget is a plan that describes what you expect to spend on Cloud projects,
+      # plus the rules to execute as spend is tracked against that plan, (for example,
+      # send an alert when 90% of the target spend is met). Currently all plans are
+      # monthly budgets so the usage period(s) tracked are implied (calendar months of
+      # usage back-to-back).
+      class GoogleCloudBillingBudgetsV1Budget
+        include Google::Apis::Core::Hashable
+      
+        # The budgeted amount for each usage period.
+        # Corresponds to the JSON property `amount`
+        # @return [Google::Apis::BillingbudgetsV1::GoogleCloudBillingBudgetsV1BudgetAmount]
+        attr_accessor :amount
+      
+        # A filter for a budget, limiting the scope of the cost to calculate.
+        # Corresponds to the JSON property `budgetFilter`
+        # @return [Google::Apis::BillingbudgetsV1::GoogleCloudBillingBudgetsV1Filter]
+        attr_accessor :budget_filter
+      
+        # User data for display name in UI. The name must be less than or equal to 60
+        # characters.
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        # Optional. Etag to validate that the object is unchanged for a read-modify-
+        # write operation. An empty etag will cause an update to overwrite other changes.
+        # Corresponds to the JSON property `etag`
+        # @return [String]
+        attr_accessor :etag
+      
+        # Output only. Resource name of the budget. The resource name implies the scope
+        # of a budget. Values are of the form `billingAccounts/`billingAccountId`/
+        # budgets/`budgetId``.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # NotificationsRule defines notifications that are sent based on budget spend
+        # and thresholds.
+        # Corresponds to the JSON property `notificationsRule`
+        # @return [Google::Apis::BillingbudgetsV1::GoogleCloudBillingBudgetsV1NotificationsRule]
+        attr_accessor :notifications_rule
+      
+        # Optional. Rules that trigger alerts (notifications of thresholds being crossed)
+        # when spend exceeds the specified percentages of the budget.
+        # Corresponds to the JSON property `thresholdRules`
+        # @return [Array<Google::Apis::BillingbudgetsV1::GoogleCloudBillingBudgetsV1ThresholdRule>]
+        attr_accessor :threshold_rules
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @amount = args[:amount] if args.key?(:amount)
+          @budget_filter = args[:budget_filter] if args.key?(:budget_filter)
+          @display_name = args[:display_name] if args.key?(:display_name)
+          @etag = args[:etag] if args.key?(:etag)
+          @name = args[:name] if args.key?(:name)
+          @notifications_rule = args[:notifications_rule] if args.key?(:notifications_rule)
+          @threshold_rules = args[:threshold_rules] if args.key?(:threshold_rules)
+        end
+      end
+      
+      # The budgeted amount for each usage period.
+      class GoogleCloudBillingBudgetsV1BudgetAmount
+        include Google::Apis::Core::Hashable
+      
+        # Describes a budget amount targeted to last period's spend. At this time, the
+        # amount is automatically 100% of last period's spend; that is, there are no
+        # other options yet. Future configuration will be described here (for example,
+        # configuring a percentage of last period's spend).
+        # Corresponds to the JSON property `lastPeriodAmount`
+        # @return [Google::Apis::BillingbudgetsV1::GoogleCloudBillingBudgetsV1LastPeriodAmount]
+        attr_accessor :last_period_amount
+      
+        # Represents an amount of money with its currency type.
+        # Corresponds to the JSON property `specifiedAmount`
+        # @return [Google::Apis::BillingbudgetsV1::GoogleTypeMoney]
+        attr_accessor :specified_amount
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @last_period_amount = args[:last_period_amount] if args.key?(:last_period_amount)
+          @specified_amount = args[:specified_amount] if args.key?(:specified_amount)
+        end
+      end
+      
+      # A filter for a budget, limiting the scope of the cost to calculate.
+      class GoogleCloudBillingBudgetsV1Filter
+        include Google::Apis::Core::Hashable
+      
+        # Optional. If not set, default behavior is `INCLUDE_ALL_CREDITS`.
+        # Corresponds to the JSON property `creditTypesTreatment`
+        # @return [String]
+        attr_accessor :credit_types_treatment
+      
+        # Optional. A single label and value pair specifying that usage from only this
+        # set of labeled resources should be included in the budget. Currently, multiple
+        # entries or multiple values per entry are not allowed. If omitted, the report
+        # will include all labeled and unlabeled usage.
+        # Corresponds to the JSON property `labels`
+        # @return [Hash<String,Array<Object>>]
+        attr_accessor :labels
+      
+        # Optional. A set of projects of the form `projects/`project``, specifying that
+        # usage from only this set of projects should be included in the budget. If
+        # omitted, the report will include all usage for the billing account, regardless
+        # of which project the usage occurred on. Only zero or one project can be
+        # specified currently.
+        # Corresponds to the JSON property `projects`
+        # @return [Array<String>]
+        attr_accessor :projects
+      
+        # Optional. A set of services of the form `services/`service_id``, specifying
+        # that usage from only this set of services should be included in the budget. If
+        # omitted, the report will include usage for all the services. The service names
+        # are available through the Catalog API: https://cloud.google.com/billing/v1/how-
+        # tos/catalog-api.
+        # Corresponds to the JSON property `services`
+        # @return [Array<String>]
+        attr_accessor :services
+      
+        # Optional. A set of subaccounts of the form `billingAccounts/`account_id``,
+        # specifying that usage from only this set of subaccounts should be included in
+        # the budget. If a subaccount is set to the name of the parent account, usage
+        # from the parent account will be included. If the field is omitted, the report
+        # will include usage from the parent account and all subaccounts, if they exist.
+        # Corresponds to the JSON property `subaccounts`
+        # @return [Array<String>]
+        attr_accessor :subaccounts
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @credit_types_treatment = args[:credit_types_treatment] if args.key?(:credit_types_treatment)
+          @labels = args[:labels] if args.key?(:labels)
+          @projects = args[:projects] if args.key?(:projects)
+          @services = args[:services] if args.key?(:services)
+          @subaccounts = args[:subaccounts] if args.key?(:subaccounts)
+        end
+      end
+      
+      # Describes a budget amount targeted to last period's spend. At this time, the
+      # amount is automatically 100% of last period's spend; that is, there are no
+      # other options yet. Future configuration will be described here (for example,
+      # configuring a percentage of last period's spend).
+      class GoogleCloudBillingBudgetsV1LastPeriodAmount
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # Response for ListBudgets
+      class GoogleCloudBillingBudgetsV1ListBudgetsResponse
+        include Google::Apis::Core::Hashable
+      
+        # List of the budgets owned by the requested billing account.
+        # Corresponds to the JSON property `budgets`
+        # @return [Array<Google::Apis::BillingbudgetsV1::GoogleCloudBillingBudgetsV1Budget>]
+        attr_accessor :budgets
+      
+        # If not empty, indicates that there may be more budgets that match the request;
+        # this value should be passed in a new `ListBudgetsRequest`.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @budgets = args[:budgets] if args.key?(:budgets)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
+      # NotificationsRule defines notifications that are sent based on budget spend
+      # and thresholds.
+      class GoogleCloudBillingBudgetsV1NotificationsRule
+        include Google::Apis::Core::Hashable
+      
+        # Optional. When set to true, disables default notifications sent when a
+        # threshold is exceeded. Default notifications are sent to those with Billing
+        # Account Administrator and Billing Account User IAM roles for the target
+        # account.
+        # Corresponds to the JSON property `disableDefaultIamRecipients`
+        # @return [Boolean]
+        attr_accessor :disable_default_iam_recipients
+        alias_method :disable_default_iam_recipients?, :disable_default_iam_recipients
+      
+        # Optional. Targets to send notifications to when a threshold is exceeded. This
+        # is in addition to default recipients who have billing account IAM roles. The
+        # value is the full REST resource name of a monitoring notification channel with
+        # the form `projects/`project_id`/notificationChannels/`channel_id``. A maximum
+        # of 5 channels are allowed. See https://cloud.google.com/billing/docs/how-to/
+        # budgets-notification-recipients for more details.
+        # Corresponds to the JSON property `monitoringNotificationChannels`
+        # @return [Array<String>]
+        attr_accessor :monitoring_notification_channels
+      
+        # Optional. The name of the Pub/Sub topic where budget related messages will be
+        # published, in the form `projects/`project_id`/topics/`topic_id``. Updates are
+        # sent at regular intervals to the topic. The topic needs to be created before
+        # the budget is created; see https://cloud.google.com/billing/docs/how-to/
+        # budgets#manage-notifications for more details. Caller is expected to have `
+        # pubsub.topics.setIamPolicy` permission on the topic when it's set for a budget,
+        # otherwise, the API call will fail with PERMISSION_DENIED. See https://cloud.
+        # google.com/billing/docs/how-to/budgets-programmatic-notifications for more
+        # details on Pub/Sub roles and permissions.
+        # Corresponds to the JSON property `pubsubTopic`
+        # @return [String]
+        attr_accessor :pubsub_topic
+      
+        # Optional. The schema version of the notification sent to `pubsub_topic`. Only "
+        # 1.0" is accepted. It represents the JSON schema as defined in https://cloud.
+        # google.com/billing/docs/how-to/budgets-programmatic-notifications#
+        # notification_format
+        # Corresponds to the JSON property `schemaVersion`
+        # @return [String]
+        attr_accessor :schema_version
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @disable_default_iam_recipients = args[:disable_default_iam_recipients] if args.key?(:disable_default_iam_recipients)
+          @monitoring_notification_channels = args[:monitoring_notification_channels] if args.key?(:monitoring_notification_channels)
+          @pubsub_topic = args[:pubsub_topic] if args.key?(:pubsub_topic)
+          @schema_version = args[:schema_version] if args.key?(:schema_version)
+        end
+      end
+      
+      # ThresholdRule contains a definition of a threshold which triggers an alert (a
+      # notification of a threshold being crossed) to be sent when spend goes above
+      # the specified amount. Alerts are automatically e-mailed to users with the
+      # Billing Account Administrator role or the Billing Account User role. The
+      # thresholds here have no effect on notifications sent to anything configured
+      # under `Budget.all_updates_rule`.
+      class GoogleCloudBillingBudgetsV1ThresholdRule
+        include Google::Apis::Core::Hashable
+      
+        # Optional. The type of basis used to determine if spend has passed the
+        # threshold. Behavior defaults to CURRENT_SPEND if not set.
+        # Corresponds to the JSON property `spendBasis`
+        # @return [String]
+        attr_accessor :spend_basis
+      
+        # Required. Send an alert when this threshold is exceeded. This is a 1.0-based
+        # percentage, so 0.5 = 50%. Validation: non-negative number.
+        # Corresponds to the JSON property `thresholdPercent`
+        # @return [Float]
+        attr_accessor :threshold_percent
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @spend_basis = args[:spend_basis] if args.key?(:spend_basis)
+          @threshold_percent = args[:threshold_percent] if args.key?(:threshold_percent)
+        end
+      end
+      
+      # A generic empty message that you can re-use to avoid defining duplicated empty
+      # messages in your APIs. A typical example is to use it as the request or the
+      # response type of an API method. For instance: service Foo ` rpc Bar(google.
+      # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
+      # `Empty` is empty JSON object ````.
+      class GoogleProtobufEmpty
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # Represents an amount of money with its currency type.
+      class GoogleTypeMoney
+        include Google::Apis::Core::Hashable
+      
+        # The 3-letter currency code defined in ISO 4217.
+        # Corresponds to the JSON property `currencyCode`
+        # @return [String]
+        attr_accessor :currency_code
+      
+        # Number of nano (10^-9) units of the amount. The value must be between -999,999,
+        # 999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be
+        # positive or zero. If `units` is zero, `nanos` can be positive, zero, or
+        # negative. If `units` is negative, `nanos` must be negative or zero. For
+        # example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+        # Corresponds to the JSON property `nanos`
+        # @return [Fixnum]
+        attr_accessor :nanos
+      
+        # The whole units of the amount. For example if `currencyCode` is `"USD"`, then
+        # 1 unit is one US dollar.
+        # Corresponds to the JSON property `units`
+        # @return [Fixnum]
+        attr_accessor :units
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @currency_code = args[:currency_code] if args.key?(:currency_code)
+          @nanos = args[:nanos] if args.key?(:nanos)
+          @units = args[:units] if args.key?(:units)
+        end
+      end
+    end
+  end
+end

data/generated/google/apis/billingbudgets_v1/representations.rb

@@ -0,0 +1,170 @@
+# Copyright 2015 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'date'
+require 'google/apis/core/base_service'
+require 'google/apis/core/json_representation'
+require 'google/apis/core/hashable'
+require 'google/apis/errors'
+
+module Google
+  module Apis
+    module BillingbudgetsV1
+      
+      class GoogleCloudBillingBudgetsV1Budget
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudBillingBudgetsV1BudgetAmount
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudBillingBudgetsV1Filter
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudBillingBudgetsV1LastPeriodAmount
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudBillingBudgetsV1ListBudgetsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudBillingBudgetsV1NotificationsRule
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudBillingBudgetsV1ThresholdRule
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleProtobufEmpty
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleTypeMoney
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudBillingBudgetsV1Budget
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :amount, as: 'amount', class: Google::Apis::BillingbudgetsV1::GoogleCloudBillingBudgetsV1BudgetAmount, decorator: Google::Apis::BillingbudgetsV1::GoogleCloudBillingBudgetsV1BudgetAmount::Representation
+      
+          property :budget_filter, as: 'budgetFilter', class: Google::Apis::BillingbudgetsV1::GoogleCloudBillingBudgetsV1Filter, decorator: Google::Apis::BillingbudgetsV1::GoogleCloudBillingBudgetsV1Filter::Representation
+      
+          property :display_name, as: 'displayName'
+          property :etag, as: 'etag'
+          property :name, as: 'name'
+          property :notifications_rule, as: 'notificationsRule', class: Google::Apis::BillingbudgetsV1::GoogleCloudBillingBudgetsV1NotificationsRule, decorator: Google::Apis::BillingbudgetsV1::GoogleCloudBillingBudgetsV1NotificationsRule::Representation
+      
+          collection :threshold_rules, as: 'thresholdRules', class: Google::Apis::BillingbudgetsV1::GoogleCloudBillingBudgetsV1ThresholdRule, decorator: Google::Apis::BillingbudgetsV1::GoogleCloudBillingBudgetsV1ThresholdRule::Representation
+      
+        end
+      end
+      
+      class GoogleCloudBillingBudgetsV1BudgetAmount
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :last_period_amount, as: 'lastPeriodAmount', class: Google::Apis::BillingbudgetsV1::GoogleCloudBillingBudgetsV1LastPeriodAmount, decorator: Google::Apis::BillingbudgetsV1::GoogleCloudBillingBudgetsV1LastPeriodAmount::Representation
+      
+          property :specified_amount, as: 'specifiedAmount', class: Google::Apis::BillingbudgetsV1::GoogleTypeMoney, decorator: Google::Apis::BillingbudgetsV1::GoogleTypeMoney::Representation
+      
+        end
+      end
+      
+      class GoogleCloudBillingBudgetsV1Filter
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :credit_types_treatment, as: 'creditTypesTreatment'
+          hash :labels, as: 'labels', :class => Array do
+        include Representable::JSON::Collection
+        items
+      end
+      
+          collection :projects, as: 'projects'
+          collection :services, as: 'services'
+          collection :subaccounts, as: 'subaccounts'
+        end
+      end
+      
+      class GoogleCloudBillingBudgetsV1LastPeriodAmount
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class GoogleCloudBillingBudgetsV1ListBudgetsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :budgets, as: 'budgets', class: Google::Apis::BillingbudgetsV1::GoogleCloudBillingBudgetsV1Budget, decorator: Google::Apis::BillingbudgetsV1::GoogleCloudBillingBudgetsV1Budget::Representation
+      
+          property :next_page_token, as: 'nextPageToken'
+        end
+      end
+      
+      class GoogleCloudBillingBudgetsV1NotificationsRule
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :disable_default_iam_recipients, as: 'disableDefaultIamRecipients'
+          collection :monitoring_notification_channels, as: 'monitoringNotificationChannels'
+          property :pubsub_topic, as: 'pubsubTopic'
+          property :schema_version, as: 'schemaVersion'
+        end
+      end
+      
+      class GoogleCloudBillingBudgetsV1ThresholdRule
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :spend_basis, as: 'spendBasis'
+          property :threshold_percent, as: 'thresholdPercent'
+        end
+      end
+      
+      class GoogleProtobufEmpty
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class GoogleTypeMoney
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :currency_code, as: 'currencyCode'
+          property :nanos, as: 'nanos'
+          property :units, :numeric_string => true, as: 'units'
+        end
+      end
+    end
+  end
+end