Aracılığıyla paylaş


Dashboards - Replace Dashboards

Sağlanan gruptaki panoların adını ve konumunu güncelleştirin ve atlanmış panoları kaldırın. Pano içeriğini değiştirmez.

PUT https://dev.azure.com/{organization}/{project}/{team}/_apis/dashboard/dashboards?api-version=7.1-preview.3

URI Parametreleri

Name İçinde Gerekli Tür Description
organization
path True

string

Azure DevOps kuruluşunun adı.

project
path True

string

Proje Kimliği veya proje adı

team
path

string

Ekip kimliği veya ekip adı

api-version
query True

string

Kullanılacak API'nin sürümü. Bu, api'nin bu sürümünü kullanmak için '7.1-preview.3' olarak ayarlanmalıdır.

İstek Gövdesi

Name Tür Description
_links

ReferenceLinks

REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.

dashboardEntries

DashboardGroupEntry[]

Pano Grubu tarafından tutulan Panoların listesi

permission

GroupMemberPermission

Kullanım dışı: Geçerli ekip için izin düzeyini açıklayan eski izin modeli. M125 öncesi.

teamDashboardPermission

TeamDashboardPermission

Panolar için geçerli ekibin güvenlik izinlerini açıklayan izin bit maskesi. Bu izin Yok değeri olduğunda GroupMemberPermission kullanın. İzinler Yok dışında bir değerin varlığına göre değerlendirilir, aksi takdirde GroupMemberPermission kaydedilir.

url

string

Yanıtlar

Name Tür Description
200 OK

DashboardGroup

başarılı işlem

Güvenlik

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

Name Description
vso.dashboards_manage Ekip panosu bilgilerini yönetme olanağı sağlar

Örnekler

Sample Request

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

{
  "widgets": []
}

Sample Response

{
  "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
}

Tanımlar

Name Description
Dashboard

Pano modeli.

DashboardGroup

Sahiple ilişkili panoların listesini açıklar. Şu anda ekipler pano gruplarına sahip.

DashboardGroupEntry

Pano grubu girdisi, Pano çevresinde kaydırma (gerekli mi?)

DashboardScope

Pano Kapsamı. Project veya Project_Team olabilir

GroupMemberPermission

Kullanım dışı: Geçerli ekip için izin düzeyini açıklayan eski izin modeli. M125 öncesi.

LightboxOptions

Lightbox yapılandırması

ReferenceLinks

REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.

SemanticVersion

major.minor.patch formunun: http://semver.org/adresinde açıklandığı gibi bir yapıt için sürüm oluşturma.

TeamDashboardPermission

Panolar için geçerli ekibin güvenlik izinlerini açıklayan izin bit maskesi. Bu izin Yok değeri olduğunda GroupMemberPermission kullanın. İzinler Yok dışında bir değerin varlığına göre değerlendirilir, aksi takdirde GroupMemberPermission kaydedilir.

Widget

Pencere öğesi verileri

WidgetPosition
WidgetSize

Dashboard

Pano modeli.

Name Tür Description
_links

ReferenceLinks

REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.

dashboardScope

DashboardScope

Panonun kapsamı belirlenmiş varlık.

description

string

Panonun açıklaması.

eTag

string

Düzenleme çakışması algılaması için kullanılan sunucu tanımlı sürüm izleme değeri.

groupId

string

Pano için grubun kimliği. Ekip kapsamlı panolar için bu, panoyla ilişkilendirilmiş ekibin benzersiz tanımlayıcısıdır. Proje kapsamlı panolar için bu özellik boş.

id

string

Panonun kimliği. Oluşturma zamanında hizmet tarafından sağlanır.

lastAccessedDate

string

Panoya Son Erişim Tarihi.

modifiedBy

string

Pano'yu değiştiren kişinin kimliği.

modifiedDate

string

Panonun son değiştirme tarihi.

name

string

Panonun adı.

ownerId

string

Pano sahibinin kimliği. Ekip kapsamlı panolar için bu, panoyla ilişkilendirilmiş ekibin benzersiz tanımlayıcısıdır. Proje kapsamlı panolar için bu, panoyla ilişkilendirilmiş kullanıcı kimliğinin benzersiz tanımlayıcısıdır.

position

integer

Panonun bir pano grubu içindeki konumu. Oluşturma zamanında ayarlanmazsa, konum hizmet tarafından belirlenir.

refreshInterval

integer

İstemcinin panoyu otomatik olarak yenileme aralığı. Dakika cinsinden ifade edilir.

url

string

widgets

Widget[]

Panodaki Pencere Öğeleri kümesi.

DashboardGroup

Sahiple ilişkili panoların listesini açıklar. Şu anda ekipler pano gruplarına sahip.

Name Tür Description
_links

ReferenceLinks

REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.

dashboardEntries

DashboardGroupEntry[]

Pano Grubu tarafından tutulan Panoların listesi

permission

GroupMemberPermission

Kullanım dışı: Geçerli ekip için izin düzeyini açıklayan eski izin modeli. M125 öncesi.

teamDashboardPermission

TeamDashboardPermission

Panolar için geçerli ekibin güvenlik izinlerini açıklayan izin bit maskesi. Bu izin Yok değeri olduğunda GroupMemberPermission kullanın. İzinler Yok dışında bir değerin varlığına göre değerlendirilir, aksi takdirde GroupMemberPermission kaydedilir.

url

string

DashboardGroupEntry

Pano grubu girdisi, Pano çevresinde kaydırma (gerekli mi?)

