Classification Nodes - Create Or Update

Referenz

Dienst:: Work Item Tracking

API-Version:: 7.1

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

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

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 "7.1" festgelegt werden, um diese Version der API zu verwenden.

Anforderungstext

Name	Typ	Beschreibung
_links	ReferenceLinks	Verknüpfen Sie Verweise auf verwandte REST-Ressourcen.
attributes	object	Wörterbuch mit Knotenattributen wie Start-/Endtermin 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 (int32)	Ganzzahl-ID des Klassifizierungsknotens.
identifier	string (uuid)	GUID-ID des Klassifizierungsknotens.
name	string	Name des Klassifizierungsknotens.
path	string	Pfad 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	Gewährt die Möglichkeit, Arbeitsaufgaben und Abfragen zu lesen, zu erstellen und zu aktualisieren, Boardmetadaten zu aktualisieren, Bereiche und Iterationspfade für andere Pfade für die Nachverfolgung verwandter Arbeitsaufgaben zu aktualisieren, Abfragen auszuführen und Benachrichtigungen über Arbeitsaufgabenereignisse über Diensthaken zu erhalten.

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

{
  "name": "Web"
}

Beispiel für eine Antwort

Statuscode:: 201

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

Beispielanforderung

HTTP

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

{
  "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,
  "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

Beispielanforderung

HTTP

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

{
  "id": 126391
}

Beispiel für eine Antwort

Statuscode:: 200

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

Beispielanforderung

HTTP

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

{
  "id": 126392
}

Beispiel für eine Antwort

Statuscode:: 200

{
  "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
ReferenceLinks	Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt.
TreeNodeStructureType	Knotenstrukturtyp.
TreeStructureGroup	Strukturgruppe des Klassifizierungsknotens, des Bereichs oder der Iteration.
WorkItemClassificationNode	Definiert einen Klassifizierungsknoten für die Nachverfolgung von Arbeitsaufgaben.

ReferenceLinks

Objekt

Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt.

Name	Typ	Beschreibung
links	object	Die schreibgeschützte Ansicht der Links. Da Referenzlinks schreibgeschützt sind, möchten wir sie nur als schreibgeschützt 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 Arbeitsaufgaben.

Name	Typ	Beschreibung
_links	ReferenceLinks	Verknüpfen Sie Verweise auf verwandte REST-Ressourcen.
attributes	object	Wörterbuch mit Knotenattributen wie Start-/Endtermin 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 (int32)	Ganzzahl-ID des Klassifizierungsknotens.
identifier	string (uuid)	GUID-ID des Klassifizierungsknotens.
name	string	Name des Klassifizierungsknotens.
path	string	Pfad des Klassifizierungsknotens.
structureType	TreeNodeStructureType	Knotenstrukturtyp.
url	string

AI Skills Fest

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