RPC API documentation v44.0.0

Back to Documentation Version:  General How to use RPC Managers AttributesManagerAuditMessagesManagerAuthzResolverCabinetManagerConfigManagerConsentsManagerDatabaseManagerExtSourcesManagerFacilitiesManagerGroupsManagerIntegrationManagerInvitationsManagerMembersManagerNotificationManagerOwnersManagerRTMessagesManagerRegistrarManagerResourcesManagerSearcherSecurityTeamsManagerServicesManagerTasksManagerUsersManagerVosManager

ServicesManager

Adds an destination for a facility and service. If destination doesn't exist it will be created.

Parameter nameData typeDescription
serviceintService id
facilityintFacility id
destinationStringDestination
typeStringDestination type (host,user@host,user@host:port,url,mail,service-specific,s3)
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
DestinationCreated destination.

Example URL

https://[hostname]/krb/rpc/json/servicesManager/addDestination

Example params

{ "service" : 21 , "facility" : 34 , "destination" : "text" , "type" : "text" }

Example response

{ "id" : 99 , "destination" : "host@host.cz" , "type" : "HOST" , "propagationType" : "PARALLEL" }

Adds an destination for a facility and list of services. If destination doesn't exist it will be created.

Parameter nameData typeDescription
servicesList<Service>Services
facilityintFacility id
destinationStringDestination
typeStringDestination type (host,user@host,user@host:port,url,mail,service-specific,s3)
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
DestinationCreated destination.

Example URL

https://[hostname]/krb/rpc/json/servicesManager/addDestination

Example params

{ "services" : [ { "id" : 290 , "name" : "passwd" , "description" : "Provision /etc/passwd file." , "delay" : 10 , "recurrence" : 2 , "enabled" : true , "script" : "./passwd" , "useExpiredMembers" : false , "useExpiredVoMembers" : false } , {...} , {...} ] , "facility" : 76 , "destination" : "text" , "type" : "text" }

Example response

{ "id" : 99 , "destination" : "host@host.cz" , "type" : "HOST" , "propagationType" : "PARALLEL" }

Adds an destination for a facility and service. If destination doesn't exist it will be created.

