defect-links Collection

Description

The collection of links to and from defects.

URL

/qcbin/rest/domains/{domain}/projects/{project}/defect-links

Remarks

To find defect-link from a specific defect, query for /defect-links?query={first-endpoint-id[<defect ID>]}.

Defect links between two defects are not directional. There is no importance to which defect is identified with first-endpoint-id and which is identified with second-endpoint-id. Therefore, query defect-links?query={second-endpoint-type[defect];second-endpoint-id[1]} returns all defect-links between two defects where defect 1 is at either end of the link.

When creating a new link, pass an XML string compliant with the Entity Schema.  To find the required fields, GET
/qcbin/rest/domains/{domain}/projects/{project}
  /customization/entities/defect-link/fields?required=true

Note that although the POST is on the collection, you get the fields on defect-link in the singular.

On successful creation, the resource returns HTTP 201 and the XML that represents the new entity.

HTTP Methods

GET: Returns the collection of defect links.

PUT: N/A

DELETE: N/A

POST: Creates a new defect link.

Media Type
GET
PUT
DELETE
POST
application/xml
check
-
-
check
application/json
check
-
-
check

Returns

One of the HTTP Return Codes.

An XML string compliant with the Entities Collection Schema or a string containing the collection data in another supported format.

Examples

GET defect-links Example

POST defect-links XML

See Also

Query a Collection of Entities
Create an Entity