Classification Nodes - Create Or Update

Referenz

Dienst:: Work Item Tracking

API-Version:: 5.0

Erstellen Sie einen neuen Klassifizierungsknoten, oder aktualisieren Sie einen vorhandenen Klassifizierungsknoten.

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

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
structureGroup	path	True	TreeStructureGroup	Strukturgruppe des Klassifizierungsknotens, des Bereichs oder der Iteration.
path	path		string	Pfad des Klassifizierungsknotens.
api-version	query	True	string	Version der zu verwendenden API. Dies sollte auf "5.0" festgelegt werden, um diese Version der API zu verwenden.

Anforderungstext

Name	Typ	Beschreibung
_links	ReferenceLinks	Links zu verwandten REST-Ressourcen.
attributes	object	Wörterbuch mit Knotenattributen wie Start-/Enddatum für Iterationsknoten.
children	WorkItemClassificationNode[]	Liste der abgerufenen untergeordneten Knoten.
hasChildren	boolean	Flag, das angibt, ob der Klassifizierungsknoten über untergeordnete Knoten verfügt.
id	integer	Ganzzahl-ID des Klassifizierungsknotens.
identifier	string	GUID-ID des Klassifizierungsknotens.
name	string	Name des Klassifizierungsknotens.
structureType	TreeNodeStructureType	Knotenstrukturtyp.
url	string

Antworten

Name	Typ	Beschreibung
200 OK	WorkItemClassificationNode	Erfolgreicher Vorgang

Sicherheit

oauth2

Typ: oauth2
Ablauf: accessCode
Autorisierungs-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

Bereiche

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 im Zusammenhang mit der Nachverfolgung von Arbeitselementen, Ausführen von Abfragen und das Empfangen von Benachrichtigungen zu Arbeitselementereignissen über Diensthooks.

Beispiele

Create an area

Create an iteration

Move an area node

Move an iteration node

Create an area

Beispielanforderung

HTTP

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

{
  "name": "Web"
}

Beispiel für eine Antwort

Statuscode:: 201

{
  "id": 126391,
  "identifier": "a5c68379-3258-4d62-971c-71c1c459336e",
  "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"
}

Create an iteration

Beispielanforderung

HTTP

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

{
  "name": "Final Iteration",
  "attributes": {
    "startDate": "2014-10-27T00:00:00Z",
    "finishDate": "2014-10-31T00:00:00Z"
  }
}

Beispiel für eine Antwort

Statuscode:: 201

{
  "id": 126392,
  "identifier": "8dbed14a-c1b6-46e8-8540-8118c4ea29ae",
  "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"
}

Move an area node

Beispielanforderung

HTTP

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

{
  "id": 126391
}

Beispiel für eine Antwort

Statuscode:: 200

{
  "id": 126391,
  "identifier": "d01a1947-781a-4328-95be-960b90d04fe3",
  "name": "Website team",
  "structureType": "area",
  "hasChildren": false,
  "_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

Beispielanforderung

HTTP

POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/{structureGroup}?api-version=5.0

{
  "id": 126392
}

Beispiel für eine Antwort

Statuscode:: 200

{
  "id": 126392,
  "identifier": "81f373b4-93cb-4c2b-99e6-1308ea5d1adc",
  "name": "Ultimate iteration",
  "structureType": "iteration",
  "hasChildren": false,
  "_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
ReferenceLinks	Die -Klasse, die eine Auflistung von REST-Verweislinks darstellt.
TreeNodeStructureType	Knotenstrukturtyp.
TreeStructureGroup	Strukturgruppe des Klassifizierungsknotens, des Bereichs oder der Iteration.
WorkItemClassificationNode	Definiert einen Klassifizierungsknoten für die Nachverfolgung von Arbeitselementen.

ReferenceLinks

Objekt

Die -Klasse, die eine Auflistung von REST-Verweislinks darstellt.

Name	Typ	Beschreibung
links	object	Die schreibgeschützte Ansicht der Links. Da Verweislinks schreibgeschützter Sind, möchten wir sie nur als schreibgeschützter Link verfügbar machen.

TreeNodeStructureType

Enumeration

Knotenstrukturtyp.

Wert	Beschreibung
area	Bereichstyp.
iteration	Iterationstyp.

TreeStructureGroup

Enumeration

Strukturgruppe des Klassifizierungsknotens, des Bereichs oder der Iteration.

Wert	Beschreibung
areas
iterations

WorkItemClassificationNode

Objekt

Definiert einen Klassifizierungsknoten für die Nachverfolgung von Arbeitselementen.

Name	Typ	Beschreibung
_links	ReferenceLinks	Links zu verwandten REST-Ressourcen.
attributes	object	Wörterbuch mit Knotenattributen wie Start-/Enddatum für Iterationsknoten.
children	WorkItemClassificationNode[]	Liste der abgerufenen untergeordneten Knoten.
hasChildren	boolean	Flag, das angibt, ob der Klassifizierungsknoten über untergeordnete Knoten verfügt.
id	integer	Ganzzahl-ID des Klassifizierungsknotens.
identifier	string	GUID-ID des Klassifizierungsknotens.
name	string	Name des Klassifizierungsknotens.
structureType	TreeNodeStructureType	Knotenstrukturtyp.
url	string

Freigeben über

Classification Nodes - Create Or Update

URI-Parameter

Anforderungstext

Antworten

Sicherheit

oauth2

Bereiche

Beispiele

Create an area

Beispielanforderung

Beispiel für eine Antwort

Create an iteration

Beispielanforderung

Beispiel für eine Antwort

Move an area node

Beispielanforderung

Beispiel für eine Antwort

Move an iteration node

Beispielanforderung

Beispiel für eine Antwort

Definitionen

ReferenceLinks

TreeNodeStructureType

TreeStructureGroup

WorkItemClassificationNode

Zusätzliche Ressourcen