Capacities - Get Capacities With Identity Ref And Totals

Serviço:

Work

Versão da API:

7.1

Obter a capacidade de uma equipe, incluindo capacidade total e dias de folga

GET https://dev.azure.com/{organization}/{project}/{team}/_apis/work/teamsettings/iterations/{iterationId}/capacities?api-version=7.1

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
iterationId	path	True	string (uuid)	ID da iteração
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' para usar essa versão da api.

Respostas

Nome	Tipo	Description
200 OK	TeamCapacity	operação bem-sucedida

Segurança

oauth2

Tipo: oauth2
Flow: accessCode
URL de Autorização: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL do Token: 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

Escopos

Nome	Description
vso.work	Concede a capacidade de ler itens de trabalho, consultas, placas, caminhos de área e iterações e outros metadados relacionados ao acompanhamento de itens de trabalho. Também concede a capacidade de executar consultas, pesquisar itens de trabalho e receber notificações sobre eventos de item de trabalho por meio de ganchos de serviço.

Definições

Nome	Description
Activity
DateRange
IdentityRef
ReferenceLinks	A classe para representar uma coleção de links de referência REST.
TeamCapacity	Representa a capacidade do membro da equipe com totais agregados
TeamMemberCapacityIdentityRef	Representa a capacidade de um membro específico da equipe

Activity

Objeto

Nome	Tipo	Description
capacityPerDay	number (float)
name	string

DateRange

Objeto

Nome	Tipo	Description
end	string (date-time)	Fim do intervalo de datas.
start	string (date-time)	Início do intervalo de datas.

IdentityRef

Objeto

Nome	Tipo	Description
_links	ReferenceLinks	Este campo contém zero ou mais links interessantes sobre o assunto do grafo. Esses links podem ser invocados para obter relações adicionais ou informações mais detalhadas sobre esse assunto do grafo.
descriptor	string	O descritor é a principal maneira de referenciar o assunto do grafo enquanto o sistema está em execução. Esse campo identificará exclusivamente o mesmo assunto de grafo em contas e organizações.
directoryAlias	string	Preterido – pode ser recuperado consultando o usuário do Graph referenciado na entrada "self" do dicionário "_links" identityRef
displayName	string	Esse é o nome de exibição não exclusivo do assunto do grafo. Para alterar esse campo, você deve alterar seu valor no provedor de origem.
id	string
imageUrl	string	Preterido – Disponível na entrada "avatar" do dicionário "_links" do IdentityRef
inactive	boolean	Preterido – pode ser recuperado consultando o estado de associação do Graph referenciado na entrada "membershipState" do dicionário "_links" do GraphUser
isAadIdentity	boolean	Preterido – pode ser adiado do tipo de assunto do descritor (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Preterido – pode ser inferido do tipo de assunto do descritor (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	Preterido - não em uso na maioria das implementações pré-existentes de ToIdentityRef
uniqueName	string	Preterido – use Domain+PrincipalName em vez disso
url	string	Essa URL é a rota completa para o recurso de origem desta entidade de grafo.

ReferenceLinks

Objeto

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.

TeamCapacity

Objeto

Representa a capacidade do membro da equipe com totais agregados

Nome	Tipo	Description
teamMembers	TeamMemberCapacityIdentityRef[]	Representa a capacidade de um membro específico da equipe
totalCapacityPerDay	number (double)
totalDaysOff	integer (int32)

TeamMemberCapacityIdentityRef

Objeto

Representa a capacidade de um membro específico da equipe

Nome	Tipo	Description
_links	ReferenceLinks	Coleção de links relevantes para o recurso
activities	Activity[]	Coleção de capacidades associadas ao membro da equipe
daysOff	DateRange[]	Os dias de folga associados ao membro da equipe
teamMember	IdentityRef	Ref de identidade do membro da equipe associado
url	string	Link http completo para o recurso