Udostępnij za pośrednictwem

Classification Nodes - Update

  • Odwołanie
Service:
Work Item Tracking
API Version:
5.0

Zaktualizuj istniejący węzeł klasyfikacji.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
organization
 path True

string

Nazwa organizacji usługi Azure DevOps.
project
 path True

string

Identyfikator projektu lub nazwa projektu
structureGroup
 path True

TreeStructureGroup

Grupa struktury węzła klasyfikacji, obszaru lub iteracji.
path
 path

string

Ścieżka węzła klasyfikacji.
api-version
 query True

string

Wersja interfejsu API do użycia. Należy ustawić wartość "5.0", aby używać tej wersji interfejsu API.

Treść żądania

Nazwa Typ Opis
_links

ReferenceLinks

Linki do powiązanych zasobów REST.
attributes

object

Słownik zawierający atrybuty węzła, takie jak data rozpoczęcia/zakończenia dla węzłów iteracji.
children

WorkItemClassificationNode[]

Lista pobranych węzłów podrzędnych.
hasChildren

boolean

Flaga wskazująca, czy węzeł klasyfikacji ma jakiekolwiek węzły podrzędne.
id

integer

Identyfikator liczby całkowitej węzła klasyfikacji.
identifier

string

Identyfikator GUID węzła klasyfikacji.
name

string

Nazwa węzła klasyfikacji.
structureType

TreeNodeStructureType

Typ struktury węzła.
url

string

Odpowiedzi

Nazwa Typ Opis
200 OK

WorkItemClassificationNode

operacja zakończona powodzeniem

Zabezpieczenia

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

Nazwa Opis
vso.work_write Umożliwia odczytywanie, tworzenie i aktualizowanie elementów roboczych i zapytań, aktualizowanie metadanych tablicy, ścieżki obszaru odczytu i iteracji innych metadanych powiązanych z elementami roboczymi, wykonywanie zapytań i odbieranie powiadomień o zdarzeniach elementów roboczych za pośrednictwem punktów zaczepienia usługi.

Przykłady

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=5.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,
  "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=5.0

{
  "name": "Website team"
}

Sample Response

Status code:
200 
{
  "id": 126391,
  "identifier": "25450731-5178-4044-84f0-0a0ebdef0c33",
  "name": "Website team",
  "structureType": "area",
  "hasChildren": false,
  "_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=5.0

{
  "name": "Ultimate iteration"
}

Sample Response

Status code:
200 
{
  "id": 126392,
  "identifier": "8677aa7d-2f4a-4f53-8f0f-b84a23997f70",
  "name": "Ultimate iteration",
  "structureType": "iteration",
  "hasChildren": false,
  "_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"
}

Definicje

Nazwa Opis
ReferenceLinks

Klasa reprezentująca kolekcję linków referencyjnych REST.
TreeNodeStructureType

Typ struktury węzła.
TreeStructureGroup

Grupa struktury węzła klasyfikacji, obszaru lub iteracji.
WorkItemClassificationNode

Definiuje węzeł klasyfikacji na potrzeby śledzenia elementów roboczych.

Klasa reprezentująca kolekcję linków referencyjnych REST.

Nazwa Typ Opis
links

object

Widok linków w trybie tylko do odczytu. Ponieważ linki odwołania są tylko do odczytu, chcemy uwidocznić je tylko jako tylko do odczytu.

TreeNodeStructureType

Typ struktury węzła.

Nazwa Typ Opis
area

string

Typ obszaru.
iteration

string

Typ iteracji.

TreeStructureGroup

Grupa struktury węzła klasyfikacji, obszaru lub iteracji.

Nazwa Typ Opis
areas

string

iterations

string

WorkItemClassificationNode

Definiuje węzeł klasyfikacji na potrzeby śledzenia elementów roboczych.

Nazwa Typ Opis
_links

ReferenceLinks

Linki do powiązanych zasobów REST.
attributes

object

Słownik zawierający atrybuty węzła, takie jak data rozpoczęcia/zakończenia dla węzłów iteracji.
children

WorkItemClassificationNode[]

Lista pobranych węzłów podrzędnych.
hasChildren

boolean

Flaga wskazująca, czy węzeł klasyfikacji ma jakiekolwiek węzły podrzędne.
id

integer

Identyfikator liczby całkowitej węzła klasyfikacji.
identifier

string

Identyfikator GUID węzła klasyfikacji.
name

string

Nazwa węzła klasyfikacji.
structureType

TreeNodeStructureType

Typ struktury węzła.
url

string