共用方式為

Classification Nodes - Update

  • 參考
服務:
Work Item Tracking
API 版本:
5.0

更新現有的分類節點。

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

URI 參數

名稱 位於 必要 類型 Description
organization
 path True

string

Azure DevOps 組織的名稱。
project
 path True

string

專案識別碼或專案名稱
structureGroup
 path True

TreeStructureGroup

分類節點、區域或反復專案的結構群組。
path
 path

string

分類節點的路徑。
api-version
 query True

string

要使用的 API 版本。 這應該設定為 '5.0' 以使用此版本的 API。

要求本文

名稱 類型 Description
_links

ReferenceLinks

連結相關 REST 資源的參考。
attributes

object

具有節點屬性的字典，例如反復專案節點的開始/完成日期。
children

WorkItemClassificationNode[]

擷取的子節點清單。
hasChildren

boolean

旗標，指出分類節點是否有任何子節點。
id

integer

分類節點的整數識別碼。
identifier

string

分類節點的 GUID 識別碼。
name

string

分類節點的名稱。
structureType

TreeNodeStructureType

節點結構類型。
url

string

回應

名稱 類型 Description
200 OK

WorkItemClassificationNode

成功作業

安全性

oauth2

類型: oauth2
Flow: accessCode
授權 URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
權杖 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

範圍

名稱 Description
vso.work_write 授與讀取、建立及更新工作專案和查詢、更新面板中繼資料、讀取區域和反復專案路徑的其他工作專案追蹤相關中繼資料、執行查詢，以及透過服務勾點接收工作專案事件通知的能力。

範例

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

Change an iteration's dates

範例要求

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"
  }
}

範例回覆

狀態碼:
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

範例要求

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

{
  "name": "Website team"
}

範例回覆

狀態碼:
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

範例要求

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

{
  "name": "Ultimate iteration"
}

範例回覆

狀態碼:
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"
}

定義

名稱 Description
ReferenceLinks

表示 REST 參考連結集合的類別。
TreeNodeStructureType

節點結構類型。
TreeStructureGroup

分類節點、區域或反復專案的結構群組。
WorkItemClassificationNode

定義工作專案追蹤的分類節點。
Object

表示 REST 參考連結集合的類別。

名稱 類型 Description
links

object

連結的唯讀檢視。 因為參考連結是唯讀的，所以我們只想要將它們公開為唯讀。

TreeNodeStructureType

Enumeration

節點結構類型。

值 Description
area

區欄位型別。
iteration

反復專案類型。

TreeStructureGroup

Enumeration

分類節點、區域或反復專案的結構群組。

值 Description
areas
iterations

WorkItemClassificationNode

Object

定義工作專案追蹤的分類節點。

名稱 類型 Description
_links

ReferenceLinks

連結相關 REST 資源的參考。
attributes

object

具有節點屬性的字典，例如反復專案節點的開始/完成日期。
children

WorkItemClassificationNode[]

擷取的子節點清單。
hasChildren

boolean

旗標，指出分類節點是否有任何子節點。
id

integer

分類節點的整數識別碼。
identifier

string

分類節點的 GUID 識別碼。
name

string

分類節點的名稱。
structureType

TreeNodeStructureType

節點結構類型。
url

string