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

Classification Nodes - Create Or Update

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

Создайте новый или обновите существующий узел классификации.

POST https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?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".

Текст запроса

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

ReferenceLinks

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

object

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

WorkItemClassificationNode[]

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

boolean

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

integer (int32)

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

string (uuid)

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

string

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

string

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

TreeNodeStructureType

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

string

Ответы

Имя Тип Описание
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_write Предоставляет возможность читать, создавать и обновлять рабочие элементы и запросы, метаданные доски обновления, области чтения и итерации пути других связанных метаданных рабочих элементов, выполнять запросы и получать уведомления о событиях рабочих элементов с помощью перехватчиков служб.

Примеры

Create an area
Create an iteration
Move an area node
Move an iteration node

Create an area

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

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

{
  "name": "Web"
}

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

Код состояния:
201 
{
  "id": 126391,
  "identifier": "a5c68379-3258-4d62-971c-71c1c459336e",
  "name": "Web",
  "structureType": "area",
  "hasChildren": false,
  "path": "\\fabrikam\\fiber\\tfvc\\area",
  "_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"
}

Create an iteration

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

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

{
  "name": "Final Iteration",
  "attributes": {
    "startDate": "2014-10-27T00:00:00Z",
    "finishDate": "2014-10-31T00:00:00Z"
  }
}

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

Код состояния:
201 
{
  "id": 126392,
  "identifier": "8dbed14a-c1b6-46e8-8540-8118c4ea29ae",
  "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"
}

Move an area node

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

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

{
  "id": 126391
}

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

Код состояния:
200 
{
  "id": 126391,
  "identifier": "d01a1947-781a-4328-95be-960b90d04fe3",
  "name": "Website team",
  "structureType": "area",
  "hasChildren": false,
  "path": "\\fabrikam\\fiber\\tfvc\\area",
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas/Parent%20Area/Website%20team"
    },
    "parent": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas/Parent%20Area"
    }
  },
  "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas/Parent%20Area/Website%20team"
}

Move an iteration node

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

POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/{structureGroup}?api-version=7.1

{
  "id": 126392
}

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

Код состояния:
200 
{
  "id": 126392,
  "identifier": "81f373b4-93cb-4c2b-99e6-1308ea5d1adc",
  "name": "Ultimate iteration",
  "structureType": "iteration",
  "hasChildren": false,
  "path": "\\fabrikam\\fiber\\tfvc\\iteration",
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Parent%20Iteration/Ultimate%20iteration"
    },
    "parent": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Parent%20Iteration"
    }
  },
  "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Parent%20Iteration/Ultimate%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