Partilhar via


Dashboards - Replace Dashboards

Atualize o nome e a posição dos painéis no grupo fornecido e remova os painéis omitidos. Não modifica dashboard conteúdo.

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
organization
path True

string

O nome da organização do Azure DevOps.

project
path True

string

ID do projeto ou nome do projeto

team
path

string

ID da equipe ou nome da equipe

api-version
query True

string

Versão da API a ser usada. Isso deve ser definido como '7.1-preview.3' para usar essa versão da api.

Corpo da solicitação

Nome Tipo Description
_links

ReferenceLinks

A classe para representar uma coleção de links de referência REST.

dashboardEntries

DashboardGroupEntry[]

Uma lista de painéis mantidos pelo Grupo de Painéis

permission

GroupMemberPermission

Preterido: o modelo de permissão antigo que descreve o nível de permissões para a equipe atual. Pré-M125.

teamDashboardPermission

TeamDashboardPermission

Uma máscara de bits de permissões que descreve as permissões de segurança da equipe atual para dashboards. Quando essa permissão for o valor None, use GroupMemberPermission. As permissões são avaliadas com base na presença de um valor diferente de Nenhum, caso contrário, o GroupMemberPermission será salvo.

url

string

Respostas

Nome Tipo Description
200 OK

DashboardGroup

operação bem-sucedida

Segurança

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

Nome Description
vso.dashboards_manage Concede a capacidade de gerenciar informações de dashboard de equipe

Exemplos

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
}

Definições

Nome Description
Dashboard

Modelo de um Painel.

DashboardGroup

Descreve uma lista de painéis associados a um proprietário. Atualmente, as equipes possuem grupos de dashboard.

DashboardGroupEntry

Entrada do grupo de painéis, encapsulando o Painel (necessário?)

DashboardScope

Escopo do Painel. Pode ser Project ou Project_Team

GroupMemberPermission

Preterido: o modelo de permissão antigo que descreve o nível de permissões para a equipe atual. Pré-M125.

LightboxOptions

Configuração do Lightbox

ReferenceLinks

A classe para representar uma coleção de links de referência REST.

SemanticVersion

controle de versão de um artefato, conforme descrito em: http://semver.org/, do formulário major.minor.patch.

TeamDashboardPermission

Uma máscara de bits de permissões que descreve as permissões de segurança da equipe atual para dashboards. Quando essa permissão for o valor None, use GroupMemberPermission. As permissões são avaliadas com base na presença de um valor diferente de Nenhum, caso contrário, o GroupMemberPermission será salvo.

Widget

Dados do widget

WidgetPosition
WidgetSize

Dashboard

Modelo de um Painel.

Nome Tipo Description
_links

ReferenceLinks

A classe para representar uma coleção de links de referência REST.

dashboardScope

DashboardScope

Entidade à qual o dashboard está no escopo.

description

string

Descrição do dashboard.

eTag

string

Valor de acompanhamento de versão definido pelo servidor, usado para editar a detecção de colisão.

groupId

string

ID do grupo para um dashboard. Para painéis com escopo de equipe, esse é o identificador exclusivo para a equipe associada ao dashboard. Para painéis com escopo de projeto, essa propriedade está vazia.

id

string

ID do Painel. Fornecido pelo serviço no momento da criação.

lastAccessedDate

string

Data do Último Acesso do Painel.

modifiedBy

string

Id da pessoa que modificou o Painel.

modifiedDate

string

Data da última modificação do painel.

name

string

Nome do Painel.

ownerId

string

ID do proprietário de um dashboard. Para painéis com escopo de equipe, esse é o identificador exclusivo para a equipe associada ao dashboard. Para painéis com escopo de projeto, esse é o identificador exclusivo para a identidade do usuário associada ao dashboard.

position

integer

Posição do dashboard, em um grupo de dashboard. Se não estiver definido no momento da criação, a posição será decidida pelo serviço.

refreshInterval

integer

Intervalo para o cliente atualizar automaticamente o dashboard. Expresso em minutos.

url

string

widgets

Widget[]

O conjunto de Widgets no dashboard.

DashboardGroup

Descreve uma lista de painéis associados a um proprietário. Atualmente, as equipes possuem grupos de dashboard.

Nome Tipo Description
_links

ReferenceLinks

A classe para representar uma coleção de links de referência REST.

dashboardEntries

DashboardGroupEntry[]

Uma lista de painéis mantidos pelo Grupo de Painéis

permission

GroupMemberPermission

Preterido: o modelo de permissão antigo que descreve o nível de permissões para a equipe atual. Pré-M125.

teamDashboardPermission

TeamDashboardPermission

Uma máscara de bits de permissões que descreve as permissões de segurança da equipe atual para dashboards. Quando essa permissão for o valor None, use GroupMemberPermission. As permissões são avaliadas com base na presença de um valor diferente de Nenhum, caso contrário, o GroupMemberPermission será salvo.

url

string

DashboardGroupEntry

