Budgets - Create Or Update

Tjänst:: Consumption

API-version:: 2024-08-01

Åtgärden för att skapa eller uppdatera en budget. Du kan också ange en eTag om du vill som en form av samtidighetskontroll. Om du vill hämta den senaste eTag-koden för en viss budget utför du en get-åtgärd före put-åtgärden.

PUT https://management.azure.com/{scope}/providers/Microsoft.Consumption/budgets/{budgetName}?api-version=2024-08-01

URI-parametrar

Name	I	Obligatorisk	Typ	Description
budgetName	path	True	string	Budgetnamn.
scope	path	True	string	Resursens fullständigt kvalificerade Azure Resource Manager-identifierare.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Begärandetext

Name	Obligatorisk	Typ	Description
properties.amount	True	number (decimal)	Den totala kostnaden som ska spåras med budgeten
properties.category	True	CategoryType	Kategorin för budgeten, oavsett om budgeten spårar kostnader eller användning.
properties.timeGrain	True	TimeGrainType	Den tid som omfattas av en budget. Spårning av beloppet återställs baserat på tidsintervallet. BillingMonth, BillingQuarter och Billing Annual stöds endast av WD-kunder
properties.timePeriod	True	BudgetTimePeriod	Har start- och slutdatum för budgeten. Startdatumet måste vara det första i månaden och bör vara mindre än slutdatumet. Budgetstartdatum måste vara den 1 juni 2017 eller senare. Det framtida startdatumet får inte vara längre än tolv månader. Tidigare startdatum bör väljas inom tidsintervallet. Det finns inga begränsningar för slutdatumet.
eTag		string	eTag för resursen. För att hantera samtidiga uppdateringsscenarion används det här fältet för att avgöra om användaren uppdaterar den senaste versionen eller inte.
properties.filter		BudgetFilter	Kan användas för att filtrera budgetar efter användardefinierade dimensioner och/eller taggar.
properties.notifications		<string, Notification>	Ordlista med meddelanden som är associerade med budgeten. Budget kan ha upp till fem meddelanden.

Svar

Name	Typ	Description
200 OK	Budget	Uppdateringsåtgärden för resursen "Budget" lyckades
201 Created	Budget	Åtgärden för att skapa resursen "Budget" lyckades
Other Status Codes	ErrorResponse	Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

CreateOrUpdateBudget

Exempelbegäran

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Consumption/budgets/TestBudget?api-version=2024-08-01

{
  "eTag": "\"1d34d016a593709\"",
  "properties": {
    "amount": 100.65,
    "category": "Cost",
    "filter": {
      "and": [
        {
          "dimensions": {
            "name": "ResourceId",
            "operator": "In",
            "values": [
              "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Compute/virtualMachines/MSVM2",
              "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Compute/virtualMachines/platformcloudplatformGeneric1"
            ]
          }
        },
        {
          "tags": {
            "name": "category",
            "operator": "In",
            "values": [
              "Dev",
              "Prod"
            ]
          }
        },
        {
          "tags": {
            "name": "department",
            "operator": "In",
            "values": [
              "engineering",
              "sales"
            ]
          }
        }
      ]
    },
    "notifications": {
      "Actual_GreaterThan_80_Percent": {
        "contactEmails": [
          "johndoe@contoso.com",
          "janesmith@contoso.com"
        ],
        "contactGroups": [
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/microsoft.insights/actionGroups/SampleActionGroup"
        ],
        "contactRoles": [
          "Contributor",
          "Reader"
        ],
        "enabled": true,
        "locale": "en-us",
        "operator": "GreaterThan",
        "threshold": 80,
        "thresholdType": "Actual"
      }
    },
    "timeGrain": "Monthly",
    "timePeriod": {
      "endDate": "2018-10-31T00:00:00Z",
      "startDate": "2017-10-01T00:00:00Z"
    }
  }
}

Exempelsvar

Statuskod:: 200

