You need to enable JavaScript to run this app.
导航
UpdateBudget - 更新预算
最近更新时间:2025.11.20 17:10:17首次发布时间:2025.10.17 15:10:53
复制全文
我的收藏
有用
有用
无用
无用

更新预算的详细信息

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数

参数
类型
是否必填
示例值
描述
Action
String

UpdateBudget

要执行的操作,取值:UpdateBudget。

Version
String

2022-01-01

API的版本,取值:2022-01-01。

BudgetID
String

bg7561472907441230124

具体所要更新的预算ID

BudgetRange
Object

{
"Tag": [
"{"voKey5":["vhh"]}"
],
"PayerID": [
2100266035
],
"Region": [
"R000807"
],
"OwnerID": [
2100266035
],
"BillingMode": [
"1"
],
"Project": [
"project_test"
],
"Product": [
"CDN"
],
"Zone": [
"{"R000807":""}"
],
"SubjectNo": [
"3423"
]
}

预算范围

Budget
Object

{
"BudgetType": "cost_budget",
"BudgetPlanType": "fixed_amount",
"BudgetStartTime": "2025-03",
"BudgetName": "test_budget",
"Period": "month",
"BudgetEndTime": "2025-12"
}

预算信息

BudgetAmount
Array of Object

[
{
"BudgetPeriod": "2025-10",
"BudgetAmount": "100"
}
]

预算金额

BudgetAlertRule
Array of Object

[
{
"BudgetAlertItem": "actual_amount",
"BudgetAlertThresholdType": "amount",
"BudgetAlertThreshold": "200"
}
]

报警阈值规则

BudgetAlertMessage
Array of Object

[
{
"EmailSendSwitch": 0,
"MessageSendSwitch": 0,
"InternalSendSwitch": 0,
"RecipientID": 123456
}
]

报警发送人

返回参数

本接口无特有的返回参数。更多信息请见返回结构

请求示例

{
    "BudgetID": "bg7561472907441230124",
    "Budget": {
      "BudgetType": "cost_budget",
      "BudgetPlanType": "fixed_amount",
      "BudgetStartTime": "2025-03",
      "BudgetName": "test_budget",
      "Period": "month",
      "BudgetEndTime": "2025-12"
    },
    "BudgetRange": {
      "Tag": [
        "{\"voKey5\":[\"vhh\"]}"
      ],
      "PayerID": [
        2100266035
      ],
      "Region": [
        "R000807"
      ],
      "OwnerID": [
        2100266035
      ],
      "BillingMode": [
        "1"
      ],
      "Project": [
        "project_test"
      ],
      "Product": [
        "CDN"
      ],
      "Zone": [
        "{\"R000807\":\"\"}"
      ],
      "SubjectNo": [
        "3423"
      ]
    },
    "BudgetAmount": [
      {
        "BudgetPeriod": "2025-10",
        "BudgetAmount": "100"
      }
    ],
    "BudgetAlertRule": [
      {
        "BudgetAlertItem": "actual_amount",
        "BudgetAlertThresholdType": "amount",
        "BudgetAlertThreshold": "200"
      }
    ],
    "BudgetAlertMessage": [
      {
        "EmailSendSwitch": 0,
        "MessageSendSwitch": 0,
        "InternalSendSwitch": 0,
        "RecipientID": 123456
      }
    ]
  }

返回示例

{
  Metadata: {
    RequestId: "20251016011229F29CB788CE435F03613C",
    Action: "UpdateBudget",
    Version: "2022-01-01",
    Service: "billing",
    Region: "cn-beijing",
    HTTPCode: 200
  }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码
错误码
错误信息
说明
400
MissingParameter

The required parameter %s is missing.

参数缺失

400
OperationDenied.NoneAvailableReceivers

None available alert receiver.

没有设置报警接收人

400
OperationDenied.ReachedBudgetCreateNumberLimit

Reached budget create number limit 100.

预算报警创建数量已抵达阈值100

400
OperationDenied.BudgetNameExist

Budget name exist.

预算名称已存在

400
OperationDenied.BudgetAmountNotExist

Budget amount not exist, budgetAmountId: %s

请求更新的预算金额不存在

400
InvalidParameter

The parameter %s not in %s.

参数不符合枚举规范

400
OperationDenied.BudgetEndTimeInvalid

Budget end time cannot be earlier than the current time.

预算结束时间不能早于当前时间

400
OperationDenied.BudgetAlertRuleNotExist

Budget alert rule not exist, budgetAlertRuleId: %s

请求更新的预算报警规则不存在

400
OperationDenied.BudgetNotExist

Budget not exist.

请求更新的预算不存在

400
OperationDenied.InvalidRecipientID

InvalidRecipientID %d not belong .response

消息接收人ID不在ListRecipientInformation接口的返回集中。

500
InternalServerError

The request has failed due to an unknown error.

系统错误,多次出现时请联系管理员