如何通过Az PowerShell向Azure API Management现有API修订版追加操作？

我完全懂你的困扰——在Azure门户里给现有API修订版加新操作很顺手，但用Import-AzApiManagementAPI这个PowerShell命令时，发现它没法直接支持增量追加操作，只能覆盖整个API定义，确实不太灵活。下面给你几个实用的解决方案，按需选择就行：

方案1：合并现有API定义与新操作后重新导入 #

适合需要批量添加多个操作的场景，步骤是先导出现有API的完整定义，把新操作合并进去，再重新导入到目标修订版：

1. 先获取目标API修订版的现有定义：

# 初始化APIM上下文
$apimContext = New-AzApiManagementContext -ResourceGroupName "your-resource-group" -ServiceName "your-apim-service-name"

# 获取指定API和修订版的定义
$targetApi = Get-AzApiManagementApi -Context $apimContext -ApiId "your-api-id" -Revision "target-revision-number"
$existingApiDef = $targetApi.Content | ConvertFrom-Json

2. 准备好包含新操作的OpenAPI定义（比如new-operations.json），把新操作的paths合并到现有定义中：

$newOperationsDef = Get-Content -Path "./new-operations.json" -Raw | ConvertFrom-Json
# 合并paths部分（OpenAPI格式下，操作都在paths节点下）
$existingApiDef.paths += $newOperationsDef.paths

# 把合并后的定义保存为新文件
$existingApiDef | ConvertTo-Json -Depth 10 | Set-Content -Path "./merged-api-definition.json"

3. 调用Import-AzApiManagementAPI重新导入到指定修订版：

Import-AzApiManagementApi -Context $apimContext -ApiId "your-api-id" -Revision "target-revision-number" `
    -SpecificationFormat "OpenApiJson" -SpecificationPath "./merged-api-definition.json" `
    -PassThru

方案2：用New-AzApiManagementOperation直接添加单个操作 #

如果只是要追加少量操作，这个方法更直接，不用处理整个API定义文件，直接逐个创建操作：

# 初始化APIM上下文（未初始化时执行）
$apimContext = New-AzApiManagementContext -ResourceGroupName "your-resource-group" -ServiceName "your-apim-service-name"

# 添加一个GET类型的新操作
New-AzApiManagementOperation -Context $apimContext -ApiId "your-api-id" -ApiRevision "target-revision-number" `
    -OperationId "get-new-resource" -Method GET -UrlTemplate "/new-resource/{resourceId}" `
    -DisplayName "Get New Resource" -Description "Retrieve details of a specific new resource"

# 再添加一个POST类型的新操作
New-AzApiManagementOperation -Context $apimContext -ApiId "your-api-id" -ApiRevision "target-revision-number" `
    -OperationId "create-new-resource" -Method POST -UrlTemplate "/new-resource" `
    -DisplayName "Create New Resource" -Description "Create a new resource entry"

方案3：调用Azure APIM REST API实现增量更新 #

如果PowerShell cmdlet的功能还是满足不了你的需求，可以直接调用Azure APIM的REST API来添加操作，灵活性最高。比如调用创建或更新操作的接口，指定目标API修订版和新操作的详细参数即可。

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