billingbudgets

type BillingAccountsBudgetsCreateCall struct {
	// contains filtered or unexported fields
}

type BillingAccountsBudgetsDeleteCall struct {
	// contains filtered or unexported fields
}

type BillingAccountsBudgetsGetCall struct {
	// contains filtered or unexported fields
}

type BillingAccountsBudgetsListCall struct {
	// contains filtered or unexported fields
}

type BillingAccountsBudgetsPatchCall struct {
	// contains filtered or unexported fields
}

type BillingAccountsBudgetsService struct {
	// contains filtered or unexported fields
}

type BillingAccountsService struct {
	Budgets *BillingAccountsBudgetsService
	// contains filtered or unexported fields
}

type GoogleCloudBillingBudgetsV1beta1AllUpdatesRule struct {
	// DisableDefaultIamRecipients: 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.
	DisableDefaultIamRecipients bool `json:"disableDefaultIamRecipients,omitempty"`
	// EnableProjectLevelRecipients: Optional. When set to true, and when the
	// budget has a single project configured, notifications will be sent to
	// project level recipients of that project. This field will be ignored if the
	// budget has multiple or no project configured. Currently, project level
	// recipients are the users with `Owner` role on a cloud project.
	EnableProjectLevelRecipients bool `json:"enableProjectLevelRecipients,omitempty"`
	// MonitoringNotificationChannels: 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.
	MonitoringNotificationChannels []string `json:"monitoringNotificationChannels,omitempty"`
	// PubsubTopic: 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-programmatic-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#permissions_required_for_this_task
	// for more details on Pub/Sub roles and permissions.
	PubsubTopic string `json:"pubsubTopic,omitempty"`
	// SchemaVersion: Optional. Required when AllUpdatesRule.pubsub_topic is set.
	// The schema version of the notification sent to AllUpdatesRule.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.
	SchemaVersion string `json:"schemaVersion,omitempty"`
	// ForceSendFields is a list of field names (e.g.
	// "DisableDefaultIamRecipients") to unconditionally include in API requests.
	// By default, fields with empty or default values are omitted from API
	// requests. See https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields
	// for more details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "DisableDefaultIamRecipients") to
	// include in API requests with the JSON null value. By default, fields with
	// empty values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

type GoogleCloudBillingBudgetsV1beta1Budget struct {
	// AllUpdatesRule: Optional. Rules to apply to notifications sent based on
	// budget spend and thresholds.
	AllUpdatesRule *GoogleCloudBillingBudgetsV1beta1AllUpdatesRule `json:"allUpdatesRule,omitempty"`
	// Amount: Required. Budgeted amount.
	Amount *GoogleCloudBillingBudgetsV1beta1BudgetAmount `json:"amount,omitempty"`
	// BudgetFilter: Optional. Filters that define which resources are used to
	// compute the actual spend against the budget amount, such as projects,
	// services, and the budget's time period, as well as other filters.
	BudgetFilter *GoogleCloudBillingBudgetsV1beta1Filter `json:"budgetFilter,omitempty"`
	// DisplayName: User data for display name in UI. Validation: <= 60 chars.
	DisplayName string `json:"displayName,omitempty"`
	// Etag: 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.
	Etag string `json:"etag,omitempty"`
	// Name: 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}`.
	Name string `json:"name,omitempty"`
	// Possible values:
	//   "OWNERSHIP_SCOPE_UNSPECIFIED" - Unspecified ownership scope, same as
	// ALL_USERS.
	//   "ALL_USERS" - The Budget is fully accessible to both billing account users
	// and resource users, provided that they have the required IAM permissions.
	//   "BILLING_ACCOUNT" - Only billing account users have full access to the
	// `Budget`, resource-level users have read-only access, provided that they
	// have the required IAM permissions.
	OwnershipScope string `json:"ownershipScope,omitempty"`
	// ThresholdRules: Optional. Rules that trigger alerts (notifications of
	// thresholds being crossed) when spend exceeds the specified percentages of
	// the budget. Optional for `pubsubTopic` notifications. Required if using
	// email notifications.
	ThresholdRules []*GoogleCloudBillingBudgetsV1beta1ThresholdRule `json:"thresholdRules,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "AllUpdatesRule") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "AllUpdatesRule") to include in
	// API requests with the JSON null value. By default, fields with empty values
	// are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

type GoogleCloudBillingBudgetsV1beta1BudgetAmount struct {
	// LastPeriodAmount: Use the last period's actual spend as the budget for the
	// present period. LastPeriodAmount can only be set when the budget's time
	// period is a Filter.calendar_period. It cannot be set in combination with
	// Filter.custom_period.
	LastPeriodAmount *GoogleCloudBillingBudgetsV1beta1LastPeriodAmount `json:"lastPeriodAmount,omitempty"`
	// SpecifiedAmount: A specified amount to use as the budget. `currency_code` is
	// optional. If specified when creating a budget, it must match the currency of
	// the billing account. If specified when updating a budget, it must match the
	// currency_code of the existing budget. The `currency_code` is provided on
	// output.
	SpecifiedAmount *GoogleTypeMoney `json:"specifiedAmount,omitempty"`
	// ForceSendFields is a list of field names (e.g. "LastPeriodAmount") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "LastPeriodAmount") to include in
	// API requests with the JSON null value. By default, fields with empty values
	// are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

type GoogleCloudBillingBudgetsV1beta1CreateBudgetRequest struct {
	// Budget: Required. Budget to create.
	Budget *GoogleCloudBillingBudgetsV1beta1Budget `json:"budget,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Budget") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Budget") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

type GoogleCloudBillingBudgetsV1beta1CustomPeriod struct {
	// EndDate: Optional. The end date of the time period. Budgets with elapsed end
	// date won't be processed. If unset, specifies to track all usage incurred
	// since the start_date.
	EndDate *GoogleTypeDate `json:"endDate,omitempty"`
	// StartDate: Required. The start date must be after January 1, 2017.
	StartDate *GoogleTypeDate `json:"startDate,omitempty"`
	// ForceSendFields is a list of field names (e.g. "EndDate") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "EndDate") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

type GoogleCloudBillingBudgetsV1beta1Filter struct {
	// CalendarPeriod: Optional. Specifies to track usage for recurring calendar
	// period. For example, assume that CalendarPeriod.QUARTER is set. The budget
	// will track usage from April 1 to June 30, when the current calendar month is
	// April, May, June. After that, it will track usage from July 1 to September
	// 30 when the current calendar month is July, August, September, so on.
	//
	// Possible values:
	//   "CALENDAR_PERIOD_UNSPECIFIED" - Calendar period is unset. This is the
	// default if the budget is for a custom time period (CustomPeriod).
	//   "MONTH" - A month. Month starts on the first day of each month, such as
	// January 1, February 1, March 1, and so on.
	//   "QUARTER" - A quarter. Quarters start on dates January 1, April 1, July 1,
	// and October 1 of each year.
	//   "YEAR" - A year. Year starts on January 1.
	CalendarPeriod string `json:"calendarPeriod,omitempty"`
	// CreditTypes: Optional. If Filter.credit_types_treatment is
	// INCLUDE_SPECIFIED_CREDITS, this is a list of credit types to be subtracted
	// from gross cost to determine the spend for threshold calculations. See a
	// list of acceptable credit type values
	// (https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#credits-type).
	// If Filter.credit_types_treatment is **not** INCLUDE_SPECIFIED_CREDITS, this
	// field must be empty.
	CreditTypes []string `json:"creditTypes,omitempty"`
	// CreditTypesTreatment: Optional. If not set, default behavior is
	// `INCLUDE_ALL_CREDITS`.
	//
	// Possible values:
	//   "CREDIT_TYPES_TREATMENT_UNSPECIFIED"
	//   "INCLUDE_ALL_CREDITS" - All types of credit are subtracted from the gross
	// cost to determine the spend for threshold calculations.
	//   "EXCLUDE_ALL_CREDITS" - All types of credit are added to the net cost to
	// determine the spend for threshold calculations.
	//   "INCLUDE_SPECIFIED_CREDITS" - [Credit
	// types](https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tabl
	// es#credits-type) specified in the credit_types field are subtracted from the
	// gross cost to determine the spend for threshold calculations.
	CreditTypesTreatment string `json:"creditTypesTreatment,omitempty"`
	// CustomPeriod: Optional. Specifies to track usage from any start date
	// (required) to any end date (optional). This time period is static, it does
	// not recur.
	CustomPeriod *GoogleCloudBillingBudgetsV1beta1CustomPeriod `json:"customPeriod,omitempty"`
	// Labels: Optional. A single label and value pair specifying that usage from
	// only this set of labeled resources should be included in the budget. If
	// omitted, the report will include all labeled and unlabeled usage. An object
	// containing a single "key": value` pair. Example: `{ "name": "wrench" }`.
	// _Currently, multiple entries or multiple values per entry are not allowed._
	Labels map[string][]interface{} `json:"labels,omitempty"`
	// Projects: 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.
	Projects []string `json:"projects,omitempty"`
	// ResourceAncestors: Optional. A set of folder and organization names of the
	// form `folders/{folderId}` or `organizations/{organizationId}`, specifying
	// that usage from only this set of folders and organizations should be
	// included in the budget. If omitted, the budget includes all usage that the
	// billing account pays for. If the folder or organization contains projects
	// that are paid for by a different Cloud Billing account, the budget *doesn't*
	// apply to those projects.
	ResourceAncestors []string `json:"resourceAncestors,omitempty"`
	// Services: 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.
	Services []string `json:"services,omitempty"`
	// Subaccounts: 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 omitted, the report will include usage from the parent account and all
	// subaccounts, if they exist.
	Subaccounts []string `json:"subaccounts,omitempty"`
	// ForceSendFields is a list of field names (e.g. "CalendarPeriod") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "CalendarPeriod") to include in
	// API requests with the JSON null value. By default, fields with empty values
	// are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

type GoogleCloudBillingBudgetsV1beta1LastPeriodAmount struct {
}

type GoogleCloudBillingBudgetsV1beta1ListBudgetsResponse struct {
	// Budgets: List of the budgets owned by the requested billing account.
	Budgets []*GoogleCloudBillingBudgetsV1beta1Budget `json:"budgets,omitempty"`
	// NextPageToken: If not empty, indicates that there may be more budgets that
	// match the request; this value should be passed in a new
	// `ListBudgetsRequest`.
	NextPageToken string `json:"nextPageToken,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Budgets") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Budgets") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

type GoogleCloudBillingBudgetsV1beta1ThresholdRule struct {
	// SpendBasis: Optional. The type of basis used to determine if spend has
	// passed the threshold. Behavior defaults to CURRENT_SPEND if not set.
	//
	// Possible values:
	//   "BASIS_UNSPECIFIED" - Unspecified threshold basis.
	//   "CURRENT_SPEND" - Use current spend as the basis for comparison against
	// the threshold.
	//   "FORECASTED_SPEND" - Use forecasted spend for the period as the basis for
	// comparison against the threshold. FORECASTED_SPEND can only be set when the
	// budget's time period is a Filter.calendar_period. It cannot be set in
	// combination with Filter.custom_period.
	SpendBasis string `json:"spendBasis,omitempty"`
	// ThresholdPercent: Required. Send an alert when this threshold is exceeded.
	// This is a 1.0-based percentage, so 0.5 = 50%. Validation: non-negative
	// number.
	ThresholdPercent float64 `json:"thresholdPercent,omitempty"`
	// ForceSendFields is a list of field names (e.g. "SpendBasis") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "SpendBasis") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

type GoogleCloudBillingBudgetsV1beta1UpdateBudgetRequest struct {
	// Budget: Required. The updated budget object. The budget to update is
	// specified by the budget name in the budget.
	Budget *GoogleCloudBillingBudgetsV1beta1Budget `json:"budget,omitempty"`
	// UpdateMask: Optional. Indicates which fields in the provided budget to
	// update. Read-only fields (such as `name`) cannot be changed. If this is not
	// provided, then only fields with non-default values from the request are
	// updated. See
	// https://developers.google.com/protocol-buffers/docs/proto3#default for more
	// details about default values.
	UpdateMask string `json:"updateMask,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Budget") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Budget") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

type GoogleProtobufEmpty struct {
	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
}

type GoogleTypeDate struct {
	// Day: Day of a month. Must be from 1 to 31 and valid for the year and month,
	// or 0 to specify a year by itself or a year and month where the day isn't
	// significant.
	Day int64 `json:"day,omitempty"`
	// Month: Month of a year. Must be from 1 to 12, or 0 to specify a year without
	// a month and day.
	Month int64 `json:"month,omitempty"`
	// Year: Year of the date. Must be from 1 to 9999, or 0 to specify a date
	// without a year.
	Year int64 `json:"year,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Day") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Day") to include in API requests
	// with the JSON null value. By default, fields with empty values are omitted
	// from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

type GoogleTypeMoney struct {
	// CurrencyCode: The three-letter currency code defined in ISO 4217.
	CurrencyCode string `json:"currencyCode,omitempty"`
	// Nanos: 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.
	Nanos int64 `json:"nanos,omitempty"`
	// Units: The whole units of the amount. For example if `currencyCode` is
	// "USD", then 1 unit is one US dollar.
	Units int64 `json:"units,omitempty,string"`
	// ForceSendFields is a list of field names (e.g. "CurrencyCode") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "CurrencyCode") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

type Service struct {
	BasePath  string // API endpoint base URL
	UserAgent string // optional additional User-Agent fragment

	BillingAccounts *BillingAccountsService
	// contains filtered or unexported fields
}