Partager via


Work Items - Get Work Item Template

Retourne un seul élément de travail à partir d’un modèle.

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

Paramètres URI

Nom Dans Obligatoire Type Description
organization
path True

string

Nom de l’organisation Azure DevOps.

project
path True

string

ID de projet ou nom du projet

type
path True

string

Nom du type d’élément de travail

api-version
query True

string

Version de l’API à utiliser. Cette valeur doit être définie sur « 4.1 » pour utiliser cette version de l’API.

$expand
query

WorkItemExpand

Paramètres de développement pour les attributs d’élément de travail. Les options possibles sont { None, Relations, Fields, Links, All }.

asOf
query

string

date-time

Chaîne d’heure de date UTC AsOf

fields
query

string

Liste des champs demandés séparés par des virgules

Réponses

Nom Type Description
200 OK

WorkItem

opération réussie

Sécurité

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

Nom Description
vso.work Accorde la possibilité de lire des éléments de travail, des requêtes, des tableaux, des chemins de zone et d’itérations et d’autres métadonnées associées au suivi des éléments de travail. Accorde également la possibilité d’exécuter des requêtes et de recevoir des notifications sur les événements d’élément de travail via des hooks de service.

Définitions

Nom Description
ReferenceLinks

Classe pour représenter une collection de liens de référence REST.

WorkItem

Décrit un élément de travail.

WorkItemExpand

Paramètres de développement pour les attributs d’élément de travail. Les options possibles sont { None, Relations, Fields, Links, All }.

WorkItemRelation

Classe pour représenter une collection de liens de référence REST.

Nom Type Description
links

object

Vue en lecture seule des liens. Étant donné que les liens référence sont en lecture seule, nous voulons uniquement les exposer en lecture seule.

WorkItem

Décrit un élément de travail.

Nom Type Description
_links

ReferenceLinks

Lier des références à des ressources REST associées.

fields

object

Carte du champ et des valeurs de l’élément de travail.

id

integer

ID de l’élément de travail.

relations

WorkItemRelation[]

Relations de l’élément de travail.

rev

integer

Numéro de révision de l’élément de travail.

url

string

WorkItemExpand

Paramètres de développement pour les attributs d’élément de travail. Les options possibles sont { None, Relations, Fields, Links, All }.

Nom Type Description
all

string

fields

string

links

string

none

string

relations

string

WorkItemRelation

Nom Type Description
attributes

object

Collection d’attributs de lien.

rel

string

Type de relation.

url

string

URL du lien.