Classification Nodes - Get

  • Reference
Service:
Work Item Tracking
API Version:
6.0

Získá klasifikační uzel pro danou cestu uzlu.

GET https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?api-version=6.0
With optional parameters: 
GET https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?$depth={$depth}&api-version=6.0

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 hodnotu 6.0.
$depth
 query

integer

int32

Hloubka dětí, které se mají načíst.

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 Umožňuje číst pracovní položky, dotazy, panely, cesty oblastí a iterací a další metadata související se sledováním pracovních položek. Umožňuje také spouštět dotazy, prohledávat pracovní položky a přijímat oznámení o událostech pracovních položek prostřednictvím služeb.

Příklady

Get an area
Get an iteration

Get an area

Sample Request

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

Sample Response

Status code:
200 
{
  "id": 126391,
  "identifier": "d5d98099-47ac-468a-9579-c059c90bf7c5",
  "name": "Web",
  "structureType": "area",
  "hasChildren": false,
  "path": "\\fabrikam\\fiber\\tfvc\\iteration",
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas/Web"
    },
    "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/Web"
}

Get an iteration

Sample Request

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

Sample Response

Status code:
200 
{
  "id": 126392,
  "identifier": "dd643523-4d15-4106-a6a4-e70d39a09446",
  "name": "Final Iteration",
  "structureType": "iteration",
  "hasChildren": false,
  "path": "\\fabrikam\\fiber\\tfvc\\iteration",
  "attributes": {
    "startDate": "2014-10-27T00:00:00Z",
    "finishDate": "2014-10-31T00:00:00Z"
  },
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Final%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/Final%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