Work Item Type Categories - Get

Riferimento

Service:: Work Item Tracking

API Version:: 7.1-preview.2

Ottiene una categoria specifica del tipo di elemento di lavoro in base al nome.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
category	path	True	string	Nome della categoria
organization	path	True	string	Nome dell'organizzazione di Azure DevOps.
project	path	True	string	ID progetto o nome del progetto
api-version	query	True	string	Versione dell'API da usare. Deve essere impostato su '7.1-preview.2' per usare questa versione dell'API.

Risposte

Nome	Tipo	Descrizione
200 OK	WorkItemTypeCategory	operazione riuscita

Sicurezza

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

Nome	Descrizione
vso.work	Concede la possibilità di leggere elementi di lavoro, query, bacheche, percorsi di aree e iterazioni e altri metadati correlati al rilevamento degli elementi di lavoro. Concede inoltre la possibilità di eseguire query, cercare elementi di lavoro e ricevere notifiche sugli eventi degli elementi di lavoro tramite hook del servizio.

Esempio

Get category by name

Sample Request

HTTP

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

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

Definizioni

Nome	Descrizione
ReferenceLinks	Classe per rappresentare una raccolta di collegamenti di riferimento REST.
WorkItemTypeCategory	Descrive una categoria di tipi di elemento di lavoro.
WorkItemTypeReference	Riferimento a un tipo di elemento di lavoro.

ReferenceLinks

Classe per rappresentare una raccolta di collegamenti di riferimento REST.

Nome	Tipo	Descrizione
links	object	Visualizzazione di sola lettura dei collegamenti. Poiché i collegamenti di riferimento sono di sola lettura, è consigliabile esporli solo come di sola lettura.

WorkItemTypeCategory

Descrive una categoria di tipi di elemento di lavoro.

Nome	Tipo	Descrizione
_links	ReferenceLinks	Collegare i riferimenti alle risorse REST correlate.
defaultWorkItemType	WorkItemTypeReference	Ottiene o imposta il tipo predefinito dell'elemento di lavoro.
name	string	Nome della categoria.
referenceName	string	Nome di riferimento della categoria.
url	string
workItemTypes	WorkItemTypeReference[]	Tipi di elemento di lavoro che appartengono alla categoria.

WorkItemTypeReference

Riferimento a un tipo di elemento di lavoro.

Nome	Tipo	Descrizione
name	string	Nome del tipo di elemento di lavoro.
url	string

Share via