你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
言论
有关创建仪表板的详细信息,请参阅 Azure 仪表板的结构。
Bicep 资源定义
可以使用目标操作部署仪表板资源类型:
有关每个 API 版本中已更改属性的列表,请参阅 更改日志。
资源格式
若要创建 Microsoft.Portal/dashboards 资源,请将以下 Bicep 添加到模板。
resource symbolicname 'Microsoft.Portal/dashboards@2025-04-01-preview' = {
scope: resourceSymbolicName or scope
location: 'string'
name: 'string'
properties: {
lenses: [
{
metadata: any(...)
order: int
parts: [
{
metadata: {
type: 'string'
// For remaining properties, see DashboardPartMetadata objects
}
position: {
colSpan: int
metadata: any(...)
rowSpan: int
x: int
y: int
}
}
]
}
]
metadata: any(...)
}
tags: {
{customized property}: 'string'
}
}
DashboardPartMetadata 对象
设置 类型 属性以指定对象的类型。
对于 Extension/HubsExtension/PartType/MarkdownPart,请使用:
{
inputs: [
any(...)
]
settings: {
content: {
content: 'string'
markdownSource: int
markdownUri: 'string'
subtitle: 'string'
title: 'string'
}
}
type: 'Extension/HubsExtension/PartType/MarkdownPart'
}
属性值
Microsoft.Portal/仪表板
| 名字 | 描述 | 价值 |
|---|---|---|
| 位置 | 资源所在的地理位置 | string (必需) |
| 名字 | 资源名称 | 字符串 约束: 最小长度 = 3 最大长度 = 64 模式 = ^[a-zA-Z0-9-]{3,24}$ (必需) |
| 性能 | 此资源的资源特定属性。 | DashboardPropertiesWithProvisioningState |
| 作用域 | 在与部署范围不同的范围内创建资源时使用。 | 将此属性设置为资源的符号名称以应用 扩展资源。 |
| 标签 | 资源标记 | 标记名称和值的字典。 请参阅模板 中的 |
仪表板镜头
| 名字 | 描述 | 价值 |
|---|---|---|
| 元数据 | 仪表板 len 的元数据。 | 任何 |
| 顺序 | 镜头顺序。 | int (必需) |
| 部件 | 仪表板部件。 | DashboardParts[] (必需) |
DashboardPartMetadata
| 名字 | 描述 | 价值 |
|---|---|---|
| 类型 | 对于 MarkdownPartMetadata,请设置为“Extension/HubsExtension/PartType/MarkdownPart”。 | “Extension/HubsExtension/PartType/MarkdownPart”(必需) |
仪表板部件
| 名字 | 描述 | 价值 |
|---|---|---|
| 元数据 | 仪表板部件的元数据。 | DashboardPartMetadata |
| 位置 | 仪表板的部件位置。 | DashboardPartsPosition (必需) |
DashboardPartsPosition
| 名字 | 描述 | 价值 |
|---|---|---|
| colSpan | 仪表板的部件列范围。 | int (必需) |
| 元数据 | 仪表板部件的元数据。 | 任何 |
| rowSpan (行跨度) | 仪表板的部件行范围。 | int (必需) |
| x | 仪表板的第 x 部分坐标。 | int (必需) |
| y | 仪表板的部分 y 坐标。 | int (必需) |
DashboardPropertiesWithProvisioningState
| 名字 | 描述 | 价值 |
|---|---|---|
| 镜头 | 仪表板镜头。 | 仪表板镜头 |
| 元数据 | 仪表板元数据。 | 任何 |
MarkdownPartMetadata
| 名字 | 描述 | 价值 |
|---|---|---|
| 输入 | 仪表板部件的输入。 | 任何[] |
| 设置 | Markdown 部件设置。 | MarkdownPartMetadataSettings |
| 类型 | 仪表板部件元数据类型。 | “Extension/HubsExtension/PartType/MarkdownPart”(必需) |
MarkdownPartMetadataSettings
| 名字 | 描述 | 价值 |
|---|---|---|
| 内容 | markdown 部件的内容。 | MarkdownPartMetadataSettingsContent |
MarkdownPartMetadataSettingsContent
| 名字 | 描述 | 价值 |
|---|---|---|
| 内容 | markdown 部件的内容。 | 字符串 |
| markdown源 | Markdown 部件内容的源。 | 整数 (int) |
| markdownUri 的 | markdown 内容的 URI。 | 字符串 |
| 字幕 | Markdown 部件的副标题。 | 字符串 |
| 标题 | Markdown 部件的标题。 | 字符串 |
TrackedResourceTags
| 名字 | 描述 | 价值 |
|---|
用法示例
Azure 验证模块
以下 Azure 验证模块 可用于部署此资源类型。
| 模块 | 描述 |
|---|---|
| 门户仪表板 | 门户仪表板的 AVM 资源模块 |
Azure 快速入门示例
以下 Azure 快速入门模板 包含用于部署此资源类型的 Bicep 示例。
| Bicep 文件 | 描述 |
|---|---|
| 创建 Azure 门户仪表板 | 此模板在 Azure 门户中创建示例仪表板,其中显示了订阅中现有虚拟机的性能,以及一些静态信息和链接。 |
| 部署简单的 Azure Spring Apps 微服务应用程序 | 此模板部署一个简单的 Azure Spring Apps 微服务应用程序,以在 Azure 上运行。 |
ARM 模板资源定义
可以使用目标操作部署仪表板资源类型:
有关每个 API 版本中已更改属性的列表,请参阅 更改日志。
资源格式
若要创建 Microsoft.Portal/dashboards 资源,请将以下 JSON 添加到模板。
{
"type": "Microsoft.Portal/dashboards",
"apiVersion": "2025-04-01-preview",
"name": "string",
"location": "string",
"properties": {
"lenses": [
{
"metadata": {},
"order": "int",
"parts": [
{
"metadata": {
"type": "string"
// For remaining properties, see DashboardPartMetadata objects
},
"position": {
"colSpan": "int",
"metadata": {},
"rowSpan": "int",
"x": "int",
"y": "int"
}
}
]
}
],
"metadata": {}
},
"tags": {
"{customized property}": "string"
}
}
DashboardPartMetadata 对象
设置 类型 属性以指定对象的类型。
对于 Extension/HubsExtension/PartType/MarkdownPart,请使用:
{
"inputs": [ {} ],
"settings": {
"content": {
"content": "string",
"markdownSource": "int",
"markdownUri": "string",
"subtitle": "string",
"title": "string"
}
},
"type": "Extension/HubsExtension/PartType/MarkdownPart"
}
属性值
Microsoft.Portal/仪表板
| 名字 | 描述 | 价值 |
|---|---|---|
| apiVersion | API 版本 | “2025-04-01-预览” |
| 位置 | 资源所在的地理位置 | string (必需) |
| 名字 | 资源名称 | 字符串 约束: 最小长度 = 3 最大长度 = 64 模式 = ^[a-zA-Z0-9-]{3,24}$ (必需) |
| 性能 | 此资源的资源特定属性。 | DashboardPropertiesWithProvisioningState |
| 标签 | 资源标记 | 标记名称和值的字典。 请参阅模板 中的 |
| 类型 | 资源类型 | “Microsoft.Portal/dashboards” |
仪表板镜头
| 名字 | 描述 | 价值 |
|---|---|---|
| 元数据 | 仪表板 len 的元数据。 | 任何 |
| 顺序 | 镜头顺序。 | int (必需) |
| 部件 | 仪表板部件。 | DashboardParts[] (必需) |
DashboardPartMetadata
| 名字 | 描述 | 价值 |
|---|---|---|
| 类型 | 对于 MarkdownPartMetadata,请设置为“Extension/HubsExtension/PartType/MarkdownPart”。 | “Extension/HubsExtension/PartType/MarkdownPart”(必需) |
仪表板部件
| 名字 | 描述 | 价值 |
|---|---|---|
| 元数据 | 仪表板部件的元数据。 | DashboardPartMetadata |
| 位置 | 仪表板的部件位置。 | DashboardPartsPosition (必需) |
DashboardPartsPosition
| 名字 | 描述 | 价值 |
|---|---|---|
| colSpan | 仪表板的部件列范围。 | int (必需) |
| 元数据 | 仪表板部件的元数据。 | 任何 |
| rowSpan (行跨度) | 仪表板的部件行范围。 | int (必需) |
| x | 仪表板的第 x 部分坐标。 | int (必需) |
| y | 仪表板的部分 y 坐标。 | int (必需) |
DashboardPropertiesWithProvisioningState
| 名字 | 描述 | 价值 |
|---|---|---|
| 镜头 | 仪表板镜头。 | 仪表板镜头 |
| 元数据 | 仪表板元数据。 | 任何 |
MarkdownPartMetadata
| 名字 | 描述 | 价值 |
|---|---|---|
| 输入 | 仪表板部件的输入。 | 任何[] |
| 设置 | Markdown 部件设置。 | MarkdownPartMetadataSettings |
| 类型 | 仪表板部件元数据类型。 | “Extension/HubsExtension/PartType/MarkdownPart”(必需) |
MarkdownPartMetadataSettings
| 名字 | 描述 | 价值 |
|---|---|---|
| 内容 | markdown 部件的内容。 | MarkdownPartMetadataSettingsContent |
MarkdownPartMetadataSettingsContent
| 名字 | 描述 | 价值 |
|---|---|---|
| 内容 | markdown 部件的内容。 | 字符串 |
| markdown源 | Markdown 部件内容的源。 | 整数 (int) |
| markdownUri 的 | markdown 内容的 URI。 | 字符串 |
| 字幕 | Markdown 部件的副标题。 | 字符串 |
| 标题 | Markdown 部件的标题。 | 字符串 |
TrackedResourceTags
| 名字 | 描述 | 价值 |
|---|
用法示例
Azure 快速入门模板
以下 Azure 快速入门模板 部署此资源类型。
| 模板 | 描述 |
|---|---|
|
创建 Azure ML 监视仪表板 |
此模板在现有 Log Analytics 工作区诊断数据的基础上创建 AML 仪表板 |
|
创建 Azure 门户仪表板 |
此模板在 Azure 门户中创建示例仪表板,其中显示了订阅中现有虚拟机的性能,以及一些静态信息和链接。 |
|
部署简单的 Azure Spring Apps 微服务应用程序 |
此模板部署一个简单的 Azure Spring Apps 微服务应用程序,以在 Azure 上运行。 |
|
共享的默认仪表板 |
为了使应用程序正常运行,它有助于获得构成系统的服务的共享仪表板视图。 此仪表板提供了一个快速入门,用于自定义和共享团队中的其他人。 |
Terraform (AzAPI 提供程序)资源定义
可以使用目标操作部署仪表板资源类型:
有关每个 API 版本中已更改属性的列表,请参阅 更改日志。
资源格式
若要创建 Microsoft.Portal/dashboards 资源,请将以下 Terraform 添加到模板。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Portal/dashboards@2025-04-01-preview"
name = "string"
parent_id = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
lenses = [
{
metadata = ?
order = int
parts = [
{
metadata = {
type = "string"
// For remaining properties, see DashboardPartMetadata objects
}
position = {
colSpan = int
metadata = ?
rowSpan = int
x = int
y = int
}
}
]
}
]
metadata = ?
}
}
}
DashboardPartMetadata 对象
设置 类型 属性以指定对象的类型。
对于 Extension/HubsExtension/PartType/MarkdownPart,请使用:
{
inputs = [
?
]
settings = {
content = {
content = "string"
markdownSource = int
markdownUri = "string"
subtitle = "string"
title = "string"
}
}
type = "Extension/HubsExtension/PartType/MarkdownPart"
}
属性值
Microsoft.Portal/仪表板
| 名字 | 描述 | 价值 |
|---|---|---|
| 位置 | 资源所在的地理位置 | string (必需) |
| 名字 | 资源名称 | 字符串 约束: 最小长度 = 3 最大长度 = 64 模式 = ^[a-zA-Z0-9-]{3,24}$ (必需) |
| parent_id | 要向其应用此扩展资源的资源的 ID。 | string (必需) |
| 性能 | 此资源的资源特定属性。 | DashboardPropertiesWithProvisioningState |
| 标签 | 资源标记 | 标记名称和值的字典。 |
| 类型 | 资源类型 | “Microsoft.Portal/dashboards@2025-04-01-preview” |
仪表板镜头
| 名字 | 描述 | 价值 |
|---|---|---|
| 元数据 | 仪表板 len 的元数据。 | 任何 |
| 顺序 | 镜头顺序。 | int (必需) |
| 部件 | 仪表板部件。 | DashboardParts[] (必需) |
DashboardPartMetadata
| 名字 | 描述 | 价值 |
|---|---|---|
| 类型 | 对于 MarkdownPartMetadata,请设置为“Extension/HubsExtension/PartType/MarkdownPart”。 | “Extension/HubsExtension/PartType/MarkdownPart”(必需) |
仪表板部件
| 名字 | 描述 | 价值 |
|---|---|---|
| 元数据 | 仪表板部件的元数据。 | DashboardPartMetadata |
| 位置 | 仪表板的部件位置。 | DashboardPartsPosition (必需) |
DashboardPartsPosition
| 名字 | 描述 | 价值 |
|---|---|---|
| colSpan | 仪表板的部件列范围。 | int (必需) |
| 元数据 | 仪表板部件的元数据。 | 任何 |
| rowSpan (行跨度) | 仪表板的部件行范围。 | int (必需) |
| x | 仪表板的第 x 部分坐标。 | int (必需) |
| y | 仪表板的部分 y 坐标。 | int (必需) |
DashboardPropertiesWithProvisioningState
| 名字 | 描述 | 价值 |
|---|---|---|
| 镜头 | 仪表板镜头。 | 仪表板镜头 |
| 元数据 | 仪表板元数据。 | 任何 |
MarkdownPartMetadata
| 名字 | 描述 | 价值 |
|---|---|---|
| 输入 | 仪表板部件的输入。 | 任何[] |
| 设置 | Markdown 部件设置。 | MarkdownPartMetadataSettings |
| 类型 | 仪表板部件元数据类型。 | “Extension/HubsExtension/PartType/MarkdownPart”(必需) |
MarkdownPartMetadataSettings
| 名字 | 描述 | 价值 |
|---|---|---|
| 内容 | markdown 部件的内容。 | MarkdownPartMetadataSettingsContent |
MarkdownPartMetadataSettingsContent
| 名字 | 描述 | 价值 |
|---|---|---|
| 内容 | markdown 部件的内容。 | 字符串 |
| markdown源 | Markdown 部件内容的源。 | 整数 (int) |
| markdownUri 的 | markdown 内容的 URI。 | 字符串 |
| 字幕 | Markdown 部件的副标题。 | 字符串 |
| 标题 | Markdown 部件的标题。 | 字符串 |
TrackedResourceTags
| 名字 | 描述 | 价值 |
|---|
用法示例
Terraform 示例
在 Azure 门户中部署共享仪表板的基本示例。
terraform {
required_providers {
azapi = {
source = "Azure/azapi"
}
}
}
provider "azapi" {
skip_provider_registration = false
}
variable "resource_name" {
type = string
default = "acctest0001"
}
variable "location" {
type = string
default = "westeurope"
}
resource "azapi_resource" "resourceGroup" {
type = "Microsoft.Resources/resourceGroups@2020-06-01"
name = var.resource_name
location = var.location
}
resource "azapi_resource" "dashboard" {
type = "Microsoft.Portal/dashboards@2019-01-01-preview"
parent_id = azapi_resource.resourceGroup.id
name = var.resource_name
location = var.location
body = {
properties = {
lenses = {
}
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}
Azure 验证模块
以下 Azure 验证模块 可用于部署此资源类型。
| 模块 | 描述 |
|---|---|
| Azure 门户仪表板 | Azure 门户仪表板的 AVM 资源模块 |