Sdílet prostřednictvím

Classification Nodes - Update

  • Reference
Služba:
Work Item Tracking
Verze rozhraní API:
4.1

Aktualizace existujícího uzlu klasifikace

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

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 uzlu klasifikace.
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 hodnotu 4.1.

Text požadavku

Name Typ Description
_links

ReferenceLinks

Odkazy na související prostředky REST.
attributes

object

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

WorkItemClassificationNode[]

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

boolean

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

integer

Celočíselné ID uzlu klasifikace.
identifier

string

IDENTIFIKÁTOR GUID uzlu klasifikace.
name

string

Název uzlu klasifikace.
structureType

TreeNodeStructureType

Typ struktury uzlu.
url

string

Odpovědi

Name Typ Description
200 OK

WorkItemClassificationNode

úspěšná operace

Zabezpečení

oauth2

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

Rozsahy

Name Description
vso.work_write Uděluje možnost čí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 zachytávání služeb.

Příklady

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

Change an iteration's dates

Ukázkový požadavek

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

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

Ukázková odpověď

Stavový kód:
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

Ukázkový požadavek

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

{
  "name": "Website team"
}

Ukázková odpověď

Stavový kód:
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

Ukázkový požadavek

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

{
  "name": "Ultimate iteration"
}

Ukázková odpověď

Stavový kód:
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"
}

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

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 odkazy jen pro čtení.

TreeNodeStructureType

Enumeration

Typ struktury uzlu.

Hodnota Description
area

Typ oblasti.
iteration

Typ iterace.

TreeStructureGroup

Enumeration

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

Hodnota Description
areas
iterations

WorkItemClassificationNode

Object

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 uzlu, jako je datum zahájení a dokončení pro uzly iterace.
children

WorkItemClassificationNode[]

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

boolean

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

integer

Celočíselné ID uzlu klasifikace.
identifier

string

IDENTIFIKÁTOR GUID uzlu klasifikace.
name

string

Název uzlu klasifikace.
structureType

TreeNodeStructureType

Typ struktury uzlu.
url

string