Получение связи между двумя CI

Для чтения конкретной связи CI используйте следующий URL:

http://<servername>:<portnumber>/api/cmdb/cirelationships/CI Name 1<->CI Name 2/

Если вы читаете конкретную связь CI — например, сервер, используемый специалистом, — на локальном сервере с портом 8080, URL должен иметь следующий вид:

http://localhost:8080/api/cmdb/cirelationships/connector.iad8.amazon.com<->dlf-1w.printer-1/

Основные положения:

Имя операции "read" должно передаваться как «атрибут POST» с ключом "OPERATION_NAME".
Ключ специалиста должен передаваться как «атрибут POST» с ключом "TECHNICIAN_KEY

Иллюстрация 1: Получение связи между CI

Примечание:

Если формат результата не указан, API вернёт данные в JSON формате.

Параметр Result Format — необязательный. Задаёт формат возвращаемых данных (XML или JSON).

Иллюстрация 2: Получение связи между CI

Обязательные параметры:

Символ между двумя CI обязателен
CI Name1 — обязательный. CI Name может не учитывать регистр.

Пример XML результата для связи между двумя CI: Здесь веб-сервер connector.iad8.amazon.com связан с принтером dlf-1w.printer-1.

<?xml version="1.0" encoding="UTF-8"?>

<API version="1.0">

    <response>

            <result>

                <statuscode>200</statuscode>

                <status>Success</status>

                <message>Successfully fetched.</message>

                <created-date>Mar 22, 2013 12:51 PM</created-date>

                       <relationships for="connector.iad8.amazon.com">

                                   <relationship>

                                    <name>Connected to</name>

                                        <ci>

                                              <type>Printer</type>

                                               <name>dlf-1w.printer-1</name>

                                               <relattributes/>

                                         </ci>

                                   </relationship>

                       </relationships>

            </result>

    </response>

</API>

Пример Ответ JSON:

{

    "API": {

        "response": {

            "result": {

                "created-date": "Sep 2, 2013 03:05 PM",

                "message": "Successfully fetched.",

                "status": "Success",

                "statuscode": "200",

                "relationships": {

                    "relationship": {

                        "ci": {

                            "type": "Switch Ports",

                            "name": "connector.iad8.amazon.com"

                        },

                        "name": "Connected to"

                    },

                    "for": "DLF11thFloor-I.csez.zohocorpin.com"

                }

            }

        },

        "operation": {

            "name": "read"

        },

        "version": "1.0"

    }

}