Partilhar via


Capacities - Update

Atualizar a capacidade de um membro da equipe

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

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

teamMemberId
path True

string

uuid

ID do membro da equipe

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
activities

Activity[]

daysOff

DateRange[]

Respostas

Nome Tipo Description
200 OK

TeamMemberCapacityIdentityRef

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_write Concede a capacidade de ler, criar e atualizar itens de trabalho e consultas, atualizar metadados do quadro, ler caminhos de área e iterações de outros itens de trabalho que acompanham metadados relacionados, executar consultas e receber notificações sobre eventos de item de trabalho por meio de ganchos de serviço.

Exemplos

Update a team member's capacity

Sample Request

PATCH https://dev.azure.com/{organization}/{project}/_apis/work/teamsettings/iterations/{iterationId}/capacities/{teamMemberId}?api-version=7.1-preview.3

{
  "activities": [
    {
      "capacityPerDay": 5,
      "name": "Design"
    },
    {
      "capacityPerDay": 5,
      "name": "Development"
    }
  ],
  "daysOff": []
}

Sample Response

{
  "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": 5,
      "name": "Design"
    },
    {
      "capacityPerDay": 5,
      "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",
  "_links": {
    "self": {
      "href": "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"
    },
    "project": {
      "href": "https://codedev.ms/fabrikam/_apis/projects/d9bb59ee-cd01-4569-80d1-dce8c2e712f4"
    },
    "team": {
      "href": "https://codedev.ms/fabrikam/_apis/projects/d9bb59ee-cd01-4569-80d1-dce8c2e712f4/teams/1d8e5f76-54bd-4d11-889b-fee63c864ea6"
    },
    "teamSettings": {
      "href": "https://codedev.ms/fabrikam/d9bb59ee-cd01-4569-80d1-dce8c2e712f4/1d8e5f76-54bd-4d11-889b-fee63c864ea6/_apis/work/teamsettings"
    },
    "teamIterations": {
      "href": "https://codedev.ms/fabrikam/d9bb59ee-cd01-4569-80d1-dce8c2e712f4/1d8e5f76-54bd-4d11-889b-fee63c864ea6/_apis/work/teamsettings/iterations"
    },
    "teamIteration": {
      "href": "https://codedev.ms/fabrikam/d9bb59ee-cd01-4569-80d1-dce8c2e712f4/1d8e5f76-54bd-4d11-889b-fee63c864ea6/_apis/work/teamsettings/iterations/def498ab-a9cf-41eb-a7c7-9eb67d1852ef"
    },
    "capacity": {
      "href": "https://codedev.ms/fabrikam/d9bb59ee-cd01-4569-80d1-dce8c2e712f4/1d8e5f76-54bd-4d11-889b-fee63c864ea6/_apis/work/teamsettings/iterations/def498ab-a9cf-41eb-a7c7-9eb67d1852ef/capacities"
    },
    "classificationNode": {
      "href": "https://codedev.ms/fabrikam/d9bb59ee-cd01-4569-80d1-dce8c2e712f4/_apis/wit/classificationNodes/Iterations/Iteration%201"
    }
  }
}

Definições

Nome Description
Activity
CapacityPatch

Dados esperados do PATCH

DateRange
IdentityRef
ReferenceLinks

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

TeamMemberCapacityIdentityRef

Representa a capacidade de um membro específico da equipe

Activity

Nome Tipo Description
capacityPerDay

number

name

string

CapacityPatch

Dados esperados do PATCH

Nome Tipo Description
activities

Activity[]

daysOff

DateRange[]

DateRange

Nome Tipo Description
end

string

Fim do intervalo de datas.

start

string

Início do intervalo de datas.

IdentityRef

Nome Tipo Description
_links

ReferenceLinks

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.

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

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

Identidade ref do membro da equipe associado

url

string

Link http completo para o recurso