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

Classification Nodes - Update

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

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

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

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

Имя Тип Описание
_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

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

{
  "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

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

{
  "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

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

{
  "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

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

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