你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Budgets - Create Or Update

服务:: Consumption

API 版本:: 2024-08-01

用于创建或更新预算的作。如果需要，可以选择提供 eTag 作为并发控制的形式。若要获取给定预算的最新 eTag，请在放置作之前执行 get作。

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

URI 参数

名称	在	必需	类型	说明
budgetName	path	True	string	预算名称。
scope	path	True	string	资源的完全限定的 Azure 资源管理器标识符。
api-version	query	True	string minLength: 1	要用于此操作的 API 版本。

请求正文

名称	必需	类型	说明
properties.amount	True	number (decimal)	用于跟踪预算的总成本
properties.category	True	CategoryType	预算类别，无论是预算跟踪成本还是使用情况。
properties.timeGrain	True	TimeGrainType	预算涵盖的时间。将根据时间粒度重置对金额的跟踪。仅 WD 客户支持 BillingMonth、BillingQuarter 和 BillingAnnual
properties.timePeriod	True	BudgetTimePeriod	预算的开始日期和结束日期。开始日期必须是月份的第一个，并且应小于结束日期。预算开始日期必须在 2017 年 6 月 1 日或之后。未来的开始日期不应超过 12 个月。应在时间段内选择过去的开始日期。结束日期没有限制。
eTag		string	资源的 eTag。若要处理并发更新方案，此字段将用于确定用户是否正在更新最新版本。
properties.filter		BudgetFilter	可用于按用户指定的维度和/或标记筛选预算。
properties.notifications		<string, Notification>	与预算关联的通知字典。预算最多可以有五个通知。

响应

名称	类型	说明
200 OK	Budget	资源“预算”更新作成功
201 Created	Budget	资源“预算”创建作成功
Other Status Codes	ErrorResponse	意外错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

CreateOrUpdateBudget

示例请求

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"
    }
  }
}

示例响应

状态代码:: 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"
    }
  }
}

状态代码:: 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"
    }
  }
}

定义

名称	说明
Budget	预算资源。
BudgetComparisonExpression	要用于预算的比较表达式。
BudgetFilter	可用于按资源组、资源或计量筛选预算。
BudgetFilterProperties	要按其筛选预算的维度或标记。
BudgetOperatorType	要用于比较的运算符。
BudgetTimePeriod	预算的开始日期和结束日期。
CategoryType	预算类别，无论是预算跟踪成本还是使用情况。
createdByType	创建资源的标识的类型。
CultureCode	收件人接收通知的语言
CurrentSpend	正在跟踪预算的当前成本量。
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
ErrorResponse	错误响应
ForecastSpend	正在跟踪预算的预测成本。
Notification	与预算关联的通知。
OperatorType	比较运算符。
systemData	与创建和上次修改资源相关的元数据。
ThresholdType	阈值的类型
TimeGrainType	预算涵盖的时间。将根据时间粒度重置对金额的跟踪。仅 WD 客户支持 BillingMonth、BillingQuarter 和 BillingAnnual

Budget

Object

预算资源。

名称	类型	说明
eTag	string	资源的 eTag。若要处理并发更新方案，此字段将用于确定用户是否正在更新最新版本。
id	string	资源的完全限定资源 ID。示例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	资源的名称
properties.amount	number (decimal)	用于跟踪预算的总成本
properties.category	CategoryType	预算类别，无论是预算跟踪成本还是使用情况。
properties.currentSpend	CurrentSpend	正在跟踪预算的当前成本量。
properties.filter	BudgetFilter	可用于按用户指定的维度和/或标记筛选预算。
properties.forecastSpend	ForecastSpend	正在跟踪预算的预测成本。
properties.notifications	<string, Notification>	与预算关联的通知字典。预算最多可以有五个通知。
properties.timeGrain	TimeGrainType	预算涵盖的时间。将根据时间粒度重置对金额的跟踪。仅 WD 客户支持 BillingMonth、BillingQuarter 和 BillingAnnual
properties.timePeriod	BudgetTimePeriod	预算的开始日期和结束日期。开始日期必须是月份的第一个，并且应小于结束日期。预算开始日期必须在 2017 年 6 月 1 日或之后。未来的开始日期不应超过 12 个月。应在时间段内选择过去的开始日期。结束日期没有限制。
systemData	systemData	包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
type	string	资源类型。例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

BudgetComparisonExpression

Object

要用于预算的比较表达式。

名称	类型	说明
name	string	要进行比较的列的名称。
operator	BudgetOperatorType	要用于比较的运算符。
values	string[]	要用于比较的值数组

BudgetFilter

Object

可用于按资源组、资源或计量筛选预算。

名称	类型	说明
and	BudgetFilterProperties[]	逻辑“AND”表达式。必须至少有 2 个项目。
dimensions	BudgetComparisonExpression	具有维度的比较表达式
tags	BudgetComparisonExpression	具有标记的比较表达式

