az bot create 命令失败，请求正文中的参数“schemaTransformationVersion”设置为“0.0”- 为什么会发生这种情况？ 怎么修？

Question

我正在尝试让命令az bot create在 docker 容器内运行。 更具体地说，这是完整的命令：

az bot create `
    --app-type $appType `
    --appid $appInfo.AppId `
    --name $botName `
    --resource-group $resourceGroupName `
    --endpoint $messagingEndpoint `
    --sku $sku

其中$appType等于"MultiTenant" ； $appInfo.AppId来自在有效的应用程序注册及其 object id 上使用命令Get-AzADApplication ； $botName设置为"TestingScriptBot" ； $resourceGroupName设置为有效资源组的名称； $messagingEndpoint设置为有效的 url； $sku设置为"FO" 。

但是，我在 docker 容器中收到一个相当奇怪的错误：

(InvalidBotData) Bot is not valid. Errors: The schema transformation version is not supported.  See https://docs.microsoft.com/azure/bot-service/bot-service-resources-bot-framework-faq?view=azure-bot-service-4.0 for detailed requirements.
Code: InvalidBotData
Message: Bot is not valid. Errors: The schema transformation version is not supported.  See https://docs.microsoft.com/azure/bot-service/bot-service-resources-bot-framework-faq?view=azure-bot-service-4.0 for detailed requirements.

此外，在上述命令中启用--debug标志时，我注意到请求正文中的以下参数“ schemaTransformationVersion"设置为"0.0" ：

cli.azure.cli.core.sdk.policies: Request body:
cli.azure.cli.core.sdk.policies: {"location": "global", "sku": {"name": "F0"}, "kind": "azurebot", "properties": {"displayName": "AutomationTestingScriptBot", "iconUrl": "", "endpoint": <working_endpoint>, "msaAppType": "MultiTenant", "msaAppId": <working_app_id>, "isCmekEnabled": false, "publicNetworkAccess": "Enabled", "isStreamingSupported": false, "schemaTransformationVersion": "0.0"}}

但是，当我在本地运行相同的命令时，此参数甚至不在请求正文中。 az bot create命令甚至不允许我更改此参数 - 所以我有点不知所措。 我也尝试过使用不同版本的 Azure CLI 重新构建容器（从2.38.0到最新版本的2.43.0 ）并且发生相同的行为。

因为我最初认为这是模块版本问题，所以我尝试使用不同版本的 Powershell 和 Azure CLI 重新构建容器。 此外，我也尝试过不同版本的 Python。

我还尝试使用租户 ID 登录到每个相应的客户端（Powershell 和 Azure CLI），因为我有一个共享令牌/刷新令牌警告 - 但这似乎也没有帮助。

无论我尝试什么，都会发生同样的错误。

直到最近，此命令在 docker 容器内为我工作 - 上周五 (12/2/22) 是我重建容器并开始此行为的时间。

所以我真的不明白为什么这个参数突然出现在这个命令的请求体中并且我目前不知道如何修复它。 我认为这可能是模块版本问题，但在试用了不同版本的 Azure CLI 并更新了容器内的软件之后，我不太确定这种行为是如何/为什么发生的，以及我需要做什么来修复它。

** 以下是我拥有的所有版本/包：**

docker 容器使用以下版本运行： Alpine Linux v3.16 。

我正在运行最新版本的 Powershell: 7.3.0 。

我正在运行最新版本的 Azure CLI：

{               
  "azure-cli": "2.43.0",
  "azure-cli-core": "2.43.0",
  "azure-cli-telemetry": "1.0.8",
  "extensions": {}
}

我通过Install-Module -name Az安装了最新版本的Az模块，通过Install-Module -Name Az.BotService了最新版本的Az.BotService模块。

我安装了 libffi 和 OpenSSL 版本1.1.1s 。

我安装了 Python 版本3.10.8 。

这是我一直在测试的 powershell 脚本：

$appInfo = Get-AzADApplication -ObjectId <valid_obj_id>

$appType = "MultiTenant"
$botName = "TestingScriptBot"
$resourceGroupName = <valid_resource_group_name>
$messagingEndpoint = <valid_endpoint>
$sku = "F0"

az bot create `
    --app-type $appType `
    --appid $appInfo.AppId `
    --name $botName `
    --resource-group $resourceGroupName `
    --endpoint $messagingEndpoint `
    --sku $sku `
    --debug

我在本地和 docker 容器内部运行相同的脚本，并将命令与启用的--debug标志进行比较，并从两个输出的文本比较中，我看到的两个主要区别是：

1. 请求主体内的“ schemaTransformationVersion"参数设置为"0.0" - 但仅当命令在 docker 容器内运行时 - 当命令在本地运行时，此参数不在命令的请求主体中
2. docker 容器在使用az bot create命令发出请求之前使用 auth 令牌，而 local 使用刷新令牌 - 虽然我不怀疑这是导致问题的原因，因为这发生在过去命令在内部运行时docker 容器给我

如果需要任何进一步的信息，请告诉我。

Answer 1

进一步研究后，我找到了一个可行的替代解决方案。 诚然，我不喜欢这个解决方案，因为它感觉有点像 hack，但我认为它可以坚持下去，直到我可以进一步深入了解az bot create命令出了什么问题。

在做了更多研究之后，我想我可能知道这个问题，或者这是我注意到的另一个不同之处。 为本地运行此命令时的 api 版本如下： 2021-05-01-preview 。 另一方面，运行此命令时的 docker 容器 api-version 是2022-06-15-preview 。

因此，我将az rest命令与与本地相同的请求 url（包括 api 版本）一起使用，并使用与本地相同的主体。 结果，机器人创建对我有用。 这确实让我避免了az bot create命令的失败。 这是我测试过的脚本，它允许我使用az bot create做我想做的事：

$body = '{\"location\": \"global\", \"sku\": {\"name\": \"F0\"}, \"kind\": \"azurebot\", \"properties\": {\"displayName\": \"TestingScriptBot\", \"endpoint\": \"<valid_endpoint>\", \"msaAppType\": \"MultiTenant\", \"msaAppId\": \"<valid_app_id>\", \"isCmekEnabled\": false, \"publicNetworkAccess\": \"Enabled\", \"isStreamingSupported\": false}}'

$uri = "/subscriptions/<subscription_id>/resourceGroups/<resoure_group_name>/providers/Microsoft.BotService/botServices/<bot_name>?api-version=2021-05-01-preview"

az rest --uri $uri `
    --method put `
    --body $body `
    --debug

请注意，您可能需要根据您使用的操作系统调整您的 json 主体。 这个特定的身体在我的 macOS 上工作。 为了让它在 docker 容器中工作，我删除了转义字符（ json 正文中每个双引号之前的\ ）。

但是，我不认为使用az rest是解决问题的好方法，并且仍然希望深入了解为什么az bot create命令在 docker 容器内对我来说失败。

我现在的猜测是请求 url 中的 api 版本差异可能是包含“schemaTransformationVersion”参数并且具有无效值的原因，特别是因为我无法控制此命令中的值。

有谁知道是否有办法更改 api 的哪个版本用于 Azure CLI 命令？ 因为如果可能的话，我想用较旧的 api 版本测试az bot create命令，而不是仅仅模仿我希望通过az rest进行的调用。