排查 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
    

错误代码

错误代码 缓解
缺少订阅注册 向资源提供程序注册您的订阅。 运行 az provider register --namespace Microsoft.DBMySQL 命令以解决此问题。
InternalServerError 尝试查看服务器的活动日志,以确认是否有详细信息。 运行命令 az monitor activity-log list --correlation-id <enter correlation-id>。 几分钟后,可以尝试相同的 CLI 命令。 如果问题仍然存在,请报告问题或联系 Azure 支持人员。

如果在运行 az mysql flexible-server list-skus 时收到此错误,则通常意味着由于容量约束,指定的区域中没有可用的 SKU。 选择其他区域,验证Azure门户中可用的 SKU,稍后在补充容量后重试,或打开支持请求。
ResourceNotFound 找不到引用的资源。 可以检查资源属性,或者检查资源是否被删除,或者检查资源是否在其他订阅中。
该资源类型在此位置不可用 - 检查 Azure 区域中 Azure Database for MySQL 灵活服务器的可用性。
- 检查是否已向订阅注册 Azure Database for MySQL 灵活服务器实例资源类型。
资源组正在被删除 正在删除资源组。 等待删除操作完成。
PasswordTooLong 提供的密码过长。 该密码必须包含 8 到 128 个字符。 密码必须含以下字符类别中的三类:英文大写字母、英文小写字母、数字(0 到 9)及非字母数字字符(!、$、#、% 等)。
密码不够复杂 提供的密码不够复杂。 该密码必须包含 8 到 128 个字符。 密码必须含以下字符类别中的三类:英文大写字母、英文小写字母、数字(0 到 9)及非字母数字字符(!、$、#、% 等)。
PasswordTooShort 该密码必须包含 8 到 128 个字符。 密码必须含以下字符类别中的三类:英文大写字母、英文小写字母、数字(0 到 9)及非字母数字字符(!、$、#、% 等)。
SubscriptionNotFound 找不到所请求的订阅。 运行 az account list all 以查看所有当前订阅。
InvalidParameterValue 为参数提供了无效值。 检查 CLI 参考文档,以查看参数所支持的正确取值。
无效位置 指定的位置无效。 检查 Azure 区域中 Azure Database for MySQL 灵活服务器的可用性
InvalidServerName 已识别到无效的服务器名称。 检查服务器名称。 运行命令 az mysql flexible-server list 以查看可用 Azure Database for MySQL 灵活服务器实例的所有列表。
InvalidResourceIdSegment Azure 资源管理器模板中标识了语法错误。 使用 JSON 格式化程序工具验证 JSON 以识别语法错误。
无效用户名 输入有效的用户名。 管理员用户名不能是 azure_superuser、azure_pg_admin、admin、administrator、root、guest 或 public。 且不能以 pg_ 开头。
BlockedUserName 管理员用户名不能是 azure_superuser、azure_pg_admin、admin、administrator、root、guest 或 public。 且不能以 pg_ 开头。 避免在管理员名称中使用这些模式。

下一步