Compartilhar via

Classification Nodes - Update

  • Referência
Serviço:
Work Item Tracking
Versão da API:
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

Tipo: oauth2
Flow: accessCode
URL de Autorização: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL do Token: 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

Escopos

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

Solicitação de exemplo

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

Resposta de exemplo

Código de status:
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

Solicitação de exemplo

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

{
  "name": "Website team"
}

Resposta de exemplo

Código de status:
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

Solicitação de exemplo

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

{
  "name": "Ultimate iteration"
}

Resposta de exemplo

Código de status:
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.
Object

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

Enumeration

Tipo de estrutura de nó.

Valor Description
area

Tipo de área.
iteration

Tipo de iteração.

TreeStructureGroup

Enumeration

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

Valor Description
areas
iterations

WorkItemClassificationNode

Object

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