用于 Visual Studio 订阅管理的 REST API 端点

GitHub Enterprise Cloud 管理员现在能够通过下列 REST API 端点，以编程方式管理 Visual Studio 订阅（Visual Studio Subscription，简称 VSS）的分配。这些端点使企业可以自动化处理订阅的授予、查询与回收，无需依赖手工操作或管理控制台。

可用端点

列出所有分配

GET /enterprises/{enterprise}/visual-studio-subscriptions

返回指定企业内全部 Visual Studio 订阅分配的列表，包含被分配用户、订阅级别、分配日期等信息。管理员可通过该端点监控许可使用情况，并为审计或合规提供数据支撑。

创建分配（示例）

POST /enterprises/{enterprise}/visual-studio-subscriptions

{ "email": "user@example.com", "subscription_plan": "visual_studio_enterprise" }

允许管理员为组织成员分配 Visual Studio 订阅。请求体中需要指定用户邮箱以及计划标识符。成功调用后，成员即可下载并使用对应的 IDE 及权益。

撤销分配（示例）

DELETE /enterprises/{enterprise}/visual-studio-subscriptions/{subscription_id}

当成员岗位变动或离开项目时，可通过该端点及时收回许可，避免许可证闲置或额外开销。

对开发者与企业的意义

自动化治理：企业可以将订阅分配纳入入职、离职脚本，或通过 GitHub Actions 等平台自动触发，实现“零手动”的许可管理。
成本优化：实时查询分配状态，按需分配与回收，确保 Visual Studio 订阅始终与实际使用情况匹配，降低不必要的许可支出。
集成便利：REST API 与现有 GitHub Enterprise Cloud API 风格一致，开发团队可以快速集成到内部门户、工单系统或合规报告中。

注意：使用这些端点需具备适当的 GitHub Enterprise 管理员权限，并在请求头中包含有效的身份认证令牌。详细权限范围与响应结构请参考官方 API 文档。