{
  "name": "TestBudget",
  "type": "Microsoft.Consumption/budgets",
  "eTag": "\"1d34d012214157f\"",
  "id": "subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Consumption/budgets/TestBudget",
  "properties": {
    "amount": 100.65,
    "category": "Cost",
    "currentSpend": {
      "amount": 80.89,
      "unit": "USD"
    },
    "filter": {
      "and": [
        {
          "dimensions": {
            "name": "ResourceId",
            "operator": "In",
            "values": [
              "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Compute/virtualMachines/MSVM2",
              "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Compute/virtualMachines/platformcloudplatformGeneric1"
            ]
          }
        },
        {
          "tags": {
            "name": "category",
            "operator": "In",
            "values": [
              "Dev",
              "Prod"
            ]
          }
        },
        {
          "tags": {
            "name": "department",
            "operator": "In",
            "values": [
              "engineering",
              "sales"
            ]
          }
        }
      ]
    },
    "notifications": {
      "Actual_GreaterThan_80_Percent": {
        "contactEmails": [
          "johndoe@contoso.com",
          "janesmith@contoso.com"
        ],
        "contactGroups": [
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/microsoft.insights/actionGroups/SampleActionGroup"
        ],
        "contactRoles": [
          "Contributor",
          "Reader"
        ],
        "enabled": true,
        "locale": "en-us",
        "operator": "GreaterThan",
        "threshold": 80,
        "thresholdType": "Actual"
      }
    },
    "timeGrain": "Monthly",
    "timePeriod": {
      "endDate": "2018-10-31T00:00:00Z",
      "startDate": "2017-10-01T00:00:00Z"
    }
  }
}

Statuskod:: 201

{
  "name": "TestBudget",
  "type": "Microsoft.Consumption/budgets",
  "eTag": "\"1d34d012214157f\"",
  "id": "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Consumption/budgets/TestBudget",
  "properties": {
    "amount": 100.65,
    "category": "Cost",
    "currentSpend": {
      "amount": 80.89,
      "unit": "USD"
    },
    "filter": {
      "and": [
        {
          "dimensions": {
            "name": "ResourceId",
            "operator": "In",
            "values": [
              "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Compute/virtualMachines/MSVM2",
              "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/Microsoft.Compute/virtualMachines/platformcloudplatformGeneric1"
            ]
          }
        },
        {
          "tags": {
            "name": "category",
            "operator": "In",
            "values": [
              "Dev",
              "Prod"
            ]
          }
        },
        {
          "tags": {
            "name": "department",
            "operator": "In",
            "values": [
              "engineering",
              "sales"
            ]
          }
        }
      ]
    },
    "notifications": {
      "Actual_GreaterThan_80_Percent": {
        "contactEmails": [
          "johndoe@contoso.com",
          "janesmith@contoso.com"
        ],
        "contactGroups": [
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MYDEVTESTRG/providers/microsoft.insights/actionGroups/SampleActionGroup"
        ],
        "contactRoles": [
          "Contributor",
          "Reader"
        ],
        "enabled": true,
        "locale": "en-us",
        "operator": "GreaterThan",
        "threshold": 80,
        "thresholdType": "Actual"
      }
    },
    "timeGrain": "Monthly",
    "timePeriod": {
      "endDate": "2018-10-31T00:00:00Z",
      "startDate": "2017-10-01T00:00:00Z"
    }
  }
}

Definitioner

Name	Description
Budget	En budgetresurs.
BudgetComparisonExpression	Jämförelseuttrycket som ska användas i budgetarna.
BudgetFilter	Kan användas för att filtrera budgetar efter resursgrupp, resurs eller mätare.
BudgetFilterProperties	De dimensioner eller taggar som en budget ska filtreras efter.
BudgetOperatorType	Operatorn som ska användas för jämförelse.
BudgetTimePeriod	Start- och slutdatum för en budget.
CategoryType	Kategorin för budgeten, oavsett om budgeten spårar kostnader eller användning.
createdByType	Den typ av identitet som skapade resursen.
CultureCode	Språk där mottagaren får meddelandet
CurrentSpend	Det aktuella kostnadsbeloppet som spåras för en budget.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
ForecastSpend	Den prognostiserade kostnad som spåras för en budget.
Notification	Meddelandet som är associerat med en budget.
OperatorType	Jämförelseoperatorn.
systemData	Metadata som rör skapande och senaste ändring av resursen.
ThresholdType	Typ av tröskelvärde
TimeGrainType	Den tid som omfattas av en budget. Spårning av beloppet återställs baserat på tidsintervallet. BillingMonth, BillingQuarter och Billing Annual stöds endast av WD-kunder

