你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

排查 Azure Database for MySQL - 灵活服务器 CLI 错误

本文帮助排查使用 Azure Database for MySQL 灵活服务器时 Azure CLI 的常见问题。

找不到命令

如果收到错误提示命令“拼写错误或系统无法识别”,这可能意味着客户端计算机上的 CLI 版本可能不是最新的。 运行 az upgrade 以升级到最新版本。 升级 CLI 版本有助于解决因任何 API 更改而导致的命令不兼容问题。

调试部署失败

目前，Azure CLI 不支持启用调试日志记录，但可以通过执行以下步骤来检索调试日志记录。

注意

• 将 examplegroup 和 exampledeployment 替换为 Azure Database for MySQL 灵活服务器实例的正确资源组和部署名称。
• 可以在资源组的部署页中查看部署名称。 请参阅了解如何查找部署名称。

1. 列出资源组中的部署以标识 Azure Database for MySQL 灵活服务器部署。

   az deployment operation group list \
     --resource-group examplegroup \
     --name exampledeployment
   

2. 获取 Azure Database for MySQL 灵活服务器部署的请求内容。

   az deployment operation group list \
     --name exampledeployment \
     -g examplegroup \
     --query [].properties.request
   

3. 检查响应内容。

   az deployment operation group list \
     --name exampledeployment \
     -g examplegroup \
     --query [].properties.response
   

错误代码

错误代码	缓解措施
MissingSubscriptionRegistration	向资源提供程序注册订阅。 运行 az provider register --namespace Microsoft.DBMySQL 命令以解决此问题。
InternalServerError	尝试查看服务器的活动日志，以确认是否有详细信息。 运行命令 az monitor activity-log list --correlation-id <enter correlation-id>。 几分钟后，可以尝试相同的 CLI 命令。 如果问题仍然存在，请报告问题或联系 Microsoft 支持人员。
ResourceNotFound	找不到引用的资源。 可以检查资源属性，或者检查资源是否被删除，或者检查资源是否在其他订阅中。
LocationNotAvailableForResourceType	- 检查 Azure 区域中 Azure Database for MySQL 灵活服务器的可用性。 - 检查是否已向订阅注册 Azure Database for MySQL 灵活服务器实例资源类型。
ResourceGroupBeingDeleted	正在删除资源组。 等待删除操作完成。
PasswordTooLong	提供的密码过长。 该密码必须包含 8 到 128 个字符。 密码必须含以下字符类别中的三类：英文大写字母、英文小写字母、数字（0 到 9）及非字母数字字符（!、$、#、% 等）。
PasswordNotComplex	提供的密码不够复杂。 该密码必须包含 8 到 128 个字符。 密码必须含以下字符类别中的三类：英文大写字母、英文小写字母、数字（0 到 9）及非字母数字字符（!、$、#、% 等）。
PasswordTooShort	该密码必须包含 8 到 128 个字符。 密码必须含以下字符类别中的三类：英文大写字母、英文小写字母、数字（0 到 9）及非字母数字字符（!、$、#、% 等）。
SubscriptionNotFound	找不到所请求的订阅。 运行 az account list all 以查看所有当前订阅。
InvalidParameterValue	为参数提供了无效值。 检查 CLI 参考文档以查看参数支持的正确值。
InvalidLocation	指定的位置无效。 检查 Azure 区域中 Azure Database for MySQL 灵活服务器的可用性
InvalidServerName	标识了无效的服务器名称。 检查服务器名称。 运行命令 az mysql flexible-server list 以查看可用 Azure Database for MySQL 灵活服务器实例的所有列表。
InvalidResourceIdSegment	Azure 资源管理器模板中标识了语法错误。 使用 JSON 格式化程序工具验证 JSON 以识别语法错误。
InvalidUserName	输入有效的用户名。 管理员用户名不能是 azure_superuser、azure_pg_admin、admin、administrator、root、guest 或 public。 且不能以 pg_ 开头。
BlockedUserName	管理员用户名不能是 azure_superuser、azure_pg_admin、admin、administrator、root、guest 或 public。 且不能以 pg_ 开头。 避免在管理员名称中使用这些模式。

下一步

报告此问题