Classification Nodes - Update

Service:

Work Item Tracking

API Version:

4.1

Обновление существующего узла классификации.

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

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

Имя	Тип	Описание
_links	ReferenceLinks	Ссылки на связанные ресурсы REST.
attributes	object	Словарь, имеющий атрибуты узла, такие как дата начала и окончания для узлов итерации.
children	WorkItemClassificationNode[]	Список извлекаемых дочерних узлов.
hasChildren	boolean	Флаг, указывающий, есть ли в узле классификации какие-либо дочерние узлы.
id	integer	Целочисленный идентификатор узла классификации.
identifier	string	Идентификатор GUID узла классификации.
name	string	Имя узла классификации.
structureType	TreeNodeStructureType	Тип структуры узла.
url	string

Ответы

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

Примеры

Change an iteration's dates

Rename an area

Rename an iteration

Change an iteration's dates

Sample Request

HTTP

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

{
  "attributes": {
    "startDate": "2015-01-26T00:00:00Z",
    "finishDate": "2015-01-30T00:00:00Z"
  }
}

Sample Response

Status code:

200

{
  "id": 126392,
  "identifier": "a5c68379-3258-4d62-971c-71c1c459336e",
  "name": "Ultimate iteration",
  "structureType": "iteration",
  "hasChildren": false,
  "attributes": {
    "startDate": "2015-01-26T00:00:00Z",
    "finishDate": "2015-01-30T00:00:00Z"
  },
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Ultimate%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/Ultimate%20iteration"
}

Rename an area

Sample Request

HTTP

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

{
  "name": "Website team"
}

Sample Response

Status code:

200

{
  "id": 126391,
  "identifier": "25450731-5178-4044-84f0-0a0ebdef0c33",
  "name": "Website team",
  "structureType": "area",
  "hasChildren": false,
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas/Website%20team"
    },
    "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/Website%20team"
}

Rename an iteration

Sample Request

HTTP

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

{
  "name": "Ultimate iteration"
}

Sample Response

Status code:

200

{
  "id": 126392,
  "identifier": "8677aa7d-2f4a-4f53-8f0f-b84a23997f70",
  "name": "Ultimate iteration",
  "structureType": "iteration",
  "hasChildren": false,
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Ultimate%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/Ultimate%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