Partager via

Classification Nodes - Get

  • Référence
Service:
Work Item Tracking
API Version:
6.0

Obtient le nœud de classification pour un chemin de nœud donné.

GET https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?api-version=6.0
With optional parameters: 
GET https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?$depth={$depth}&api-version=6.0

Paramètres URI

Nom Dans Obligatoire Type Description
organization
 path True

string

Nom de l’organisation Azure DevOps.
project
 path True

string

ID de projet ou nom du projet
structureGroup
 path True

TreeStructureGroup

Groupe de structure du nœud de classification, de la zone ou de l’itération.
path
 path

string

Chemin du nœud de classification.
api-version
 query True

string

Version de l’API à utiliser. Cette valeur doit être définie sur « 6.0 » pour utiliser cette version de l’API.
$depth
 query

integer

int32

Profondeur des enfants à extraire.

Réponses

Nom Type Description
200 OK

WorkItemClassificationNode

opération réussie

Sécurité

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

Nom Description
vso.work Accorde la possibilité de lire des éléments de travail, des requêtes, des tableaux, des chemins de zone et d’itérations et d’autres métadonnées associées au suivi des éléments de travail. Permet également d’exécuter des requêtes, de rechercher des éléments de travail et de recevoir des notifications sur les événements d’élément de travail via des hooks de service.

Exemples

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=6.0

Sample Response

Status code:
200 
{
  "id": 126391,
  "identifier": "d5d98099-47ac-468a-9579-c059c90bf7c5",
  "name": "Web",
  "structureType": "area",
  "hasChildren": false,
  "path": "\\fabrikam\\fiber\\tfvc\\iteration",
  "_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=6.0

Sample Response

Status code:
200 
{
  "id": 126392,
  "identifier": "dd643523-4d15-4106-a6a4-e70d39a09446",
  "name": "Final Iteration",
  "structureType": "iteration",
  "hasChildren": false,
  "path": "\\fabrikam\\fiber\\tfvc\\iteration",
  "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"
}

Définitions

Nom Description
ReferenceLinks

Classe pour représenter une collection de liens de référence REST.
TreeNodeStructureType

Type de structure de nœud.
TreeStructureGroup

Groupe de structure du nœud de classification, de la zone ou de l’itération.
WorkItemClassificationNode

Définit un nœud de classification pour le suivi des éléments de travail.

Classe pour représenter une collection de liens de référence REST.

Nom Type Description
links

object

Vue en lecture seule des liens. Étant donné que les liens référence sont en lecture seule, nous voulons uniquement les exposer en lecture seule.

TreeNodeStructureType

Type de structure de nœud.

Nom Type Description
area

string

Type de zone.
iteration

string

Type d’itération.

TreeStructureGroup

Groupe de structure du nœud de classification, de la zone ou de l’itération.

Nom Type Description
areas

string

iterations

string

WorkItemClassificationNode

Définit un nœud de classification pour le suivi des éléments de travail.

Nom Type Description
_links

ReferenceLinks

Lier des références à des ressources REST associées.
attributes

object

Dictionnaire qui a des attributs de nœud comme la date de début/fin pour les nœuds d’itération.
children

WorkItemClassificationNode[]

Liste des nœuds enfants extraits.
hasChildren

boolean

Indicateur qui indique si le nœud de classification a des nœuds enfants.
id

integer

ID entier du nœud de classification.
identifier

string

ID GUID du nœud de classification.
name

string

Nom du nœud de classification.
path

string

Chemin du nœud de classification.
structureType

TreeNodeStructureType

Type de structure de nœud.
url

string