Поделиться через

Classification Nodes - Get

  • Ссылка
Служба:
Work Item Tracking
Версия API:
7.1

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

GET https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?api-version=7.1
С использованием необязательных параметров: 
GET https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?$depth={$depth}&api-version=7.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 необходимо задать значение "7.1".
$depth
 query

integer (int32)

Глубина получения дочерних элементов.

Ответы

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

WorkItemClassificationNode

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

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

oauth2

Тип: oauth2
Flow: accessCode
URL-адрес авторизации: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
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

Области

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

Примеры

Get an area
Get an iteration

Get an area

Образец запроса

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

Пример ответа

Код состояния:
200 
{
  "id": 126391,
  "identifier": "d5d98099-47ac-468a-9579-c059c90bf7c5",
  "name": "Web",
  "structureType": "area",
  "hasChildren": false,
  "path": "\\fabrikam\\fiber\\tfvc\\iteration",
  "_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

Образец запроса

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

Пример ответа

Код состояния:
200 
{
  "id": 126392,
  "identifier": "dd643523-4d15-4106-a6a4-e70d39a09446",
  "name": "Final Iteration",
  "structureType": "iteration",
  "hasChildren": false,
  "path": "\\fabrikam\\fiber\\tfvc\\iteration",
  "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

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

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

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

object

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

TreeNodeStructureType

Перечисление

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

Значение Описание
area

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

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

TreeStructureGroup

Перечисление

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

Значение Описание
areas
iterations

WorkItemClassificationNode

Object

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

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

ReferenceLinks

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

object

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

WorkItemClassificationNode[]

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

boolean

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

integer (int32)

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

string (uuid)

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

string

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

string

Путь к узлу классификации.
structureType

TreeNodeStructureType

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

string