用途:在 Medusa Cloud CLI 中执行 mcloud organizations 命令,用于发现组织、按名称解析组织 ID,或获取组织详情。
主要能力:
- organizations list:列出账号可访问的所有组织,例如 mcloud organizations list --json,--json 选项以 JSON 格式输出。
- organizations get:按 ID 获取单个组织,返回元数据、订阅详情与成员,用法为 mcloud organizations get <organization-id> --json。参数 organization 为必填的组织 ID;选项 -o/--organization <id> 可在当前上下文中覆盖组织(须与参数一致),--json 以 JSON 格式输出。
JSON 字段:id(组织 ID)、name(显示名称)、billing_email(账单联系邮箱)、status(active 或其他)、members(成员对象数组,含 id、role、user.email)、subscription(当前计划、周期与 is_active 标志)、account_holder(账单账户持有人详情)。
使用限制:organizations list 需要个人身份认证(浏览器登录或个人访问密钥);使用组织访问密钥调用该命令会返回 401。当以 MCLOUD_TOKEN 配合组织访问密钥认证时,应改用 mcloud whoami --json 获取组织 ID。
常见用法:可结合 jq 提取字段,如从列表取第一个组织 ID 后用 mcloud use --organization 设置上下文,或按名称筛选组织 ID;也可用 get 输出成员邮箱或订阅计划名称与状态。资料未提供命令的安装方式、权限范围之外的限制及其他命令说明。