查询实例列表

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",    # 替换为你的公钥（控制台 账户中心 → API 密钥：https://console.compshare.cn/uaccount/api_manage）
        "private_key": "my_private_key",   # 替换为你的私钥
        "base_url": "https://api.compshare.cn",
    })
 
    try:
        # 查询所有实例（分页）
        resp = client.ucompshare().invoke("DescribeCompShareInstance", {
            "Region": "cn-wlcb",
            "Limit": 20,
            "Offset": 0,
            "IncludeShareBandwidth": True,
        })
        print(f"总数: {resp.get('TotalCount')}")
        for inst in resp.get("UHostSet", []):
            print(f"  {inst['UHostId']} - {inst['Name']} - {inst['State']}")
 
        # 查询指定实例
        resp = client.ucompshare().invoke("DescribeCompShareInstance", {
            "Region": "cn-wlcb",
            "UHostIds": ["uhost-xxxx"],
        })
        print(resp)
    except exc.UCloudException as e:
        print(e)
 
 
if __name__ == "__main__":
    main()

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

package main
 
import (
	"fmt"
 
	"github.com/ucloud/ucloud-sdk-go/ucloud"
	"github.com/ucloud/ucloud-sdk-go/ucloud/auth"
	"github.com/ucloud/ucloud-sdk-go/ucloud/request"
	"github.com/ucloud/ucloud-sdk-go/ucloud/response"
)
 
type DescribeCompShareInstanceRequest struct {
	request.CommonBase
	UHostIds              []string `required:"false"`
	Limit                 *int     `required:"false"`
	Offset                *int     `required:"false"`
	IncludeShareBandwidth *bool    `required:"false"`
}
 
type EIPShareBandwidth struct {
	ShareBandwidthId string `json:"ShareBandwidthId"`
	Scope            string `json:"Scope"`
	Bandwidth        int    `json:"Bandwidth"`
	Status           string `json:"Status"`
	CanSwitch        bool   `json:"CanSwitch"`
	TargetScope      string `json:"TargetScope"`
}
 
type IPInfo struct {
	IP             string                 `json:"IP"`
	Type           string                 `json:"Type"`
	ShareBandwidth *EIPShareBandwidth     `json:"ShareBandwidth,omitempty"`
}
 
// UHostInstance 只列举常用字段，多余字段会被自动忽略
type UHostInstance struct {
	UHostId            string      `json:"UHostId"`
	Name               string      `json:"Name"`
	State              string      `json:"State"` // Running / Stopped / Starting / Install ...
	Zone               string      `json:"Zone"`
	CPU                int         `json:"CPU"`
	Memory             int         `json:"Memory"` // MB
	GPU                int         `json:"GPU"`
	GpuType            string      `json:"GpuType"`
	ChargeType         string      `json:"ChargeType"`
	OsName             string      `json:"OsName"`
	OsType             string      `json:"OsType"`
	Password           string      `json:"Password"` // Base64
	SshLoginCommand    string      `json:"SshLoginCommand"`
	CompShareImageId   string      `json:"CompShareImageId"`
	CompShareImageName string      `json:"CompShareImageName"`
	IPSet              []IPInfo    `json:"IPSet"`
	DiskSet            interface{} `json:"DiskSet"`
}
 
type DescribeCompShareInstanceResponse struct {
	response.CommonBase
	TotalCount int             `json:"TotalCount"`
	UHostSet   []UHostInstance `json:"UHostSet"`
}
 
func main() {
	cfg := ucloud.NewConfig()
	cfg.Region = "cn-wlcb"
	cfg.BaseUrl = "https://api.compshare.cn"
 
	credential := auth.NewCredential()
	credential.PublicKey = "my_public_key"   // 替换为你的公钥（控制台 账户中心 → API 密钥：https://console.compshare.cn/uaccount/api_manage）
	credential.PrivateKey = "my_private_key" // 替换为你的私钥
	client := ucloud.NewClient(&cfg, &credential)
 
	req := &DescribeCompShareInstanceRequest{
		Limit:                 ucloud.Int(20),
		Offset:                ucloud.Int(0),
		IncludeShareBandwidth: ucloud.Bool(true),
	}
	req.SetRegion("cn-wlcb")
	resp := &DescribeCompShareInstanceResponse{}
 
	if err := client.InvokeAction("DescribeCompShareInstance", req, resp); err != nil {
		fmt.Printf("调用失败: RetCode=%d Msg=%s err=%v\n", resp.RetCode, resp.Message, err)
		return
	}
	fmt.Printf("总数: %d\n", resp.TotalCount)
	for _, inst := range resp.UHostSet {
		fmt.Printf("  %s - %s - %s\n", inst.UHostId, inst.Name, inst.State)
	}
}

{
  "Action": "DescribeCompShareInstanceResponse",
  "RetCode": 0,
  "TotalCount": 1,
  "UHostSet": [
    {
      "UHostId": "uhost-xxxx",
      "Name": "my-gpu-instance",
      "State": "Running",
      "Zone": "cn-wlcb-01",
      "Region": "cn-wlcb",
      "MachineType": "G",
      "CPU": 16,
      "Memory": 65536,
      "GPU": 1,
      "GpuType": "4090",
      "CpuPlatform": "Amd/Epyc2",
      "ChargeType": "Month",
      "CreateTime": 1712563200,
      "ExpireTime": 1715155200,
      "IsExpire": "No",
      "IsSpot": false,
      "CompShareImageId": "compshareImage-xxxx",
      "CompShareImageName": "PyTorch 2.1",
      "CompShareImageType": "System",
      "InstanceType": "Container",
      "OsType": "Linux",
      "Password": "dWNsb3VkLmNu",
      "SshLoginCommand": "ssh root@x.x.x.x -p 60022",
      "IPSet": [
        {
          "IPId": "eip-xxxx",
          "IP": "203.0.113.10",
          "IPMode": "IPv4",
          "Type": "Bgp",
          "ShareBandwidth": {
            "ShareBandwidthId": "share-bandwidth-xxxx",
            "Scope": "Company",
            "Bandwidth": 100,
            "Status": "Available",
            "CanSwitch": true,
            "TargetScope": "Public"
          }
        }
      ],
      "DiskSet": [],
      "SupportWithoutGpuStart": true
    }
  ]
}