Adds an destination for a facility and service. If destination doesn't exist it will be created.
Parameter name | Data type | Description |
---|---|---|
service | int | Service id |
facility | int | Facility id |
destination | String | Destination |
type | String | Destination type (host,user@host,user@host:port,url,mail,service-specific,s3) |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
Destination | Created 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 name | Data type | Description |
---|---|---|
services | List<Service> | Services |
facility | int | Facility id |
destination | String | Destination |
type | String | Destination type (host,user@host,user@host:port,url,mail,service-specific,s3) |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
Destination | Created 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 name | Data type | Description |
---|---|---|
service | int | Service id |
facility | int | Facility id |
destination | String | Destination |
type | String | Destination type (host,user@host,user@host:port,url,mail,service-specific,s3) |
propagationType | String | propagation type (PARALLEL, DUMMY - doesn't send data) |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
Destination | Created 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 name | Data type | Description |
---|---|---|
services | List<Service> | Services |
facility | int | Facility id |
destination | String | Destination |
type | String | Destination type (host,user@host,user@host:port,url,mail,service-specific,s3) |
propagationType | String | propagation type (PARALLEL, DUMMY - doesn't send data) |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
Destination | Created 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 name | Data type | Description |
---|---|---|
service | int | Service id |
facility | int | Facility id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
services | List<Service> | Services |
facility | int | Facility id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
facility | int | Facility id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
facility | int | Facility id |
destination | String | Destination |
type | String | String Destination type (host,user@host,user@host:port,url,mail,service-specific,s3) |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
facility | int | Facility id |
destination | String | Destination |
type | String | Destination type (host,user@host,user@host:port,url,mail,service-specific,s3) |
propagationType | String | propagation type (PARALLEL, DUMMY - doesn't send data) |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
service | int | Service id |
attribute | int | Attribute id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
ServiceAttributesCannotExtend | if trying to add user-related attribute that could invalidate consents, requires disabling service |
Return type | Description |
---|---|
void |
Example URL
https://[hostname]/krb/rpc/json/servicesManager/addRequiredAttribute
Example params
{ "service" : 20 , "attribute" : 78 }
Example response
null
Batch version of addRequiredAttribute.
Parameter name | Data type | Description |
---|---|---|
service | int | Service id |
attributes | int[] | Attribute IDs |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
ServiceAttributesCannotExtend | if trying to add user-related attribute that could invalidate consents, requires disabling service |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
servicesPackage | int | Services package id to which the service supposed to be added |
service | int | Service id to be added to the services package |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
destination | int | Destination id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
destinationName | String | Destination name (like hostnames) |
destinationType | String | Destination type (like host, user@host, user@host:port, email, service-specific, s3 ...) |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
facility | int | Facility id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
void |
Example URL
https://[hostname]/krb/rpc/json/servicesManager/blockAllServicesOnFacility
Example params
{ "facility" : 95 }
Example response
null
Bans Service on a destination.
Parameter name | Data type | Description |
---|---|---|
service | int | Service id |
destination | int | Destination id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
service | int | Service id |
destinationName | String | Destination name (like hostnames) |
destinationType | String | Destination type (like host, user@host, user@host:port, email, service-specific, s3 ...) |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
service | int | Service id |
facility | int | Facility id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
ServiceAlreadyBannedException | When service is already banned on facility. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
service | int | Service id |
richDestinations | List<RichDestination> | the list of rich destinations |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
services | List<Integer> | id of service |
facility | int | Facility id |
Thrown exception | Description |
---|---|
FacilityNotExistsException | when facility does not exist |
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
PrivilegeException | insufficient permissions |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
ServiceAlreadyBannedException | when service is already banned on facility |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
service | Service | JSON object |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
Service | Created 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 name | Data type | Description |
---|---|---|
name | String | name |
description | String | description |
script | String | script which should be constructed like ./service_name (where anything else than [a-z,A-Z] is converted to _) |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
Service | Created 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 name | Data type | Description |
---|---|---|
servicesPackage | ServicesPackage | JSON object. |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
ServicesPackage | Created 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 name | Data type | Description |
---|---|---|
name | String | name |
description | String | description |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
ServicesPackage | Created 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 name | Data type | Description |
---|---|---|
service | int | Service id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
void |
Example URL
https://[hostname]/krb/rpc/json/servicesManager/deleteService
Example params
{ "service" : 28 }
Example response
null
Deletes a service.
Parameter name | Data type | Description |
---|---|---|
service | int | Service id |
force | boolean | if true, service will be removed with all dependant objects from the db instead of raising exception |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
void |
Example URL
https://[hostname]/krb/rpc/json/servicesManager/deleteService
Example params
{ "service" : 33 , "force" : true }
Example response
null
Deletes given services.
Parameter name | Data type | Description |
---|---|---|
services | List<Service> | Services |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
services | List<Integer> | id of services |
force | boolean | if true, service will be removed with all dependant objects from the db instead of raising exception |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
servicesPackage | int | ServicesPackage id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
void |
Example URL
https://[hostname]/krb/rpc/json/servicesManager/deleteServicesPackage
Example params
{ "servicesPackage" : 0 }
Example response
null
Forces service propagation on defined facility.
Parameter name | Data type | Description |
---|---|---|
service | int | Service id |
facility | int | Facility id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
int | 1 = 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 name | Data type | Description |
---|---|---|
service | int | Service id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
int | 1 = 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 name | Data type | Description |
---|---|---|
facility | int | Facility id |
services | List<Integer> | id of service |
Thrown exception | Description |
---|---|
FacilityNotExistsException | if there is no such facility |
ForceServicePropagationDisabledException | when forcing propagation is not possible |
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
PrivilegeException | insufficient permissions |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
services | List<Integer> | id of service |
Thrown exception | Description |
---|---|
ForceServicePropagationDisabledException | when forcing propagation is not possible |
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
PrivilegeException | insufficient permissions |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
hostname | String | hostname |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
PrivilegeException | insufficient permissions |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
String | Space 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 name | Data type | Description |
---|---|---|
facility | int | Facility id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
service | int | Service id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
service | int | Service id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
facility | int | Facility id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
facility | int | Facility id |
vo | int | Vo id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
id | int | Destination id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
Destination | Found 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 name | Data type | Description |
---|---|---|
service | int | Service id |
facility | int | Facility id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
int | destinations 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 name | Data type | Description |
---|---|---|
vo | int | VO id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
facility | int | Facility id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
service | Integer | service |
facility | Integer | facility |
consentEval | Boolean | if the generator should enforce evaluation of consents |
taskRun | Integer | id of the task run propagation |
Thrown exception | Description |
---|---|
FacilityNotExistsException | if there is no such facility |
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
PrivilegeException | insufficient permissions |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
ServiceNotExistsException | if there is no such service |
Return type | Description |
---|---|
HashedGenData | generated 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 name | Data type | Description |
---|---|---|
service | Integer | service |
facility | Integer | facility |
Thrown exception | Description |
---|---|
FacilityNotExistsException | if there is no such facility |
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
PrivilegeException | insufficient permissions |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
ServiceNotExistsException | if there is no such service |
Return type | Description |
---|---|
HashedGenData | generated 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 name | Data type | Description |
---|---|---|
service | Integer | service |
facility | Integer | facility |
consentEval | Boolean | if the generator should enforce evaluation of consents |
taskRun | Integer | id of the task run propagation |
Thrown exception | Description |
---|---|
FacilityNotExistsException | if there is no such facility |
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
PrivilegeException | insufficient permissions |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
ServiceNotExistsException | if there is no such service |
Return type | Description |
---|---|
HashedGenData | generated 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 name | Data type | Description |
---|---|---|
service | Integer | service |
facility | Integer | facility |
Thrown exception | Description |
---|---|
FacilityNotExistsException | if there is no such facility |
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
PrivilegeException | insufficient permissions |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
ServiceNotExistsException | if there is no such service |
Return type | Description |
---|---|
HashedGenData | generated 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 name | Data type | Description |
---|---|---|
service | int | Service id |
facility | int | Facility id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
id | int | Service id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
Service | Found 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 name | Data type | Description |
---|---|---|
name | String | Service Name |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
Service | Found 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 exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
destination | int | Destination id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
facility | int | Facility id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
attributeDefinition | int | attributeDefinition id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
all | services 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 name | Data type | Description |
---|---|---|
servicesPackage | int | ServicesPackage id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
servicesPackageId | int | ServicesPackage id . |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
ServicesPackage | Found 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 name | Data type | Description |
---|---|---|
name | String | ServicesPackage name. |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
ServicesPackage | Found 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 exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
service | int | Service id |
destination | int | Destination id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
int | 1 = 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 name | Data type | Description |
---|---|---|
service | int | Service id |
facility | int | Facility id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
int | 1 = 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 name | Data type | Description |
---|---|---|
service | int | Service id |
facility | int | Facility id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
int | 1 = 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 name | Data type | Description |
---|---|---|
service | int | Service id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
int | 1 = 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 name | Data type | Description |
---|---|---|
service | int | Service id |
facility | int | Facility id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
service | int | Service id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
service | int | Service id |
facility | int | Facility id |
destination | String | Destination |
type | String | Type |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
richDestinations | List<RichDestination> | list of rich destinations |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
service | int | Service id |
attribute | int | Attribute id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
service | int | Service id |
attributes | int[] | Attribute IDs |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
servicesPackage | int | Services package id from which the service supposed to be removed |
service | int | Service id that will be removed from the services package |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
destination | int | Destination id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
destinationName | String | Destination name (like hostnames) |
destinationType | String | Destination type (like host, user@host, user@host:port, email, service-specific, s3 ...) |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
facility | int | Facility id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
service | int | Service id |
destination | int | Destination id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
service | int | Service id |
destinationName | String | Destination name (like hostnames) |
destinationType | String | Destination type (like host, user@host, user@host:port, email, service-specific, s3 ...) |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
service | int | Service id |
facility | int | Facility id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
service | int | Service id |
richDestinations | List<RichDestination> | list of rich destinations |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
services | List<Integer> | id of service |
facility | int | Facility id |
Thrown exception | Description |
---|---|
FacilityNotExistsException | when facility does not exist |
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
PrivilegeException | insufficient permissions |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
ServiceIsNotBannedException | when unblocking service which is not blocked |
Return type | Description |
---|---|
void |
Example URL
https://[hostname]/krb/rpc/json/servicesManager/unblockServicesOnFacility
Example params
{ "services" : [ 47 , 44 ] , "facility" : 38 }
Example response
null
Updates a service.
Parameter name | Data type | Description |
---|---|---|
service | Service | JSON object |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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 name | Data type | Description |
---|---|---|
servicesPackage | ServicesPackage | JSON object. |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
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