Classification Nodes - Update

  • Referência
Service:
Work Item Tracking
API Version:
4.1

Atualize um nó de classificação existente.

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
organization
 path True

string

O nome da organização do Azure DevOps.
project
 path True

string

ID do projeto ou nome do projeto
structureGroup
 path True

TreeStructureGroup

Grupo de estrutura do nó de classificação, área ou iteração.
path
 path

string

Caminho do nó de classificação.
api-version
 query True

string

Versão da API a ser usada. Isso deve ser definido como '4.1' para usar essa versão da api.

Corpo da solicitação

Nome Tipo Description
_links

ReferenceLinks

Vincular referências a recursos REST relacionados.
attributes

object

Dicionário que tem atributos de nó, como data de início/término para nós de iteração.
children

WorkItemClassificationNode[]

Lista de nós filho buscados.
hasChildren

boolean

Sinalizador que indica se o nó de classificação tem nós filho.
id

integer

ID de inteiro do nó de classificação.
identifier

string

ID do GUID do nó de classificação.
name

string

Nome do nó de classificação.
structureType

TreeNodeStructureType

Tipo de estrutura de nó.
url

string

Respostas

Nome Tipo Description
200 OK

WorkItemClassificationNode

operação bem-sucedida

Segurança

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

Nome Description
vso.work_write Concede a capacidade de ler, criar e atualizar itens de trabalho e consultas, atualizar metadados do quadro, ler caminhos de área e iterações de outros itens de trabalho que acompanham metadados relacionados, executar consultas e receber notificações sobre eventos de item de trabalho por meio de ganchos de serviço.

Exemplos

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=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

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

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

Definições

Nome Description
ReferenceLinks

A classe para representar uma coleção de links de referência REST.
TreeNodeStructureType

Tipo de estrutura de nó.
TreeStructureGroup

Grupo de estrutura do nó de classificação, área ou iteração.
WorkItemClassificationNode

Define um nó de classificação para o acompanhamento de item de trabalho.

A classe para representar uma coleção de links de referência REST.

Nome Tipo Description
links

object

A exibição somente leitura dos links. Como os links de referência são somente leitura, só queremos expô-los como somente leitura.

TreeNodeStructureType

Tipo de estrutura de nó.

Nome Tipo Description
area

string

Tipo de área.
iteration

string

Tipo de iteração.

TreeStructureGroup

Grupo de estrutura do nó de classificação, área ou iteração.

Nome Tipo Description
areas

string

iterations

string

WorkItemClassificationNode

Define um nó de classificação para o acompanhamento de item de trabalho.

Nome Tipo Description
_links

ReferenceLinks

Vincular referências a recursos REST relacionados.
attributes

object

Dicionário que tem atributos de nó, como data de início/término para nós de iteração.
children

WorkItemClassificationNode[]

Lista de nós filho buscados.
hasChildren

boolean

Sinalizador que indica se o nó de classificação tem nós filho.
id

integer

ID de inteiro do nó de classificação.
identifier

string

ID do GUID do nó de classificação.
name

string

Nome do nó de classificação.
structureType

TreeNodeStructureType

Tipo de estrutura de nó.
url

string