Freigeben über

Classification Nodes - Get

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

Ruft den Klassifizierungsknoten für einen angegebenen Knotenpfad ab.

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

integer

int32

Tiefe der abzurufenden untergeordneten Elemente.

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 Ermöglicht das Lesen von Arbeitselementen, Abfragen, Boards, Bereichs- und Iterationspfaden und anderen Metadaten zur Nachverfolgung von Arbeitselementen. Außerdem können Sie Abfragen ausführen, Arbeitselemente durchsuchen und Benachrichtigungen über Arbeitselementereignisse über Diensthaken empfangen.

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

Beispiel für eine Antwort

Statuscode:
200 
{
  "id": 126391,
  "identifier": "d5d98099-47ac-468a-9579-c059c90bf7c5",
  "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"
}

Get an iteration

Beispielanforderung

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

Beispiel für eine Antwort

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

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

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

Enumeration

Knotenstrukturtyp.

Wert Beschreibung
area

Bereichstyp.
iteration

Iterationstyp.

TreeStructureGroup

Enumeration

Strukturgruppe des Klassifizierungsknotens, Bereichs oder Iteration.

Wert Beschreibung
areas
iterations

WorkItemClassificationNode

Objekt

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

TreeNodeStructureType

Knotenstrukturtyp.
url

string