Budget

Objekt

En budgetresurs.

Name	Typ	Description
eTag	string	eTag för resursen. För att hantera samtidiga uppdateringsscenarion används det här fältet för att avgöra om användaren uppdaterar den senaste versionen eller inte.
id	string	Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Namnet på resursen
properties.amount	number (decimal)	Den totala kostnaden som ska spåras med budgeten
properties.category	CategoryType	Kategorin för budgeten, oavsett om budgeten spårar kostnader eller användning.
properties.currentSpend	CurrentSpend	Det aktuella kostnadsbeloppet som spåras för en budget.
properties.filter	BudgetFilter	Kan användas för att filtrera budgetar efter användardefinierade dimensioner och/eller taggar.
properties.forecastSpend	ForecastSpend	Den prognostiserade kostnad som spåras för en budget.
properties.notifications	<string, Notification>	Ordlista med meddelanden som är associerade med budgeten. Budget kan ha upp till fem meddelanden.
properties.timeGrain	TimeGrainType	Den tid som omfattas av en budget. Spårning av beloppet återställs baserat på tidsintervallet. BillingMonth, BillingQuarter och Billing Annual stöds endast av WD-kunder
properties.timePeriod	BudgetTimePeriod	Har start- och slutdatum för budgeten. Startdatumet måste vara det första i månaden och bör vara mindre än slutdatumet. Budgetstartdatum måste vara den 1 juni 2017 eller senare. Det framtida startdatumet får inte vara längre än tolv månader. Tidigare startdatum bör väljas inom tidsintervallet. Det finns inga begränsningar för slutdatumet.
systemData	systemData	Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.
type	string	Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

BudgetComparisonExpression

Objekt

Jämförelseuttrycket som ska användas i budgetarna.

Name	Typ	Description
name	string	Namnet på kolumnen som ska användas i jämförelse.
operator	BudgetOperatorType	Operatorn som ska användas för jämförelse.
values	string[]	Matris med värden som ska användas för jämförelse

BudgetFilter

Objekt

Kan användas för att filtrera budgetar efter resursgrupp, resurs eller mätare.

Name	Typ	Description
and	BudgetFilterProperties[]	Det logiska "AND"-uttrycket. Måste ha minst 2 objekt.
dimensions	BudgetComparisonExpression	Har jämförelseuttryck för en dimension
tags	BudgetComparisonExpression	Har jämförelseuttryck för en tagg

BudgetFilterProperties

Objekt

De dimensioner eller taggar som en budget ska filtreras efter.

Name	Typ	Description
dimensions	BudgetComparisonExpression	Har jämförelseuttryck för en dimension
tags	BudgetComparisonExpression	Har jämförelseuttryck för en tagg

BudgetOperatorType

Uppräkning

Operatorn som ska användas för jämförelse.

Värde	Description
In

BudgetTimePeriod

Objekt

Start- och slutdatum för en budget.

Name	Typ	Description
endDate	string (date-time)	Slutdatum för budgeten. Om det inte anges är standardinställningen 10 år från startdatumet.
startDate	string (date-time)	Startdatum för budgeten.

CategoryType

Uppräkning

Kategorin för budgeten, oavsett om budgeten spårar kostnader eller användning.

Värde	Description
Cost

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Description
User
Application
ManagedIdentity
Key

CultureCode

Uppräkning

Språk där mottagaren får meddelandet

Värde	Description
en-us
ja-jp
zh-cn
de-de
es-es
fr-fr
it-it
ko-kr
pt-br
ru-ru
zh-tw
cs-cz
pl-pl
tr-tr
da-dk
en-gb
hu-hu
nb-no
nl-nl
pt-pt
sv-se

CurrentSpend

Objekt

