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

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

Имя	Тип	Описание
_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[]	Набор мини-приложений на панели мониторинга.

Ответы

Имя	Тип	Описание
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	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	Область панели мониторинга ограничена командой.

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	Версия исправления при создании исправлений ошибок, совместимых с обратной совместимостью

Данные мини-приложения

Имя	Тип	Описание
_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