购买算力单元实例

更新时间：2024-11-14

功能介绍

用于购买当前服务部署所需的算力单元实例。

注意事项

当库存不足或余额不足时，可能会导致购买失败。
本文API支持通过Python SDK、Go SDK、Java SDK 和 Node.js SDK调用，调用流程请参考SDK安装及使用流程。

权限说明

调用本文API，需符合以下权限要求，权限介绍及分配，请查看角色与权限控制列表、账号创建与权限分配。需具有以下任一权限：

管理员权限：QianfanFullControlAccessPolicy
模型服务运维权限：QianfanServiceOperateAccessPolicy

SDK调用

调用示例

import os
from qianfan import resources

# 使用安全认证AK/SK鉴权，通过环境变量方式初始化；替换下列示例中参数，安全认证Access Key替换your_iam_ak，Secret Key替换your_iam_sk
os.environ["QIANFAN_ACCESS_KEY"] = "your_iam_ak"
os.environ["QIANFAN_SECRET_KEY"] = "your_iam_sk"

resp = resources.Charge.charge_tpm_credit(
    service_id='svco-48esssdpa594',
    billing={
        "paymentTiming":"Prepaid",
        "reservation":{
            "reservationTimeUnit":"Month",
            "reservationLength":5
        }
    },
    replicas=1,
)
print(resp.body)

package main

import (
	"context"
	"fmt"
    "os"

	"github.com/baidubce/bce-qianfan-sdk/go/qianfan"
)

func main() {
	 // 使用安全认证AK/SK鉴权，通过环境变量初始化；替换下列示例中参数，安全认证Access Key替换your_iam_ak，Secret Key替换your_iam_sk
	os.Setenv("QIANFAN_ACCESS_KEY", "your_iam_ak")
	os.Setenv("QIANFAN_SECRET_KEY", "your_iam_sk")
    
	ca := qianfan.NewConsoleAction()
    
	res, err := ca.Call(context.TODO(),
    // 调用本文API，该参数值为固定值，无需修改；对应本文HTTP调用-请求说明-请求地址的后缀
    "/v2/serviceresources",
    // 调用本文API，该参数值为固定值，无需修改；对应本文HTTP调用-请求说明-请求参数-Query参数的Action
    "PurchaseComputeUnit",
    // 对应本文HTTP调用-请求说明-请求参数-Body参数，具体使用请查看Body参数说明，根据实际使用选择参数
    map[string]interface{}{
		"serviceId":     "svco-48esssdpa594",
		"replicasCount": 5,
		"billing": map[string]any{
			"paymentTiming": "Prepaid",
			"reservation": map[string]any{
				"reservationTimeUnit": "Month",
				"reservationLength":   5,
			},
		},
	})
    
	if err != nil {
		panic(err)
	}
    
	fmt.Println(string(res.Body))
	
}

import com.baidubce.qianfan.Qianfan;
import com.baidubce.qianfan.model.console.ConsoleResponse;
import com.baidubce.qianfan.util.CollUtils;
import com.baidubce.qianfan.util.Json;
import java.util.Map;

public class Dome {
    public static void main(String args[]){
        // 使用安全认证AK/SK鉴权，替换下列示例中参数，安全认证Access Key替换your_iam_ak，Secret Key替换your_iam_sk
        Qianfan qianfan = new Qianfan("your_iam_ak", "your_iam_sk");
        
        ConsoleResponse<Map<String, Object>> response = qianfan.console()
                // 调用本文API，该参数值为固定值，无需修改；对应本文HTTP调用-请求说明-请求地址的后缀
                .route("/v2/serviceresources")
                // 调用本文API，该参数值为固定值，无需修改；对应本文HTTP调用-请求说明-请求参数-Query参数的Action
                .action("PurchaseComputeUnit")               
                // 需要传入参数的场景，可以自行封装请求类，或者使用Map.of()来构建请求Body
                // Java 8可以使用SDK提供的CollUtils.mapOf()来替代Map.of()
                // 对应本文HTTP调用-请求说明-请求参数-Body参数，具体使用请查看Body参数说明，根据实际使用选择参数 
                .body(CollUtils.mapOf(
                    "serviceId","svco-48esssdpa594",
                    "billing",CollUtils.mapOf(
                        "paymentTiming","Prepaid",
                        "reservation",CollUtils.mapOf(
                            "reservationTimeUnit","Month",
                            "reservationLength",5
                        )
                    ),
                    "replicasCount",5
                ))
                .execute();

        System.out.println(Json.serialize(response));
    }
}

import {consoleAction, setEnvVariable} from "@baiducloud/qianfan";

