Classification Nodes - Update

  • Referenz
Service:
Work Item Tracking
API Version:
6.0

Aktualisieren Sie einen vorhandenen Klassifizierungsknoten.

PATCH https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?api-version=6.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. Diese sollte auf 6.0 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

Change an iteration's dates
Rename an area
Rename an iteration

Change an iteration's dates

Sample Request

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

{
  "attributes": {
    "startDate": "2015-01-26T00:00:00Z",
    "finishDate": "2015-01-30T00:00:00Z"
  }
}

Sample Response

Status code:
200 
{
  "id": 126392,
  "identifier": "a5c68379-3258-4d62-971c-71c1c459336e",
  "name": "Ultimate iteration",
  "structureType": "iteration",
  "hasChildren": false,
  "path": "\\fabrikam\\fiber\\tfvc\\area",
  "attributes": {
    "startDate": "2015-01-26T00:00:00Z",
    "finishDate": "2015-01-30T00:00:00Z"
  },
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Ultimate%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/Ultimate%20iteration"
}

Rename an area

Sample Request

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

{
  "name": "Website team"
}

Sample Response

Status code:
200 
{
  "id": 126391,
  "identifier": "25450731-5178-4044-84f0-0a0ebdef0c33",
  "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/Website%20team"
    },
    "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/Website%20team"
}

Rename an iteration

Sample Request

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

{
  "name": "Ultimate iteration"
}

Sample Response

Status code:
200 
{
  "id": 126392,
  "identifier": "8677aa7d-2f4a-4f53-8f0f-b84a23997f70",
  "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/Ultimate%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/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