API 版本控制
理解组件、资源和路由版本控制
要了解如何制定特定的 API 调用,请参阅该路由的组件 API 参考文档。
组件版本控制
例如,Marathon 组件在路由下为 提供服务,其中一个资源路径是/v2/apps
,所以该资源的完整路径是 /service/marathon/v2/apps
。
路由版本控制
例如,在路由下为 System Health API服务,其中一个资源路径是 /report
,所以该资源的完整路径是 /system/health/v1/report
。
资源版本控制
例如,DC/OS Package Manager (Cosmos) 组件在路由 下为 服务,其中一个资源路径是/list
,所以该资源的完整路径是 /package/list
。请求的版本和所期待的应答版本分别由 和 Accept
HTTP 标头指定: