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 のバージョン。このバージョンの 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_Team
GroupMemberPermission	非推奨: 現在のチームのアクセス許可のレベルを説明する古いアクセス許可モデル。 M125 より前。
LightboxOptions	ライトボックスの構成
ReferenceLinks	REST 参照リンクのコレクションを表すクラス。
SemanticVersion	「major.minor.patch」という形式の成果物 http://semver.org/のバージョン管理。
TeamDashboardPermission	ダッシュボードに対する現在のチームのセキュリティアクセス許可を記述するアクセス許可ビットマスク。このアクセス許可の値が None の場合は、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。チームスコープのダッシュボードの場合、これはダッシュボードに関連付けられているチームの一意の識別子です。プロジェクトスコープのダッシュボードの場合、これはダッシュボードに関連付けられているユーザー ID の一意の識別子です。
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。チームスコープのダッシュボードの場合、これはダッシュボードに関連付けられているチームの一意の識別子です。プロジェクトスコープのダッシュボードの場合、このプロパティは空です。
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_Team

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

GroupMemberPermission

非推奨: 現在のチームのアクセス許可のレベルを説明する古いアクセス許可モデル。 M125 より前。

名前	型	説明
edit	string
manage	string
managePermissions	string
none	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	下位互換性のあるバグ修正を行うときのパッチバージョン

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	指定されたウィジェット構成を定義する基になるコントリビューションの 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	ダッシュボードグリッド行で表されるウィジェットの高さ。

次の方法で共有