Share via


Work Items - Get Work Item Template

Restituisce un singolo elemento di lavoro da un modello.

GET https://dev.azure.com/{organization}/{project}/_apis/wit/workitems/${type}?api-version=4.1
GET https://dev.azure.com/{organization}/{project}/_apis/wit/workitems/${type}?fields={fields}&asOf={asOf}&$expand={$expand}&api-version=4.1

Parametri dell'URI

Nome In Necessario Tipo Descrizione
organization
path True

string

Nome dell'organizzazione di Azure DevOps.

project
path True

string

ID progetto o nome progetto

type
path True

string

Nome del tipo di elemento di lavoro

api-version
query True

string

Versione dell'API da usare. Questa opzione deve essere impostata su '4.1' per usare questa versione dell'API.

$expand
query

WorkItemExpand

Parametri di espansione per gli attributi dell'elemento di lavoro. Le opzioni possibili sono { Nessuna, Relazioni, Campi, Collegamenti, Tutti }.

asOf
query

string

date-time

Stringa di ora della data UTC AsOf

fields
query

string

Elenco delimitato da virgole di campi richiesti

Risposte

Nome Tipo Descrizione
200 OK

WorkItem

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, schede, aree e percorsi iterazioni e altri metadati correlati al rilevamento degli elementi di lavoro. Concede inoltre la possibilità di eseguire query e di ricevere notifiche sugli eventi dell'elemento di lavoro tramite hook del servizio.

Definizioni

Nome Descrizione
ReferenceLinks

Classe da rappresentare una raccolta di collegamenti di riferimento REST.

WorkItem

Descrive un elemento di lavoro.

WorkItemExpand

Parametri di espansione per gli attributi dell'elemento di lavoro. Le opzioni possibili sono { Nessuna, Relazioni, Campi, Collegamenti, Tutti }.

WorkItemRelation

Classe da rappresentare una raccolta di collegamenti di riferimento REST.

Nome Tipo Descrizione
links

object

Visualizzazione di lettura dei collegamenti. Poiché i collegamenti di riferimento sono in sola lettura, si vuole esporre solo i collegamenti di riferimento come sola lettura.

WorkItem

Descrive un elemento di lavoro.

Nome Tipo Descrizione
_links

ReferenceLinks

Riferimenti ai collegamenti alle risorse REST correlate.

fields

object

Mappa di campi e valori per l'elemento di lavoro.

id

integer

ID elemento di lavoro.

relations

WorkItemRelation[]

Relazioni dell'elemento di lavoro.

rev

integer

Numero di revisione dell'elemento di lavoro.

url

string

WorkItemExpand

Parametri di espansione per gli attributi dell'elemento di lavoro. Le opzioni possibili sono { Nessuna, Relazioni, Campi, Collegamenti, Tutti }.

Nome Tipo Descrizione
all

string

fields

string

links

string

none

string

relations

string

WorkItemRelation

Nome Tipo Descrizione
attributes

object

Raccolta di attributi di collegamento.

rel

string

Tipo di relazione.

url

string

URL di collegamento.