DescribeTeamMemberOrder — 查询成员订单列表

接口说明

查询指定团队成员的订单列表，支持按时间范围、计费类型、订单状态等条件筛选。

使用限制

账户需完成实名认证。
需要团队管理员权限。

请求参数

名称	类型	必填	描述	示例值
Action	String	是	接口名称	`DescribeTeamMemberOrder`
Region	String	是	地域	`cn-wlcb`
TeamId	Uint32	是	团队 ID	`100001`
VirtualCompanyId	Uint32	是	成员虚拟账户 ID	`300001`
BeginTime	Int64	否	起始时间（Unix 时间戳）	`1700000000`
EndTime	Int64	否	结束时间（Unix 时间戳）	`1700086400`
Limit	Int	否	每页数量，范围 1~100	`25`
Offset	Int	否	偏移量，默认 0	`0`
ChargeTypes	Array	否	计费类型筛选	`["Dynamic","Month"]`
OrderStates	Array	否	订单状态筛选	`["Paid","Unpaid"]`
ResourceIds	Array	否	资源 ID 筛选	`["uhost-xxx"]`
OrderBy	String	否	排序字段	`CreateTime`
OrderDir	String	否	排序方向	`Desc`

响应参数

名称	类型	描述	示例值
Action	String	响应名称	`DescribeTeamMemberOrderResponse`
RetCode	Integer	返回码，`0` 为成功	`0`
OrderInfos	Array	订单列表	见下表
Total	Int	订单总数	`10`
Limit	Int	每页数量	`25`
Offset	Int	偏移量	`0`

OrderInfos 元素

名称	类型	描述	示例值
OrderNo	String	订单号	`order-20231115001`
OrderType	String	订单类型	`Buy`
OrderState	String	订单状态	`Paid`
ChargeType	String	计费类型	`Dynamic`
Amount	String	订单金额（元）	`10.00`
AmountReal	String	实付金额（元）	`8.50`
ResourceId	String	资源 ID	`uhost-xxx`
CreateTime	Integer	创建时间（Unix 时间戳）	`1700000000`
OrderDetail	Array	订单明细	见下表

OrderDetail 元素

名称	类型	描述	示例值
ProductName	String	产品名称	`GPU算力`
Value	String	产品规格值	`NVIDIA A100`

请求示例

Python（使用 UCloud SDK）

安装 SDK：

pip install --upgrade ucloud-sdk-python3

示例代码：

from ucloud.core import exc
from ucloud.client import Client
 
 
def main():
    client = Client({
        "region": "cn-wlcb",
        "public_key": "my_public_key",    # 替换为你的公钥，从 https://console.compshare.cn/uaccount/api_manage 获取
        "private_key": "my_private_key",   # 替换为你的私钥
        "base_url": "https://api.compshare.cn",
    })
 
    try:
        resp = client.ucompshare().describe_team_member_order({
            "TeamId": 100001,
            "VirtualCompanyId": 300001,
            "Limit": 25,
            "Offset": 0,
        })
        print(f"总数: {resp['Total']}")
        for order in resp["OrderInfos"]:
            print(f"订单号: {order['OrderNo']}, 金额: {order['Amount']}, 状态: {order['OrderState']}")
    except exc.UCloudException as e:
        print(e)
 
 
if __name__ == "__main__":
    main()

Go（使用 UCloud SDK）

安装依赖：

go get github.com/ucloud/ucloud-sdk-go

示例代码：

package main
 
import (
	"fmt"
 
	"github.com/ucloud/ucloud-sdk-go/services/ucompshare"
	"github.com/ucloud/ucloud-sdk-go/ucloud"
	"github.com/ucloud/ucloud-sdk-go/ucloud/auth"
)
 
func main() {
	cfg := ucloud.NewConfig()
	cfg.Region = "cn-wlcb"
	cfg.BaseUrl = "https://api.compshare.cn"
 
	credential := auth.NewCredential()
	credential.PublicKey = "my_public_key"   // 替换为你的公钥，从 https://console.compshare.cn/uaccount/api_manage 获取
	credential.PrivateKey = "my_private_key" // 替换为你的私钥
	client := ucompshare.NewClient(&cfg, &credential)
 
	req := client.NewDescribeTeamMemberOrderRequest()
	req.TeamId = ucloud.Uint32(100001)
	req.VirtualCompanyId = ucloud.Uint32(300001)
	req.Limit = ucloud.Int(25)
	req.Offset = ucloud.Int(0)
 
	resp, err := client.DescribeTeamMemberOrder(req)
	if err != nil {
		fmt.Printf("查询失败: %s\n", err)
		return
	}
	fmt.Printf("总数: %d\n", resp.Total)
	for _, order := range resp.OrderInfos {
		fmt.Printf("订单号: %s, 金额: %s, 状态: %s\n", order.OrderNo, order.Amount, order.OrderState)
	}
}

响应示例

{
  "Action": "DescribeTeamMemberOrderResponse",
  "RetCode": 0,
  "Total": 10,
  "Limit": 25,
  "Offset": 0,
  "OrderInfos": [
    {
      "OrderNo": "order-20231115001",
      "OrderType": "Buy",
      "OrderState": "Paid",
      "ChargeType": "Dynamic",
      "Amount": "10.00",
      "AmountReal": "8.50",
      "ResourceId": "uhost-xxx",
      "CreateTime": 1700000000,
      "OrderDetail": [
        {
          "ProductName": "GPU算力",
          "Value": "NVIDIA A100"
        }
      ]
    }
  ]
}

删除团队查询成员订单数量