Classification Nodes - Create Or Update
Erstellen Sie einen neuen, oder aktualisieren Sie einen vorhandenen Klassifizierungsknoten.
POST https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?api-version=7.1-preview.2
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
organization
|
path | True |
string |
Der Name der Azure DevOps-Organisation. |
project
|
path | True |
string |
Projekt-ID oder Projektname |
structure
|
path | True |
Strukturgruppe des Klassifizierungsknotens, Bereichs oder Iteration. |
|
path
|
path |
string |
Pfad des Klassifizierungsknotens. |
|
api-version
|
query | True |
string |
Version der zu verwendenden API. Dies sollte auf "7.1-preview.2" festgelegt werden, um diese Version der API zu verwenden. |
Anforderungstext
Name | Typ | Beschreibung |
---|---|---|
_links |
Verknüpfen Sie Verweise auf verwandte REST-Ressourcen. |
|
attributes |
object |
Wörterbuch mit Knotenattributen wie Start-/Enddatum für Iterationsknoten. |
children |
Liste der abgerufenen untergeordneten Knoten. |
|
hasChildren |
boolean |
Flag, das angibt, ob der Klassifizierungsknoten über untergeordnete Knoten verfügt. |
id |
integer |
Ganzzahlige ID des Klassifizierungsknotens. |
identifier |
string |
GUID-ID des Klassifizierungsknotens. |
name |
string |
Name des Klassifizierungsknotens. |
path |
string |
Pfad des Klassifizierungsknotens. |
structureType |
Knotenstrukturtyp. |
|
url |
string |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Erfolgreicher Vorgang |
Sicherheit
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
Name | Beschreibung |
---|---|
vso.work_write | Ermöglicht das Lesen, Erstellen und Aktualisieren von Arbeitselementen und Abfragen, Aktualisieren von Boardmetadaten, Lesebereichs- und Iterationspfaden für andere Metadaten zur Nachverfolgung von Arbeitselementen, Ausführen von Abfragen und das Empfangen von Benachrichtigungen über Arbeitselementereignisse über Diensthaken. |
Beispiele
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"
}
Definitionen
Name | Beschreibung |
---|---|
Reference |
Die Klasse, die eine Auflistung von REST-Verweislinks darstellt. |
Tree |
Knotenstrukturtyp. |
Tree |
Strukturgruppe des Klassifizierungsknotens, Bereichs oder Iteration. |
Work |
Definiert einen Klassifizierungsknoten für die Arbeitselementnachverfolgung. |
ReferenceLinks
Die Klasse, die eine Auflistung von REST-Verweislinks darstellt.
Name | Typ | Beschreibung |
---|---|---|
links |
object |
Die schreibgeschützte Ansicht der Links. Da Verweislinks schreibgeschützt sind, möchten wir sie nur als schreibgeschützt verfügbar machen. |
TreeNodeStructureType
Knotenstrukturtyp.
Name | Typ | Beschreibung |
---|---|---|
area |
string |
Bereichstyp. |
iteration |
string |
Iterationstyp. |
TreeStructureGroup
Strukturgruppe des Klassifizierungsknotens, Bereichs oder Iteration.
Name | Typ | Beschreibung |
---|---|---|
areas |
string |
|
iterations |
string |
WorkItemClassificationNode
Definiert einen Klassifizierungsknoten für die Arbeitselementnachverfolgung.
Name | Typ | Beschreibung |
---|---|---|
_links |
Verknüpfen Sie Verweise auf verwandte REST-Ressourcen. |
|
attributes |
object |
Wörterbuch mit Knotenattributen wie Start-/Enddatum für Iterationsknoten. |
children |
Liste der abgerufenen untergeordneten Knoten. |
|
hasChildren |
boolean |
Flag, das angibt, ob der Klassifizierungsknoten über untergeordnete Knoten verfügt. |
id |
integer |
Ganzzahlige ID des Klassifizierungsknotens. |
identifier |
string |
GUID-ID des Klassifizierungsknotens. |
name |
string |
Name des Klassifizierungsknotens. |
path |
string |
Pfad des Klassifizierungsknotens. |
structureType |
Knotenstrukturtyp. |
|
url |
string |