Classification Nodes - Update

Référence

Service:: Work Item Tracking

Version d'API:: 7.1

Mettez à jour un nœud de classification existant.

PATCH https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?api-version=7.1

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 d’accès du nœud de classification.
api-version	query	True	string	Version de l’API à utiliser. Cette valeur doit être définie sur « 7.1 » pour utiliser cette version de l’API.

Corps de la demande

Nom	Type	Description
_links	ReferenceLinks	Lier des références aux ressources REST associées.
attributes	object	Dictionnaire qui a des attributs de nœud tels que la date de début/fin des nœuds d’itération.
children	WorkItemClassificationNode[]	Liste des nœuds enfants récupérés.
hasChildren	boolean	Indicateur qui indique si le nœud de classification a des nœuds enfants.
id	integer (int32)	ID entier du nœud de classification.
identifier	string (uuid)	ID GUID du nœud de classification.
name	string	Nom du nœud de classification.
path	string	Chemin d’accès du nœud de classification.
structureType	TreeNodeStructureType	Type de structure de nœud.
url	string

Réponses

Nom	Type	Description
200 OK	WorkItemClassificationNode	opération réussie

Sécurité

oauth2

Type: oauth2
Flux: accessCode
URL d’autorisation: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL du jeton: 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

Étendues

Nom	Description
vso.work_write	Octroie la possibilité de lire, de créer et de mettre à jour des éléments de travail et des requêtes, de mettre à jour des métadonnées de carte, de lire des zones de lecture et des itérations chemins d’accès à d’autres métadonnées associées au suivi des éléments de travail, d’exécuter des requêtes et de recevoir des notifications sur les événements d’élément de travail via des hooks de service.

Nom

Description

vso.work_write

Octroie la possibilité de lire, de créer et de mettre à jour des éléments de travail et des requêtes, de mettre à jour des métadonnées de carte, de lire des zones de lecture et des itérations chemins d’accès à d’autres métadonnées associées au suivi des éléments de travail, d’exécuter des requêtes et de recevoir des notifications sur les événements d’élément de travail via des hooks de service.

Exemples

Change an iteration's dates

Rename an area

Rename an iteration

Change an iteration's dates

Exemple de requête

HTTP

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

{
  "attributes": {
    "startDate": "2015-01-26T00:00:00Z",
    "finishDate": "2015-01-30T00:00:00Z"
  }
}

Exemple de réponse

Code d’état:: 200

{
  "id": 126392,
  "identifier": "a5c68379-3258-4d62-971c-71c1c459336e",
  "name": "Ultimate iteration",
  "structureType": "iteration",
  "hasChildren": false,
  "path": "\\fabrikam\\fiber\\tfvc\\area",
  "attributes": {
    "startDate": "2015-01-26T00:00:00Z",
    "finishDate": "2015-01-30T00:00:00Z"
  },
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Ultimate%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/Ultimate%20iteration"
}

Rename an area

Exemple de requête

HTTP

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

{
  "name": "Website team"
}

Exemple de réponse

Code d’état:: 200

{
  "id": 126391,
  "identifier": "25450731-5178-4044-84f0-0a0ebdef0c33",
  "name": "Website team",
  "structureType": "area",
  "hasChildren": false,
  "path": "\\fabrikam\\fiber\\tfvc\\area",
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas/Website%20team"
    },
    "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/Website%20team"
}

Rename an iteration

Exemple de requête

HTTP

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

{
  "name": "Ultimate iteration"
}

Exemple de réponse

Code d’état:: 200

{
  "id": 126392,
  "identifier": "8677aa7d-2f4a-4f53-8f0f-b84a23997f70",
  "name": "Ultimate iteration",
  "structureType": "iteration",
  "hasChildren": false,
  "path": "\\fabrikam\\fiber\\tfvc\\iteration",
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Ultimate%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/Ultimate%20iteration"
}

Définitions

Nom	Description
ReferenceLinks	Classe à 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

Object

Classe à 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

Énumération

Type de structure de nœud.

Valeur	Description
area	Type de zone.
iteration	Type d’itération.

TreeStructureGroup

Énumération

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

Valeur	Description
areas
iterations

WorkItemClassificationNode

Object

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 aux ressources REST associées.
attributes	object	Dictionnaire qui a des attributs de nœud tels que la date de début/fin des nœuds d’itération.
children	WorkItemClassificationNode[]	Liste des nœuds enfants récupérés.
hasChildren	boolean	Indicateur qui indique si le nœud de classification a des nœuds enfants.
id	integer (int32)	ID entier du nœud de classification.
identifier	string (uuid)	ID GUID du nœud de classification.
name	string	Nom du nœud de classification.
path	string	Chemin d’accès du nœud de classification.
structureType	TreeNodeStructureType	Type de structure de nœud.
url	string

Partager via

Classification Nodes - Update

Paramètres URI

Corps de la demande

Réponses

Sécurité

oauth2

Étendues

Exemples

Change an iteration's dates

Exemple de requête

Exemple de réponse

Rename an area

Exemple de requête

Exemple de réponse

Rename an iteration

Exemple de requête

Exemple de réponse

Définitions

ReferenceLinks

TreeNodeStructureType

TreeStructureGroup

WorkItemClassificationNode