Package Classes (1.15.1)

Summary of entries of Classes for billingbudgets.

Classes

BudgetServiceAsyncClient

BudgetService stores Cloud Billing budgets, which define a budget plan and rules to execute as we track spend against that plan.

BudgetServiceClient

BudgetService stores Cloud Billing budgets, which define a budget plan and rules to execute as we track spend against that plan.

ListBudgetsAsyncPager

A pager for iterating through list_budgets requests.

This class thinly wraps an initial ListBudgetsResponse object, and provides an __aiter__ method to iterate through its budgets field.

If there are more pages, the __aiter__ method will make additional ListBudgets requests and continue to iterate through the budgets field on the corresponding responses.

All the usual ListBudgetsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListBudgetsPager

A pager for iterating through list_budgets requests.

This class thinly wraps an initial ListBudgetsResponse object, and provides an __iter__ method to iterate through its budgets field.

If there are more pages, the __iter__ method will make additional ListBudgets requests and continue to iterate through the budgets field on the corresponding responses.

All the usual ListBudgetsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

Budget

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). The budget time period is configurable, with options such as month (default), quarter, year, or custom time period.

BudgetAmount

The budgeted amount for each usage period.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

CalendarPeriod

A CalendarPeriod represents the abstract concept of a time period that has a canonical start. Grammatically, "the start of the current CalendarPeriod". All calendar times begin at 12 AM US and Canadian Pacific Time (UTC-8).

CreateBudgetRequest

Request for CreateBudget

CustomPeriod

All date times begin at 12 AM US and Canadian Pacific Time (UTC-8).

DeleteBudgetRequest

Request for DeleteBudget

Filter

A filter for a budget, limiting the scope of the cost to calculate.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

CreditTypesTreatment

Specifies how credits are applied when determining the spend for threshold calculations. Budgets track the total cost minus any applicable selected credits. See the documentation for a list of credit types <https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#credits-type>__.

LabelsEntry

The abstract base class for a message.

GetBudgetRequest

Request for GetBudget

LastPeriodAmount

Describes a budget amount targeted to the last Filter.calendar_period spend. At this time, the amount is automatically 100% of the last calendar period's spend; that is, there are no other options yet. LastPeriodAmount cannot be set for a budget configured with a Filter.custom_period.

ListBudgetsRequest

Request for ListBudgets

ListBudgetsResponse

Response for ListBudgets

NotificationsRule

NotificationsRule defines notifications that are sent based on budget spend and thresholds.

ThresholdRule

ThresholdRule contains the definition of a threshold. Threshold rules define the triggering events used to generate a budget notification email. When a threshold is crossed (spend exceeds the specified percentages of the budget), budget alert emails are sent to the email recipients you specify in the NotificationsRule <#notificationsrule>__.

Threshold rules also affect the fields included in the JSON data object <https://cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications#notification_format>__ sent to a Pub/Sub topic.

Threshold rules are required if using email notifications.

Threshold rules are optional if only setting a `pubsubTopic NotificationsRule <#NotificationsRule>`__, unless you want your JSON data object to include data about the thresholds you set.

For more information, see set budget threshold rules and actions <https://cloud.google.com/billing/docs/how-to/budgets#budget-actions>__.

Basis

The type of basis used to determine if spend has passed the threshold.

UpdateBudgetRequest

Request for UpdateBudget

BudgetServiceAsyncClient

BudgetService stores Cloud Billing budgets, which define a budget plan and rules to execute as we track spend against that plan.

BudgetServiceClient

BudgetService stores Cloud Billing budgets, which define a budget plan and rules to execute as we track spend against that plan.

ListBudgetsAsyncPager

A pager for iterating through list_budgets requests.

This class thinly wraps an initial ListBudgetsResponse object, and provides an __aiter__ method to iterate through its budgets field.

If there are more pages, the __aiter__ method will make additional ListBudgets requests and continue to iterate through the budgets field on the corresponding responses.

All the usual ListBudgetsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListBudgetsPager

A pager for iterating through list_budgets requests.

This class thinly wraps an initial ListBudgetsResponse object, and provides an __iter__ method to iterate through its budgets field.

If there are more pages, the __iter__ method will make additional ListBudgets requests and continue to iterate through the budgets field on the corresponding responses.

All the usual ListBudgetsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

AllUpdatesRule

AllUpdatesRule defines notifications that are sent based on budget spend and thresholds.

Budget

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). The budget time period is configurable, with options such as month (default), quarter, year, or custom time period.

BudgetAmount

The budgeted amount for each usage period.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

CalendarPeriod

A CalendarPeriod represents the abstract concept of a time period that has a canonical start. Grammatically, "the start of the current CalendarPeriod". All calendar times begin at 12 AM US and Canadian Pacific Time (UTC-8).

CreateBudgetRequest

Request for CreateBudget

CustomPeriod

All date times begin at 12 AM US and Canadian Pacific Time (UTC-8).

DeleteBudgetRequest

Request for DeleteBudget

Filter

A filter for a budget, limiting the scope of the cost to calculate.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

CreditTypesTreatment

Specifies how credits are applied when determining the spend for threshold calculations. Budgets track the total cost minus any applicable selected credits. See the documentation for a list of credit types <https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#credits-type>__.

LabelsEntry

The abstract base class for a message.

GetBudgetRequest

Request for GetBudget

LastPeriodAmount

Describes a budget amount targeted to the last Filter.calendar_period spend. At this time, the amount is automatically 100% of the last calendar period's spend; that is, there are no other options yet. Future configuration options will be described here (for example, configuring a percentage of last period's spend). LastPeriodAmount cannot be set for a budget configured with a Filter.custom_period.

ListBudgetsRequest

Request for ListBudgets

ListBudgetsResponse

Response for ListBudgets

ThresholdRule

ThresholdRule contains the definition of a threshold. Threshold rules define the triggering events used to generate a budget notification email. When a threshold is crossed (spend exceeds the specified percentages of the budget), budget alert emails are sent to the email recipients you specify in the NotificationsRule <#notificationsrule>__.

Threshold rules also affect the fields included in the JSON data object <https://cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications#notification_format>__ sent to a Pub/Sub topic.

Threshold rules are required if using email notifications.

Threshold rules are optional if only setting a `pubsubTopic NotificationsRule <#NotificationsRule>`__, unless you want your JSON data object to include data about the thresholds you set.

For more information, see set budget threshold rules and actions <https://cloud.google.com/billing/docs/how-to/budgets#budget-actions>__.

Basis

The type of basis used to determine if spend has passed the threshold.

UpdateBudgetRequest

Request for UpdateBudget

Modules

pagers

API documentation for billing.budgets_v1.services.budget_service.pagers module.

pagers

API documentation for billing.budgets_v1beta1.services.budget_service.pagers module.