다음을 통해 공유


Work Items - Delete

지정된 작업 항목을 삭제하고 휴지통으로 보내 필요한 경우 다시 복원할 수 있도록 합니다. 필요에 따라 destroy 매개 변수가 true로 설정된 경우 작업 항목이 영구적으로 삭제됩니다. 경고: destroy 매개 변수가 true로 설정된 경우 이 명령에 의해 삭제된 작업 항목은 휴지통으로 이동하지 않으며 삭제 후 복원/복구할 방법이 없습니다. 이 매개 변수를 사용하지 않는 것이 좋습니다. 이 경우 이 매개 변수를 매우 주의해서 사용하세요.

DELETE https://dev.azure.com/{organization}/{project}/_apis/wit/workitems/{id}?api-version=7.1-preview.3
DELETE https://dev.azure.com/{organization}/{project}/_apis/wit/workitems/{id}?destroy={destroy}&api-version=7.1-preview.3

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
id
path True

integer

int32

삭제할 작업 항목의 ID

organization
path True

string

Azure DevOps 조직의 이름입니다.

project
path

string

프로젝트 ID 또는 프로젝트 이름

api-version
query True

string

사용할 API의 버전입니다. 이 버전의 api를 사용하려면 '7.1-preview.3'으로 설정해야 합니다.

destroy
query

boolean

선택적 매개 변수인 true로 설정하면 작업 항목이 영구적으로 삭제됩니다. 참고: 삭제 작업은 영구이며 실행 취소할 수 없습니다.

응답

Name 형식 Description
200 OK

WorkItemDelete

성공한 작업

보안

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

Name Description
vso.work_write 작업 항목 및 쿼리를 읽고, 만들고, 업데이트하고, 보드 메타데이터, 읽기 영역 및 반복 경로를 다른 작업 항목이 관련 메타데이터를 추적하고, 쿼리를 실행하고, 서비스 후크를 통해 작업 항목 이벤트에 대한 알림을 받을 수 있는 기능을 부여합니다.

예제

Sample Request

DELETE https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/wit/workitems/{id}?api-version=7.1-preview.3

Sample Response

정의

Name Description
ReferenceLinks

REST 참조 링크의 컬렉션을 나타내는 클래스입니다.

WorkItem

작업 항목을 설명합니다.

WorkItemCommentVersionRef

작업 항목에 대한 특정 버전의 주석에 대한 참조를 나타냅니다.

WorkItemDelete

전체 삭제된 작업 항목 개체입니다. 작업 항목 자체를 포함합니다.

WorkItemRelation

REST 참조 링크의 컬렉션을 나타내는 클래스입니다.

Name 형식 Description
links

object

링크의 읽기 전용 보기입니다. 참조 링크는 읽기 전용이므로 읽기 전용으로만 노출하려고 합니다.

WorkItem

작업 항목을 설명합니다.

Name 형식 Description
_links

ReferenceLinks

관련 REST 리소스에 대한 참조를 연결합니다.

commentVersionRef

WorkItemCommentVersionRef

이 수정 버전에서 추가/편집/삭제된 특정 버전의 주석에 대한 참조입니다.

fields

object

작업 항목에 대한 필드 및 값의 맵입니다.

id

integer

작업 항목 ID입니다.

relations

WorkItemRelation[]

작업 항목의 관계입니다.

rev

integer

작업 항목의 수정 번호입니다.

url

string

WorkItemCommentVersionRef

작업 항목에 대한 특정 버전의 주석에 대한 참조를 나타냅니다.

Name 형식 Description
commentId

integer

주석에 할당된 ID입니다.

createdInRevision

integer

[내부] 이 주석이 원래 추가된 작업 항목 수정 버전입니다.

isDeleted

boolean

[내부] 주석이 삭제되었는지 여부를 지정합니다.

text

string

[내부] 주석의 텍스트입니다.

url

string

version

integer

버전 번호입니다.

WorkItemDelete

전체 삭제된 작업 항목 개체입니다. 작업 항목 자체를 포함합니다.

Name 형식 Description
code

integer

일괄 처리 요청의 작업 항목 작업에 대한 HTTP 상태 코드입니다.

deletedBy

string

작업 항목 유형을 삭제한 사용자입니다.

deletedDate

string

작업 항목 삭제 날짜입니다.

id

integer

작업 항목 ID입니다.

message

string

일괄 처리 요청의 작업 항목 작업에 대한 예외 메시지입니다.

name

string

작업 항목의 이름 또는 제목입니다.

project

string

삭제된 작업 항목의 부모 프로젝트입니다.

resource

WorkItem

삭제된 작업 항목 개체입니다.

type

string

작업 항목의 유형입니다.

url

string

리소스의 REST API URL

WorkItemRelation

Name 형식 Description
attributes

object

링크 특성의 컬렉션입니다.

rel

string

관계 유형입니다.

url

string

링크 URL입니다.