在 Azure 托管 Grafana 中创建和管理 Grafana API 密钥（已弃用）

1. 在 Azure 门户中的“设置”下选择“配置”，然后在“API 密钥”下选择“启用”。

   

2. 选择“保存”以确认你要激活在 Azure 托管 Grafana 中创建 API 密钥的功能。

运行 az grafana update 命令，在现有的 Azure 托管 Grafana 实例中启用创建 API 密钥的功能。 在以下命令中，将 <azure-managed-grafana-name> 替换为要更新的 Azure 托管 Grafana 实例的名称。

az grafana update --name <azure-managed-grafana-name> --api-keys Enabled

1. 打开 Azure 托管 Grafana 实例，然后从左侧菜单中选择“配置”>“API 密钥”。

2. 选择“新建 API 密钥”。

3. 填写表单，然后选择“添加”以生成新的 API 密钥。

   参数	说明	示例
   密钥名称	输入新 Grafana API 密钥的名称。	api-key-1
   Microsoft 托管 Grafana	选择托管 Grafana 角色：查看者、编辑者或管理员。	编辑器
   生存时间	输入 API 密钥过期之前的时间。 使用 s 表示秒，m 表示分钟，h 表示小时，d 表示天，w 表示周，M 表示月，y 表示年。	7d

   

4. 生成密钥后，会弹出一条消息，其中包含新密钥和 curl 命令（包含你的密钥）。 现在复制此信息并将其保存到记录中，因为离开此页面后将隐藏此信息。 如果在未保存新 API 密钥的情况下关闭此页面，则需要生成一个新密钥。

   

现在可以使用此 Grafana API 密钥调用 Grafana 服务器。

1. 运行 az grafana api-key create 命令，为 Azure 托管 Grafana 创建 API 密钥。 将 <azure-managed-grafana-name> 和 <key> 替换为要更新的 Azure 托管 Grafana 实例的名称，以及新 API 密钥的名称。

   还可以选择添加更多参数，例如 --role 和 --time-to-live。

   参数	说明	示例
   --role	通过输入 Admin、Editor 或 Viewer 选择一个 Azure 托管 Grafana 角色。 默认值为 Viewer。	编辑器
   --time-to-live	输入 API 密钥过期之前的时间。 将 s 用于秒，将 m 用于分钟，将 h 用于小时，将 d 用于天，将 w 用于周，将 M 用于月，将 y 用于年。 默认值为 1d。	7d

   az grafana api-key create --name <azure-managed-grafana-name> --key <key>
   

2. 终端返回密钥 ID、密钥和密钥名称。 立即复制此信息并将其保存到记录中，因为你只能查看此密钥一次。

“配置”>“API 密钥”中列出了现有 API 密钥。 默认情况下，仅显示活动 API 密钥。 选择“包括过期的密钥”以查看所有已创建的密钥，然后选择“X”（“删除”）以删除 API 密钥。

列出 API 密钥

运行 az grafana api-key list 命令，列出现有 Azure 托管 Grafana 实例中的 API 密钥。 在以下命令中，将 <azure-managed-grafana-name> 替换为 Azure 托管 Grafana 实例的名称。

az grafana api-key list --name <azure-managed-grafana-name> --output table

输出示例：

Name   Role    Expiration
-----  ------  --------------------
key01  Viewer
key02  Viewer  2022-08-31T17:14:44Z

删除 API 密钥

运行 az grafana api-key delete 命令以删除 API 密钥。 在以下命令中，将 <azure-managed-grafana-name> 和 <key> 替换为 Azure 托管 Grafana 实例的名称以及要删除的 API 密钥的 ID 或名称。

az grafana api-key delete --name <azure-managed-grafana-name> --key <key>