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 のバージョン。 このバージョンの API を使用するには、これを '7.1-preview.3' に設定する必要があります。

要求本文

名前	型	説明
_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。 チーム スコープのダッシュボードの場合、これはダッシュボードに関連付けられているチームの一意の識別子です。 プロジェクト スコープのダッシュボードの場合、これはダッシュボードに関連付けられているユーザー 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	ライトボックスの構成
ReferenceLinks	REST 参照リンクのコレクションを表す クラス。
SemanticVersion	major.minor.patch 形式の 成果物 http://semver.org/のバージョン管理。
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。 チーム スコープのダッシュボードの場合、これはダッシュボードに関連付けられているチームの一意の識別子です。 プロジェクト スコープのダッシュボードの場合、これはダッシュボードに関連付けられているユーザー ID の一意の識別子です。
position	integer	ダッシュボード グループ内でのダッシュボードの位置。 作成時に設定を解除すると、サービスによって位置が決定されます。
refreshInterval	integer	クライアントがダッシュボードを自動的に更新する間隔。 分単位で表されます。
url	string
widgets	Widget[]	ダッシュボード上のウィジェットのセット。

DashboardScope

ダッシュボードのスコープ。 Project または Project_Team のいずれかを指定できます

名前	型	説明
collection_User	string	[非推奨]ダッシュボードのスコープはコレクション ユーザーです。
project	string	ダッシュボードのスコープはプロジェクトです。
project_Team	string	ダッシュボードはチームにスコープが設定されます。

LightboxOptions

ライトボックスの構成

名前	型	説明
height	integer	必要なライトボックスの高さ (ピクセル単位)
resizable	boolean	ライトボックスのサイズ変更を許可する場合は True、ライトボックスのサイズ変更を許可しない場合は false、既定値は false です。
width	integer	目的のライトボックスの幅 (ピクセル単位)

ReferenceLinks

REST 参照リンクのコレクションを表す クラス。

名前	型	説明
links	object	リンクの読み取り専用ビュー。 参照リンクは読み取り専用であるため、参照リンクは読み取り専用として公開する必要があります。

SemanticVersion

major.minor.patch 形式の 成果物 http://semver.org/のバージョン管理。

名前	型	説明
major	integer	互換性のない API 変更を行うときのメジャー バージョン
minor	integer	下位互換性のある方法で機能を追加する場合のマイナー バージョン
patch	integer	下位互換性のあるバグ修正を行うときのパッチ バージョン

Widget

ウィジェット データ

名前	型	説明
_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	ライトボックスの構成
loadingImageUrl	string
name	string
position	WidgetPosition
settings	string
settingsVersion	SemanticVersion	major.minor.patch 形式の 成果物 http://semver.org/のバージョン管理。
size	WidgetSize
typeId	string
url	string

WidgetPosition

名前	型	説明
column	integer
row	integer

WidgetSize

名前	型	説明
columnSpan	integer	ダッシュボード グリッド列で表されるウィジェットの幅。
rowSpan	integer	ダッシュボード グリッド行で表されるウィジェットの高さ。