Entrada do grupo de painéis, encapsulando o Painel (necessário?)

Nome Tipo Description
_links

ReferenceLinks

A classe para representar uma coleção de links de referência REST.

dashboardScope

DashboardScope

Entidade à qual o dashboard está no escopo.

description

string

Descrição do dashboard.

eTag

string

Valor de acompanhamento de versão definido pelo servidor, usado para editar a detecção de colisão.

groupId

string

ID do grupo para um dashboard. Para painéis com escopo de equipe, esse é o identificador exclusivo para a equipe associada ao dashboard. Para painéis com escopo de projeto, essa propriedade está vazia.

id

string

ID do Painel. Fornecido pelo serviço no momento da criação.

lastAccessedDate

string

Data do Último Acesso do Painel.

modifiedBy

string

Id da pessoa que modificou o Painel.

modifiedDate

string

Data da última modificação do painel.

name

string

Nome do Painel.

ownerId

string

ID do proprietário de um dashboard. Para painéis com escopo de equipe, esse é o identificador exclusivo para a equipe associada ao dashboard. Para painéis com escopo de projeto, esse é o identificador exclusivo para a identidade do usuário associada ao dashboard.

position

integer

Posição do dashboard, em um grupo de dashboard. Se não estiver definido no momento da criação, a posição será decidida pelo serviço.

refreshInterval

integer

Intervalo para o cliente atualizar automaticamente o dashboard. Expresso em minutos.

url

string

widgets

Widget[]

O conjunto de Widgets no dashboard.

DashboardScope

Escopo do Painel. Pode ser Project ou Project_Team

Nome Tipo Description
collection_User

string

[PRETERIDO] O painel tem como escopo o usuário da coleção.

project

string

O painel tem como escopo o projeto.

project_Team

string

O painel tem o escopo definido para a equipe.

GroupMemberPermission

Preterido: o modelo de permissão antigo que descreve o nível de permissões para a equipe atual. Pré-M125.

Nome Tipo Description
edit

string

manage

string

managePermissions

string

none

string

LightboxOptions

Configuração do Lightbox

Nome Tipo Description
height

integer

Altura da caixa de luz desejada, em pixels

resizable

boolean

True para permitir o redimensionamento de lightbox, false para não permitir o redimensionamento de lightbox, o padrão é false.

width

integer

Largura da caixa de luz desejada, em pixels

A classe para representar uma coleção de links de referência REST.

Nome Tipo Description
links

object

A exibição somente leitura dos links. Como os links de referência são somente leitura, só queremos expô-los como somente leitura.

SemanticVersion

controle de versão de um artefato, conforme descrito em: http://semver.org/, do formulário major.minor.patch.

Nome Tipo Description
major

integer

Versão principal quando você faz alterações incompatíveis na API

minor

integer

Versão secundária quando você adiciona funcionalidade de maneira compatível com versões anteriores

patch

integer

Versão do patch quando você faz correções de bug compatíveis com versões anteriores

TeamDashboardPermission

Uma máscara de bits de permissões que descreve as permissões de segurança da equipe atual para dashboards. Quando essa permissão for o valor None, use GroupMemberPermission. As permissões são avaliadas com base na presença de um valor diferente de Nenhum, caso contrário, o GroupMemberPermission será salvo.

Nome Tipo Description
create

string

delete

string

edit

string

managePermissions

string

none

string

read

string

Widget

Dados do widget

Nome Tipo Description
_links

ReferenceLinks

A classe para representar uma coleção de links de referência REST.

allowedSizes

WidgetSize[]

Refere-se aos tamanhos permitidos para o widget. Isso é preenchido quando o usuário deseja configurar o widget

areSettingsBlockedForUser

boolean

propriedade Read-Only do Dashboard Service. Indica se as configurações estão bloqueadas para o usuário atual.

artifactId

string

Refere-se ao identificador exclusivo de um artefato de recurso. Usado para fixar+desafixar um artefato específico.

configurationContributionId

string

configurationContributionRelativeId

string

contentUri

string

contributionId

string

A ID da contribuição subjacente que define a Configuração de Widget fornecida.

dashboard

Dashboard

Conteúdo de dashboard parcial opcional, para dar suporte à troca de ETag de versão no nível dashboard para APIs no nível do widget

eTag

string

id

string

isEnabled

boolean

isNameConfigurable

boolean

lightboxOptions

LightboxOptions

Configuração do Lightbox

loadingImageUrl

string

name

string

position

WidgetPosition

settings

string

settingsVersion

SemanticVersion

controle de versão de um artefato, conforme descrito em: http://semver.org/, do formulário major.minor.patch.

size

WidgetSize

typeId

string

url

string

WidgetPosition

Nome Tipo Description
column

integer

row

integer

WidgetSize

Nome Tipo Description
columnSpan

integer

A Largura do widget, expressa em dashboard colunas de grade.

rowSpan

integer

A altura do widget, expressa em linhas de grade dashboard.