Dashboards - Create

参考

Service:: Dashboard

API Version:: 7.1-preview.3

创建提供的仪表板。

POST https://dev.azure.com/{organization}/{project}/{team}/_apis/dashboard/dashboards?api-version=7.1-preview.3

URI 参数

名称	在	必需	类型	说明
organization	path	True	string	Azure DevOps 组织的名称。
project	path	True	string	项目 ID 或项目名称
team	path		string	团队 ID 或团队名称
api-version	query	True	string	要使用的 API 版本。这应设置为“7.1-preview.3”才能使用此版本的 API。

请求正文

名称	类型	说明
_links	ReferenceLinks	表示 REST 引用链接集合的类。
dashboardScope	DashboardScope	将仪表板限定为的实体。
description	string	仪表板的说明。
eTag	string	服务器定义的版本跟踪值，用于编辑冲突检测。
groupId	string	仪表板组的 ID。对于团队范围的仪表板，这是与仪表板关联的团队的唯一标识符。对于项目范围的仪表板，此属性为空。
id	string	仪表板的 ID。创建时由服务提供。
lastAccessedDate	string	仪表板上次访问日期。
modifiedBy	string	修改仪表板的人员的 ID。
modifiedDate	string	仪表板的上次修改日期。
name	string	仪表板的名称。
ownerId	string	仪表板所有者的 ID。对于团队范围的仪表板，这是与仪表板关联的团队的唯一标识符。对于项目范围的仪表板，这是与仪表板关联的用户标识的唯一标识符。
position	integer	仪表板组中仪表板的位置。如果在创建时未设置，则位置由服务决定。
refreshInterval	integer	客户端自动刷新仪表板的间隔。以分钟为单位表示。
url	string
widgets	Widget[]	仪表板上的小组件集。

响应

名称	类型	说明
200 OK	Dashboard	成功的操作

安全性

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Scopes

名称	说明
vso.dashboards_manage	授予管理团队仪表板信息的能力

示例

Sample Request

HTTP

POST https://dev.azure.com/fabrikam/{project}/_apis/dashboard/dashboards?api-version=7.1-preview.3

{
  "name": "test",
  "position": 5,
  "widgets": [
    {
      "name": "Team Members renamed",
      "position": {
        "row": 2,
        "column": 2
      },
      "size": {
        "rowSpan": 1,
        "columnSpan": 2
      },
      "settings": null,
      "settingsVersion": {
        "major": 1,
        "minor": 0,
        "patch": 0
      },
      "contributionId": "ms.vss-dashboards-web.Microsoft.VisualStudioOnline.Dashboards.TeamMembersWidget"
    }
  ]
}

Sample Response

Status code:: 200

{
  "id": "29653dd2-c18a-4d19-8333-e556c5b8d025",
  "name": "test",
  "position": 5,
  "eTag": "1",
  "widgets": [
    {
      "name": "Team Members renamed",
      "position": {
        "row": 2,
        "column": 2
      },
      "size": {
        "rowSpan": 1,
        "columnSpan": 2
      },
      "settings": null,
      "settingsVersion": {
        "major": 1,
        "minor": 0,
        "patch": 0
      },
      "contributionId": "ms.vss-dashboards-web.Microsoft.VisualStudioOnline.Dashboards.TeamMembersWidget"
    }
  ],
  "url": "https://dev.azure.com/fabrikam/99755c45-cb33-4ab4-9f36-e5920cec7ba9/dc0d32d0-be95-4385-9df6-1176d698be22/_apis/Dashboard/Dashboards/29653dd2-c18a-4d19-8333-e556c5b8d025",
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/99755c45-cb33-4ab4-9f36-e5920cec7ba9/dc0d32d0-be95-4385-9df6-1176d698be22/_apis/Dashboard/Dashboards/29653dd2-c18a-4d19-8333-e556c5b8d025"
    },
    "group": {
      "href": "https://dev.azure.com/fabrikam/99755c45-cb33-4ab4-9f36-e5920cec7ba9/dc0d32d0-be95-4385-9df6-1176d698be22/_apis/Dashboard/Dashboards"
    },
    "widget": [
      {
        "href": "https://dev.azure.com/fabrikam/99755c45-cb33-4ab4-9f36-e5920cec7ba9/dc0d32d0-be95-4385-9df6-1176d698be22/_apis/Dashboard/dashboards/29653dd2-c18a-4d19-8333-e556c5b8d025/Widgets/456afb86-ecf6-49cf-bbcc-1ab7d0fc14b2"
      }
    ]
  }
}

