Billing API, gRPC: BudgetService.Get
Returns the specified budget.
gRPC request
rpc Get (GetBudgetRequest) returns (Budget)
GetBudgetRequest
{
"id": "string"
}
Field |
Description |
id |
string Required field. ID of the budget to return. |
Budget
{
"id": "string",
"name": "string",
"createdAt": "google.protobuf.Timestamp",
"billingAccountId": "string",
"status": "BudgetStatus",
// Includes only one of the fields `costBudget`, `expenseBudget`, `balanceBudget`
"costBudget": {
"amount": "string",
"notificationUserAccountIds": [
"string"
],
"thresholdRules": [
{
"type": "ThresholdType",
"amount": "string",
"notificationUserAccountIds": [
"string"
]
}
],
"filter": {
"serviceIds": [
"string"
],
"cloudFoldersFilters": [
{
"cloudId": "string",
"folderIds": [
"string"
]
}
]
},
// Includes only one of the fields `resetPeriod`, `startDate`
"resetPeriod": "ResetPeriodType",
"startDate": "string",
// end of the list of possible fields
"endDate": "string"
},
"expenseBudget": {
"amount": "string",
"notificationUserAccountIds": [
"string"
],
"thresholdRules": [
{
"type": "ThresholdType",
"amount": "string",
"notificationUserAccountIds": [
"string"
]
}
],
"filter": {
"serviceIds": [
"string"
],
"cloudFoldersFilters": [
{
"cloudId": "string",
"folderIds": [
"string"
]
}
]
},
// Includes only one of the fields `resetPeriod`, `startDate`
"resetPeriod": "ResetPeriodType",
"startDate": "string",
// end of the list of possible fields
"endDate": "string"
},
"balanceBudget": {
"amount": "string",
"notificationUserAccountIds": [
"string"
],
"thresholdRules": [
{
"type": "ThresholdType",
"amount": "string",
"notificationUserAccountIds": [
"string"
]
}
],
"startDate": "string",
"endDate": "string"
}
// end of the list of possible fields
}
A Budget resource. For more information, see [/docs/billing/concepts/budget].
Field |
Description |
id |
string ID of the budget. |
name |
string Name of the budget. |
createdAt |
Creation timestamp. |
billingAccountId |
string ID of the billing account that the budget belongs to. |
status |
enum BudgetStatus Status of the budget.
|
costBudget |
Cost budget specification. Includes only one of the fields Specification of the budget. |
expenseBudget |
Expense budget specification. Includes only one of the fields Specification of the budget. |
balanceBudget |
Balance budget specification. Includes only one of the fields Specification of the budget. |
CostBudgetSpec
Cost budget specification describes budget that can be used to control cost of cloud resources usage.
Field |
Description |
amount |
string Required field. Max cost threshold of the budget. Amount currency is the same as corresponding yandex.cloud.billing.v1.BillingAccount.currency. |
notificationUserAccountIds[] |
string IDs of the yandex.cloud.iam.v1.UserAccount. |
thresholdRules[] |
List of the ThresholdRule. |
filter |
Filter that can be used for specific resources selection. Only consumption cost of selected resources are used for the budget calculation. |
resetPeriod |
enum ResetPeriodType Periodic start type that resets budget after specified period is finished. Includes only one of the fields Start type of the budget.
|
startDate |
string Custom start date of the budget. Includes only one of the fields Start type of the budget. |
endDate |
string Required field. End date of the budget. |
ThresholdRule
Rules that define intermediate cost thresholds of the budget.
Field |
Description |
type |
enum ThresholdType Required field. Type of the rule.
|
amount |
string Required field. Amount of the rule.
|
notificationUserAccountIds[] |
string IDs of the yandex.cloud.iam.v1.UserAccount. |
ConsumptionFilter
Filter that can be used for specific resources selection.
Field |
Description |
serviceIds[] |
string IDs of the yandex.cloud.billing.v1.Service. |
cloudFoldersFilters[] |
Cloud and folders consumption filter. |
CloudFoldersConsumptionFilter
Filter that can be used for specific cloud and its folders selection.
Field |
Description |
cloudId |
string ID of the yandex.cloud.resourcemanager.v1.Cloud. |
folderIds[] |
string IDs of the yandex.cloud.resourcemanager.v1.Folder. |
ExpenseBudgetSpec
Expense budget specification describes budget that can be used to control expense of cloud resources usage.
Field |
Description |
amount |
string Required field. Max expense threshold of the budget. Amount currency is the same as corresponding yandex.cloud.billing.v1.BillingAccount.currency. |
notificationUserAccountIds[] |
string IDs of the yandex.cloud.iam.v1.UserAccount. |
thresholdRules[] |
List of the ThresholdRule. |
filter |
Filter that can be used for specific resources selection. Only consumption expense of selected resources are used for the budget calculation. |
resetPeriod |
enum ResetPeriodType Periodic start type that resets budget after specified period is finished. Includes only one of the fields Start type of the budget.
|
startDate |
string Custom start date of the budget. Includes only one of the fields Start type of the budget. |
endDate |
string Required field. End date of the budget. |
BalanceBudgetSpec
Balance budget specification describes budget that can be used to control yandex.cloud.billing.v1.BillingAccount.balance.
Field |
Description |
amount |
string Required field. Max balance threshold of the budget. Amount currency is the same as corresponding yandex.cloud.billing.v1.BillingAccount.currency. |
notificationUserAccountIds[] |
string IDs of the yandex.cloud.iam.v1.UserAccount. |
thresholdRules[] |
List of the ThresholdRule. |
startDate |
string Start_date of the budget. |
endDate |
string Required field. End date of the budget. |