You need to enable JavaScript to run this app.
文档中心
费用中心

费用中心

复制全文
下载 pdf
费用管理
CreateBudget - 创建预算
复制全文
下载 pdf
CreateBudget - 创建预算

创建预算

请求参数

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

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

CreateBudget

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

Version
String

2022-01-01

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

Budget
Object

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

预算信息

BudgetRange
Object

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

预算范围

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
String

bg7561497585933242668

创建成功的预算ID

请求示例

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

返回示例

{
  "ResponseMetadata": {
    "RequestId": "202510161501020F4B595169ADB5D5A63A",
    "Action": "CreateBudget",
    "Version": "2022-01-01",
    "Service": "billing",
    "Region": "cn-beijing"
  },
   "BudgetID": "bg7561497585933242668"
}

错误码

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

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

The required parameter %s is missing.

参数缺失

400
OperationDenied.ReachedBudgetCreateNumberLimit

Reached budget create number limit 100.

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

400
OperationDenied.NoneAvailableReceivers

None available alert receiver.

没有设置报警接收人

400
OperationDenied.BudgetNameExist

Budget name exist.

预算名称已存在

400
OperationDenied.BudgetEndTimeInvalid

Budget end time cannot be earlier than the current time.

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

400
InvalidParameter

The parameter %s not in %s.

参数不符合枚举规范

400
OperationDenied.InvalidRecipientID

InvalidRecipientID %d not belong .response

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

500
InternalServerError

The request has failed due to an unknown error.

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

最近更新时间:2025.11.20 17:10:17
这个页面对您有帮助吗?
有用
有用
无用
无用