Classification Nodes - Get

Service:

Work Item Tracking

API Version:

5.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=5.0

With optional parameters:

GET https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?$depth={$depth}&api-version=5.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 « 5.0 » pour utiliser cette version de l’API.
$depth	query		integer int32	Profondeur des enfants à récupérer.

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 d’accès de zone et d’itérations, ainsi que d’autres métadonnées associées au suivi des éléments de travail. Accorde également la possibilité 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

HTTP

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

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

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

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.

ReferenceLinks

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 de 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.
structureType	TreeNodeStructureType	Type de structure de nœud.
url	string