entaxy-public/documentation/core/system-managment/Users-manual-System-management.adoc

837 lines
34 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

= Руководство по управлению коннекторами и профилями в шине.
рофиль(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>
----