Classification Nodes - Create Or Update
Buat baru atau perbarui simpul klasifikasi yang sudah ada.
POST https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?api-version=7.1-preview.2Parameter URI
| Nama | Dalam | Diperlukan | Jenis | Deskripsi |
|---|---|---|---|---|
|
organization
|
path | True |
string |
Nama organisasi Azure DevOps. |
|
project
|
path | True |
string |
ID proyek atau nama proyek |
|
structure
|
path | True |
Grup struktur simpul klasifikasi, area, atau perulangan. |
|
|
path
|
path |
string |
Jalur simpul klasifikasi. |
|
|
api-version
|
query | True |
string |
Versi API yang akan digunakan. Ini harus diatur ke '7.1-preview.2' untuk menggunakan versi api ini. |
Isi Permintaan
| Nama | Jenis | Deskripsi |
|---|---|---|
| _links |
Menautkan referensi ke sumber daya REST terkait. |
|
| attributes |
object |
Kamus yang memiliki atribut node seperti tanggal mulai/selesai untuk node iterasi. |
| children |
Daftar simpul anak yang diambil. |
|
| hasChildren |
boolean |
Bendera yang menunjukkan apakah simpul klasifikasi memiliki simpul anak. |
| id |
integer |
ID bilangan bulat dari simpul klasifikasi. |
| identifier |
string |
ID GUID dari node klasifikasi. |
| name |
string |
Nama node klasifikasi. |
| path |
string |
Jalur simpul klasifikasi. |
| structureType |
Jenis struktur node. |
|
| url |
string |
Respons
| Nama | Jenis | Deskripsi |
|---|---|---|
| 200 OK |
operasi berhasil |
Keamanan
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
| Nama | Deskripsi |
|---|---|
| vso.work_write | Memberikan kemampuan untuk membaca, membuat, dan memperbarui item dan kueri kerja, memperbarui metadata papan, membaca area dan jalur iterasi metadata terkait pelacakan item kerja lainnya, menjalankan kueri, dan menerima pemberitahuan tentang peristiwa item kerja melalui kait layanan. |
Contoh
| 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=7.1-preview.2
{
"name": "Web"
}
Sample Response
{
"id": 126391,
"identifier": "a5c68379-3258-4d62-971c-71c1c459336e",
"name": "Web",
"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/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=7.1-preview.2
{
"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,
"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"
}Move an area node
Sample Request
POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/Areas?api-version=7.1-preview.2
{
"id": 126391
}
Sample Response
{
"id": 126391,
"identifier": "d01a1947-781a-4328-95be-960b90d04fe3",
"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/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=7.1-preview.2
{
"id": 126392
}
Sample Response
{
"id": 126392,
"identifier": "81f373b4-93cb-4c2b-99e6-1308ea5d1adc",
"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/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"
}Definisi
| Nama | Deskripsi |
|---|---|
|
Reference |
Kelas untuk mewakili kumpulan tautan referensi REST. |
|
Tree |
Jenis struktur node. |
|
Tree |
Grup struktur simpul klasifikasi, area, atau perulangan. |
|
Work |
Menentukan simpul klasifikasi untuk pelacakan item kerja. |
ReferenceLinks
Kelas untuk mewakili kumpulan tautan referensi REST.
| Nama | Jenis | Deskripsi |
|---|---|---|
| links |
object |
Tampilan baca-saja dari tautan. Karena tautan Referensi dibaca saja, kami hanya ingin mengeksposnya sebagai baca-saja. |
TreeNodeStructureType
Jenis struktur node.
| Nama | Jenis | Deskripsi |
|---|---|---|
| area |
string |
Jenis area. |
| iteration |
string |
Jenis perulangan. |
TreeStructureGroup
Grup struktur simpul klasifikasi, area, atau perulangan.
| Nama | Jenis | Deskripsi |
|---|---|---|
| areas |
string |
|
| iterations |
string |
WorkItemClassificationNode
Menentukan simpul klasifikasi untuk pelacakan item kerja.
| Nama | Jenis | Deskripsi |
|---|---|---|
| _links |
Menautkan referensi ke sumber daya REST terkait. |
|
| attributes |
object |
Kamus yang memiliki atribut node seperti tanggal mulai/selesai untuk node iterasi. |
| children |
Daftar simpul anak yang diambil. |
|
| hasChildren |
boolean |
Bendera yang menunjukkan apakah simpul klasifikasi memiliki simpul anak. |
| id |
integer |
ID bilangan bulat dari simpul klasifikasi. |
| identifier |
string |
ID GUID dari node klasifikasi. |
| name |
string |
Nama node klasifikasi. |
| path |
string |
Jalur simpul klasifikasi. |
| structureType |
Jenis struktur node. |
|
| url |
string |
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk