Azure Python SDK的begin_create_or_update JSON参数规范及门户视图利用咨询

一、是否存在官方的JSON参数文档？ #

有的，可通过两个权威途径获取规范：

1. Azure REST API对应文档：begin_create_or_update本质是封装了Azure REST API的PUT创建/更新接口，每个资源类型的JSON参数完全对应REST API的请求体结构。比如创建虚拟机规模集，查看Virtual Machine Scale Sets的Create Or Update接口文档，里面会明确标注每个字段的必填性、类型和说明。
2. SDK模型类文档：每个Azure管理SDK模块（如azure-mgmt-compute）都有对应模型类，比如虚拟机规模集对应的VirtualMachineScaleSet类，类中每个属性都对应JSON参数的键。查看这些模型类的官方文档，就能清楚哪些属性必填、哪些可选，以及属性的取值范围。

二、如何利用Azure门户的JSON视图确定SDK的JSON模式？ #

门户的JSON视图是快速获取合规参数结构的实用方法，操作步骤如下：

• 先在Azure门户中创建同类型的测试资源（或找到已存在的目标资源），比如你需要的虚拟机规模集。
• 进入资源详情页后，找到JSON视图入口（部分资源在“导出模板”功能里查看完整JSON，部分资源直接有“查看JSON”选项）。
• 复制导出的JSON结构，这个结构完全符合Azure API规范，和begin_create_or_update所需的参数结构一致。
• 清理JSON中的只读字段（比如id、系统生成的createdTime、etag等），保留location、sku、properties等需要自定义的核心字段，调整字段值为你的目标配置，就能直接作为begin_create_or_update的参数使用。
• 注意：门户导出的JSON可能包含默认值或额外可选字段，可根据需求删减，只保留必填和需要自定义的部分。

内容的提问来源于stack exchange，提问作者Karen Baghdasaryan