Bagikan melalui

Classification Nodes - Update

  • Referensi
Service:
Work Item Tracking
API Version:
5.0

Perbarui simpul klasifikasi yang ada.

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

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
organization
 path True

string

Nama organisasi Azure DevOps.
project
 path True

string

ID proyek atau nama proyek
structureGroup
 path True

TreeStructureGroup

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 '5.0' untuk menggunakan versi api ini.

Isi Permintaan

Nama Jenis Deskripsi
_links

ReferenceLinks

Menautkan referensi ke sumber daya REST terkait.
attributes

object

Kamus yang memiliki atribut node seperti tanggal mulai/selesai untuk node iterasi.
children

WorkItemClassificationNode[]

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

TreeNodeStructureType

Jenis struktur node.
url

string

Respons

Nama Jenis Deskripsi
200 OK

WorkItemClassificationNode

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

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

Change an iteration's dates

Sample Request

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

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

Sample Response

Status code:
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

Sample Request

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

{
  "name": "Website team"
}

Sample Response

Status code:
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

Sample Request

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

{
  "name": "Ultimate iteration"
}

Sample Response

Status code:
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"
}

Definisi

Nama Deskripsi
ReferenceLinks

Kelas untuk mewakili kumpulan tautan referensi REST.
TreeNodeStructureType

Jenis struktur node.
TreeStructureGroup

Grup struktur simpul klasifikasi, area, atau perulangan.
WorkItemClassificationNode

Menentukan simpul klasifikasi untuk pelacakan item kerja.

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

ReferenceLinks

Menautkan referensi ke sumber daya REST terkait.
attributes

object

Kamus yang memiliki atribut node seperti tanggal mulai/selesai untuk node iterasi.
children

WorkItemClassificationNode[]

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

TreeNodeStructureType

Jenis struktur node.
url

string