Det aktuella kostnadsbeloppet som spåras för en budget.

Name	Typ	Description
amount	number (decimal)	Den totala kostnad som spåras av budgeten.
unit	string	Måttenheten för budgetbeloppet.

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Objekt

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Objekt

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

ForecastSpend

Objekt

Den prognostiserade kostnad som spåras för en budget.

Name	Typ	Description
amount	number (decimal)	Den prognostiserade kostnaden för den totala tidsperiod som spåras av budgeten. Det här värdet anges endast om budgeten innehåller en prognosaviseringstyp.
unit	string	Måttenheten för budgetbeloppet.

Notification

Objekt

Meddelandet som är associerat med en budget.

Name	Typ	Standardvärde	Description
contactEmails	string[]		E-postadresser för att skicka budgetmeddelandet till när tröskelvärdet överskrids. Minst en kontakt-e-post eller kontaktgrupp måste anges i omfånget Prenumeration eller Resursgrupp. Alla andra omfång måste ha minst en e-postadress för kontakten angiven.
contactGroups	string[]		Åtgärdsgrupper som ska skicka budgetmeddelandet till när tröskelvärdet överskrids. Måste anges som ett fullständigt kvalificerat Azure-resurs-ID. Stöds endast i prenumerations- eller resursgruppsomfång.
contactRoles	string[]		Kontakta roller för att skicka budgetmeddelandet till när tröskelvärdet överskrids.
enabled	boolean		Meddelandet är aktiverat eller inte.
locale	CultureCode		Språk där mottagaren får meddelandet
operator	OperatorType		Jämförelseoperatorn.
threshold	number (decimal)		Tröskelvärde som är associerat med ett meddelande. Meddelande skickas när kostnaden överskred tröskelvärdet. Det är alltid procent och måste vara mellan 0 och 1000.
thresholdType	ThresholdType	Actual	Typ av tröskelvärde

OperatorType

Uppräkning

Jämförelseoperatorn.

Värde	Description
EqualTo	Aviseringen utlöses om den utvärderade kostnaden är samma som tröskelvärdet. Obs! Vi rekommenderar inte att du använder den här OperatorType eftersom det är låg risk att kostnaden blir exakt samma som tröskelvärdet, vilket leder till att aviseringen saknas. OperatorType kommer att bli inaktuell i framtiden.
GreaterThan	Aviseringen utlöses om den utvärderade kostnaden är större än tröskelvärdet. Obs! Det här är den rekommenderade OperatorType när du konfigurerar budgetavisering.
GreaterThanOrEqualTo	Aviseringen utlöses om den utvärderade kostnaden är större än eller lika med tröskelvärdet.

systemData

Objekt

Metadata som rör skapande och senaste ändring av resursen.

Name	Typ	Description
createdAt	string (date-time)	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string (date-time)	Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.

ThresholdType

Uppräkning

Typ av tröskelvärde

Värde	Description
Actual	Budgetaviseringar för faktiska kostnader meddelar när den faktiska upplupna kostnaden överskrider den allokerade budgeten .
Forecasted	Budgetaviseringar för prognostiserade kostnader ger ett avancerat meddelande om att dina utgiftstrender sannolikt kommer att överskrida din allokerade budget, eftersom den förlitar sig på prognostiserade kostnadsförutsägelser.

TimeGrainType

Uppräkning

Den tid som omfattas av en budget. Spårning av beloppet återställs baserat på tidsintervallet. BillingMonth, BillingQuarter och Billing Annual stöds endast av WD-kunder

Värde	Description
Monthly
Quarterly
Annually
BillingMonth
BillingQuarter
BillingAnnual

Dela via

Budgets - Create Or Update

URI-parametrar

Begärandetext

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

CreateOrUpdateBudget

Exempelbegäran

Exempelsvar

Definitioner

Budget

BudgetComparisonExpression

BudgetFilter

BudgetFilterProperties

BudgetOperatorType

BudgetTimePeriod

CategoryType

createdByType

CultureCode

CurrentSpend

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ForecastSpend

Notification

OperatorType

systemData

ThresholdType

TimeGrainType