Compartilhar via

Classification Nodes - Get

  • Referência
Serviço:
Work Item Tracking
Versão da API:
5.0

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=5.0
Com parâmetros opcionais: 
GET https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?$depth={$depth}&api-version=5.0

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 '5.0' 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

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 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, pesquisar itens de trabalho 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

Solicitação de exemplo

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

Resposta de exemplo

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

Solicitação de exemplo

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

Resposta de exemplo

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