方法路径摘要认证
GET/v1/admin/package-resource-optionsList named resources available to the current platform package catalog登录会话

契约文件:api/control-package-resources.openapi.yaml

接口详情

GET /v1/admin/package-resource-options

List named resources available to the current platform package catalog

operationId
listPackageResourceOptions
认证
  • 登录会话:主控登录后的 Bearer 会话,由客户本人在自己的主控里使用;插件不能要求客户交出会话。
所需权限

全部需要:packages.manage

说明(契约原文)

Requires packages.manage in the authenticated platform scope. No query parameters are accepted, including target_scope_id. Returns the internal UUIDs used by ProductSpec, not the numeric display IDs from the region-management API. Only this platform's regions and non-deleted line groups are returned in stable sort order. A line group's legacy region string must match exactly one current region by name or canonical UUID. A null line-group region_id means this mapping is missing or ambiguous and must not be selected. Create and update require the selected region and main/optional backup groups to exist in this platform and match the region, checked and locked inside the write transaction. Unknown legacy values remain readable but must be explicitly corrected before writing. An active reseller tenant gets the platform's regions and CNAME domains and only the platform line groups granted to it. Completed idempotent writes retain their original receipts after live authorization.

响应

listPackageResourceOptions 响应
状态码说明
200Scoped resource options; empty arrays mean no available resources.

字段:cname_domains: array<string> regions: array<object> node_groups: array<object>

400Stable error code; callers must render localized messages.
401Stable error code; callers must render localized messages.
403Stable error code; callers must render localized messages.
500Stable error code; callers must render localized messages.
503Stable error code; callers must render localized messages.

失败时怎么办

  • 400 按字段说明修正参数或请求体再发;不要原样重试。
  • 401 检查凭据格式、是否过期或被轮换。
  • 403 检查 Key 范围与所有者当前权限、当前租户作用域;不要换更高权限账号绕过。
  • 500 结果未知:先按资源 ID 或列表回读确认,再决定是否用原 Idempotency-Key 重试。
  • 503 依赖暂不可用:稍后用原 Idempotency-Key 重试。

↑ 回到列表