Sdílet prostřednictvím

Classification Nodes - Update

  • Reference
Service:
Work Item Tracking
API Version:
7.1-preview.2

Aktualizace existujícího klasifikačního uzlu

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
organization
 path True

string

Název organizace Azure DevOps.
project
 path True

string

ID projektu nebo název projektu
structureGroup
 path True

TreeStructureGroup

Skupina struktury klasifikačního uzlu, oblasti nebo iterace.
path
 path

string

Cesta klasifikačního uzlu.
api-version
 query True

string

Verze rozhraní API, která se má použít. Aby se tato verze rozhraní API používala, měla by být nastavená na 7.1-preview.2.

Text požadavku

Name Typ Description
_links

ReferenceLinks

Odkazy na související prostředky REST
attributes

object

Slovník, který má atributy uzlů, jako je datum zahájení a dokončení pro uzly iterace.
children

WorkItemClassificationNode[]

Seznam načítaných podřízených uzlů
hasChildren

boolean

Příznak, který označuje, jestli má klasifikační uzel nějaké podřízené uzly.
id

integer

Celočíselné ID klasifikačního uzlu.
identifier

string

IDENTIFIKÁTOR GUID klasifikačního uzlu.
name

string

Název klasifikačního uzlu.
path

string

Cesta klasifikačního uzlu.
structureType

TreeNodeStructureType

Typ struktury uzlu.
url

string

Odpovědi

Name Typ Description
200 OK

WorkItemClassificationNode

úspěšná operace

Zabezpečení

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 Description
vso.work_write Umožňuje číst, vytvářet a aktualizovat pracovní položky a dotazy, metadata aktualizačního panelu, oblast čtení a iterace cest k jiným metadatům souvisejícím se sledováním pracovních položek, spouštět dotazy a přijímat oznámení o událostech pracovních položek prostřednictvím služeb.

Příklady

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=7.1-preview.2

{
  "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=7.1-preview.2

{
  "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=7.1-preview.2

{
  "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"
}

Definice

Name Description
ReferenceLinks

Třída představující kolekci odkazů REST.
TreeNodeStructureType

Typ struktury uzlu.
TreeStructureGroup

Skupina struktury klasifikačního uzlu, oblasti nebo iterace.
WorkItemClassificationNode

Definuje uzel klasifikace pro sledování pracovních položek.

Třída představující kolekci odkazů REST.

Name Typ Description
links

object

Zobrazení odkazů jen pro čtení. Vzhledem k tomu, že odkazy jsou jen pro čtení, chceme je zveřejnit jenom jako jen pro čtení.

TreeNodeStructureType

Typ struktury uzlu.

Name Typ Description
area

string

Typ oblasti.
iteration

string

Typ iterace.

TreeStructureGroup

Skupina struktury klasifikačního uzlu, oblasti nebo iterace.

Name Typ Description
areas

string

iterations

string

WorkItemClassificationNode

Definuje uzel klasifikace pro sledování pracovních položek.

Name Typ Description
_links

ReferenceLinks

Odkazy na související prostředky REST
attributes

object

Slovník, který má atributy uzlů, jako je datum zahájení a dokončení pro uzly iterace.
children

WorkItemClassificationNode[]

Seznam načítaných podřízených uzlů
hasChildren

boolean

Příznak, který označuje, jestli má klasifikační uzel nějaké podřízené uzly.
id

integer

Celočíselné ID klasifikačního uzlu.
identifier

string

IDENTIFIKÁTOR GUID klasifikačního uzlu.
name

string

Název klasifikačního uzlu.
path

string

Cesta klasifikačního uzlu.
structureType

TreeNodeStructureType

Typ struktury uzlu.
url

string