Team 配额管理

环境变量说明

访问凭证按阿里云 SDK & API 说明配置，通过环境变量传入，不写入代码、镜像、模板或日志。本文示例读取以下环境变量：

设置或更新配额

UpdateQuota 同时用于设置配额和更新已有配置。执行前，将示例中的 CPU、内存和存活实例数改为目标值；已有配额时，先查询当前配置再更新。

在已配置访问凭证的终端中设置参数，以下以北京地域为例：

export SANDBOX_REGION_ID="cn-beijing"
export SANDBOX_ENDPOINT="sandbox.cn-beijing.aliyuncs.com"
export SANDBOX_TEAM_ID="<TEAM-ID>"

将以下代码保存为 main.go。该示例将指定 Team 的配额设置为 32 核 CPU、64 GB 内存和 16 个存活实例：

package main

import (
    "encoding/json"
    "fmt"
    "log"
    "os"
    "strings"

    openapiutil "github.com/alibabacloud-go/darabonba-openapi/v2/utils"
    sandbox "github.com/alibabacloud-go/sandbox-20260820/client"
    "github.com/alibabacloud-go/tea/tea"
)

func requireEnv(name string) string {
    value := strings.TrimSpace(os.Getenv(name))
    if value == "" {
        log.Fatalf("请设置 %s", name)
    }
    return value
}

func printJSON(value interface{}) {
    data, err := json.MarshalIndent(value, "", "  ")
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(string(data))
}

func main() {
    client, err := sandbox.NewClient(&openapiutil.Config{
        AccessKeyId:     tea.String(requireEnv("ALIBABA_CLOUD_ACCESS_KEY_ID")),
        AccessKeySecret: tea.String(requireEnv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")),
        SecurityToken:   tea.String(os.Getenv("ALIBABA_CLOUD_SECURITY_TOKEN")),
        RegionId:        tea.String(requireEnv("SANDBOX_REGION_ID")),
        Endpoint:        tea.String(requireEnv("SANDBOX_ENDPOINT")),
    })
    if err != nil {
        log.Fatal(err)
    }

    // 设置或更新配额。
    resp, err := client.UpdateQuota(&sandbox.UpdateQuotaRequest{
        Body: &sandbox.Quota{
            TagValue:      tea.String(requireEnv("SANDBOX_TEAM_ID")),
            CpuCores:      tea.Int32(32),
            MemoryGB:      tea.Int32(64),
            InstanceCount: tea.Int32(16),
        },
    })
    if err != nil {
        log.Fatalf("设置配额失败: %v", err)
    }
    printJSON(resp.Body)
}

在已安装 SDK 的 Go 项目中运行：

go run main.go

响应包含保存后的配额和请求 ID。需要再次调整时，修改 sandbox.Quota 中的目标值后调用同一接口。

以下查询、列表和删除示例复用上述导入、辅助函数和客户端初始化代码。将 main 中“设置或更新配额”注释之后的操作代码替换为对应示例即可，执行查询或删除不需要先运行更新操作。

查询配额

使用 DescribeQuota 查询指定 Team 的配额：

resp, err := client.DescribeQuota(&sandbox.DescribeQuotaRequest{
    TagValue: tea.String(requireEnv("SANDBOX_TEAM_ID")),
})
if err != nil {
    log.Fatalf("查询配额失败: %v", err)
}
printJSON(resp.Body)

查询配额列表

使用 ListQuota 分页查询账号下的配额列表：

var nextToken *string
for {
    resp, err := client.ListQuota(&sandbox.ListQuotaRequest{
        MaxResults: tea.Int32(100),
        NextToken:  nextToken,
    })
    if err != nil {
        log.Fatalf("查询配额列表失败: %v", err)
    }
    printJSON(resp.Body)

    nextToken = resp.Body.NextToken
    if tea.StringValue(nextToken) == "" {
        break
    }
}

ListQuota 查询当前账号在目标地域的配额列表，不使用 SANDBOX_TEAM_ID 筛选。需要查询指定 Team 时，使用 DescribeQuota。

删除配额

确认该 Team 不再需要这项配额配置后，单独执行删除操作：

resp, err := client.DeleteQuota(&sandbox.DeleteQuotaRequest{
    TagValue: tea.String(requireEnv("SANDBOX_TEAM_ID")),
})
if err != nil {
    log.Fatalf("删除配额失败: %v", err)
}
printJSON(resp.Body)

删除后可通过 DescribeQuota 确认配置是否仍存在。返回 ResourceQuotaNotFound 表示未查到该配额配置。

tagValue 应该填什么？

填写目标 Team 的 ID，不要填写 Team 名称、资源组 ID 或 API Key。获取方法参见创建 Team。

设置配额提示参数不合法

返回 InvalidParameter 时，检查 Team ID 格式、CPU 和内存字段是否齐全，以及这两项数值是否为非负整数。传入 instanceCount 时，取值必须为不小于 -1 的整数。

提示无权调用配额接口

检查调用身份的 RAM 权限及资源范围。查询账号配额列表需要 sandbox:ListQuotas，设置配额需要 sandbox:UpdateQuota。具体授权参见授权 RAM 用户访问控制台。若错误消息明确提示功能未开通，请联系产品支持确认目标地域和账号的开通条件。

设置配额提示超过账号额度

根据错误消息确认超限的是 CPU、内存还是其他配额项，再检查账号额度与已有 Team 配额。CPU 或内存额度不足时，调整各 Team 的分配，或申请提升对应账号额度。

设置的配额超过账号额度时，请求可能返回 LimitExceededError 等错误信息，应结合返回的 HTTP 状态码、错误码和消息判断，不能仅按 429 识别配额超限。

查询提示配额不存在

返回 ResourceQuotaNotFound 时，核对账号、地域和 Team ID，并确认该 Team 是否已配置配额、是否刚执行过删除。返回 TeamNotFound 时，先检查目标地域中是否存在该 Team。

请求失败后如何排查？

保留错误消息和请求 ID。检查访问凭证是否有效、地域与接入点是否一致。使用 STS 临时凭证时，确认 AccessKey ID、AccessKey Secret 和 SecurityToken 来自同一组凭证且未过期。参数、权限或额度问题应修正后再重试。