Sdílet prostřednictvím

Classification Nodes - Get

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

Získá uzel klasifikace pro danou cestu uzlu.

GET https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?api-version=7.1
S volitelnými parametry: 
GET https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?$depth={$depth}&api-version=7.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 struktur uzlu klasifikace, oblasti nebo iterace
path
 path

string

Cesta uzlu klasifikace
api-version
 query True

string

Verze rozhraní API, která se má použít. Pokud chcete použít tuto verzi rozhraní API, měla by být nastavená na hodnotu 7.1.
$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

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 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 volání služby.

Příklady

Get an area
Get an iteration

Get an area

Ukázkový požadavek

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

Ukázková odpověď

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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
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 struktur uzlu klasifikace, oblasti nebo iterace
WorkItemClassificationNode

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

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

Name Typ Description
links

object

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

TreeNodeStructureType

Výčet

Typ struktury uzlu.

Hodnota Description
area

Typ oblasti.
iteration

Typ iterace.

TreeStructureGroup

Výčet

Skupina struktur uzlu klasifikace, oblasti nebo iterace

Hodnota Description
areas
iterations

WorkItemClassificationNode

Objekt

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 s 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 označující, jestli uzel klasifikace obsahuje podřízené uzly.
id

integer (int32)

Celé číslo ID uzlu klasifikace.
identifier

string (uuid)

IDENTIFIKÁTOR GUID uzlu klasifikace.
name

string

Název uzlu klasifikace
path

string

Cesta uzlu klasifikace
structureType

TreeNodeStructureType

Typ struktury uzlu.
url

string