Classification Nodes - Create Or Update

Referencia

Service:: Work Item Tracking

API Version:: 7.1-preview.2

Cree un nodo de clasificación existente o actualice uno existente.

POST https://dev.azure.com/{organization}/{project}/_apis/wit/classificationnodes/{structureGroup}/{path}?api-version=7.1-preview.2

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
organization	path	True	string	El nombre de la organización de Azure DevOps.
project	path	True	string	Id. de proyecto o nombre del proyecto
structureGroup	path	True	TreeStructureGroup	Grupo de estructura del nodo de clasificación, área o iteración.
path	path		string	Ruta de acceso del nodo de clasificación.
api-version	query	True	string	Versión de la API que se va a usar. Debe establecerse en "7.1-preview.2" para usar esta versión de la API.

Cuerpo de la solicitud

Nombre	Tipo	Description
_links	ReferenceLinks	Vincular referencias a recursos REST relacionados.
attributes	object	Diccionario que tiene atributos de nodo, como la fecha de inicio y finalización de los nodos de iteración.
children	WorkItemClassificationNode[]	Lista de nodos secundarios capturados.
hasChildren	boolean	Marca que indica si el nodo de clasificación tiene nodos secundarios.
id	integer	Identificador entero del nodo de clasificación.
identifier	string	Identificador GUID del nodo de clasificación.
name	string	Nombre del nodo de clasificación.
path	string	Ruta de acceso del nodo de clasificación.
structureType	TreeNodeStructureType	Tipo de estructura de nodo.
url	string

Respuestas

Nombre	Tipo	Description
200 OK	WorkItemClassificationNode	operación correcta

Seguridad

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

Nombre	Description
vso.work_write	Concede la capacidad de leer, crear y actualizar elementos de trabajo y consultas, actualizar metadatos del panel, leer áreas de lectura e iteraciones rutas de acceso a otros metadatos relacionados de seguimiento de elementos de trabajo, ejecutar consultas y recibir notificaciones sobre eventos de elementos de trabajo a través de enlaces de servicio.

Ejemplos

Create an area

Create an iteration

Move an area node

Move an iteration node

Create an area

Sample Request

HTTP

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

{
  "name": "Web"
}

Sample Response

Status code:: 201

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

HTTP

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

Status code:: 201

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

HTTP

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

{
  "id": 126391
}

Sample Response

Status code:: 200

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

HTTP

POST https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/classificationnodes/{structureGroup}?api-version=7.1-preview.2

{
  "id": 126392
}

Sample Response

Status code:: 200

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

Definiciones

Nombre	Description
ReferenceLinks	Clase que representa una colección de vínculos de referencia de REST.
TreeNodeStructureType	Tipo de estructura de nodo.
TreeStructureGroup	Grupo de estructura del nodo de clasificación, área o iteración.
WorkItemClassificationNode	Define un nodo de clasificación para el seguimiento de elementos de trabajo.

ReferenceLinks

Clase que representa una colección de vínculos de referencia de REST.

Nombre	Tipo	Description
links	object	Vista de solo lectura de los vínculos. Dado que los vínculos de referencia son de solo lectura, solo queremos exponerlos como de solo lectura.

TreeNodeStructureType

Tipo de estructura de nodo.

Nombre	Tipo	Description
area	string	Tipo de área.
iteration	string	Tipo de iteración.

TreeStructureGroup

Grupo de estructura del nodo de clasificación, área o iteración.

Nombre	Tipo	Description
areas	string
iterations	string

WorkItemClassificationNode

Define un nodo de clasificación para el seguimiento de elementos de trabajo.

Nombre	Tipo	Description
_links	ReferenceLinks	Vincular referencias a recursos REST relacionados.
attributes	object	Diccionario que tiene atributos de nodo, como la fecha de inicio y finalización de los nodos de iteración.
children	WorkItemClassificationNode[]	Lista de nodos secundarios capturados.
hasChildren	boolean	Marca que indica si el nodo de clasificación tiene nodos secundarios.
id	integer	Identificador entero del nodo de clasificación.
identifier	string	Identificador GUID del nodo de clasificación.
name	string	Nombre del nodo de clasificación.
path	string	Ruta de acceso del nodo de clasificación.
structureType	TreeNodeStructureType	Tipo de estructura de nodo.
url	string

Compartir a través de

Classification Nodes - Create Or Update

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Seguridad

oauth2

Scopes

Ejemplos

Create an area

Sample Request

Sample Response

Create an iteration

Sample Request

Sample Response

Move an area node

Sample Request

Sample Response

Move an iteration node

Sample Request

Sample Response

Definiciones

ReferenceLinks

TreeNodeStructureType

TreeStructureGroup

WorkItemClassificationNode

Recursos adicionales