Compartir a través de

Classification Nodes - Update

  • Referencia
Servicio:
Work Item Tracking
Versión de la API:
7.1

Actualice un nodo de clasificación existente.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
organization
 path True

string

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" 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 (int32)

Identificador entero del nodo de clasificación.
identifier

string (uuid)

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

Tipo: oauth2
Flujo: accessCode
Dirección URL de autorización: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Dirección URL del token: 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

Ámbitos

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

Ejemplos

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

Change an iteration's dates

Solicitud de ejemplo

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

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

Respuesta de muestra

status code:
200 
{
  "id": 126392,
  "identifier": "a5c68379-3258-4d62-971c-71c1c459336e",
  "name": "Ultimate iteration",
  "structureType": "iteration",
  "hasChildren": false,
  "path": "\\fabrikam\\fiber\\tfvc\\area",
  "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

Solicitud de ejemplo

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

{
  "name": "Website team"
}

Respuesta de muestra

status code:
200 
{
  "id": 126391,
  "identifier": "25450731-5178-4044-84f0-0a0ebdef0c33",
  "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/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

Solicitud de ejemplo

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

{
  "name": "Ultimate iteration"
}

Respuesta de muestra

status code:
200 
{
  "id": 126392,
  "identifier": "8677aa7d-2f4a-4f53-8f0f-b84a23997f70",
  "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/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"
}

Definiciones

Nombre Description
ReferenceLinks

Clase que representa una colección de vínculos de referencia 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.
Object

Clase que representa una colección de vínculos de referencia 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

Enumeración

Tipo de estructura de nodo.

Valor Description
area

Tipo de área.
iteration

Tipo de iteración.

TreeStructureGroup

Enumeración

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

Valor Description
areas
iterations

WorkItemClassificationNode

Object

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 (int32)

Identificador entero del nodo de clasificación.
identifier

string (uuid)

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