Classification Nodes - Get

  • Ссылка
Service:
Work Item Tracking
API Version:
5.0

Возвращает узел классификации для заданного пути к узлу.

GET https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?api-version=5.0
With optional parameters: 
GET https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?$depth={$depth}&api-version=5.0

Параметры URI

Имя В Обязательно Тип Описание
organization
 path True

string

Название организации Azure DevOps.
project
 path True

string

Идентификатор проекта или имя проекта
structureGroup
 path True

TreeStructureGroup

Группа структуры узла классификации, области или итерации.
path
 path

string

Путь к узлу классификации.
api-version
 query True

string

Используемая версия API. Для использования этой версии API необходимо задать значение 5.0.
$depth
 query

integer

int32

Глубина извлекаемых дочерних элементов.

Ответы

Имя Тип Описание
200 OK

WorkItemClassificationNode

успешная операция

Безопасность

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

Имя Описание
vso.work Предоставляет возможность чтения рабочих элементов, запросов, досок, путей областей и итераций, а также других метаданных, связанных с отслеживанием рабочих элементов. Также предоставляет возможность выполнять запросы, искать рабочие элементы и получать уведомления о событиях рабочих элементов с помощью перехватчиков служб.

Примеры

Get an area
Get an iteration

Get an area

Sample Request

GET https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/Areas?api-version=5.0

Sample Response

Status code:
200 
{
  "id": 126391,
  "identifier": "d5d98099-47ac-468a-9579-c059c90bf7c5",
  "name": "Web",
  "structureType": "area",
  "hasChildren": false,
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas/Web"
    },
    "parent": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas"
    }
  },
  "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas/Web"
}

Get an iteration

Sample Request

GET https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/Iterations?api-version=5.0

Sample Response

Status code:
200 
{
  "id": 126392,
  "identifier": "dd643523-4d15-4106-a6a4-e70d39a09446",
  "name": "Final Iteration",
  "structureType": "iteration",
  "hasChildren": false,
  "attributes": {
    "startDate": "2014-10-27T00:00:00Z",
    "finishDate": "2014-10-31T00:00:00Z"
  },
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Final%20Iteration"
    },
    "parent": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations"
    }
  },
  "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Final%20Iteration"
}

Определения

Имя Описание
ReferenceLinks

Класс, представляющий коллекцию ссылок REST.
TreeNodeStructureType

Тип структуры узла.
TreeStructureGroup

Группа структуры узла классификации, области или итерации.
WorkItemClassificationNode

Определяет узел классификации для отслеживания рабочих элементов.

Класс, представляющий коллекцию ссылок REST.

Имя Тип Описание
links

object

Представление ссылок только для чтения. Так как ссылочные ссылки доступны только для чтения, мы хотим предоставить их только для чтения.

TreeNodeStructureType

Тип структуры узла.

Имя Тип Описание
area

string

Тип области.
iteration

string

Тип итерации.

TreeStructureGroup

Группа структуры узла классификации, области или итерации.

Имя Тип Описание
areas

string

iterations

string

WorkItemClassificationNode

Определяет узел классификации для отслеживания рабочих элементов.

Имя Тип Описание
_links

ReferenceLinks

Ссылки на связанные ресурсы REST.
attributes

object

Словарь, имеющий атрибуты узла, такие как дата начала и окончания для узлов итерации.
children

WorkItemClassificationNode[]

Список извлекаемых дочерних узлов.
hasChildren

boolean

Флаг, указывающий, есть ли в узле классификации какие-либо дочерние узлы.
id

integer

Целочисленный идентификатор узла классификации.
identifier

string

Идентификатор GUID узла классификации.
name

string

Имя узла классификации.
structureType

TreeNodeStructureType

Тип структуры узла.
url

string