定义

名称	说明
Dashboard	仪表板的模型。
DashboardScope	仪表板范围。可以是 Project 或 Project_Team
LightboxOptions	Lightbox 配置
ReferenceLinks	表示 REST 引用链接集合的类。
SemanticVersion	项目的版本控制，如上所述： http://semver.org/，格式为 major.minor.patch。
Widget	小组件数据
WidgetPosition
WidgetSize

Dashboard

仪表板的模型。

名称	类型	说明
_links	ReferenceLinks	表示 REST 引用链接集合的类。
dashboardScope	DashboardScope	将仪表板限定为的实体。
description	string	仪表板的说明。
eTag	string	服务器定义的版本跟踪值，用于编辑冲突检测。
groupId	string	仪表板组的 ID。对于团队范围的仪表板，这是与仪表板关联的团队的唯一标识符。对于项目范围的仪表板，此属性为空。
id	string	仪表板的 ID。创建时由服务提供。
lastAccessedDate	string	仪表板上次访问日期。
modifiedBy	string	修改仪表板的人员的 ID。
modifiedDate	string	仪表板的上次修改日期。
name	string	仪表板的名称。
ownerId	string	仪表板所有者的 ID。对于团队范围的仪表板，这是与仪表板关联的团队的唯一标识符。对于项目范围的仪表板，这是与仪表板关联的用户标识的唯一标识符。
position	integer	仪表板组中仪表板的位置。如果在创建时未设置，则位置由服务决定。
refreshInterval	integer	客户端自动刷新仪表板的间隔。以分钟为单位表示。
url	string
widgets	Widget[]	仪表板上的小组件集。

DashboardScope

仪表板范围。可以是 Project 或 Project_Team

名称	类型	说明
collection_User	string	[已弃用]仪表板的范围限定为集合用户。
project	string	仪表板的范围限定为项目。
project_Team	string	仪表板的范围限定为团队。

LightboxOptions

Lightbox 配置

名称	类型	说明
height	integer	所需灯箱的高度（以像素为单位）
resizable	boolean	如果为 True，则允许重设灯箱大小，如果为 false，则不允许重设灯箱大小，默认为 false。
width	integer	所需灯箱的宽度（以像素为单位）

ReferenceLinks

表示 REST 引用链接集合的类。

名称	类型	说明
links	object	链接的只读视图。由于引用链接是只读的，因此我们只想将其公开为只读。

SemanticVersion

项目的版本控制，如上所述： http://semver.org/，格式为 major.minor.patch。

名称	类型	说明
major	integer	进行不兼容 API 更改时的主版本
minor	integer	以向后兼容的方式添加功能时的次要版本
patch	integer	进行向后兼容的 bug 修复时的修补程序版本

小组件数据

名称	类型	说明
_links	ReferenceLinks	表示 REST 引用链接集合的类。
allowedSizes	WidgetSize[]	指小组件允许的大小。当用户想要配置小组件时，会填充此内容
areSettingsBlockedForUser	boolean	Read-Only仪表板服务中的属性。指示是否阻止当前用户的设置。
artifactId	string	引用功能项目的唯一标识符。用于固定+取消固定特定项目。
configurationContributionId	string
configurationContributionRelativeId	string
contentUri	string
contributionId	string	定义提供的小组件配置的基础贡献的 ID。
dashboard	Dashboard	可选部分仪表板内容，支持交换小组件级 API 的仪表板级版本 ETag
eTag	string
id	string
isEnabled	boolean
isNameConfigurable	boolean
lightboxOptions	LightboxOptions	Lightbox 配置
loadingImageUrl	string
name	string
position	WidgetPosition
settings	string
settingsVersion	SemanticVersion	项目的版本控制，如上所述： http://semver.org/，格式为 major.minor.patch。
size	WidgetSize
typeId	string
url	string

WidgetPosition

名称	类型	说明
column	integer
row	integer

WidgetSize

名称	类型	说明
columnSpan	integer	小组件的宽度，以网格列仪表板表示。
rowSpan	integer	小组件的高度，以网格行仪表板表示。

通过