Capacities - List
Obter a capacidade de uma equipe
GET https://dev.azure.com/{organization}/{project}/{team}/_apis/work/teamsettings/iterations/{iterationId}/capacities?api-version=6.0
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
iteration
|
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 '6.0' para usar essa versão da api. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
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.work | Concede a capacidade de ler itens de trabalho, consultas, quadros, 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. |
Exemplos
Get a team's capacity
Sample Request
GET https://dev.azure.com/{organization}/{project}/_apis/work/teamsettings/iterations/{iterationId}/capacities?api-version=6.0
Sample Response
{
"count": 1,
"value": [
{
"teamMember": {
"displayName": "Chuck Reinhart",
"url": "https://sps1.vssps.vsts.me/Aa8f1b4b1-d4b5-4bc2-a949-cca3e3d3cab4/_apis/Identities/73a2309e-d0b3-6bf5-9500-9af8bcc805ec",
"_links": {
"avatar": {
"href": "https://codedev.ms/fabrikam/_apis/GraphProfile/MemberAvatars/aad.NzNhMjMwOWUtZDBiMy03YmY1LTk1MDAtOWFmOGJjYzgwNWVj"
}
},
"id": "73a2309e-d0b3-6bf5-9500-9af8bcc805ec",
"uniqueName": "fabrikamfiber3@hotmail.com",
"imageUrl": "https://codedev.ms/fabrikam/_api/_common/identityImage?id=73a2309e-d0b3-6bf5-9500-9af8bcc805ec",
"descriptor": "aad.NzNhMjMwOWUtZDBiMy03YmY1LTk1MDAtOWFmOGJjYzgwNWVj"
},
"activities": [
{
"capacityPerDay": 4,
"name": "Design"
},
{
"capacityPerDay": 4,
"name": "Development"
}
],
"daysOff": [],
"url": "https://codedev.ms/fabrikam/d9bb59ee-cd01-4569-80d1-dce8c2e712f4/1d8e5f76-54bd-4d11-889b-fee63c864ea6/_apis/work/teamsettings/iterations/def498ab-a9cf-41eb-a7c7-9eb67d1852ef/capacities/73a2309e-d0b3-6bf5-9500-9af8bcc805ec"
}
]
}
Definições
Nome | Description |
---|---|
Activity | |
Date |
|
Identity |
|
Reference |
A classe para representar uma coleção de links de referência REST. |
Team |
Representa a capacidade de um membro específico da equipe |
Activity
Nome | Tipo | Description |
---|---|---|
capacityPerDay |
number |
|
name |
string |
DateRange
Nome | Tipo | Description |
---|---|---|
end |
string |
Fim do intervalo de datas. |
start |
string |
Início do intervalo de datas. |
IdentityRef
Nome | Tipo | Description |
---|---|---|
_links |
Esse 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 entre contas e organizações. |
directoryAlias |
string |
Preterido – pode ser recuperado consultando o usuário do Graph referenciado na entrada "self" do dicionário IdentityRef "_links" |
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 IdentityRef "_links" |
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 inferido 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 preexistir 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
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. |
TeamMemberCapacityIdentityRef
Representa a capacidade de um membro específico da equipe
Nome | Tipo | Description |
---|---|---|
_links |
Coleção de links relevantes para o recurso |
|
activities |
Activity[] |
Coleção de capacidades associadas ao membro da equipe |
daysOff |
Os dias de folga associados ao membro da equipe |
|
teamMember |
Identidade ref do membro da equipe associado |
|
url |
string |
Link http completo para o recurso |