Name Tür Description
_links

ReferenceLinks

REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.

dashboardScope

DashboardScope

Panonun kapsamı belirlenmiş varlık.

description

string

Panonun açıklaması.

eTag

string

Düzenleme çakışması algılaması için kullanılan sunucu tanımlı sürüm izleme değeri.

groupId

string

Pano için grubun kimliği. Ekip kapsamlı panolar için bu, panoyla ilişkilendirilmiş ekibin benzersiz tanımlayıcısıdır. Proje kapsamlı panolar için bu özellik boş.

id

string

Panonun kimliği. Oluşturma zamanında hizmet tarafından sağlanır.

lastAccessedDate

string

Panoya Son Erişim Tarihi.

modifiedBy

string

Pano'yu değiştiren kişinin kimliği.

modifiedDate

string

Panonun son değiştirme tarihi.

name

string

Panonun adı.

ownerId

string

Pano sahibinin kimliği. Ekip kapsamlı panolar için bu, panoyla ilişkilendirilmiş ekibin benzersiz tanımlayıcısıdır. Proje kapsamlı panolar için bu, panoyla ilişkilendirilmiş kullanıcı kimliğinin benzersiz tanımlayıcısıdır.

position

integer

Panonun bir pano grubu içindeki konumu. Oluşturma zamanında ayarlanmazsa, konum hizmet tarafından belirlenir.

refreshInterval

integer

İstemcinin panoyu otomatik olarak yenileme aralığı. Dakika cinsinden ifade edilir.

url

string

widgets

Widget[]

Panodaki Pencere Öğeleri kümesi.

DashboardScope

Pano Kapsamı. Project veya Project_Team olabilir

Name Tür Description
collection_User

string

[KULLANIM DIŞI] Panonun kapsamı koleksiyon kullanıcısı olarak belirlenmiştir.

project

string

Panonun kapsamı proje kapsamındadır.

project_Team

string

Panonun kapsamı ekip tarafından belirlenmiştir.

GroupMemberPermission

Kullanım dışı: Geçerli ekip için izin düzeyini açıklayan eski izin modeli. M125 öncesi.

Name Tür Description
edit

string

manage

string

managePermissions

string

none

string

LightboxOptions

Lightbox yapılandırması

Name Tür Description
height

integer

İstenen ışık kutusunun piksel cinsinden yüksekliği

resizable

boolean

Lightbox yeniden boyutlandırmasına izin vermek için True, lightbox'ın yeniden boyutlandırılmasına izin vermek için false, varsayılan olarak false olarak ayarlanır.

width

integer

İstenen ışık kutusunun piksel cinsinden genişliği

REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.

Name Tür Description
links

object

Bağlantıların salt okunur görünümü. Başvuru bağlantıları salt okunur olduğundan, bunları yalnızca salt okunur olarak göstermek istiyoruz.

SemanticVersion

major.minor.patch formunun: http://semver.org/adresinde açıklandığı gibi bir yapıt için sürüm oluşturma.

Name Tür Description
major

integer

Uyumsuz API değişiklikleri yaptığınızda ana sürüm

minor

integer

İşlevselliği geriye dönük uyumlu bir şekilde eklediğinizde ikincil sürüm

patch

integer

Geriye dönük uyumlu hata düzeltmeleri yaptığınızda düzeltme eki sürümü

TeamDashboardPermission

Panolar için geçerli ekibin güvenlik izinlerini açıklayan izin bit maskesi. Bu izin Yok değeri olduğunda GroupMemberPermission kullanın. İzinler Yok dışında bir değerin varlığına göre değerlendirilir, aksi takdirde GroupMemberPermission kaydedilir.

Name Tür Description
create

string

delete

string

edit

string

managePermissions

string

none

string

read

string

Widget

Pencere öğesi verileri

Name Tür Description
_links

ReferenceLinks

REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.

allowedSizes

WidgetSize[]

Pencere öğesi için izin verilen boyutları ifade eder. Bu, kullanıcı pencere öğesini yapılandırmak istediğinde doldurulur

areSettingsBlockedForUser

boolean

Pano Hizmeti'nden Read-Only Özelliği. Geçerli kullanıcı için ayarların engellenip engellenmediğini gösterir.

artifactId

string

Özellik yapıtının benzersiz tanımlayıcısına başvurur. Belirli bir yapıtı sabitlemek+sabitlemek için kullanılır.

configurationContributionId

string

configurationContributionRelativeId

string

contentUri

string

contributionId

string

Sağlanan Pencere Öğesi Yapılandırmasını tanımlayan temel katkının kimliği.

dashboard

Dashboard

Pencere öğesi düzeyinde API'ler için pano düzeyinde ETag alışverişi desteklemek üzere isteğe bağlı kısmi pano içeriği

eTag

string

id

string

isEnabled

boolean

isNameConfigurable

boolean

lightboxOptions

LightboxOptions

Lightbox yapılandırması

loadingImageUrl

string

name

string

position

WidgetPosition

settings

string

settingsVersion

SemanticVersion

major.minor.patch formunun: http://semver.org/adresinde açıklandığı gibi bir yapıt için sürüm oluşturma.

size

WidgetSize

typeId

string

url

string

WidgetPosition

Name Tür Description
column

integer

row

integer

WidgetSize

Name Tür Description
columnSpan

integer

Pano kılavuzu sütunlarında ifade edilen pencere öğesinin Genişliği.

rowSpan

integer

Pano kılavuzu satırlarında ifade edilen pencere öğesinin yüksekliği.