Detalles de la petición
-
Uri: /api/v9/ci/{id}/relation
-
Tipo: POST
-
Encabezados requeridos:
- content-type: application/json
- X-Authorization: Bearer {token}
Parámetros:
| Nombre | Tipo de dato | Obligatorio | Descripción |
|---|---|---|---|
| id | Número | Si | Identificador del ci. |
| itemType | Texto | Si | Tipo de item. |
| relatedItemType | Texto | Si | Tipo de item a relacionar (Incidents, Problem, Change, Release, ServiceCall, Task, Maintenance, Ci, Packages, Contract, Invoice, OtherDocument, Article.) |
| relatedItemId | Número | Si | Identificador del ítem a relacionar. |
| relationTypeId | Número | Si | Identificador del tipo de relación. |
| typeIsReverse | bool | Si | Identificador para determinar si el CI principal con la que se establece la relación es padre o hijo. |
Cuerpo de la petición
Ejemplo de relación de **CI** con **CI**. {
"id": 147,
"itemType": "ci",
"relatedItemId": 1035,
"relatedItemType": "ci",
"relationTypeId": 139,
"typeIsReverse": true
}
Ejemplo de cuerpo de la relación de ***CI*** con ***Article***: {
"id": 147,
"itemType": "ci",
"relatedItemId": 58,
"relatedItemType": "article",
"relationTypeId": 137,
"typeIsReverse": true
}
*Respuesta*
{
"result": true
}
Parámetros Response
| Nombre | Tipo de dato | Descripción |
|---|---|---|
| result | Booleano | Indica si la operación se realizó con éxito |
Mensajes de error
| Código | Estado HTTP | Mensaje de error |
|---|---|---|
| 400 | BadRequest | \r\nNombre del parámetro: Id |
| 400 | BadRequest | InvalidItemType |
| 400 | BadRequest | InvalidRelatedItemId |
| 400 | BadRequest | InvalidRelatedItemType |
| 400 | BadRequest | InvalidRelationTypeId |
| 400 | BadRequest | InvalidProjectId |
| 400 | BadRequest | RequestNeedsSomeArguments |
| 403 | Forbidden | DoNotHavePermissionForThisAction |
| 500 | InternalServerError | FailureAddRelatedItem |