Classification Nodes - Create Or Update
Vytvořte nový nebo aktualizujte existující uzel klasifikace.
POST https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?api-version=4.1Parametry 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 |
|
structure
|
path | True |
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 4.1. |
Text požadavku
| Name | Typ | Description |
|---|---|---|
| _links |
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 |
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. |
| structureType |
Typ struktury uzlu. |
|
| url |
string |
Odpovědi
| Name | Typ | Description |
|---|---|---|
| 200 OK |
ú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
| Create an area |
| Create an iteration |
| Move an area node |
| Move an iteration node |
Create an area
Sample Request
POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/Areas?api-version=4.1
{
"name": "Web"
}
Sample Response
{
"id": 126391,
"identifier": "a5c68379-3258-4d62-971c-71c1c459336e",
"name": "Web",
"structureType": "area",
"hasChildren": false,
"_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"
}Create an iteration
Sample Request
POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/Iterations?api-version=4.1
{
"name": "Final Iteration",
"attributes": {
"startDate": "2014-10-27T00:00:00Z",
"finishDate": "2014-10-31T00:00:00Z"
}
}
Sample Response
{
"id": 126392,
"identifier": "8dbed14a-c1b6-46e8-8540-8118c4ea29ae",
"name": "Final Iteration",
"structureType": "iteration",
"hasChildren": false,
"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"
}Move an area node
Sample Request
POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/Areas?api-version=4.1
{
"id": 126391
}
Sample Response
{
"id": 126391,
"identifier": "d01a1947-781a-4328-95be-960b90d04fe3",
"name": "Website team",
"structureType": "area",
"hasChildren": false,
"_links": {
"self": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas/Parent%20Area/Website%20team"
},
"parent": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas/Parent%20Area"
}
},
"url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Areas/Parent%20Area/Website%20team"
}Move an iteration node
Sample Request
POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/{structureGroup}?api-version=4.1
{
"id": 126392
}
Sample Response
{
"id": 126392,
"identifier": "81f373b4-93cb-4c2b-99e6-1308ea5d1adc",
"name": "Ultimate iteration",
"structureType": "iteration",
"hasChildren": false,
"_links": {
"self": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Parent%20Iteration/Ultimate%20iteration"
},
"parent": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Parent%20Iteration"
}
},
"url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/classificationNodes/Iterations/Parent%20Iteration/Ultimate%20iteration"
}Definice
| Name | Description |
|---|---|
|
Reference |
Třída představující kolekci odkazů REST. |
|
Tree |
Typ struktury uzlu. |
|
Tree |
Skupina struktury klasifikačního uzlu, oblasti nebo iterace. |
|
Work |
Definuje uzel klasifikace pro sledování pracovních položek. |
ReferenceLinks
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 |
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 |
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. |
| structureType |
Typ struktury uzlu. |
|
| url |
string |
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro