다음을 통해 공유


Capacities - Get

팀 구성원의 용량 가져오기

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
iterationId
path True

string

uuid

반복의 ID

organization
path True

string

Azure DevOps 조직의 이름입니다.

project
path True

string

프로젝트 ID 또는 프로젝트 이름

teamMemberId
path True

string

uuid

팀 구성원의 ID

team
path

string

팀 ID 또는 팀 이름

api-version
query True

string

사용할 API의 버전입니다. 이 API 버전을 사용하려면 '6.0'으로 설정해야 합니다.

응답

Name 형식 Description
200 OK

TeamMemberCapacityIdentityRef

성공적인 작업

보안

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.work 작업 항목, 쿼리, 보드, 영역 및 반복 경로 및 기타 작업 항목 추적 관련 메타데이터를 읽을 수 있는 기능을 부여합니다. 또한 쿼리를 실행하고, 작업 항목을 검색하고, 서비스 후크를 통해 작업 항목 이벤트에 대한 알림을 받을 수 있는 기능을 부여합니다.

예제

Get a team member's capacity

Sample Request

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

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": 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",
  "_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"
    }
  }
}

정의

Name Description
Activity
DateRange
IdentityRef
ReferenceLinks

REST 참조 링크의 컬렉션을 나타내는 클래스입니다.

TeamMemberCapacityIdentityRef

특정 팀 구성원의 용량을 나타냅니다.

Activity

Name 형식 Description
capacityPerDay

number

name

string

DateRange

Name 형식 Description
end

string

날짜 범위의 끝입니다.

start

string

날짜 범위의 시작입니다.

IdentityRef

Name 형식 Description
_links

ReferenceLinks

이 필드에는 그래프 제목에 대한 0개 이상의 흥미로운 링크가 포함되어 있습니다. 이러한 링크를 호출하여 이 그래프 제목에 대한 추가 관계 또는 자세한 정보를 얻을 수 있습니다.

descriptor

string

설명자는 시스템이 실행되는 동안 그래프 제목을 참조하는 기본 방법입니다. 이 필드는 계정과 조직 모두에서 동일한 그래프 제목을 고유하게 식별합니다.

directoryAlias

string

사용되지 않음 - IdentityRef "_links" 사전의 "자체" 항목에서 참조된 Graph 사용자를 쿼리하여 검색할 수 있습니다.

displayName

string

그래프 주체의 고유하지 않은 표시 이름입니다. 이 필드를 변경하려면 원본 공급자에서 해당 값을 변경해야 합니다.

id

string

imageUrl

string

사용되지 않음 - IdentityRef "_links" 사전의 "아바타" 항목에서 사용할 수 있습니다.

inactive

boolean

사용되지 않음 - GraphUser "_links" 사전의 "membershipState" 항목에서 참조되는 Graph 멤버 자격 상태를 쿼리하여 검색할 수 있습니다.

isAadIdentity

boolean

사용되지 않음 - 설명자의 주체 형식(Descriptor.IsAadUserType/Descriptor.IsAadGroupType)에서 유추할 수 있습니다.

isContainer

boolean

사용되지 않음 - 설명자의 주체 형식에서 유추할 수 있음(Descriptor.IsGroupType)

isDeletedInOrigin

boolean

profileUrl

string

사용되지 않음 - ToIdentityRef의 대부분의 기존 구현에서 사용되지 않음

uniqueName

string

사용되지 않음 - 대신 Domain+PrincipalName 사용

url

string

이 URL은 이 그래프 주체의 원본 리소스에 대한 전체 경로입니다.

REST 참조 링크의 컬렉션을 나타내는 클래스입니다.

Name 형식 Description
links

object

링크의 읽기 전용 보기입니다. 참조 링크는 읽기 전용이므로 읽기 전용으로만 노출하려고 합니다.

TeamMemberCapacityIdentityRef

특정 팀 구성원의 용량을 나타냅니다.

Name 형식 Description
_links

ReferenceLinks

리소스와 관련된 링크 컬렉션

activities

Activity[]

팀 구성원과 연결된 용량 컬렉션

daysOff

DateRange[]

팀 구성원과 연결된 쉬는 날

teamMember

IdentityRef

연결된 팀 구성원의 ID 참조

url

string

리소스에 대한 전체 http 링크