Classification Nodes - Get

  • Referência
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

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

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.

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