Dashboards - Replace Dashboards

参考

Service:: Dashboard

API Version:: 7.1-preview.3

更新提供的组中仪表板的名称和位置，并删除省略的仪表板。不修改仪表板内容。

PUT 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 引用链接集合的类。
dashboardEntries	DashboardGroupEntry[]	仪表板组持有的仪表板列表
permission	GroupMemberPermission	已弃用：描述当前团队权限级别的旧权限模型。 M125 之前的。
teamDashboardPermission	TeamDashboardPermission	描述当前团队对仪表板的安全权限的权限位掩码。如果此权限为“无”值，请使用 GroupMemberPermission。权限根据是否存在非 None 值进行评估，否则将保存 GroupMemberPermission。
url	string

响应

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

安全性

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

PUT https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/dashboard/dashboards?api-version=7.1-preview.3

{
  "widgets": []
}

Sample Response

Status code:: 200

{
  "widgets": [],
  "url": "https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/Dashboard/groups/999EF3B4-93E1-4086-86C2-5E8BD24512C7/Dashboards/7562562a-4f9f-4258-94a9-b048b1c817cf",
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/Dashboard/groups/999EF3B4-93E1-4086-86C2-5E8BD24512C7/Dashboards/7562562a-4f9f-4258-94a9-b048b1c817cf"
    },
    "group": {
      "href": "https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/Dashboard/Groups/999ef3b4-93e1-4086-86c2-5e8bd24512c7"
    }
  },
  "id": "7562562a-4f9f-4258-94a9-b048b1c817cf",
  "name": "Dashboard98",
  "position": 2,
  "refreshInterval": 5
}

定义

名称	说明
Dashboard	仪表板的模型。
DashboardGroup	描述与所有者关联的仪表板列表。目前，团队拥有仪表板组。
DashboardGroupEntry	仪表板组条目，环绕仪表板 (需要？)
DashboardScope	仪表板范围。可以是 Project 或 Project_Team
GroupMemberPermission	已弃用：描述当前团队权限级别的旧权限模型。 M125 之前的。
LightboxOptions	Lightbox 配置
ReferenceLinks	表示 REST 引用链接集合的类。
SemanticVersion	项目的版本控制，如： http://semver.org/，格式为 major.minor.patch。
TeamDashboardPermission	描述当前团队对仪表板的安全权限的权限位掩码。如果此权限为“无”值，请使用 GroupMemberPermission。权限根据是否存在非 None 值进行评估，否则将保存 GroupMemberPermission。
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[]	仪表板上的小组件集。

DashboardGroup

描述与所有者关联的仪表板列表。目前，团队拥有仪表板组。

名称	类型	说明
_links	ReferenceLinks	表示 REST 引用链接集合的类。
dashboardEntries	DashboardGroupEntry[]	仪表板组持有的仪表板列表
permission	GroupMemberPermission	已弃用：描述当前团队权限级别的旧权限模型。 M125 之前的。
teamDashboardPermission	TeamDashboardPermission	描述当前团队对仪表板的安全权限的权限位掩码。如果此权限为“无”值，请使用 GroupMemberPermission。权限根据是否存在非 None 值进行评估，否则将保存 GroupMemberPermission。
url	string

DashboardGroupEntry

仪表板组条目，环绕仪表板 (需要？)

名称	类型	说明
_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	仪表板的范围限定为团队。

GroupMemberPermission

已弃用：描述当前团队权限级别的旧权限模型。 M125 之前的。

名称	类型	说明
edit	string
manage	string
managePermissions	string
none	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 修复时修补版本

TeamDashboardPermission

描述当前团队对仪表板的安全权限的权限位掩码。如果此权限为“无”值，请使用 GroupMemberPermission。权限根据是否存在非 None 值进行评估，否则将保存 GroupMemberPermission。

名称	类型	说明
create	string
delete	string
edit	string
managePermissions	string
none	string
read	string

小组件数据

名称	类型	说明
_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	小组件的高度，以网格行仪表板表示。

通过