Recyclebin - Restore Work Item
Restaura o item de trabalho excluído da Lixeira.
PATCH https://dev.azure.com/{organization}/{project}/_apis/wit/recyclebin/{id}?api-version=7.1-preview.2
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
id
|
path | True |
integer int32 |
ID do item de trabalho a ser restaurado |
organization
|
path | True |
string |
O nome da organização do Azure DevOps. |
project
|
path |
string |
ID do projeto ou nome do projeto |
|
api-version
|
query | True |
string |
Versão da API a ser usada. Isso deve ser definido como '7.1-preview.2' para usar essa versão da API. |
Corpo da solicitação
Nome | Tipo | Description |
---|---|---|
isDeleted |
boolean |
Define um valor que indica se este item de trabalho é excluído. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
operação bem-sucedida |
Segurança
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 | Description |
---|---|
vso.work_write | Concede a capacidade de ler, criar e atualizar itens de trabalho e consultas, atualizar metadados do quadro, ler caminhos de área e iterações de outros itens de trabalho que acompanham metadados relacionados, executar consultas e receber notificações sobre eventos de item de trabalho por meio de ganchos de serviço. |
Exemplos
Restore a work item
Sample Request
PATCH https://dev.azure.com/{organization}/_apis/wit/recyclebin/403?api-version=7.1-preview.2
{
"isDeleted": false
}
Sample Response
{
"id": 403,
"code": 200,
"type": "Bug",
"name": "Test bug to be deleted and then restored",
"project": "Fabrikam-Fiber-Git",
"deletedDate": "1/11/2017 11:18:16 PM",
"deletedBy": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/403",
"resource": {
"id": 403,
"rev": 3,
"fields": {
"System.AreaPath": "Fabrikam-Fiber-Git",
"System.TeamProject": "Fabrikam-Fiber-Git",
"System.IterationPath": "Fabrikam-Fiber-Git\\Release 1\\Sprint 2",
"System.WorkItemType": "Bug",
"System.State": "New",
"System.Reason": "New defect reported",
"System.CreatedDate": "2017-01-11T23:14:16.37Z",
"System.CreatedBy": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
"System.ChangedDate": "2017-01-11T23:18:16.03Z",
"System.ChangedBy": "Jamal Hartnett <fabrikamfiber4@hotmail.com>",
"System.Title": "Test bug to be deleted and then restored",
"System.BoardColumn": "New",
"System.BoardColumnDone": false,
"Microsoft.VSTS.Common.StateChangeDate": "2017-01-11T23:14:16.37Z",
"Microsoft.VSTS.Common.Priority": 2,
"Microsoft.VSTS.Common.Severity": "3 - Medium",
"WEF_6CB513B6E70E43499D9FC94E5BBFB784_Kanban.Column": "New",
"WEF_6CB513B6E70E43499D9FC94E5BBFB784_Kanban.Column.Done": false,
"Microsoft.VSTS.Common.ValueArea": "Business"
},
"_links": {
"self": {
"href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/403"
},
"workItemUpdates": {
"href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/403/updates"
},
"workItemRevisions": {
"href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/403/revisions"
},
"workItemHistory": {
"href": "https://dev.azure.com/fabrikam/_apis/wit/workItems/403/history"
},
"html": {
"href": "https://dev.azure.com/fabrikam/web/wi.aspx?pcguid=d81542e4-cdfa-4333-b082-1ae2d6c3ad16&id=403"
},
"workItemType": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/_apis/wit/workItemTypes/Bug"
},
"fields": {
"href": "https://dev.azure.com/fabrikam/_apis/wit/fields"
}
},
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/403"
}
}
Definições
Nome | Description |
---|---|
Reference |
A classe para representar uma coleção de links de referência REST. |
Work |
Descreve um item de trabalho. |
Work |
Representa a referência a uma versão específica de um comentário em um Item de Trabalho. |
Work |
Objeto de item de trabalho excluído completo. Inclui o item de trabalho em si. |
Work |
Descreve uma solicitação de atualização para um item de trabalho excluído. |
Work |
ReferenceLinks
A classe para representar uma coleção de links de referência REST.
Nome | Tipo | Description |
---|---|---|
links |
object |
A exibição somente leitura dos links. Como os links de referência são somente leitura, só queremos expô-los como somente leitura. |
WorkItem
Descreve um item de trabalho.
Nome | Tipo | Description |
---|---|---|
_links |
Vincular referências a recursos REST relacionados. |
|
commentVersionRef |
Referência a uma versão específica do comentário adicionado/editado/excluído nesta revisão. |
|
fields |
object |
Mapa de campos e valores para o item de trabalho. |
id |
integer |
O ID do item de trabalho. |
relations |
Relações do item de trabalho. |
|
rev |
integer |
Número de revisão do item de trabalho. |
url |
string |
WorkItemCommentVersionRef
Representa a referência a uma versão específica de um comentário em um Item de Trabalho.
Nome | Tipo | Description |
---|---|---|
commentId |
integer |
A ID atribuída ao comentário. |
createdInRevision |
integer |
[Interno] A revisão do item de trabalho em que este comentário foi originalmente adicionado. |
isDeleted |
boolean |
[Interno] Especifica se o comentário foi excluído. |
text |
string |
[Interno] O texto do comentário. |
url |
string |
|
version |
integer |
O número de versão. |
WorkItemDelete
Objeto de item de trabalho excluído completo. Inclui o item de trabalho em si.
Nome | Tipo | Description |
---|---|---|
code |
integer |
O código http status para a operação de item de trabalho em uma solicitação em lote. |
deletedBy |
string |
O usuário que excluiu o tipo de item de trabalho. |
deletedDate |
string |
A data de exclusão do item de trabalho. |
id |
integer |
ID do item de trabalho. |
message |
string |
A mensagem de exceção para a operação de item de trabalho em uma solicitação em lote. |
name |
string |
Nome ou título do item de trabalho. |
project |
string |
Projeto pai do item de trabalho excluído. |
resource |
O objeto de item de trabalho que foi excluído. |
|
type |
string |
Tipo de item de trabalho. |
url |
string |
URL da API REST do recurso |
WorkItemDeleteUpdate
Descreve uma solicitação de atualização para um item de trabalho excluído.
Nome | Tipo | Description |
---|---|---|
isDeleted |
boolean |
Define um valor que indica se este item de trabalho é excluído. |
WorkItemRelation
Nome | Tipo | Description |
---|---|---|
attributes |
object |
Coleção de atributos de link. |
rel |
string |
Tipo de relação. |
url |
string |
Url do link. |
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de