feat: enforce shared application resource quotas across namespaces

sdk/go/application_resources.go

@@ -0,0 +1,55 @@
+package orbit
+
+import "context"
+
+// ApplicationResources 是当前应用下所有命名空间共享的配置与用量快照。
+// 配置变更需要应用级权限；修改计数不会增加 Revision。
+type ApplicationResources struct {
+	// ApplicationID 所属应用标识，由凭据归属确定。
+	ApplicationID string `json:"application_id"`
+	// Revision 仅配置变更增加的版本；JSON 使用十进制字符串。
+	Revision uint64 `json:"revision,string"`
+	// MaxUnfinishedTasks 跨命名空间的未终结任务上限，包含待核查任务。
+	MaxUnfinishedTasks uint32 `json:"max_unfinished_tasks"`
+	// UnfinishedTasks 当前未终结任务总数；自动重试不重复占用。
+	UnfinishedTasks uint64 `json:"unfinished_tasks,string"`
+	// MaxConcurrency 跨队列的预占及运行尝试总上限。
+	MaxConcurrency uint32 `json:"max_concurrency"`
+	// ActiveAttempts 当前预占与运行的尝试数。
+	ActiveAttempts uint64 `json:"active_attempts,string"`
+	// PendingStarts 已预占但尚未开始的尝试数，属于 ActiveAttempts。
+	PendingStarts uint64 `json:"pending_starts,string"`
+	// RatePerSecond 每秒固定窗口允许的开始授权次数。
+	RatePerSecond uint32 `json:"rate_per_second"`
+}
+
+// ConfigureApplicationResourcesRequest 完整替换上限，重复请求必须保留原版本与幂等键。
+type ConfigureApplicationResourcesRequest struct {
+	// ExpectedRevision 管理命令预期配置版本，须保留原值重报。
+	ExpectedRevision uint64 `json:"expected_revision,string"`
+	// Reason 非空审计原因，最多 1024 个 Unicode 字符。
+	Reason string `json:"reason"`
+	// MaxUnfinishedTasks 跨命名空间的未终结任务上限，包含待核查任务。
+	MaxUnfinishedTasks uint32 `json:"max_unfinished_tasks"`
+	// MaxConcurrency 跨队列的预占及运行尝试总上限。
+	MaxConcurrency uint32 `json:"max_concurrency"`
+	// RatePerSecond 每秒固定窗口允许的开始授权次数。
+	RatePerSecond uint32 `json:"rate_per_second"`
+}
+type ConfigureApplicationResourcesResult struct {
+	// Resources 配置成功时的原用量快照，重报不刷新。
+	Resources ApplicationResources `json:"resources"`
+	// Deduplicated 是否返回先前已提交的同身份回执。
+	Deduplicated bool `json:"deduplicated"`
+}
+
+func (c *Client) GetApplicationResources(ctx context.Context) (ApplicationResources, error) {
+	var out ApplicationResources
+	err := c.call(ctx, "GET", "/v1/application/resources", "", nil, &out)
+	return out, err
+}
+func (c *Client) ConfigureApplicationResources(ctx context.Context, key string, in ConfigureApplicationResourcesRequest) (ConfigureApplicationResourcesResult, error) {
+	var out ConfigureApplicationResourcesResult
+	err := c.call(ctx, "POST", "/v1/application/resources:configure", key, in, &out)
+	return out, err
+}