// 使用安全认证AK/SK鉴权，通过环境变量初始化；替换下列示例中参数，安全认证Access Key替换your_iam_ak，Secret Key替换your_iam_sk
setEnvVariable('QIANFAN_ACCESS_KEY','your_iam_ak');
setEnvVariable('QIANFAN_SECRET_KEY','your_iam_sk');

async function main() {
  //base_api_route:调用本文API，该参数值为固定值，无需修改；对应本文HTTP调用-请求说明-请求地址的后缀
  //action:调用本文API，该参数值为固定值，无需修改；对应本文HTTP调用-请求说明-请求参数-Query参数的Action
  //data:对应本文HTTP调用-请求说明-请求参数-Body参数，具体使用请查看Body参数说明，根据实际使用选择参数
  const res = await consoleAction({base_api_route: '/v2/serviceresources', action: 'PurchaseComputeUnit', data: {
        "serviceId":"svco-48esssdpa594",
        "billing":{
            "paymentTiming":"Prepaid",
            "reservation":{
                "reservationTimeUnit":"Month",
                "reservationLength":5
            }
        },
        "replicasCount":5
    }
  });    
    
  console.log(res);
}

main();

返回示例

{
    "requestId":"1bef3f87-c5b2-4419-936b-50f9884f10d4",
    "result":{
        "instanceId":"44961088fxxxx9e9379f5daf"
    }
}

{
    "requestId":"1bef3f87-c5b2-4419-936b-50f9884f10d4",
    "result":{
        "instanceId":"44961088fxxxx9e9379f5daf"
    }
}

{
    "requestId":"1bef3f87-c5b2-4419-936b-50f9884f10d4",
    "result":{
        "instanceId":"44961088fxxxx9e9379f5daf"
    }
}

{
    requestId:'1bef3f87-c5b2-4419-936b-50f9884f10d4',
    result:{
        instanceId:'44961088fxxxx9e9379f5daf'
    }
}

请求参数

注意：不同语言SDK的请求参数不同，请根据实际调用选择对应参数。

Python SDK请求参数说明

名称	类型	必填	描述
service_id	string	是	服务ID
billing	Billing	是	订单、计费相关参数
replicasCount	int	是	购买副本数量

Billing说明

名称	类型	必填	描述
paymentTiming	string	是	付费类型，可选值： · Prepaid：表示预付费 · Postpaid：表示后付费
reservation	dict	否	保留信息，说明：（1）只有当付费类型为预付费，即paymentTiming值为Prepaid时，该字段必填（2）付费类型为后付费，无需填写此参数

reservation说明

名称	类型	必填	描述
reservationTimeUnit	string	是	时间单位，可选值： · Month：月
reservationLength	int	是	购买时长，说明： · 时间单位为月，取值范围 [1-12]

其它SDK请求参数说明

名称	类型	必填	描述
serviceId	string	是	服务ID
billing	Billing	是	订单、计费相关参数
replicasCount	int	是	购买副本数量

Billing说明

名称	类型	必填	描述
paymentTiming	string	是	付费类型，可选值： · Prepaid：表示预付费 · Postpaid：表示后付费
reservation	Reservation	否	保留信息，说明：（1）只有当付费类型为预付费，即paymentTiming值为Prepaid时，该字段必填（2）付费类型为后付费，无需填写此参数
releaseTime	string	否	定时释放时间，说明：（1）只有当付费类型为后付费，即paymentTiming值为Postpaid时，该字段有效（2）支持RFC3339格式和标准格式，如`2030-01-25T12:30:30+08:00`、`2030-01-25 12:30:30`

Reservation说明

名称	类型	必填	描述
reservationTimeUnit	string	是	时间单位，可选值： · Month: 月
reservationLength	int	是	购买时长，说明： · 时间单位为月，取值范围 [1-12]
autoRenew	boolean	否	是否自动续费，可选值： · true：是 · false：否，默认值为false
autoRenewTimeUnit	String	否	自动续费周期时间单位，默认值为month，可选值： · month：月
autoRenewTime	int	否	自动续费时长，说明：（1）单位：月（2）默认值为1，取值范围：[1,6]

返回参数

名称	类型	描述
requestId	string	请求ID
result	object	请求结果

result说明

名称	类型	描述
instanceId	string	实例ID

TPM配额管理

查询算力单元实例列表

百度智能云

百度智能云千帆大模型服务与开发平台ModelBuilder

百度智能云千帆大模型服务与开发平台ModelBuilder

购买算力单元实例

功能介绍

注意事项

权限说明

SDK调用

调用示例

返回示例

请求参数

返回参数