Classification Nodes - Get

Service:

Work Item Tracking

API Version:

4.1

Obtém o nó de classificação para um determinado caminho de nó.

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

With optional parameters:

GET https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?$depth={$depth}&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.
$depth	query		integer int32	Profundidade das crianças a serem buscadas.

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	Concede a capacidade de ler itens de trabalho, consultas, quadros, caminhos de área e iterações e outros metadados relacionados ao acompanhamento de itens de trabalho. Também concede a capacidade de executar consultas e receber notificações sobre eventos de item de trabalho por meio de ganchos de serviço.

Exemplos

Get an area

Get an iteration

Get an area

Sample Request

HTTP

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

Sample Response

Status code:

200

{
  "id": 126391,
  "identifier": "d5d98099-47ac-468a-9579-c059c90bf7c5",
  "name": "Web",
  "structureType": "area",
  "hasChildren": false,
  "_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"
}

Get an iteration

Sample Request

HTTP

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

Sample Response

Status code:

200

{
  "id": 126392,
  "identifier": "dd643523-4d15-4106-a6a4-e70d39a09446",
  "name": "Final Iteration",
  "structureType": "iteration",
  "hasChildren": false,
  "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"
}

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.

ReferenceLinks

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