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	Идентификатор проекта или имя проекта
team	path		string	Идентификатор или имя команды
api-version	query	True	string	Используемая версия API. Для использования этой версии API необходимо задать значение 7.1-preview.3.

Текст запроса

Имя	Тип	Описание
_links	ReferenceLinks	Класс, представляющий коллекцию ссылок REST.
dashboardEntries	DashboardGroupEntry[]	Список панелей мониторинга, хранящиеся в группе панелей мониторинга
permission	GroupMemberPermission	Не рекомендуется: старая модель разрешений, описывающая уровень разрешений для текущей команды. До M125.
teamDashboardPermission	TeamDashboardPermission	Битовая маска разрешений, описывающая разрешения безопасности текущей команды для панелей мониторинга. Если это разрешение имеет значение None, используйте 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	Битовая маска разрешений, описывающая разрешения безопасности текущей команды для панелей мониторинга. Если это разрешение имеет значение None, используйте GroupMemberPermission. Разрешения оцениваются на основе наличия значения, отличного от None. В противном случае groupMemberPermission будет сохранен.
Widget	Данные мини-приложения
WidgetPosition
WidgetSize

Dashboard

Модель панели мониторинга.

Имя	Тип	Описание
_links	ReferenceLinks	Класс, представляющий коллекцию ссылок REST.
dashboardScope	DashboardScope	Сущность, область действия которой ограничена панелью мониторинга.
description	string	Описание панели мониторинга.
eTag	string	Определенное сервером значение отслеживания версий, используемое для обнаружения конфликтов редактирования.
groupId	string	Идентификатор группы для панели мониторинга. Для панелей мониторинга с областью действия группы это уникальный идентификатор команды, связанной с панелью мониторинга. Для панелей мониторинга в области проекта это свойство пусто.
id	string	Идентификатор панели мониторинга. Предоставляется службой во время создания.
lastAccessedDate	string	Дата последнего доступа к панели мониторинга.
modifiedBy	string	Идентификатор пользователя, изменившего панель мониторинга.
modifiedDate	string	Дата последнего изменения панели мониторинга.
name	string	Имя панели мониторинга.
ownerId	string	Идентификатор владельца панели мониторинга. Для панелей мониторинга с областью действия группы это уникальный идентификатор команды, связанной с панелью мониторинга. Для панелей мониторинга в области проекта это уникальный идентификатор удостоверения пользователя, связанного с панелью мониторинга.
position	integer	Положение панели мониторинга в группе панелей мониторинга. Если во время создания не задано, позиция определяется службой.
refreshInterval	integer	Интервал для автоматического обновления панели мониторинга клиентом. Выражается в минутах.
url	string
widgets	Widget[]	Набор мини-приложений на панели мониторинга.

DashboardGroup

Описывает список панелей мониторинга, связанных с владельцем. В настоящее время команды владеют группами панелей мониторинга.

Имя	Тип	Описание
_links	ReferenceLinks	Класс, представляющий коллекцию ссылок REST.
dashboardEntries	DashboardGroupEntry[]	Список панелей мониторинга, хранящиеся в группе панелей мониторинга
permission	GroupMemberPermission	Не рекомендуется: старая модель разрешений, описывающая уровень разрешений для текущей команды. До M125.
teamDashboardPermission	TeamDashboardPermission	Битовая маска разрешений, описывающая разрешения безопасности текущей команды для панелей мониторинга. Если это разрешение имеет значение None, используйте GroupMemberPermission. Разрешения оцениваются на основе наличия значения, отличного от None. В противном случае groupMemberPermission будет сохранен.
url	string

DashboardGroupEntry

Запись группы панели мониторинга, оболочка вокруг панели мониторинга (требуется?)

Имя	Тип	Описание
_links	ReferenceLinks	Класс, представляющий коллекцию ссылок REST.
dashboardScope	DashboardScope	Сущность, область действия которой ограничена панелью мониторинга.
description	string	Описание панели мониторинга.
eTag	string	Определенное сервером значение отслеживания версий, используемое для обнаружения конфликтов редактирования.
groupId	string	Идентификатор группы для панели мониторинга. Для панелей мониторинга с областью действия группы это уникальный идентификатор команды, связанной с панелью мониторинга. Для панелей мониторинга в области проекта это свойство пусто.
id	string	Идентификатор панели мониторинга. Предоставляется службой во время создания.
lastAccessedDate	string	Дата последнего доступа к панели мониторинга.
modifiedBy	string	Идентификатор пользователя, изменившего панель мониторинга.
modifiedDate	string	Дата последнего изменения панели мониторинга.
name	string	Имя панели мониторинга.
ownerId	string	Идентификатор владельца панели мониторинга. Для панелей мониторинга с областью действия группы это уникальный идентификатор команды, связанной с панелью мониторинга. Для панелей мониторинга в области проекта это уникальный идентификатор удостоверения пользователя, связанного с панелью мониторинга.
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	Версия исправления при создании исправлений ошибок, совместимых с обратной совместимостью

TeamDashboardPermission

Битовая маска разрешений, описывающая разрешения безопасности текущей команды для панелей мониторинга. Если это разрешение имеет значение None, используйте 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	Идентификатор базового вклада, определяющего предоставленную конфигурацию мини-приложения.
dashboard	Dashboard	Необязательное частичное содержимое панели мониторинга для поддержки обмена версией ETag на уровне панели мониторинга для API уровня мини-приложения
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	Высота мини-приложения, выраженная в строках сетки панели мониторинга.

Share via