Classification Nodes - Create Or Update

  • Referenz
Service:
Work Item Tracking
API Version:
7.1-preview.2

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
structureGroup
 path True

TreeStructureGroup

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

ReferenceLinks

Verknüpfen Sie Verweise auf verwandte 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

Ganzzahlige ID des Klassifizierungsknotens.
identifier

string

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

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

Status code:
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

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

Status code:
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

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

Status code:
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

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

Status code:
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-Verweislinks darstellt.
TreeNodeStructureType

Knotenstrukturtyp.
TreeStructureGroup

Strukturgruppe des Klassifizierungsknotens, Bereichs oder Iteration.
WorkItemClassificationNode

Definiert einen Klassifizierungsknoten für die Arbeitselementnachverfolgung.

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

ReferenceLinks

Verknüpfen Sie Verweise auf verwandte 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

Ganzzahlige ID des Klassifizierungsknotens.
identifier

string

GUID-ID des Klassifizierungsknotens.
name

string

Name des Klassifizierungsknotens.
path

string

Pfad des Klassifizierungsknotens.
structureType

TreeNodeStructureType

Knotenstrukturtyp.
url

string