BudgetFilterProperties

Object

要按其筛选预算的维度或标记。

名称	类型	说明
dimensions	BudgetComparisonExpression	具有维度的比较表达式
tags	BudgetComparisonExpression	具有标记的比较表达式

BudgetOperatorType

枚举

要用于比较的运算符。

值	说明
In

BudgetTimePeriod

Object

预算的开始日期和结束日期。

名称	类型	说明
endDate	string (date-time)	预算的结束日期。如果未提供，则从开始日期默认为 10 年。
startDate	string (date-time)	预算的开始日期。

CategoryType

枚举

预算类别，无论是预算跟踪成本还是使用情况。

值	说明
Cost

createdByType

枚举

创建资源的标识的类型。

值	说明
User
Application
ManagedIdentity
Key

CultureCode

枚举

收件人接收通知的语言

值	说明
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

Object

正在跟踪预算的当前成本量。

名称	类型	说明
amount	number (decimal)	预算跟踪的总成本量。
unit	string	预算金额的度量单位。

ErrorAdditionalInfo

Object

资源管理错误附加信息。

名称	类型	说明
info	object	其他信息。
type	string	其他信息类型。

ErrorDetail

Object

错误详细信息。

名称	类型	说明
additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
code	string	错误代码。
details	ErrorDetail[]	错误详细信息。
message	string	错误消息。
target	string	错误目标。

ErrorResponse

Object

错误响应

名称	类型	说明
error	ErrorDetail	错误对象。

ForecastSpend

Object

正在跟踪预算的预测成本。

名称	类型	说明
amount	number (decimal)	预算跟踪的总时间段的预测成本。仅当预算包含预测警报类型时，才提供此值。
unit	string	预算金额的度量单位。

Notification

Object

与预算关联的通知。

名称	类型	默认值	说明
contactEmails	string[]		用于在超出阈值时将预算通知发送到的电子邮件地址。必须在订阅或资源组范围内至少指定一个联系人电子邮件或联系人组。所有其他范围必须至少指定一个联系人电子邮件。
contactGroups	string[]		要向超出阈值时发送预算通知的操作组。必须以完全限定的 Azure 资源 ID 的形式提供。仅在订阅或资源组范围内受支持。
contactRoles	string[]		联系角色，将预算通知发送到超出阈值时。
enabled	boolean		通知已启用或不启用。
locale	CultureCode		收件人接收通知的语言
operator	OperatorType		比较运算符。
threshold	number (decimal)		与通知关联的阈值。当成本超出阈值时发送通知。它始终是百分比，必须介于 0 到 1000 之间。
thresholdType	ThresholdType	Actual	阈值的类型

OperatorType

枚举

比较运算符。

值	说明
EqualTo	如果评估的成本与阈值相同，将触发警报。注意：不建议使用此 OperatorType，因为成本与阈值完全相同，从而导致警报缺失。将来将弃用此 OperatorType。
GreaterThan	如果评估的成本大于阈值，将触发警报。注意：这是配置预算警报时建议的 OperatorType。
GreaterThanOrEqualTo	如果评估的成本大于或等于阈值，将触发警报。

systemData

Object

与创建和上次修改资源相关的元数据。

名称	类型	说明
createdAt	string (date-time)	资源创建时间戳（UTC）。
createdBy	string	创建资源的标识。
createdByType	createdByType	创建资源的标识的类型。
lastModifiedAt	string (date-time)	上次修改的资源时间戳（UTC）
lastModifiedBy	string	上次修改资源的标识。
lastModifiedByType	createdByType	上次修改资源的标识的类型。

ThresholdType

枚举

阈值的类型

值	说明
Actual	实际成本预算警报通知实际应计成本超过已分配预算的时间。
Forecasted	预测成本预算警报提供高级通知，指出支出趋势可能超过分配的预算，因为它依赖于预测的成本预测。

TimeGrainType

枚举

预算涵盖的时间。将根据时间粒度重置对金额的跟踪。仅 WD 客户支持 BillingMonth、BillingQuarter 和 BillingAnnual

值	说明
Monthly
Quarterly
Annually
BillingMonth
BillingQuarter
BillingAnnual

通过

Budgets - Create Or Update

URI 参数

请求正文

响应

安全性

azure_auth

作用域

示例

CreateOrUpdateBudget

示例请求

示例响应

定义

Budget

BudgetComparisonExpression

BudgetFilter

BudgetFilterProperties

BudgetOperatorType

BudgetTimePeriod

CategoryType

createdByType

CultureCode

CurrentSpend

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ForecastSpend

Notification

OperatorType

systemData

ThresholdType

TimeGrainType