Classification Nodes - Get

  • Referencia
Service:
Work Item Tracking
API Version:
4.1

Obtiene el nodo de clasificación de una ruta de acceso de nodo determinada.

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 identificador URI

Nombre En Requerido Tipo Description
organization
 path True

string

El nombre de la organización de Azure DevOps.
project
 path True

string

Id. de proyecto o nombre del proyecto
structureGroup
 path True

TreeStructureGroup

Grupo de estructura del nodo de clasificación, área o iteración.
path
 path

string

Ruta de acceso del nodo de clasificación.
api-version
 query True

string

Versión de la API que se va a usar. Debe establecerse en "4.1" para usar esta versión de la API.
$depth
 query

integer

int32

Profundidad de elementos secundarios que se van a capturar.

Respuestas

Nombre Tipo Description
200 OK

WorkItemClassificationNode

operación correcta

Seguridad

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

Nombre Description
vso.work Concede la capacidad de leer elementos de trabajo, consultas, paneles, rutas de acceso de área e iteraciones y otros metadatos relacionados con el seguimiento de elementos de trabajo. También concede la capacidad de ejecutar consultas y recibir notificaciones sobre eventos de elementos de trabajo a través de enlaces de servicio.

Ejemplos

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

Definiciones

Nombre Description
ReferenceLinks

Clase que representa una colección de vínculos de referencia de REST.
TreeNodeStructureType

Tipo de estructura de nodo.
TreeStructureGroup

Grupo de estructura del nodo de clasificación, área o iteración.
WorkItemClassificationNode

Define un nodo de clasificación para el seguimiento de elementos de trabajo.

Clase que representa una colección de vínculos de referencia de REST.

Nombre Tipo Description
links

object

Vista de solo lectura de los vínculos. Dado que los vínculos de referencia son de solo lectura, solo queremos exponerlos como de solo lectura.

TreeNodeStructureType

Tipo de estructura de nodo.

Nombre Tipo Description
area

string

Tipo de área.
iteration

string

Tipo de iteración.

TreeStructureGroup

Grupo de estructura del nodo de clasificación, área o iteración.

Nombre Tipo Description
areas

string

iterations

string

WorkItemClassificationNode

Define un nodo de clasificación para el seguimiento de elementos de trabajo.

Nombre Tipo Description
_links

ReferenceLinks

Vincular referencias a recursos REST relacionados.
attributes

object

Diccionario que tiene atributos de nodo, como la fecha de inicio y finalización de los nodos de iteración.
children

WorkItemClassificationNode[]

Lista de nodos secundarios capturados.
hasChildren

boolean

Marca que indica si el nodo de clasificación tiene nodos secundarios.
id

integer

Identificador entero del nodo de clasificación.
identifier

string

Identificador GUID del nodo de clasificación.
name

string

Nombre del nodo de clasificación.
structureType

TreeNodeStructureType

Tipo de estructura de nodo.
url

string