Parameter nameData typeDescription
serviceintService id
facilityintFacility id
destinationStringDestination
typeStringDestination type (host,user@host,user@host:port,url,mail,service-specific,s3)
propagationTypeStringpropagation type (PARALLEL, DUMMY - doesn't send data)
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
DestinationCreated destination.

Example URL

https://[hostname]/krb/rpc/json/servicesManager/addDestination

Example params

{ "service" : 40 , "facility" : 53 , "destination" : "text" , "type" : "text" , "propagationType" : "text" }

Example response

{ "id" : 99 , "destination" : "host@host.cz" , "type" : "HOST" , "propagationType" : "PARALLEL" }

Adds an destination for a facility and list of services. If destination doesn't exist it will be created.

Parameter nameData typeDescription
servicesList<Service>Services
facilityintFacility id
destinationStringDestination
typeStringDestination type (host,user@host,user@host:port,url,mail,service-specific,s3)
propagationTypeStringpropagation type (PARALLEL, DUMMY - doesn't send data)
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
DestinationCreated destination.

Example URL

https://[hostname]/krb/rpc/json/servicesManager/addDestination

Example params

{ "services" : [ { "id" : 290 , "name" : "passwd" , "description" : "Provision /etc/passwd file." , "delay" : 10 , "recurrence" : 2 , "enabled" : true , "script" : "./passwd" , "useExpiredMembers" : false , "useExpiredVoMembers" : false } , {...} , {...} ] , "facility" : 67 , "destination" : "text" , "type" : "text" , "propagationType" : "text" }

Example response

{ "id" : 99 , "destination" : "host@host.cz" , "type" : "HOST" , "propagationType" : "PARALLEL" }

Add services destinations for all services currently available on facility (assigned to all facility's resources). Destinations names are taken from all facility's host hostnames.

Parameter nameData typeDescription
serviceintService id
facilityintFacility id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
List<Destinations>Added destinations

Example URL

https://[hostname]/krb/rpc/json/servicesManager/addDestinationsDefinedByHostsOnFacility

Example params

{ "service" : 88 , "facility" : 93 }

Example response

{ ... TODO ... }

Add services destinations for list of services. Destinations names are taken from all facility's host hostnames.

Parameter nameData typeDescription
servicesList<Service>Services
facilityintFacility id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
List<Destinations>Added destinations

Example URL

https://[hostname]/krb/rpc/json/servicesManager/addDestinationsDefinedByHostsOnFacility

Example params

{ "services" : [ { "id" : 290 , "name" : "passwd" , "description" : "Provision /etc/passwd file." , "delay" : 10 , "recurrence" : 2 , "enabled" : true , "script" : "./passwd" , "useExpiredMembers" : false , "useExpiredVoMembers" : false } , {...} , {...} ] , "facility" : 52 }

Example response

{ ... TODO ... }

Add services destinations for one service. Destinations names are taken from all facility's host hostnames.

Parameter nameData typeDescription
facilityintFacility id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
List<Destinations>Added destinations

Example URL

https://[hostname]/krb/rpc/json/servicesManager/addDestinationsDefinedByHostsOnFacility

Example params

{ "facility" : 78 }

Example response

{ ... TODO ... }

Adds destination for all services defined on the facility.

Parameter nameData typeDescription
facilityintFacility id
destinationStringDestination
typeStringString Destination type (host,user@host,user@host:port,url,mail,service-specific,s3)
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
List<Destinations>Added destinations

Example URL

https://[hostname]/krb/rpc/json/servicesManager/addDestinationsForAllServicesOnFacility

Example params

{ "facility" : 56 , "destination" : "text" , "type" : "text" }

Example response

{ ... TODO ... }

Adds destination for all services defined on the facility.

Parameter nameData typeDescription
facilityintFacility id
destinationStringDestination
typeStringDestination type (host,user@host,user@host:port,url,mail,service-specific,s3)
propagationTypeStringpropagation type (PARALLEL, DUMMY - doesn't send data)
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
List<Destinations>Added destinations

Example URL

https://[hostname]/krb/rpc/json/servicesManager/addDestinationsForAllServicesOnFacility

Example params

{ "facility" : 33 , "destination" : "text" , "type" : "text" , "propagationType" : "text" }

Example response

{ ... TODO ... }

Mark the attribute as required for the service. Required attributes are requisite for Service to run. If you add attribute which has a default attribute then this default attribute will be automatically add too.

Parameter nameData typeDescription
serviceintService id
attributeintAttribute id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
ServiceAttributesCannotExtendif trying to add user-related attribute that could invalidate consents, requires disabling service
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/addRequiredAttribute

Example params

{ "service" : 20 , "attribute" : 78 }

Example response

null

Batch version of addRequiredAttribute.

Parameter nameData typeDescription
serviceintService id
attributesint[]Attribute IDs
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
ServiceAttributesCannotExtendif trying to add user-related attribute that could invalidate consents, requires disabling service
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/addRequiredAttributes

Example params

{ "service" : 20 , "attributes" : [ 57 , 13 ] }

Example response

null

Adds a Service to a Services Package.

Parameter nameData typeDescription
servicesPackageintServices package id to which the service supposed to be added
serviceintService id to be added to the services package
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/addServiceToServicesPackage

Example params

{ "servicesPackage" : 61 , "service" : 88 }

Example response

null

Block all services currently assigned on this destination. Newly assigned services are still allowed for propagation.

Parameter nameData typeDescription
destinationintDestination id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/blockAllServicesOnDestination

Example params

{ "destination" : 2 }

Example response

null

Block all services currently assigned on this destination. Newly assigned services are still allowed for propagation.

Parameter nameData typeDescription
destinationNameStringDestination name (like hostnames)
destinationTypeStringDestination type (like host, user@host, user@host:port, email, service-specific, s3 ...)
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/blockAllServicesOnDestination

Example params

{ "destinationName" : "text" , "destinationType" : "text" }

Example response

null

Block all services currently assigned on this facility. Newly assigned services are still allowed for propagation.

Parameter nameData typeDescription
facilityintFacility id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/blockAllServicesOnFacility

Example params

{ "facility" : 95 }

Example response

null

Bans Service on a destination.

Parameter nameData typeDescription
serviceintService id
destinationintDestination id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/blockServiceOnDestination

Example params

{ "service" : 38 , "destination" : 76 }

Example response

null

Bans Service on a destination.

Parameter nameData typeDescription
serviceintService id
destinationNameStringDestination name (like hostnames)
destinationTypeStringDestination type (like host, user@host, user@host:port, email, service-specific, s3 ...)
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/blockServiceOnDestination

Example params

{ "service" : 96 , "destinationName" : "text" , "destinationType" : "text" }

Example response

null

Bans service on a facility.

Parameter nameData typeDescription
serviceintService id
facilityintFacility id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
ServiceAlreadyBannedExceptionWhen service is already banned on facility.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/blockServiceOnFacility

Example params

{ "service" : 34 , "facility" : 8 }

Example response

null

Bans the Service on the destination - each pair defined by the rich destination. It wouldn't be possible to execute the given Service on this destination, however, it still can be executed on all the other destinations in the facility.

Parameter nameData typeDescription
serviceintService id
richDestinationsList<RichDestination>the list of rich destinations
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/blockServicesOnDestinations

Example params

{ "service" : 9 , "richDestinations" : [ { "id" : 99 , "destination" : "host@host.cz" , "type" : "HOST" , "propagationType" : "PARALLEL" , "service" : { "id" : 290 , "name" : "passwd" , "description" : "Provision /etc/passwd file." , "delay" : 10 , "recurrence" : 2 , "enabled" : true , "script" : "./passwd" , "useExpiredMembers" : false , "useExpiredVoMembers" : false } , "facility" : { "id" : 24 , "name" : "host.facility.cz" , "description" : "is optional" , "beanName" : "Facility" } } , {...} , {...} ] }

Example response

null

Bans services on a facility.

Parameter nameData typeDescription
servicesList<Integer>id of service
facilityintFacility id
Thrown exceptionDescription
FacilityNotExistsExceptionwhen facility does not exist
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
PrivilegeExceptioninsufficient permissions
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
ServiceAlreadyBannedExceptionwhen service is already banned on facility
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/blockServicesOnFacility

Example params

{ "services" : [ 51 , 52 ] , "facility" : 83 }

Example response

null

Creates a new service. Service object must contain name. Parameters desctiption, script, delay, recurrence, enabled are optional. Other parameters ignored.

Parameter nameData typeDescription
serviceServiceJSON object
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
ServiceCreated Service

Example URL

https://[hostname]/krb/rpc/json/servicesManager/createService

Example params

{ "service" : { "name" : "New Service"} }

Example response

{ "id" : 290 , "name" : "passwd" , "description" : "Provision /etc/passwd file." , "delay" : 10 , "recurrence" : 2 , "enabled" : true , "script" : "./passwd" , "useExpiredMembers" : false , "useExpiredVoMembers" : false }

Creates a new service.

Parameter nameData typeDescription
nameStringname
descriptionStringdescription
scriptStringscript which should be constructed like ./service_name (where anything else than [a-z,A-Z] is converted to _)
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
ServiceCreated Service

Example URL

https://[hostname]/krb/rpc/json/servicesManager/createService

Example params

{ "name" : "New Service" , "description" : "The new description with information" , "script" : "./service_name" }

Example response

{ "id" : 290 , "name" : "passwd" , "description" : "Provision /etc/passwd file." , "delay" : 10 , "recurrence" : 2 , "enabled" : true , "script" : "./passwd" , "useExpiredMembers" : false , "useExpiredVoMembers" : false }

Creates a new services package.

Parameter nameData typeDescription
servicesPackageServicesPackageJSON object.
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
ServicesPackageCreated ServicesPackage

Example URL

https://[hostname]/krb/rpc/json/servicesManager/createServicesPackage

Example params

{ "servicesPackage" : { "id" : 50 , "name" : "Unix account" , "description" : "Collection of services for managing unix accounts." } }

Example response

{ "id" : 50 , "name" : "Unix account" , "description" : "Collection of services for managing unix accounts." }

Creates a new services package.

Parameter nameData typeDescription
nameStringname
descriptionStringdescription
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
ServicesPackageCreated ServicesPackage

Example URL

https://[hostname]/krb/rpc/json/servicesManager/createServicesPackage

Example params

{ "name" : "text" , "description" : "text" }

Example response

{ "id" : 50 , "name" : "Unix account" , "description" : "Collection of services for managing unix accounts." }

Deletes a service.

Parameter nameData typeDescription
serviceintService id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/deleteService

Example params

{ "service" : 28 }

Example response

null

Deletes a service.

Parameter nameData typeDescription
serviceintService id
forcebooleanif true, service will be removed with all dependant objects from the db instead of raising exception
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/deleteService

Example params

{ "service" : 33 , "force" : true }

Example response

null

Deletes given services.

Parameter nameData typeDescription
servicesList<Service>Services
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/deleteServices

Example params

{ "services" : [ { "id" : 290 , "name" : "passwd" , "description" : "Provision /etc/passwd file." , "delay" : 10 , "recurrence" : 2 , "enabled" : true , "script" : "./passwd" , "useExpiredMembers" : false , "useExpiredVoMembers" : false } , {...} , {...} ] }

Example response

null

Deletes given services.

Parameter nameData typeDescription
servicesList<Integer>id of services
forcebooleanif true, service will be removed with all dependant objects from the db instead of raising exception
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/deleteServices

Example params

{ "services" : [ 83 , 85 ] , "force" : true }

Example response

null

Deletes a services package.

Parameter nameData typeDescription
servicesPackageintServicesPackage id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/deleteServicesPackage

Example params

{ "servicesPackage" : 0 }

Example response

null

Forces service propagation on defined facility.

Parameter nameData typeDescription
serviceintService id
facilityintFacility id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
int1 = true if it is possible, 0 = false if not

Example URL

https://[hostname]/krb/rpc/json/servicesManager/forceServicePropagation

Example params

{ "service" : 63 , "facility" : 35 }

Example response

89

Forces service propagation for defined service on all facilities.

Parameter nameData typeDescription
serviceintService id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
int1 = true if it is possible, 0 = false if not

Example URL

https://[hostname]/krb/rpc/json/servicesManager/forceServicePropagation

Example params

{ "service" : 60 }

Example response

30

Forces services propagation on defined facility.

Parameter nameData typeDescription
facilityintFacility id
servicesList<Integer>id of service
Thrown exceptionDescription
FacilityNotExistsExceptionif there is no such facility
ForceServicePropagationDisabledExceptionwhen forcing propagation is not possible
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
PrivilegeExceptioninsufficient permissions
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/forceServicePropagationBulk

Example params

{ "facility" : 18 , "services" : [ 73 , 31 ] }

Example response

null

Forces services propagation on all facilities where the services are defined on.

Parameter nameData typeDescription
servicesList<Integer>id of service
Thrown exceptionDescription
ForceServicePropagationDisabledExceptionwhen forcing propagation is not possible
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
PrivilegeExceptioninsufficient permissions
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/forceServicePropagationBulk

Example params

{ "services" : [ 96 , 83 ] }

Example response

null

Forces services propagation on all facilities for all services where hostname is used. Service must be correctly assigned, have destination matching hostname and not be blocked on any level (globally, facility, destination).

Parameter nameData typeDescription
hostnameStringhostname
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
PrivilegeExceptioninsufficient permissions
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
StringSpace separated list of forced services or error message.

Example URL

https://[hostname]/krb/rpc/json/servicesManager/forceServicePropagationForHostname

Example params

{ "hostname" : "text" }

Example response

"text"

Returns all rich destinations defined for a facility.

Parameter nameData typeDescription
facilityintFacility id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
List<RichDestination>Found RichDestinations

Example URL

https://[hostname]/krb/rpc/json/servicesManager/getAllRichDestinations

Example params

{ "facility" : 37 }

Example response

[ { "id" : 99 , "destination" : "host@host.cz" , "type" : "HOST" , "propagationType" : "PARALLEL" , "service" : { "id" : 290 , "name" : "passwd" , "description" : "Provision /etc/passwd file." , "delay" : 10 , "recurrence" : 2 , "enabled" : true , "script" : "./passwd" , "useExpiredMembers" : false , "useExpiredVoMembers" : false } , "facility" : { "id" : 24 , "name" : "host.facility.cz" , "description" : "is optional" , "beanName" : "Facility" } } , {...} , {...} ]

Returns all rich destinations defined for a service.

Parameter nameData typeDescription
serviceintService id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
List<RichDestination>Found RichDestinations

Example URL

https://[hostname]/krb/rpc/json/servicesManager/getAllRichDestinations

Example params

{ "service" : 93 }

Example response

[ { "id" : 99 , "destination" : "host@host.cz" , "type" : "HOST" , "propagationType" : "PARALLEL" , "service" : { "id" : 290 , "name" : "passwd" , "description" : "Provision /etc/passwd file." , "delay" : 10 , "recurrence" : 2 , "enabled" : true , "script" : "./passwd" , "useExpiredMembers" : false , "useExpiredVoMembers" : false } , "facility" : { "id" : 24 , "name" : "host.facility.cz" , "description" : "is optional" , "beanName" : "Facility" } } , {...} , {...} ]

Lists resources assigned to service.

Parameter nameData typeDescription
serviceintService id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
List<Resource>List of resources

Example URL

https://[hostname]/krb/rpc/json/servicesManager/getAssignedResources

Example params

{ "service" : 83 }

Example response

[ { "id" : 493 , "name" : "host1.host.cz" , "description" : "ROOT access to host1.host.cz" , "facilityId" : 24 , "voId" : 21 , "uuid" : "542d676f-99b2-4d1c-bc80-a46fd7f34e62" , "beanName" : "Resource" } , {...} , {...} ]

List all services associated with the facility (via resource).

Parameter nameData typeDescription
facilityintFacility id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
List<Service>Found services

Example URL

https://[hostname]/krb/rpc/json/servicesManager/getAssignedServices

Example params

{ "facility" : 37 }

Example response

[ { "id" : 290 , "name" : "passwd" , "description" : "Provision /etc/passwd file." , "delay" : 10 , "recurrence" : 2 , "enabled" : true , "script" : "./passwd" , "useExpiredMembers" : false , "useExpiredVoMembers" : false } , {...} , {...} ]

List all services associated with the facility and vo (via resource).

Parameter nameData typeDescription
facilityintFacility id
vointVo id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
List<Service>Found services

Example URL

https://[hostname]/krb/rpc/json/servicesManager/getAssignedServices

Example params

{ "facility" : 19 , "vo" : 29 }

Example response

[ { "id" : 290 , "name" : "passwd" , "description" : "Provision /etc/passwd file." , "delay" : 10 , "recurrence" : 2 , "enabled" : true , "script" : "./passwd" , "useExpiredMembers" : false , "useExpiredVoMembers" : false } , {...} , {...} ]

Returns a destination by its id.

Parameter nameData typeDescription
idintDestination id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
DestinationFound Destination

Example URL

https://[hostname]/krb/rpc/json/servicesManager/getDestinationById

Example params

{ "id" : 24 }

Example response

{ "id" : 99 , "destination" : "host@host.cz" , "type" : "HOST" , "propagationType" : "PARALLEL" }

Returns list of all destinations defined for the service and facility.

Parameter nameData typeDescription
serviceintService id
facilityintFacility id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
List<Destination>Found Destinations

Example URL

https://[hostname]/krb/rpc/json/servicesManager/getDestinations

Example params

{ "service" : 4 , "facility" : 80 }

Example response

[ { "id" : 99 , "destination" : "host@host.cz" , "type" : "HOST" , "propagationType" : "PARALLEL" } , {...} , {...} ]

Get list of all destinations.

Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
List<Destination>List of all destinations for session

Example URL

https://[hostname]/krb/rpc/json/servicesManager/getDestinations

Example response

[ { "id" : 99 , "destination" : "host@host.cz" , "type" : "HOST" , "propagationType" : "PARALLEL" } , {...} , {...} ]

Gets count of all destinations.

Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
intdestinations count

Example URL

https://[hostname]/krb/rpc/json/servicesManager/getDestinationsCount

Example response

13

List all destinations for all facilities which are joined by resources to the VO.

Parameter nameData typeDescription
vointVO id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
List<Destination>Found destinations

Example URL

https://[hostname]/krb/rpc/json/servicesManager/getFacilitiesDestinations

Example params

{ "vo" : 48 }

Example response

[ { "id" : 99 , "destination" : "host@host.cz" , "type" : "HOST" , "propagationType" : "PARALLEL" } , {...} , {...} ]

Return list of ServiceForGUI assigned on facility, (Service with "allowedOnFacility" property filled). 1 - allowed / 0 - service is service is denied.

Parameter nameData typeDescription
facilityintFacility id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
List<ServiceForGUI>list of assigned services with allowed property

Example URL

https://[hostname]/krb/rpc/json/servicesManager/getFacilityAssignedServicesForGUI

Example params

{ "facility" : 30 }

Example response

{ ... TODO ... }

Generates hashed data with group structure for given service and resource. Generates data in format: attributes: {...hashes...} hierarchy: { "1": { ** facility id ** members: { ** all members on the facility ** "4" : 5, ** member id : user id ** "6" : 7, ** member id : user id ** ... } children: [ "2": { ** resource id ** voId: 99, children: [ "89": { ** group id ** "children": {}, "members": { "91328": 57986, "91330": 60838 } } ], "members": { ** all members on the resource with id 2 ** "91328": 57986, "91330": 60838 } }, "3": { ... } ] } }

Parameter nameData typeDescription
serviceIntegerservice
facilityIntegerfacility
consentEvalBooleanif the generator should enforce evaluation of consents
taskRunIntegerid of the task run propagation
Thrown exceptionDescription
FacilityNotExistsExceptionif there is no such facility
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
PrivilegeExceptioninsufficient permissions
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
ServiceNotExistsExceptionif there is no such service
Return typeDescription
HashedGenDatagenerated hashed data structure

Example URL

https://[hostname]/krb/rpc/json/servicesManager/getHashedDataWithGroups

Example params

{ "service" : {...} , "facility" : {...} , "consentEval" : {...} , "taskRun" : {...} }

Example response

{ ... TODO ... }

Generates hashed data with group structure for given service and resource. Generates data in format: attributes: {...hashes...} hierarchy: { "1": { ** facility id ** members: { ** all members on the facility ** "4" : 5, ** member id : user id ** "6" : 7, ** member id : user id ** ... } children: [ "2": { ** resource id ** voId: 99, children: [ "89": { ** group id ** "children": {}, "members": { "91328": 57986, "91330": 60838 } } ], "members": { ** all members on the resource with id 2 ** "91328": 57986, "91330": 60838 } }, "3": { ... } ] } }

Parameter nameData typeDescription
serviceIntegerservice
facilityIntegerfacility
Thrown exceptionDescription
FacilityNotExistsExceptionif there is no such facility
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
PrivilegeExceptioninsufficient permissions
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
ServiceNotExistsExceptionif there is no such service
Return typeDescription
HashedGenDatagenerated hashed data structure

Example URL

https://[hostname]/krb/rpc/json/servicesManager/getHashedDataWithGroups

Example params

{ "service" : {...} , "facility" : {...} }

Example response

{ ... TODO ... }

Generates hashed hierarchical data structure for given service and facility. If enforcing consents is turned on on the instance and on the resource's consent hub, generates only the users that granted a consent to all the service required attributes. New UNSIGNED consents are created to users that don't have a consent containing all the service required attributes. attributes: {...hashes...} hierarchy: { "1": { ** facility id ** members: { ** all members on the facility ** "4" : 5, ** member id : user id ** "6" : 7, ** member id : user id ** ... } children: [ "2": { ** resource id ** children: [], voId: 99, members: { ** all members on the resource with id 2 ** "4" : 5 ** member id : user id ** } }, "3": { ... } ] } }

Parameter nameData typeDescription
serviceIntegerservice
facilityIntegerfacility
consentEvalBooleanif the generator should enforce evaluation of consents
taskRunIntegerid of the task run propagation
Thrown exceptionDescription
FacilityNotExistsExceptionif there is no such facility
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
PrivilegeExceptioninsufficient permissions
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
ServiceNotExistsExceptionif there is no such service
Return typeDescription
HashedGenDatagenerated hashed data structure

Example URL

https://[hostname]/krb/rpc/json/servicesManager/getHashedHierarchicalData

Example params

{ "service" : {...} , "facility" : {...} , "consentEval" : {...} , "taskRun" : {...} }

Example response

{ ... TODO ... }

Generates hashed hierarchical data structure for given service and facility. If enforcing consents is turned on on the instance and on the resource's consent hub, generates only the users that granted a consent to all the service required attributes. New UNSIGNED consents are created to users that don't have a consent containing all the service required attributes. attributes: {...hashes...} hierarchy: { "1": { ** facility id ** members: { ** all members on the facility ** "4" : 5, ** member id : user id ** "6" : 7, ** member id : user id ** ... } children: [ "2": { ** resource id ** children: [], voId: 99, members: { ** all members on the resource with id 2 ** "4" : 5 ** member id : user id ** } }, "3": { ... } ] } }

Parameter nameData typeDescription
serviceIntegerservice
facilityIntegerfacility
Thrown exceptionDescription
FacilityNotExistsExceptionif there is no such facility
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
PrivilegeExceptioninsufficient permissions
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
ServiceNotExistsExceptionif there is no such service
Return typeDescription
HashedGenDatagenerated hashed data structure

Example URL

https://[hostname]/krb/rpc/json/servicesManager/getHashedHierarchicalData

Example params

{ "service" : {...} , "facility" : {...} }

Example response

{ ... TODO ... }

Returns list of all rich destinations defined for the service and facility.

Parameter nameData typeDescription
serviceintService id
facilityintFacility id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
List<RichDestination>Found RichDestination

Example URL

https://[hostname]/krb/rpc/json/servicesManager/getRichDestinations

Example params

{ "service" : 32 , "facility" : 31 }

Example response

[ { "id" : 99 , "destination" : "host@host.cz" , "type" : "HOST" , "propagationType" : "PARALLEL" , "service" : { "id" : 290 , "name" : "passwd" , "description" : "Provision /etc/passwd file." , "delay" : 10 , "recurrence" : 2 , "enabled" : true , "script" : "./passwd" , "useExpiredMembers" : false , "useExpiredVoMembers" : false } , "facility" : { "id" : 24 , "name" : "host.facility.cz" , "description" : "is optional" , "beanName" : "Facility" } } , {...} , {...} ]

Returns a service by its id.

Parameter nameData typeDescription
idintService id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
ServiceFound Service

Example URL

https://[hostname]/krb/rpc/json/servicesManager/getServiceById

Example params

{ "id" : 46 }

Example response

{ "id" : 290 , "name" : "passwd" , "description" : "Provision /etc/passwd file." , "delay" : 10 , "recurrence" : 2 , "enabled" : true , "script" : "./passwd" , "useExpiredMembers" : false , "useExpiredVoMembers" : false }

Returns a service by its name.

Parameter nameData typeDescription
nameStringService Name
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
ServiceFound Service

Example URL

https://[hostname]/krb/rpc/json/servicesManager/getServiceByName

Example params

{ "name" : "text" }

Example response

{ "id" : 290 , "name" : "passwd" , "description" : "Provision /etc/passwd file." , "delay" : 10 , "recurrence" : 2 , "enabled" : true , "script" : "./passwd" , "useExpiredMembers" : false , "useExpiredVoMembers" : false }

Returns all services.

Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
List<Service>All services

Example URL

https://[hostname]/krb/rpc/json/servicesManager/getServices

Example response

[ { "id" : 290 , "name" : "passwd" , "description" : "Provision /etc/passwd file." , "delay" : 10 , "recurrence" : 2 , "enabled" : true , "script" : "./passwd" , "useExpiredMembers" : false , "useExpiredVoMembers" : false } , {...} , {...} ]

Returns list of denials for a destination.

Parameter nameData typeDescription
destinationintDestination id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
List<Service>Services

Example URL

https://[hostname]/krb/rpc/json/servicesManager/getServicesBlockedOnDestination

Example params

{ "destination" : 60 }

Example response

[ { "id" : 290 , "name" : "passwd" , "description" : "Provision /etc/passwd file." , "delay" : 10 , "recurrence" : 2 , "enabled" : true , "script" : "./passwd" , "useExpiredMembers" : false , "useExpiredVoMembers" : false } , {...} , {...} ]

Returns list of denials for a facility.

Parameter nameData typeDescription
facilityintFacility id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
List<Service>Services

Example URL

https://[hostname]/krb/rpc/json/servicesManager/getServicesBlockedOnFacility

Example params

{ "facility" : 44 }

Example response

[ { "id" : 290 , "name" : "passwd" , "description" : "Provision /etc/passwd file." , "delay" : 10 , "recurrence" : 2 , "enabled" : true , "script" : "./passwd" , "useExpiredMembers" : false , "useExpiredVoMembers" : false } , {...} , {...} ]

Get all services with given attribute.

Parameter nameData typeDescription
attributeDefinitionintattributeDefinition id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
allservices with given attribute

Example URL

https://[hostname]/krb/rpc/json/servicesManager/getServicesByAttributeDefinition

Example params

{ "attributeDefinition" : 42 }

Example response

{ ... TODO ... }

Lists services stored in a package.

Parameter nameData typeDescription
servicesPackageintServicesPackage id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
List<Service>List of services

Example URL

https://[hostname]/krb/rpc/json/servicesManager/getServicesFromServicesPackage

Example params

{ "servicesPackage" : 81 }

Example response

[ { "id" : 290 , "name" : "passwd" , "description" : "Provision /etc/passwd file." , "delay" : 10 , "recurrence" : 2 , "enabled" : true , "script" : "./passwd" , "useExpiredMembers" : false , "useExpiredVoMembers" : false } , {...} , {...} ]

Gets package by id.

Parameter nameData typeDescription
servicesPackageIdintServicesPackage id.
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
ServicesPackageFound ServicesPackage

Example URL

https://[hostname]/krb/rpc/json/servicesManager/getServicesPackageById

Example params

{ "servicesPackageId" : 61 }

Example response

{ "id" : 50 , "name" : "Unix account" , "description" : "Collection of services for managing unix accounts." }

Gets package by name.

Parameter nameData typeDescription
nameStringServicesPackage name.
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
ServicesPackageFound ServicesPackage

Example URL

https://[hostname]/krb/rpc/json/servicesManager/getServicesPackageByName

Example params

{ "name" : "text" }

Example response

{ "id" : 50 , "name" : "Unix account" , "description" : "Collection of services for managing unix accounts." }

Returns packages.

Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
List<ServicesPackage>Packages.

Example URL

https://[hostname]/krb/rpc/json/servicesManager/getServicesPackages

Example response

[ { "id" : 50 , "name" : "Unix account" , "description" : "Collection of services for managing unix accounts." } , {...} , {...} ]

Is this Service denied on the destination?

Parameter nameData typeDescription
serviceintService id
destinationintDestination id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
int1 = true - the Service is denied on the destination, 0 = false - the Service is NOT denied on the destination

Example URL

https://[hostname]/krb/rpc/json/servicesManager/isServiceBlockedOnDestination

Example params

{ "service" : 73 , "destination" : 73 }

Example response

1

Is this Service denied on the facility?

Parameter nameData typeDescription
serviceintService id
facilityintFacility id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
int1 = true - the Service is denied on the facility, 0 = false - the Service is NOT denied on the facility

Example URL

https://[hostname]/krb/rpc/json/servicesManager/isServiceBlockedOnFacility

Example params

{ "service" : 42 , "facility" : 36 }

Example response

1

Plans service propagation on defined facility.

Parameter nameData typeDescription
serviceintService id
facilityintFacility id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
int1 = true if it is possible, 0 = false if not

Example URL

https://[hostname]/krb/rpc/json/servicesManager/planServicePropagation

Example params

{ "service" : 32 , "facility" : 93 }

Example response

34

Plans service propagation on defined facility.

Parameter nameData typeDescription
serviceintService id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
int1 = true if it is possible, 0 = false if not

Example URL

https://[hostname]/krb/rpc/json/servicesManager/planServicePropagation

Example params

{ "service" : 56 }

Example response

6

Removes all destinations from a facility and service.

Parameter nameData typeDescription
serviceintService id
facilityintFacility id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/removeAllDestinations

Example params

{ "service" : 10 , "facility" : 33 }

Example response

null

Remove all required attributes from service.

Parameter nameData typeDescription
serviceintService id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/removeAllRequiredAttributes

Example params

{ "service" : 27 }

Example response

null

Removes an destination from a facility and service.

Parameter nameData typeDescription
serviceintService id
facilityintFacility id
destinationStringDestination
typeStringType
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/removeDestination

Example params

{ "service" : 42 , "facility" : 79 , "destination" : "text" , "type" : "text" }

Example response

null

Removes destinations defined by list of rich destinations. Each destination is removed from the rich destination's facility and service.

Parameter nameData typeDescription
richDestinationsList<RichDestination>list of rich destinations
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/removeDestinationsByRichDestinations

Example params

{ "richDestinations" : [ { "id" : 99 , "destination" : "host@host.cz" , "type" : "HOST" , "propagationType" : "PARALLEL" , "service" : { "id" : 290 , "name" : "passwd" , "description" : "Provision /etc/passwd file." , "delay" : 10 , "recurrence" : 2 , "enabled" : true , "script" : "./passwd" , "useExpiredMembers" : false , "useExpiredVoMembers" : false } , "facility" : { "id" : 24 , "name" : "host.facility.cz" , "description" : "is optional" , "beanName" : "Facility" } } , {...} , {...} ] }

Example response

null

Remove required attribute from service.

Parameter nameData typeDescription
serviceintService id
attributeintAttribute id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/removeRequiredAttribute

Example params

{ "service" : 21 , "attribute" : 66 }

Example response

null

Remove required attributes from service.

Parameter nameData typeDescription
serviceintService id
attributesint[]Attribute IDs
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/removeRequiredAttributes

Example params

{ "service" : 59 , "attributes" : [ 10 , 11 ] }

Example response

null

Removes a Service from a Services Package.

Parameter nameData typeDescription
servicesPackageintServices package id from which the service supposed to be removed
serviceintService id that will be removed from the services package
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/removeServiceFromServicesPackage

Example params

{ "servicesPackage" : 44 , "service" : 45 }

Example response

null

Erase all the possible denials on this destination.

Parameter nameData typeDescription
destinationintDestination id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/unblockAllServicesOnDestination

Example params

{ "destination" : 25 }

Example response

null

Erase all the possible denials on this destination.

Parameter nameData typeDescription
destinationNameStringDestination name (like hostnames)
destinationTypeStringDestination type (like host, user@host, user@host:port, email, service-specific, s3 ...)
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/unblockAllServicesOnDestination

Example params

{ "destinationName" : "text" , "destinationType" : "text" }

Example response

null

Erase all the possible denials on this facility.

Parameter nameData typeDescription
facilityintFacility id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/unblockAllServicesOnFacility

Example params

{ "facility" : 89 }

Example response

null

Free the denial of the Service on this destination. If the Service was banned on this destination, it will be freed. In case the Service was not banned on this destination, nothing will happen.

Parameter nameData typeDescription
serviceintService id
destinationintDestination id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/unblockServiceOnDestination

Example params

{ "service" : 35 , "destination" : 64 }

Example response

null

Free the denial of the Service on this destination. If the Service was banned on this destination, it will be freed. In case the Service was not banned on this destination, nothing will happen.

Parameter nameData typeDescription
serviceintService id
destinationNameStringDestination name (like hostnames)
destinationTypeStringDestination type (like host, user@host, user@host:port, email, service-specific, s3 ...)
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/unblockServiceOnDestination

Example params

{ "service" : 69 , "destinationName" : "text" , "destinationType" : "text" }

Example response

null

Free the denial of the Service on this facility. If the Service was banned on this facility, it will be freed. In case the Service was not banned on this facility, nothing will happen.

Parameter nameData typeDescription
serviceintService id
facilityintFacility id
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/unblockServiceOnFacility

Example params

{ "service" : 30 , "facility" : 4 }

Example response

null

Free the denial of the Service on the destination - each pair defined by the rich destination. If the Service was banned on the destination, it will be freed. In case the Service was not banned on the destination, nothing will happen.

Parameter nameData typeDescription
serviceintService id
richDestinationsList<RichDestination>list of rich destinations
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/unblockServicesOnDestinations

Example params

{ "service" : 20 , "richDestinations" : [ { "id" : 99 , "destination" : "host@host.cz" , "type" : "HOST" , "propagationType" : "PARALLEL" , "service" : { "id" : 290 , "name" : "passwd" , "description" : "Provision /etc/passwd file." , "delay" : 10 , "recurrence" : 2 , "enabled" : true , "script" : "./passwd" , "useExpiredMembers" : false , "useExpiredVoMembers" : false } , "facility" : { "id" : 24 , "name" : "host.facility.cz" , "description" : "is optional" , "beanName" : "Facility" } } , {...} , {...} ] }

Example response

null

Free the denial of the Service on this facility.

Parameter nameData typeDescription
servicesList<Integer>id of service
facilityintFacility id
Thrown exceptionDescription
FacilityNotExistsExceptionwhen facility does not exist
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
PrivilegeExceptioninsufficient permissions
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
ServiceIsNotBannedExceptionwhen unblocking service which is not blocked
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/unblockServicesOnFacility

Example params

{ "services" : [ 47 , 44 ] , "facility" : 38 }

Example response

null

Updates a service.

Parameter nameData typeDescription
serviceServiceJSON object
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/updateService

Example params

{ "service" : { "id" : 290 , "name" : "passwd" , "description" : "Provision /etc/passwd file." , "delay" : 10 , "recurrence" : 2 , "enabled" : true , "script" : "./passwd" , "useExpiredMembers" : false , "useExpiredVoMembers" : false } }

Example response

null

Updates a service package.

Parameter nameData typeDescription
servicesPackageServicesPackageJSON object.
Thrown exceptionDescription
InternalErrorExceptionWhen unspecified error occur. See exception param message for explanation.
PrivilegeExceptionWhen caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values.
RpcExceptionWrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation.
Return typeDescription
void

Example URL

https://[hostname]/krb/rpc/json/servicesManager/updateServicesPackage

Example params

{ "servicesPackage" : { "id" : 50 , "name" : "Unix account" , "description" : "Collection of services for managing unix accounts." } }

Example response

null