Work Item Type Categories - Get

Referencia

Service:: Work Item Tracking

API Version:: 6.0

Obtiene una categoría de tipo de elemento de trabajo específica por nombre.

GET https://dev.azure.com/{organization}/{project}/_apis/wit/workitemtypecategories/{category}?api-version=6.0

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
category	path	True	string	El nombre de la categoría
organization	path	True	string	El nombre de la organización de Azure DevOps.
project	path	True	string	Id. de proyecto o nombre del proyecto
api-version	query	True	string	Versión de la API que se va a usar. Debe establecerse en "6.0" para usar esta versión de la API.

Respuestas

Nombre	Tipo	Description
200 OK	WorkItemTypeCategory	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	Concede la capacidad de leer elementos de trabajo, consultas, paneles, rutas de acceso de área e iteraciones, y otros metadatos relacionados con el seguimiento de elementos de trabajo. También concede la capacidad de ejecutar consultas, buscar elementos de trabajo y recibir notificaciones sobre eventos de elementos de trabajo a través de enlaces de servicio.

Ejemplos

Get category by name

Sample Request

HTTP

GET https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/workitemtypecategories/{category}?api-version=6.0

Sample Response

Status code:: 200

{
  "name": "Requirement Category",
  "referenceName": "Microsoft.RequirementCategory",
  "defaultWorkItemType": {
    "name": "Product Backlog Item",
    "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItemTypes/Product%20Backlog%20Item"
  },
  "workItemTypes": [
    {
      "name": "Product Backlog Item",
      "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItemTypes/Product%20Backlog%20Item"
    }
  ],
  "url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItemTypeCategories/Microsoft.RequirementCategory"
}

Definiciones

Nombre	Description
ReferenceLinks	Clase que se va a representar una colección de vínculos de referencia de REST.
WorkItemTypeCategory	Describe una categoría de tipo de elemento de trabajo.
WorkItemTypeReference	Referencia a un tipo de elemento de trabajo.

ReferenceLinks

Clase que se va a representar una colección de vínculos de referencia de REST.

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

WorkItemTypeCategory

Describe una categoría de tipo de elemento de trabajo.

Nombre	Tipo	Description
_links	ReferenceLinks	Vincular referencias a recursos REST relacionados.
defaultWorkItemType	WorkItemTypeReference	Obtiene o establece el tipo predeterminado del elemento de trabajo.
name	string	Nombre de la categoría.
referenceName	string	Nombre de referencia de la categoría.
url	string
workItemTypes	WorkItemTypeReference[]	Tipos de elemento de trabajo que pertenecen a la categoría.

WorkItemTypeReference

Referencia a un tipo de elemento de trabajo.

Nombre	Tipo	Description
name	string	Nombre del tipo de elemento de trabajo.
url	string

Compartir a través de