Classification Nodes - Get

Service:

Work Item Tracking

API Version:

4.1

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

GET https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?api-version=4.1

With optional parameters:

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

Параметры 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 необходимо задать значение 4.1.
$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

HTTP

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

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

HTTP

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

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	Определяет узел классификации для отслеживания рабочих элементов.

ReferenceLinks

Класс, представляющий коллекцию ссылок 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