Classification Nodes - Create Or Update
Créez ou mettez à jour un nœud de classification existant.
POST https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?api-version=7.1-preview.2Paramè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 |
|
structure
|
path | True |
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 « 7.1-preview.2 » pour utiliser cette version de l’API. |
Corps de la demande
| Nom | Type | Description |
|---|---|---|
| _links |
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 |
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 |
Type de structure de nœud. |
|
| url |
string |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
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_write | Autorise la lecture, la création et la mise à jour d’éléments de travail et de requêtes, la mise à jour des métadonnées du tableau, la zone de lecture et les itérations des chemins d’autres métadonnées associées au suivi des éléments de travail, à exécuter des requêtes et à recevoir des notifications sur les événements d’élément de travail via des hooks de service. |
Exemples
| Create an area |
| Create an iteration |
| Move an area node |
| Move an iteration node |
Create an area
Sample Request
POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/Areas?api-version=7.1-preview.2
{
"name": "Web"
}
Sample Response
{
"id": 126391,
"identifier": "a5c68379-3258-4d62-971c-71c1c459336e",
"name": "Web",
"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/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"
}Create an iteration
Sample Request
POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/Iterations?api-version=7.1-preview.2
{
"name": "Final Iteration",
"attributes": {
"startDate": "2014-10-27T00:00:00Z",
"finishDate": "2014-10-31T00:00:00Z"
}
}
Sample Response
{
"id": 126392,
"identifier": "8dbed14a-c1b6-46e8-8540-8118c4ea29ae",
"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"
}Move an area node
Sample Request
POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/Areas?api-version=7.1-preview.2
{
"id": 126391
}
Sample Response
{
"id": 126391,
"identifier": "d01a1947-781a-4328-95be-960b90d04fe3",
"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/Parent%20Area/Website%20team"
},
"parent": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas/Parent%20Area"
}
},
"url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas/Parent%20Area/Website%20team"
}Move an iteration node
Sample Request
POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/{structureGroup}?api-version=7.1-preview.2
{
"id": 126392
}
Sample Response
{
"id": 126392,
"identifier": "81f373b4-93cb-4c2b-99e6-1308ea5d1adc",
"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/Parent%20Iteration/Ultimate%20iteration"
},
"parent": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Parent%20Iteration"
}
},
"url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Parent%20Iteration/Ultimate%20iteration"
}Définitions
| Nom | Description |
|---|---|
|
Reference |
Classe pour représenter une collection de liens de référence REST. |
|
Tree |
Type de structure de nœud. |
|
Tree |
Groupe de structure du nœud de classification, de la zone ou de l’itération. |
|
Work |
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 |
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 |
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 |
Type de structure de nœud. |
|
| url |
string |
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour