837 lines
34 KiB
Plaintext
837 lines
34 KiB
Plaintext
= Руководство по управлению коннекторами и профилями в шине.
|
||
|
||
_Профиль(profile)_ - это описание внешней системы в шине.(Например s1).
|
||
|
||
_Мостовой профиль(bridge-profile)_ - это профиль на другой стороне шины, ведущий через мост в профиль.
|
||
(Например s1)
|
||
|
||
_Коннектор(connector)_ - это связь между интерфейсом, через который может работать система, и профилем.(Например uniform-service, nsi)
|
||
|
||
_Доступ(permission)_ - это разрешение на взаимодействие двух систем.(Например для того чтобы система s1 смогла отправить сообщение s2)(/permission-management)
|
||
|
||
_Учетная запись(account)_ - это учетная запись системы для взаимодействия с шиной.
|
||
Для каждой системы должна быть учетная запись для возможности отправления сообщений в шину.
|
||
Также есть учетные записи для возможности взаимодействия с управленческим слоем(т. е. для того чтобы управлять коннекторами/профилями/учетными записями/топиками нужна учетная запись с соответствующими правами)(/basic-auth-management)
|
||
|
||
Коннекторы делятся на входящие и исходящие(in, out), которые отвечают за отправку сообщения в определенный интерфейс и на получение ответа из определенного интерфейса соответственно.
|
||
Например, для того чтобы иметь возможность отправить сообщение в soap нужно создать коннектор uniform-service-in-connector, а для того чтобы получить сообщение из soap нужно создать коннектор uniform-service-out-connector.
|
||
|
||
По адресу _/system-management-service_ находится сам сервис управления коннекторами и профилями в шине.
|
||
|
||
Для работы внешней системы в шине нужно сначала создать профиль данной системы в шине, потом добавлять к нему необходимые коннекторы и пробрасывать его в необходимые шины.
|
||
|
||
=== Управление профилями
|
||
|
||
*СreateProfile.*
|
||
|
||
Для создания профиля системы нужно вызвать метод createProfile, где вместо “system_uuid” нужно подставить uuid системы, вместо “system_name” - имя системы, “description” описание системы:
|
||
|
||
[source,xml]
|
||
----
|
||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sys="http://www.entaxy.ru/system-management-service/">
|
||
<soapenv:Header/>
|
||
<soapenv:Body>
|
||
<sys:createProfileRequest>
|
||
<sys:profileName>{{system_uuid}}</sys:profileName>
|
||
<sys:uuid>{{system_uuid}}</sys:uuid>
|
||
<!--Optional:-->
|
||
<sys:description>{{description}}</sys:description>
|
||
</sys:createProfileRequest>
|
||
</soapenv:Body>
|
||
|
||
</soapenv:Envelope>
|
||
----
|
||
|
||
Где ответом будет (“true” - если профиль успешно создался, ошибка и ее описание):
|
||
|
||
[source,xml]
|
||
----
|
||
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
|
||
<soap:Body>
|
||
<response xmlns="http://www.entaxy.ru/system-management-service/">true</response>
|
||
</soap:Body>
|
||
</soap:Envelope>
|
||
----
|
||
|
||
*GetProfile.*
|
||
|
||
Проверить созданный профиль можно с помощью метода getProfile, где вместо “system_uuid” нужно подставить uuid системы:
|
||
|
||
[source,xml]
|
||
----
|
||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sys="http://www.entaxy.ru/system-management-service/">
|
||
<soapenv:Header/>
|
||
<soapenv:Body>
|
||
<sys:getProfileRequest>
|
||
<sys:uuid>{{system_uuid}}</sys:uuid>
|
||
</sys:getProfileRequest>
|
||
</soapenv:Body>
|
||
</soapenv:Envelope>
|
||
----
|
||
|
||
Где ответом будет (профиль со всеми зависимостями, либо ошибка и ее описание):
|
||
|
||
[source,xml]
|
||
----
|
||
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
|
||
<soap:Body>
|
||
<fullProfileType xmlns="http://www.entaxy.ru/system-management-service/">
|
||
<profileName>w6</profileName>
|
||
<uuid>w6</uuid>
|
||
<description>description</description>
|
||
<createDate>2020-01-22+03:00</createDate>
|
||
<createdBy>System</createdBy>
|
||
<type>false</type>
|
||
<status>ACTIVE</status>
|
||
<connectorList/>
|
||
<esbNames/>
|
||
</fullProfileType>
|
||
</soap:Body>
|
||
</soap:Envelope>
|
||
----
|
||
|
||
*GetProfiles*
|
||
|
||
Получить список профилей, зарегистрированных в шине, можно с помощью метода getProfiles:
|
||
|
||
[source,xml]
|
||
----
|
||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sys="http://www.entaxy.ru/system-management-service/">
|
||
<soapenv:Header/>
|
||
<soapenv:Body>
|
||
<sys:listProfileRequest/>
|
||
</soapenv:Body>
|
||
</soapenv:Envelope>
|
||
----
|
||
|
||
Где ответом будет (список профилей со всеми зависимостями, либо ошибка и ее описание):
|
||
|
||
[source,xml]
|
||
----
|
||
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
|
||
<soap:Body>
|
||
<listProfile xmlns="http://www.entaxy.ru/system-management-service/">
|
||
<fullProfileType>
|
||
<profileName>w6</profileName>
|
||
<uuid>w6</uuid>
|
||
<description>description</description>
|
||
<createDate>2020-01-22+03:00</createDate>
|
||
<createdBy>System</createdBy>
|
||
<type>false</type>
|
||
<status>ACTIVE</status>
|
||
<connectorList/>
|
||
<esbNames/>
|
||
</fullProfileType>
|
||
</listProfile>
|
||
</soap:Body>
|
||
</soap:Envelope>
|
||
----
|
||
|
||
*StopProfile*
|
||
|
||
Остановить профиль и все его зависимости можно с помощью метода stopProfile, где вместо “system_uuid” нужно подставить uuid системы:
|
||
|
||
[source,xml]
|
||
----
|
||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sys="http://www.entaxy.ru/system-management-service/">
|
||
<soapenv:Header/>
|
||
<soapenv:Body>
|
||
<sys:stopProfileRequest>
|
||
<sys:uuid>{{system_uuid}}</sys:uuid>
|
||
</sys:stopProfileRequest>
|
||
</soapenv:Body>
|
||
</soapenv:Envelope>
|
||
----
|
||
|
||
Где ответом будет (“true” - если профиль и его зависимости успешно остановились, ошибка и ее описание):
|
||
|
||
[source,xml]
|
||
----
|
||
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
|
||
<soap:Body>
|
||
<response xmlns="http://www.entaxy.ru/system-management-service/">true</response>
|
||
</soap:Body>
|
||
</soap:Envelope>
|
||
----
|
||
|
||
*StartProfile*
|
||
|
||
Запустить профиль и все его зависимости можно с помощью метода startProfile, где вместо “system_uuid” нужно подставить uuid системы:
|
||
|
||
[source,xml]
|
||
----
|
||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sys="http://www.entaxy.ru/system-management-service/">
|
||
<soapenv:Header/>
|
||
<soapenv:Body>
|
||
<sys:stopProfileRequest>
|
||
<sys:uuid>{{system_uuid}}</sys:uuid>
|
||
</sys:stopProfileRequest>
|
||
</soapenv:Body>
|
||
</soapenv:Envelope>
|
||
----
|
||
|
||
Где ответом будет (“true” - если профиль успешно запустился, ошибка и ее описание):
|
||
|
||
[source,xml]
|
||
----
|
||
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
|
||
<soap:Body>
|
||
<response xmlns="http://www.entaxy.ru/system-management-service/">true</response>
|
||
</soap:Body>
|
||
</soap:Envelope>
|
||
----
|
||
|
||
*RemoveProfile*
|
||
|
||
Удалить профиль и все его зависимости можно с помощью метода removeProfile, где вместо “system_uuid” нужно подставить uuid системы(ВНИМАНИЕ!
|
||
При удалении профиля также удаляются все связанные с ним коннекторы):
|
||
|
||
[source,xml]
|
||
----
|
||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sys="http://www.entaxy.ru/system-management-service/">
|
||
<soapenv:Header/>
|
||
<soapenv:Body>
|
||
<sys:stopProfileRequest>
|
||
<sys:uuid>{{system_uuid}}</sys:uuid>
|
||
</sys:stopProfileRequest>
|
||
</soapenv:Body>
|
||
</soapenv:Envelope>
|
||
----
|
||
|
||
Где ответом будет (“true” - если профиль и его зависимости успешно удалился, ошибка и ее описание):
|
||
|
||
[source,xml]
|
||
----
|
||
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
|
||
<soap:Body>
|
||
<response xmlns="http://www.entaxy.ru/system-management-service/">true</response>
|
||
</soap:Body>
|
||
</soap:Envelope>
|
||
----
|
||
|
||
=== Управление коннекторами
|
||
|
||
*GetTemplates*
|
||
|
||
Для создания коннектора в шине нужно получить список шаблонов(требуются для создания коннекторов) методом getTemplates:
|
||
|
||
[source,xml]
|
||
----
|
||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sys="http://www.entaxy.ru/system-management-service/">
|
||
<soapenv:Header/>
|
||
<soapenv:Body>
|
||
<sys:listTemplateRequest/>
|
||
</soapenv:Body>
|
||
</soapenv:Envelope>
|
||
----
|
||
|
||
Где ответом будет (список шаблонов с параметрами):
|
||
|
||
[source,xml]
|
||
----
|
||
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
|
||
<soap:Body>
|
||
<listTemplate xmlns="http://www.entaxy.ru/system-management-service/">
|
||
<template>
|
||
<templateName>file-out-connector</templateName>
|
||
<paramList>
|
||
<param>
|
||
<name>directionTo</name>
|
||
<value>file-to</value>
|
||
</param>
|
||
</paramList>
|
||
</template>
|
||
<template>
|
||
<templateName>nsi-in-connector</templateName>
|
||
<paramList/>
|
||
</template>
|
||
<template>
|
||
<templateName>uniform-service-in-connector</templateName>
|
||
<paramList/>
|
||
</template>
|
||
<template>
|
||
<templateName>uniform-service-out-connector</templateName>
|
||
<paramList>
|
||
<param>
|
||
<name>isActive</name>
|
||
<value>false</value>
|
||
</param>
|
||
<param>
|
||
<name>queue</name>
|
||
<value>soap-root-default</value>
|
||
</param>
|
||
</paramList>
|
||
</template>
|
||
</listTemplate>
|
||
</soap:Body>
|
||
</soap:Envelope>
|
||
----
|
||
|
||
*GetTemplate*
|
||
|
||
Для создания коннектора в шине нужно получить список шаблонов(требуются для создания коннекторов) методом getTemplate, где “template_name” имя шаблона по которому будет сделан коннектор:
|
||
|
||
[source,xml]
|
||
----
|
||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sys="http://www.entaxy.ru/system-management-service/">
|
||
<soapenv:Header/>
|
||
<soapenv:Body>
|
||
<sys:getTemplateRequest>
|
||
<sys:templateName>{{template_name}}</sys:templateName>
|
||
</sys:getTemplateRequest>
|
||
</soapenv:Body>
|
||
</soapenv:Envelope>
|
||
----
|
||
|
||
Где ответом будет (шаблон с параметрами):
|
||
|
||
[source,xml]
|
||
----
|
||
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
|
||
<soap:Body>
|
||
<template xmlns="http://www.entaxy.ru/system-management-service/">
|
||
<templateName>nsi-in-connector</templateName>
|
||
<paramList/>
|
||
</template>
|
||
</soap:Body>
|
||
</soap:Envelope>
|
||
----
|
||
|
||
*СreateConnector*
|
||
|
||
Для создания коннектора в шине нужно вызвать метод createConnector, где templateName - это имя шаблона, полученное из метода getTemplates, system_uuid - это uuid профиля, зарегистрированного в системе ранее, также нужно заполнить список параметров необходимый для создания коннектора(ВНИМАНИЕ! если не заполнить список параметров, то установятся значения по умолчанию) :
|
||
|
||
[source,xml]
|
||
----
|
||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sys="http://www.entaxy.ru/system-management-service/">
|
||
<soapenv:Header/>
|
||
<soapenv:Body>
|
||
<sys:createConnectorRequest>
|
||
<sys:templateName>{{template_name}}</sys:templateName>
|
||
<sys:profileUuid>{{system_uuid}}</sys:profileUuid>
|
||
<sys:paramList>
|
||
<!--Zero or more repetitions:-->
|
||
</sys:paramList>
|
||
</sys:createConnectorRequest>
|
||
</soapenv:Body>
|
||
</soapenv:Envelope>
|
||
----
|
||
|
||
Где ответом будет (“true” - если коннектор успешно создался, ошибка и ее описание):
|
||
|
||
[source,xml]
|
||
----
|
||
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
|
||
<soap:Body>
|
||
<response xmlns="http://www.entaxy.ru/system-management-service/">true</response>
|
||
</soap:Body>
|
||
</soap:Envelope>
|
||
----
|
||
|
||
*GetConnectors*
|
||
|
||
Можно просматривать список подключенных коннекторов в шине методом getConnectors:
|
||
|
||
[source,xml]
|
||
----
|
||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sys="http://www.entaxy.ru/system-management-service/">
|
||
<soapenv:Header/>
|
||
<soapenv:Body>
|
||
<sys:listConnectorRequest/>
|
||
</soapenv:Body>
|
||
</soapenv:Envelope>
|
||
----
|
||
|
||
Где ответом будет (список коннкторов с параметрами):
|
||
|
||
[source,xml]
|
||
----
|
||
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
|
||
<soap:Body>
|
||
<listConnector xmlns="http://www.entaxy.ru/system-management-service/">
|
||
<connector>
|
||
<name>nsi-in-connector-w6</name>
|
||
<status>ACTIVE</status>
|
||
<paramList/>
|
||
</connector>
|
||
</listConnector>
|
||
</soap:Body>
|
||
</soap:Envelope>
|
||
----
|
||
|
||
*StartConnector*
|
||
|
||
Запустить коннектор можно с помощью метода startConnector, где вместо “system_uuid” нужно подставить uuid системы, “template_name” это имя шаблона:
|
||
|
||
[source,xml]
|
||
----
|
||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sys="http://www.entaxy.ru/system-management-service/">
|
||
<soapenv:Header/>
|
||
<soapenv:Body>
|
||
<sys:startConnectorRequest>
|
||
<sys:templateName>{{template_name}}</sys:templateName>
|
||
<sys:profileUuid>{{system_uuid}}</sys:profileUuid>
|
||
</sys:startConnectorRequest>
|
||
</soapenv:Body>
|
||
</soapenv:Envelope>
|
||
----
|
||
|
||
Где ответом будет (“true” - если коннектор успешно запустился, ошибка и ее описание):
|
||
|
||
[source,xml]
|
||
----
|
||
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
|
||
<soap:Body>
|
||
<response xmlns="http://www.entaxy.ru/system-management-service/">true</response>
|
||
</soap:Body>
|
||
</soap:Envelope>
|
||
----
|
||
|
||
*StopConnector*
|
||
|
||
Остановить коннектор можно с помощью метода stopConnector, где вместо “system_uuid” нужно подставить uuid системы, “template_name” это имя шаблона:
|
||
|
||
[source,xml]
|
||
----
|
||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sys="http://www.entaxy.ru/system-management-service/">
|
||
<soapenv:Header/>
|
||
<soapenv:Body>
|
||
<sys:stopConnectorRequest>
|
||
<sys:templateName>{{template_name}}</sys:templateName>
|
||
<sys:profileUuid>{{system_uuid}}</sys:profileUuid>
|
||
</sys:stopConnectorRequest>
|
||
</soapenv:Body>
|
||
</soapenv:Envelope>
|
||
----
|
||
|
||
Где ответом будет (“true” - если коннектор успешно остановилась, ошибка и ее описание):
|
||
|
||
[source,xml]
|
||
----
|
||
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
|
||
<soap:Body>
|
||
<response xmlns="http://www.entaxy.ru/system-management-service/">true</response>
|
||
</soap:Body>
|
||
</soap:Envelope>
|
||
----
|
||
|
||
*RemoveConnector*
|
||
|
||
Удалить коннектор можно с помощью метода removeConnector, где вместо “system_uuid” нужно подставить uuid системы, “template_name” это имя шаблона:
|
||
|
||
[source,xml]
|
||
----
|
||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sys="http://www.entaxy.ru/system-management-service/">
|
||
<soapenv:Header/>
|
||
<soapenv:Body>
|
||
<sys:removeConnectorRequest>
|
||
<sys:templateName>{{template_name}}</sys:templateName>
|
||
<sys:profileUuid>{{system_uuid}}</sys:profileUuid>
|
||
</sys:removeConnectorRequest>
|
||
</soapenv:Body>
|
||
</soapenv:Envelope>
|
||
----
|
||
|
||
Где ответом будет (“true” - если коннектор успешно удалился, ошибка и ее описание):
|
||
|
||
[source,xml]
|
||
----
|
||
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
|
||
<soap:Body>
|
||
<response xmlns="http://www.entaxy.ru/system-management-service/">true</response>
|
||
</soap:Body>
|
||
</soap:Envelope>
|
||
----
|
||
|
||
=== Управление мостовыми профилями
|
||
|
||
*GetListEsb*
|
||
|
||
Для получения списка подключенных шин можно с помощью метода getListEsb:
|
||
|
||
[source,xml]
|
||
----
|
||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sys="http://www.entaxy.ru/system-management-service/">
|
||
<soapenv:Header/>
|
||
<soapenv:Body>
|
||
<sys:listEsbRequest/>
|
||
</soapenv:Body>
|
||
</soapenv:Envelope>
|
||
----
|
||
|
||
Где ответом будет (список подключенных шин, ошибка и ее описание):
|
||
|
||
[source,xml]
|
||
----
|
||
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
|
||
<soap:Body>
|
||
<listEsb xmlns="http://www.entaxy.ru/system-management-service/">
|
||
<esbName>test1</esbName>
|
||
</listEsb>
|
||
</soap:Body>
|
||
</soap:Envelope>
|
||
----
|
||
|
||
*CreateBridgeProfile*
|
||
|
||
Создать профиль, ведущий на мост, можно с помощью метода createBridgeProfile, где “system_uuid” uuid системы, “esb_name” имя подключенной шины:
|
||
|
||
[source,xml]
|
||
----
|
||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sys="http://www.entaxy.ru/system-management-service/">
|
||
<soapenv:Header/>
|
||
<soapenv:Body>
|
||
<sys:createBridgeProfileRequest>
|
||
<sys:profileUuid>{{system_uuid}}</sys:profileUuid>
|
||
<sys:profileName>{{system_uuid}}</sys:profileName>
|
||
<sys:esbName>{{esb_name}}</sys:esbName>
|
||
</sys:createBridgeProfileRequest>
|
||
</soapenv:Body>
|
||
</soapenv:Envelope>
|
||
----
|
||
|
||
Где ответом будет (“true” - если профиль, ведущий на мост, успешно создался, ошибка и ее описание):
|
||
|
||
[source,xml]
|
||
----
|
||
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
|
||
<soap:Body>
|
||
<response xmlns="http://www.entaxy.ru/system-management-service/">true</response>
|
||
</soap:Body>
|
||
</soap:Envelope>
|
||
----
|
||
|
||
*StopBridgeProfile*
|
||
|
||
Остановить профиль, ведущий на мост, можно с помощью метода stopBridgeProfile, где “system_uuid” uuid системы, “esb_name” имя подключенной шины:
|
||
|
||
[source,xml]
|
||
----
|
||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sys="http://www.entaxy.ru/system-management-service/">
|
||
<soapenv:Header/>
|
||
<soapenv:Body>
|
||
<sys:stopBridgeProfileRequest>
|
||
<sys:profileUuid>{{system_uuid}}</sys:profileUuid>
|
||
<sys:profileName>{{system_uuid}}</sys:profileName>
|
||
<sys:esbName>{{esb_name}}</sys:esbName>
|
||
</sys:stopBridgeProfileRequest>
|
||
</soapenv:Body>
|
||
</soapenv:Envelope>
|
||
----
|
||
|
||
Где ответом будет (“true” - если профиль, ведущий на мост, успешно остановился, ошибка и ее описание):
|
||
|
||
[source,xml]
|
||
----
|
||
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
|
||
<soap:Body>
|
||
<response xmlns="http://www.entaxy.ru/system-management-service/">true</response>
|
||
</soap:Body>
|
||
</soap:Envelope>
|
||
----
|
||
|
||
*StartBridgeProfile*
|
||
|
||
Запустить профиль, ведущий на мост, можно с помощью метода startBridgeProfile, где “system_uuid” uuid системы, “esb_name” имя подключенной шины:
|
||
|
||
[source,xml]
|
||
----
|
||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sys="http://www.entaxy.ru/system-management-service/">
|
||
<soapenv:Header/>
|
||
<soapenv:Body>
|
||
<sys:startBridgeProfileRequest>
|
||
<sys:profileUuid>{{system_uuid}}</sys:profileUuid>
|
||
<sys:profileName>{{system_uuid}}</sys:profileName>
|
||
<sys:esbName>{{esb_name}}</sys:esbName>
|
||
</sys:startBridgeProfileRequest>
|
||
</soapenv:Body>
|
||
</soapenv:Envelope>
|
||
----
|
||
|
||
Где ответом будет (“true” - если профиль, ведущий на мост, успешно запустился, ошибка и ее описание):
|
||
|
||
[source,xml]
|
||
----
|
||
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
|
||
<soap:Body>
|
||
<response xmlns="http://www.entaxy.ru/system-management-service/">true</response>
|
||
</soap:Body>
|
||
</soap:Envelope>
|
||
----
|
||
|
||
*GetBridgeProfile*
|
||
|
||
Получить профиль, ведущий на мост, можно с помощью метода getBridgeProfile, где “system_uuid” uuid системы, “esb_name” имя подключенной шины:
|
||
|
||
[source,xml]
|
||
----
|
||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sys="http://www.entaxy.ru/system-management-service/">
|
||
<soapenv:Header/>
|
||
<soapenv:Body>
|
||
<sys:getBridgeProfileRequest>
|
||
<sys:profileUuid>{{system_uuid}}</sys:profileUuid>
|
||
<sys:profileName>{{system_uuid}}</sys:profileName>
|
||
<sys:esbName>{{esb_name}}</sys:esbName>
|
||
</sys:getBridgeProfileRequest>
|
||
</soapenv:Body>
|
||
</soapenv:Envelope>
|
||
----
|
||
|
||
Где ответом будет (профиль, ведущий на мост, пустой ответ):
|
||
|
||
[source,xml]
|
||
----
|
||
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
|
||
<soap:Body>
|
||
<fullBridgeProfileType xmlns="http://www.entaxy.ru/system-management-service/">
|
||
<profileName>w6</profileName>
|
||
<status>ACTIVE</status>
|
||
<esbName>test1</esbName>
|
||
</fullBridgeProfileType>
|
||
</soap:Body>
|
||
</soap:Envelope>
|
||
----
|
||
|
||
*RemoveBridgeProfile*
|
||
|
||
Удалить профиль, ведущий на мост, можно с помощью метода removeBridgeProfile, где “system_uuid” uuid системы, “esb_name” имя подключенной шины:
|
||
|
||
[source,xml]
|
||
----
|
||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sys="http://www.entaxy.ru/system-management-service/">
|
||
<soapenv:Header/>
|
||
<soapenv:Body>
|
||
<sys:removeBridgeProfileRequest>
|
||
<sys:profileUuid>{{system_uuid}}</sys:profileUuid>
|
||
<sys:profileName>{{system_uuid}}</sys:profileName>
|
||
<sys:esbName>{{esb_name}}</sys:esbName>
|
||
</sys:removeBridgeProfileRequest>
|
||
</soapenv:Body>
|
||
</soapenv:Envelope>
|
||
----
|
||
|
||
Где ответом будет (“true” - если профиль, ведущий на мост, успешно удален, ошибка и ее описание):
|
||
|
||
[source,xml]
|
||
----
|
||
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
|
||
<soap:Body>
|
||
<response xmlns="http://www.entaxy.ru/system-management-service/">true</response>
|
||
</soap:Body>
|
||
</soap:Envelope>
|
||
----
|
||
|
||
*GetBridgeProfiles*
|
||
|
||
Для получения списка профилей, ведущих на мост, можно использовать метод getBridgeProfiles:(ВНИМАНИЕ! запрос покажет список проброшенных профилей на ТЕКУЩЕЙ шине)
|
||
|
||
[source,xml]
|
||
----
|
||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sys="http://www.entaxy.ru/system-management-service/">
|
||
<soapenv:Header/>
|
||
<soapenv:Body>
|
||
<sys:getBridgeProfilesRequest/>
|
||
</soapenv:Body>
|
||
</soapenv:Envelope>
|
||
----
|
||
|
||
Где ответом будет (список профиль, ведущих на мост, пустой ответ):
|
||
|
||
[source,xml]
|
||
----
|
||
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
|
||
<soap:Body>
|
||
<getBridgeProfilesResponse xmlns="http://www.entaxy.ru/system-management-service/">
|
||
<fullBridgeProfileType>
|
||
<profileName>w6</profileName>
|
||
<status>ACTIVE</status>
|
||
<esbName>test1</esbName>
|
||
</fullBridgeProfileType>
|
||
</getBridgeProfilesResponse>
|
||
</soap:Body>
|
||
</soap:Envelope>
|
||
----
|
||
|
||
=== Управление доступами
|
||
|
||
*CreatePermission*
|
||
|
||
Создать доступ одной системы к другой, можно с помощью метода createPermission, где “objectUuid” uuid системы, которой нужно дать доступ, “subjectUuid” - uuid системы, к которой нужно дать доступ:
|
||
|
||
[source,xml]
|
||
----
|
||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sys="http://www.entaxy.ru/system-management-service/">
|
||
<soapenv:Header/>
|
||
<soapenv:Body>
|
||
<sys:createPermissionRequest>
|
||
<sys:objectUuid>{{objectUuid}}</sys:objectUuid>
|
||
<sys:subjectUuid>{{subjectUuid}}</sys:subjectUuid>
|
||
</sys:createPermissionRequest>
|
||
</soapenv:Body>
|
||
</soapenv:Envelope>
|
||
----
|
||
|
||
Где ответом будет (“true” - если доступ, успешно создался, ошибка и ее описание):
|
||
|
||
[source,xml]
|
||
----
|
||
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
|
||
<soap:Body>
|
||
<response xmlns="http://www.entaxy.ru/system-management-service/">true</response>
|
||
</soap:Body>
|
||
</soap:Envelope>
|
||
----
|
||
|
||
*RemovePermission*
|
||
|
||
Удалить доступ одной системы к другой, можно с помощью метода removePermission, где “objectUuid” uuid системы, которой нужно дать доступ, “subjectUuid” - uuid системы, к которой нужно дать доступ:
|
||
|
||
[source,xml]
|
||
----
|
||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sys="http://www.entaxy.ru/system-management-service/">
|
||
<soapenv:Header/>
|
||
<soapenv:Body>
|
||
<sys:removePermissionRequest>
|
||
<sys:objectUuid>{{objectUuid}}</sys:objectUuid>
|
||
<sys:subjectUuid>{{subjectUuid}}</sys:subjectUuid>
|
||
</sys:removePermissionRequest>
|
||
</soapenv:Body>
|
||
</soapenv:Envelope>
|
||
----
|
||
|
||
Где ответом будет (“true” - если доступ, успешно удалился, ошибка и ее описание):
|
||
|
||
[source,xml]
|
||
----
|
||
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
|
||
<soap:Body>
|
||
<response xmlns="http://www.entaxy.ru/system-management-service/">true</response>
|
||
</soap:Body>
|
||
</soap:Envelope>
|
||
----
|
||
|
||
*GetPermissionsByObject*
|
||
|
||
Получить список систем, доступ к которым от данной системы разрешен, можно с помощью метода getPermissionByObject, где “objectUuid” uuid системы:
|
||
|
||
[source,xml]
|
||
----
|
||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sys="http://www.entaxy.ru/system-management-service/">
|
||
<soapenv:Header/>
|
||
<soapenv:Body>
|
||
<sys:getPermissionsByObjectRequest>
|
||
<sys:uuid>{{objectUuid}}</sys:uuid>
|
||
</sys:getPermissionsByObjectRequest>
|
||
</soapenv:Body>
|
||
</soapenv:Envelope>
|
||
----
|
||
|
||
Где ответом будет (список систем, которым данная система может отправлять сообщения, ошибка и ее описание):
|
||
|
||
[source,xml]
|
||
----
|
||
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
|
||
<soap:Body>
|
||
<getPermissionsByObjectResponse xmlns="http://www.entaxy.ru/system-management-service/">
|
||
<profileType>
|
||
<uuid>r2</uuid>
|
||
</profileType>
|
||
<profileType>
|
||
<uuid>active</uuid>
|
||
</profileType>
|
||
</getPermissionsByObjectResponse>
|
||
</soap:Body>
|
||
</soap:Envelope>
|
||
----
|
||
|
||
*GetPermissionsBySubject*
|
||
|
||
Получить список систем, доступ которым разрешен к данной системе, можно с помощью метода getPermissionBySubject, где “subjectUuid” uuid системы:
|
||
|
||
[source,xml]
|
||
----
|
||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sys="http://www.entaxy.ru/system-management-service/">
|
||
<soapenv:Header/>
|
||
<soapenv:Body>
|
||
<sys:getPermissionsBySubjectRequest>
|
||
<sys:uuid>{{subjectUuid}}</sys:uuid>
|
||
</sys:getPermissionsBySubjectRequest>
|
||
</soapenv:Body>
|
||
</soapenv:Envelope>
|
||
----
|
||
|
||
Где ответом будет (список систем, для которых данная система доступна для отправки сообщений, ошибка и ее описание):
|
||
|
||
[source,xml]
|
||
----
|
||
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
|
||
<soap:Body>
|
||
<getPermissionsBySubjectResponse xmlns="http://www.entaxy.ru/system-management-service/">
|
||
<profileType>
|
||
<uuid>r2</uuid>
|
||
</profileType>
|
||
</getPermissionsBySubjectResponse>
|
||
</soap:Body>
|
||
</soap:Envelope>
|
||
----
|
||
|
||
*CreatePermissionForObjectRequest*
|
||
|
||
Создать сразу несколько доступов, которым разрешено отправлять сообщения от данной системы, можно с помощью метода сreatePermissionForObjectRequest, где “objectUuid” это uuid системы, от которой буду исходить сообщения, ‘“subjectUuid1”, “subjectUuid2” и т д, это uuid систем, которым будут отправлять сообщения:
|
||
|
||
[source,xml]
|
||
----
|
||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sys="http://www.entaxy.ru/system-management-service/">
|
||
<soapenv:Header/>
|
||
<soapenv:Body>
|
||
<sys:createPermissionForObjectRequest>
|
||
<sys:objectUuid>{{objectUuid}}</sys:objectUuid>
|
||
<!--Zero or more repetitions:-->
|
||
<sys:subjectUuid>{{subjectUuid1}}</sys:subjectUuid>
|
||
<sys:subjectUuid>{{subjectUuid2}}</sys:subjectUuid>
|
||
</sys:createPermissionForObjectRequest>
|
||
</soapenv:Body>
|
||
</soapenv:Envelope>
|
||
----
|
||
|
||
Где ответом будет (“true” - если доступа, успешно создались, ошибка и ее описание):
|
||
|
||
[source,xml]
|
||
----
|
||
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
|
||
<soap:Body>
|
||
<response xmlns="http://www.entaxy.ru/system-management-service/">true</response>
|
||
</soap:Body>
|
||
</soap:Envelope>
|
||
----
|
||
|
||
*CreatePermissionForSubjectRequest*
|
||
|
||
Создать сразу несколько доступов, которым разрешено отправлять сообщения в данную систему, можно с помощью метода сreatePermissionForSubjectRequest, где “objectUuid1”, “objectUuid2” и т д - это uuid систем, от которых буду исходить сообщения, ‘“subjectUuid” - это uuid системы, которой будут отправлять сообщения:
|
||
|
||
[source,xml]
|
||
----
|
||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sys="http://www.entaxy.ru/system-management-service/">
|
||
<soapenv:Header/>
|
||
<soapenv:Body>
|
||
<sys:createPermissionForSubjectRequest>
|
||
<!--Zero or more repetitions:-->
|
||
<sys:objectUuid>{{objectUuid1}}</sys:objectUuid>
|
||
<sys:objectUuid>{{objectUuid2}}</sys:objectUuid>
|
||
<sys:subjectUuid>{{subjectUuid}}</sys:subjectUuid>
|
||
</sys:createPermissionForSubjectRequest>
|
||
</soapenv:Body>
|
||
</soapenv:Envelope>
|
||
----
|
||
|
||
Где ответом будет (“true” - если доступа, успешно создались, ошибка и ее описание):
|
||
|
||
[source,xml]
|
||
----
|
||
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
|
||
<soap:Body>
|
||
<response xmlns="http://www.entaxy.ru/system-management-service/">true</response>
|
||
</soap:Body>
|
||
</soap:Envelope>
|
||
----
|