Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Definicja zasobu Bicep
Typ zasobu budżetów można wdrożyć przy użyciu operacji docelowych:
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Format zasobu
Aby utworzyć zasób Microsoft.Consumption/budgets, dodaj następujący kod Bicep do szablonu.
resource symbolicname 'Microsoft.Consumption/budgets@2018-03-31' = {
scope: resourceSymbolicName or scope
eTag: 'string'
name: 'string'
properties: {
amount: int
category: 'string'
filters: {
meters: [
'string'
]
resourceGroups: [
'string'
]
resources: [
'string'
]
tags: {
{customized property}: [
'string'
]
}
}
notifications: {
{customized property}: {
contactEmails: [
'string'
]
contactGroups: [
'string'
]
contactRoles: [
'string'
]
enabled: bool
operator: 'string'
threshold: int
}
}
timeGrain: 'string'
timePeriod: {
endDate: 'string'
startDate: 'string'
}
}
}
Wartości właściwości
Microsoft.Consumption/budgets
| Nazwa | Opis | Wartość |
|---|---|---|
| eTag | Element eTag zasobu. Aby obsłużyć scenariusz aktualizacji współbieżnych, to pole będzie używane do określenia, czy użytkownik aktualizuje najnowszą wersję, czy nie. | ciąg |
| nazwa | Nazwa zasobu | ciąg (wymagany) |
| Właściwości | Właściwości budżetu. | Właściwości budżetu |
| zakres | Użyj polecenia podczas tworzenia zasobu w zakresie innym niż zakres wdrożenia. | Ustaw tę właściwość na symboliczną nazwę zasobu, aby zastosować zasób rozszerzenia. |
Właściwości budżetu
| Nazwa | Opis | Wartość |
|---|---|---|
| kwota | Łączna kwota kosztów do śledzenia przy użyciu budżetu | int (wymagane) |
| kategoria | Kategoria budżetu, niezależnie od tego, czy budżet śledzi koszt, czy użycie. | "Koszt" "Użycie" (wymagane) |
| Filtry | Może służyć do filtrowania budżetów według grupy zasobów, zasobu lub miernika. | filtry |
| Powiadomienia | Słownik powiadomień skojarzonych z budżetem. Budżet może mieć maksymalnie pięć powiadomień. | BudgetPropertiesNotifications |
| timeGrain | Czas objęty budżetem. Śledzenie ilości zostanie zresetowane na podstawie ziarna czasu. | "Rocznie" "Co miesiąc" "Kwartalny" (wymagany) |
| timePeriod | Ma datę rozpoczęcia i zakończenia budżetu. Data rozpoczęcia musi być pierwsza z miesiąca i powinna być mniejsza niż data zakończenia. Data rozpoczęcia budżetu musi być 1 czerwca 2017 r. lub późniejsza. Data rozpoczęcia w przyszłości nie powinna być większa niż trzy miesiące. W przedziale czasu należy wybrać poprzednią datę rozpoczęcia. Nie ma żadnych ograniczeń dotyczących daty zakończenia. | BudgetTimePeriod (wymagane) |
BudgetPropertiesNotifications
| Nazwa | Opis | Wartość |
|---|
BudgetTimePeriod
| Nazwa | Opis | Wartość |
|---|---|---|
| data zakończenia | Data zakończenia budżetu. Jeśli nie zostanie podana, wartość domyślna to 10 lat od daty rozpoczęcia. | ciąg |
| data rozpoczęcia | Data rozpoczęcia budżetu. | ciąg (wymagany) |
Filtry
| Nazwa | Opis | Wartość |
|---|---|---|
| Metrów | Lista filtrów mierników (GUID), obowiązkowych dla budżetów kategorii użycia. | struna Ograniczenia: Minimalna długość = 36 Maksymalna długość = 36 Wzorzec = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$[] |
| Grupy zasobów | Lista filtrów dla grup zasobów dozwolonych tylko na poziomie subskrypcji. | string[] |
| zasoby | Lista filtrów dotyczących zasobów. | string[] |
| Tagi | Słownik filtrów tagów. | filtry Tagi |
FiltryTagi
| Nazwa | Opis | Wartość |
|---|
Powiadomienie
| Nazwa | Opis | Wartość |
|---|---|---|
| contactEmails | Adresy e-mail do wysyłania powiadomienia o budżecie do momentu przekroczenia progu. | string[] (wymagane) |
| contactGroups | Grupy akcji wysyłające powiadomienie o budżecie do momentu przekroczenia progu. | string[] |
| contactRoles | Role kontaktu w celu wysłania powiadomienia o budżecie do momentu przekroczenia progu. | string[] |
| Włączone | Powiadomienie jest włączone lub nie. | bool (wymagane) |
| operator | Operator porównania. | "EqualTo" "GreaterThan" "GreaterThanOrEqualTo" (wymagane) |
| próg | Wartość progowa skojarzona z powiadomieniem. Powiadomienie jest wysyłane, gdy koszt przekroczył próg. Zawsze jest to procent i musi należeć do przedziału od 0 do 1000. | int (wymagane) |
Przykłady użycia
Moduły zweryfikowane na platformie Azure
Następujące moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.
| Moduł | Opis |
|---|---|
| budżet użycia | Moduł zasobów AVM na potrzeby budżetu użycia |
Przykłady szybkiego startu platformy Azure
Poniższe szablony szybkiego startu platformy Azure zawierają przykłady Bicep na potrzeby wdrażania tego typu zasobu.
| Plik Bicep | Opis |
|---|---|
| Tworzenie budżetu | W tym szablonie pokazano, jak utworzyć budżet w ramach subskrypcji. |
| Tworzenie budżetu przy użyciu filtru | W tym szablonie pokazano, jak utworzyć budżet w ramach subskrypcji. |
| tworzenie prostego budżetu | W tym szablonie pokazano, jak utworzyć budżet w ramach subskrypcji. |
Definicja zasobu szablonu usługi ARM
Typ zasobu budżetów można wdrożyć przy użyciu operacji docelowych:
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Format zasobu
Aby utworzyć zasób Microsoft.Consumption/budgets, dodaj następujący kod JSON do szablonu.
{
"type": "Microsoft.Consumption/budgets",
"apiVersion": "2018-03-31",
"name": "string",
"eTag": "string",
"properties": {
"amount": "int",
"category": "string",
"filters": {
"meters": [ "string" ],
"resourceGroups": [ "string" ],
"resources": [ "string" ],
"tags": {
"{customized property}": [ "string" ]
}
},
"notifications": {
"{customized property}": {
"contactEmails": [ "string" ],
"contactGroups": [ "string" ],
"contactRoles": [ "string" ],
"enabled": "bool",
"operator": "string",
"threshold": "int"
}
},
"timeGrain": "string",
"timePeriod": {
"endDate": "string",
"startDate": "string"
}
}
}
Wartości właściwości
Microsoft.Consumption/budgets
| Nazwa | Opis | Wartość |
|---|---|---|
| apiVersion | Wersja interfejsu API | '2018-03-31' |
| eTag | Element eTag zasobu. Aby obsłużyć scenariusz aktualizacji współbieżnych, to pole będzie używane do określenia, czy użytkownik aktualizuje najnowszą wersję, czy nie. | ciąg |
| nazwa | Nazwa zasobu | ciąg (wymagany) |
| Właściwości | Właściwości budżetu. | Właściwości budżetu |
| typ | Typ zasobu | "Microsoft.Consumption/budgets" |
Właściwości budżetu
| Nazwa | Opis | Wartość |
|---|---|---|
| kwota | Łączna kwota kosztów do śledzenia przy użyciu budżetu | int (wymagane) |
| kategoria | Kategoria budżetu, niezależnie od tego, czy budżet śledzi koszt, czy użycie. | "Koszt" "Użycie" (wymagane) |
| Filtry | Może służyć do filtrowania budżetów według grupy zasobów, zasobu lub miernika. | filtry |
| Powiadomienia | Słownik powiadomień skojarzonych z budżetem. Budżet może mieć maksymalnie pięć powiadomień. | BudgetPropertiesNotifications |
| timeGrain | Czas objęty budżetem. Śledzenie ilości zostanie zresetowane na podstawie ziarna czasu. | "Rocznie" "Co miesiąc" "Kwartalny" (wymagany) |
| timePeriod | Ma datę rozpoczęcia i zakończenia budżetu. Data rozpoczęcia musi być pierwsza z miesiąca i powinna być mniejsza niż data zakończenia. Data rozpoczęcia budżetu musi być 1 czerwca 2017 r. lub późniejsza. Data rozpoczęcia w przyszłości nie powinna być większa niż trzy miesiące. W przedziale czasu należy wybrać poprzednią datę rozpoczęcia. Nie ma żadnych ograniczeń dotyczących daty zakończenia. | BudgetTimePeriod (wymagane) |
BudgetPropertiesNotifications
| Nazwa | Opis | Wartość |
|---|
BudgetTimePeriod
| Nazwa | Opis | Wartość |
|---|---|---|
| data zakończenia | Data zakończenia budżetu. Jeśli nie zostanie podana, wartość domyślna to 10 lat od daty rozpoczęcia. | ciąg |
| data rozpoczęcia | Data rozpoczęcia budżetu. | ciąg (wymagany) |
Filtry
| Nazwa | Opis | Wartość |
|---|---|---|
| Metrów | Lista filtrów mierników (GUID), obowiązkowych dla budżetów kategorii użycia. | struna Ograniczenia: Minimalna długość = 36 Maksymalna długość = 36 Wzorzec = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$[] |
| Grupy zasobów | Lista filtrów dla grup zasobów dozwolonych tylko na poziomie subskrypcji. | string[] |
| zasoby | Lista filtrów dotyczących zasobów. | string[] |
| Tagi | Słownik filtrów tagów. | filtry Tagi |
FiltryTagi
| Nazwa | Opis | Wartość |
|---|
Powiadomienie
| Nazwa | Opis | Wartość |
|---|---|---|
| contactEmails | Adresy e-mail do wysyłania powiadomienia o budżecie do momentu przekroczenia progu. | string[] (wymagane) |
| contactGroups | Grupy akcji wysyłające powiadomienie o budżecie do momentu przekroczenia progu. | string[] |
| contactRoles | Role kontaktu w celu wysłania powiadomienia o budżecie do momentu przekroczenia progu. | string[] |
| Włączone | Powiadomienie jest włączone lub nie. | bool (wymagane) |
| operator | Operator porównania. | "EqualTo" "GreaterThan" "GreaterThanOrEqualTo" (wymagane) |
| próg | Wartość progowa skojarzona z powiadomieniem. Powiadomienie jest wysyłane, gdy koszt przekroczył próg. Zawsze jest to procent i musi należeć do przedziału od 0 do 1000. | int (wymagane) |
Przykłady użycia
Szablony szybkiego startu platformy Azure
Następujące szablony szybkiego startu platformy Azure wdrożyć ten typ zasobu.
| Szablon | Opis |
|---|---|
|
Tworzenie budżetu wdrażanie |
W tym szablonie pokazano, jak utworzyć budżet w ramach subskrypcji. |
|
Tworzenie budżetu przy użyciu filtru wdrażanie |
W tym szablonie pokazano, jak utworzyć budżet w ramach subskrypcji. |
|
tworzenie prostego budżetu wdrażanie |
W tym szablonie pokazano, jak utworzyć budżet w ramach subskrypcji. |
Definicja zasobu narzędzia Terraform (dostawcy AzAPI)
Typ zasobu budżetów można wdrożyć przy użyciu operacji docelowych:
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Format zasobu
Aby utworzyć zasób Microsoft.Consumption/budgets, dodaj następujący program Terraform do szablonu.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Consumption/budgets@2018-03-31"
name = "string"
parent_id = "string"
body = {
eTag = "string"
properties = {
amount = int
category = "string"
filters = {
meters = [
"string"
]
resourceGroups = [
"string"
]
resources = [
"string"
]
tags = {
{customized property} = [
"string"
]
}
}
notifications = {
{customized property} = {
contactEmails = [
"string"
]
contactGroups = [
"string"
]
contactRoles = [
"string"
]
enabled = bool
operator = "string"
threshold = int
}
}
timeGrain = "string"
timePeriod = {
endDate = "string"
startDate = "string"
}
}
}
}
Wartości właściwości
Microsoft.Consumption/budgets
| Nazwa | Opis | Wartość |
|---|---|---|
| eTag | Element eTag zasobu. Aby obsłużyć scenariusz aktualizacji współbieżnych, to pole będzie używane do określenia, czy użytkownik aktualizuje najnowszą wersję, czy nie. | ciąg |
| nazwa | Nazwa zasobu | ciąg (wymagany) |
| parent_id | Identyfikator zasobu, do który ma być stosowany ten zasób rozszerzenia. | ciąg (wymagany) |
| Właściwości | Właściwości budżetu. | Właściwości budżetu |
| typ | Typ zasobu | "Microsoft.Consumption/budgets@2018-03-31" |
Właściwości budżetu
| Nazwa | Opis | Wartość |
|---|---|---|
| kwota | Łączna kwota kosztów do śledzenia przy użyciu budżetu | int (wymagane) |
| kategoria | Kategoria budżetu, niezależnie od tego, czy budżet śledzi koszt, czy użycie. | "Koszt" "Użycie" (wymagane) |
| Filtry | Może służyć do filtrowania budżetów według grupy zasobów, zasobu lub miernika. | filtry |
| Powiadomienia | Słownik powiadomień skojarzonych z budżetem. Budżet może mieć maksymalnie pięć powiadomień. | BudgetPropertiesNotifications |
| timeGrain | Czas objęty budżetem. Śledzenie ilości zostanie zresetowane na podstawie ziarna czasu. | "Rocznie" "Co miesiąc" "Kwartalny" (wymagany) |
| timePeriod | Ma datę rozpoczęcia i zakończenia budżetu. Data rozpoczęcia musi być pierwsza z miesiąca i powinna być mniejsza niż data zakończenia. Data rozpoczęcia budżetu musi być 1 czerwca 2017 r. lub późniejsza. Data rozpoczęcia w przyszłości nie powinna być większa niż trzy miesiące. W przedziale czasu należy wybrać poprzednią datę rozpoczęcia. Nie ma żadnych ograniczeń dotyczących daty zakończenia. | BudgetTimePeriod (wymagane) |
BudgetPropertiesNotifications
| Nazwa | Opis | Wartość |
|---|
BudgetTimePeriod
| Nazwa | Opis | Wartość |
|---|---|---|
| data zakończenia | Data zakończenia budżetu. Jeśli nie zostanie podana, wartość domyślna to 10 lat od daty rozpoczęcia. | ciąg |
| data rozpoczęcia | Data rozpoczęcia budżetu. | ciąg (wymagany) |
Filtry
| Nazwa | Opis | Wartość |
|---|---|---|
| Metrów | Lista filtrów mierników (GUID), obowiązkowych dla budżetów kategorii użycia. | struna Ograniczenia: Minimalna długość = 36 Maksymalna długość = 36 Wzorzec = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$[] |
| Grupy zasobów | Lista filtrów dla grup zasobów dozwolonych tylko na poziomie subskrypcji. | string[] |
| zasoby | Lista filtrów dotyczących zasobów. | string[] |
| Tagi | Słownik filtrów tagów. | filtry Tagi |
FiltryTagi
| Nazwa | Opis | Wartość |
|---|
Powiadomienie
| Nazwa | Opis | Wartość |
|---|---|---|
| contactEmails | Adresy e-mail do wysyłania powiadomienia o budżecie do momentu przekroczenia progu. | string[] (wymagane) |
| contactGroups | Grupy akcji wysyłające powiadomienie o budżecie do momentu przekroczenia progu. | string[] |
| contactRoles | Role kontaktu w celu wysłania powiadomienia o budżecie do momentu przekroczenia progu. | string[] |
| Włączone | Powiadomienie jest włączone lub nie. | bool (wymagane) |
| operator | Operator porównania. | "EqualTo" "GreaterThan" "GreaterThanOrEqualTo" (wymagane) |
| próg | Wartość progowa skojarzona z powiadomieniem. Powiadomienie jest wysyłane, gdy koszt przekroczył próg. Zawsze jest to procent i musi należeć do przedziału od 0 do 1000. | int (wymagane) |
Przykłady użycia
Przykłady programu Terraform
Podstawowy przykład wdrożenia Budżetu Zużycia.
terraform {
required_providers {
azapi = {
source = "Azure/azapi"
}
}
}
provider "azapi" {
skip_provider_registration = false
}
variable "resource_name" {
type = string
default = "acctest0001"
}
variable "location" {
type = string
default = "westus"
}
resource "azapi_resource" "resourceGroup" {
type = "Microsoft.Resources/resourceGroups@2020-06-01"
name = var.resource_name
location = var.location
}
resource "azapi_resource" "budget" {
type = "Microsoft.Consumption/budgets@2019-10-01"
parent_id = azapi_resource.resourceGroup.id
name = var.resource_name
body = {
properties = {
amount = 1000
category = "Cost"
filter = {
tags = {
name = "foo"
operator = "In"
values = ["bar"]
}
}
notifications = {
"Actual_EqualTo_90.000000_Percent" = {
contactEmails = ["foo@example.com", "bar@example.com"]
contactGroups = []
contactRoles = []
enabled = true
operator = "EqualTo"
threshold = 90
thresholdType = "Actual"
}
}
timeGrain = "Monthly"
timePeriod = {
startDate = "2025-08-01T00:00:00Z"
}
}
}
}