ES
Español
English
Português
    Eliminar Relaciones

    Detalles de la petición

    • URL Base: {host}/ASMSAPI/
    • Uri: api/v9/ci/{id}/{relatedItemType}/{relatedItemId}/relation?isReverse={isReverse}&relationTypeId={relationTypeId}
    • Tipo: DELETE

    • Encabezados requeridos:

      • Content-Type: application/json
      • X-Authorization: Bearer {token}

    Descripción de la URL

    • {host}: Representa el dominio del ambiente en el que se encuentra la API.
    • ASMSAPI/: Prefijo fijo de la API.
    • Uri: Endpoint específico para la petición.


    ⚐ EJEMPLO URL:

    https://{host}/ASMSAPI/api/v9/ci/{id}/{relatedItemType}/{relatedItemId}/relation?isReverse={isReverse}&relationTypeId={relationTypeId}


    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.

    Ejemplos de uri

    Eliminar relaciones de CIs con:

    • CIs
      • api/v9/ci/147/ci/1035/relation?isReverse=true&relationTypeId=139
    • Articulos
      • api/v9/ci/147/article/58/relation?isReverse=true&relationTypeId=137

    Cuerpo de la petición

    N/A

    Respuesta

    El servicio retorna un Json con la siguiente información:

    { “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 \r\nNombre del parámetro: ItemType
    400 BadRequest \r\nNombre del parámetro: RelatedItemId
    400 BadRequest \r\nNombre del parámetro: RelatedItemtype
    400 BadRequest RequestNeedsSomeArguments
    403 Forbidden DoNotHavePermissionForThisAction
    500 InternalServerError FailureDeleteRelatedItem