Udostępnij za pośrednictwem

Classification Nodes - Update

  • Odwołanie
Usługa:
Work Item Tracking
Wersja interfejsu API:
7.1

Zaktualizuj istniejący węzeł klasyfikacji.

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

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ść "7.1", aby używać tej wersji interfejsu API.

Treść żądania

Nazwa Typ Opis
_links

ReferenceLinks

Połącz odwołania 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 (int32)

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

string (uuid)

Identyfikator GUID węzła klasyfikacji.
name

string

Nazwa węzła klasyfikacji.
path

string

Ścieżka 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

Typ: oauth2
Flow: accessCode
Adres URL autoryzacji: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Adres URL tokenu: 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

Zakresy

Nazwa Opis
vso.work_write Umożliwia odczytywanie, tworzenie i aktualizowanie elementów roboczych i zapytań, metadanych tablicy aktualizacji, ścieżek obszaru odczytu i iteracji innych metadanych powiązanych elementów roboczych, wykonywania zapytań i odbierania 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

Przykładowe żądanie

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

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

Przykładowa odpowiedź

Kod stanu:
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

Przykładowe żądanie

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

{
  "name": "Website team"
}

Przykładowa odpowiedź

Kod stanu:
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

Przykładowe żądanie

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

{
  "name": "Ultimate iteration"
}

Przykładowa odpowiedź

Kod stanu:
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"
}

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

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

Nazwa Typ Opis
links

object

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

TreeNodeStructureType

Wyliczanie

Typ struktury węzła.

Wartość Opis
area

Typ obszaru.
iteration

Typ iteracji.

TreeStructureGroup

Wyliczanie

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

Wartość Opis
areas
iterations

WorkItemClassificationNode

Objekt

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

Nazwa Typ Opis
_links

ReferenceLinks

Połącz odwołania 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 (int32)

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

string (uuid)

Identyfikator GUID węzła klasyfikacji.
name

string

Nazwa węzła klasyfikacji.
path

string

Ścieżka węzła klasyfikacji.
structureType

TreeNodeStructureType

Typ struktury węzła.
url

string