Azure REST API 规范

描述

本仓库是 Microsoft Azure REST API 规范的权威来源。您可以在此处了解更多。

入门指南

如果您是正在寻找有关 Azure SDK 库发布的所有仓库和步骤信息的 Microsoft 员工，请访问 aka.ms/azsdk/join。

外部贡献者可以阅读 OpenAPI 规范入门。

术语

• Offerings、Skus 和 Features - 这些是在 Eco Manager 和 Service Tree 中表示的不同实体。 虽然 Offering/Sku/Feature 实体及其层级结构代表对外营销的产品，但 service tree 中的 service/components 实体代表共同支撑这些外部产品的相应工程实体。 有关详细信息，请参阅 Product Taxonomy。

• Resource Provider - 当服务将新功能引入 ARM 时，必须完成 Resource Provider Registration。 对于现有的 Resource Provider to Service Mapping，请参阅 Match resource provider to service*

目录结构

参见 aka.ms/azsdk/spec-dirs。

示例

这些示例提供了库应如何构建的起点，以及库应使用的预期选项：

• 数据平面：https://aka.ms/azsdk/tspconfig-sample-dpg
• 管理平面 (ARM)：https://aka.ms/azsdk/tspconfig-sample-mpg

后续步骤

规范完成后的流程下一步是生成 SDK 和 API 参考文档。 如果您是 Microsoft 员工，请访问 Azure SDK - Internal Wiki 以获取更多信息。

外部贡献者可以阅读 Getting Started with OpenAPI Specifications。

_本项目已采纳 Microsoft 开源行为准则。有关更多信息，请参阅 行为准则常见问题解答 或联系 opencode@microsoft.com 提出任何额外的问题或意见。