Freigeben über

Classification Nodes - Get

  • Referenz
Dienst:
Work Item Tracking
API-Version:
7.1

Ruft den Klassifizierungsknoten für einen bestimmten Knotenpfad ab.

GET https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?api-version=7.1
Mit optionalen Parametern: 
GET https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?$depth={$depth}&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.
$depth
 query

integer (int32)

Tiefe der abzurufenden Untergeordneten.

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 Gewährt die Möglichkeit, Arbeitsaufgaben, Abfragen, Boards, Flächen- und Iterationspfade und andere Metadaten zur Nachverfolgung von Arbeitsaufgaben zu lesen. Gewährt außerdem die Möglichkeit, Abfragen auszuführen, Arbeitsaufgaben zu durchsuchen und Benachrichtigungen über Arbeitsaufgabenereignisse über Dienst-Hooks zu erhalten.

Beispiele

Get an area
Get an iteration

Get an area

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
200 
{
  "id": 126391,
  "identifier": "d5d98099-47ac-468a-9579-c059c90bf7c5",
  "name": "Web",
  "structureType": "area",
  "hasChildren": false,
  "path": "\\fabrikam\\fiber\\tfvc\\iteration",
  "_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"
}

Get an iteration

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
200 
{
  "id": 126392,
  "identifier": "dd643523-4d15-4106-a6a4-e70d39a09446",
  "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"
}

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.
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