Managing Service Providers and Applications

     Previous  Next    Open TOC in new window    View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Reference: Provisioning operations for accounts and groups

The following sections contain a reference for the management attributes operations and attributes for service provider and application administration. All attributes and operations are available in the managed object ESPA_access in the Network Gatekeeper management console.

 


Management operations related to service provider groups

Below is a list of management operations related to service provider groups:

 


Management operations related to service provider accounts

Below is a list of management operations related to service provider accounts:

 


Management operations related to application accounts

Below is a list of management operations related to application accounts:

 


Management operations related to application groups

Below is a list of management operations related to application groups:

 


Management operations related to application instance group IDs

Below is a list of management operations related to application instance group IDs:

 


Reference: attributes and operations for ESPA_access

Below is a list of attributes and operations for configuration and maintenance:

Attribute: NumberOfApplicationGroups (r)

Scope: Cluster

Unit: n/a

Format: int

Displays the number of registered application groups.

Attribute: NumberOfServiceProviderGroups (r)

Scope: Cluster

Unit: n/a

Format: int

Displays the number of registered service provider groups.

Attribute: OverloadPercentage

Scope: Server

Unit: n/a

Format: int [0...100]

Specifies the load percentage that defines when the software module will raise an overloaded alarm. Must be less than Attribute: SevereOverloadPercentage.

Attribute: SevereOverloadPercentage

Scope: Server

Unit: n/a

Format: int [0...100]

Specifies the load percentage that defines when the plug-in will raise a severely overloaded alarm.

Must be larger than Attribute: OverloadPercentage.

Attribute: NumberOfServiceProviderAccounts (r)

Scope: Cluster

Unit: n/a

Format: int

Displays the number of registered service provider accounts.

Operation: activateApplicationAccount

Scope: Cluster

Activate an application account. The application account must be activated before the application can start accessing services in the network.

Signature:

activateApplicationAccount(serviceProviderAccountID:String, applicationAccountID: String)

Table 12-1 activateApplicationAccount
activateApplicationAccount
Parameter
Description
serviceProviderAccountID
Service provider account ID.
applicationAccountID
Application account ID.

Operation: activateApplicationInstanceGroup

Scope: Cluster

Activates an application instance group ID (the application's login username). The application instance group ID must be activated before the application can start accessing services in the network.

Signature:

activateApplicationInstanceGroup(serviceProviderAccountID:String, applicationAccountID: String, applicationInstanceGroupID: String)

Table 12-2 activateApplicationInstanceGroup
activateApplicationInstanceGroup
Parameter
Description
serviceProviderAccountID
Service provider account ID.
applicationAccountID
Application account ID.
applicationInstanceGroupID
Application instance group ID.

Operation: activateServiceProviderAccount

Scope: Cluster

Activates a service provider account. The service provider account must be activated before any of its applications can start accessing services in the network.

Signature:

activateServiceProviderAccount(serviceProviderAccountID:String)

Table 12-3 activateServiceProviderAccount
activateServiceProviderAccount
Parameter
Description
serviceProviderAccountID
Service provider account ID.

Operation: addApplicationAccount

Scope: Cluster

Creates an application account. The service provider account and the application group to which this application account is to be connected must be created before the application account is created

Signature:

addApplicationAccount(applicationAccount.serviceProviderAccountID:String, applicationAccount.applicationAccountID: String, applicationAccount.applicationGroupID: String, applicationAccount.applicationRef:String, applicationAccount.properties)

Table 12-4 addApplicationAccount
addApplicationAccount
Parameter
Description
applicationAccount.serviceProviderAccountID
The ID for the service provider account that the application shall belong to.
applicationAccount.applicationAccountID
The ID of the new application account.
applicationAccount.applicationGroupID
ID for the application group that the application shall belong to.
applicationAccount.applicationRef
This is an optional reference used for internal mappings. Must not contain spaces.
applicationAccount.properties
These properties can only be set from an integrated PRM/CRM system.

Operation: addApplicationGroupWithSLAString

Scope: Cluster

Creates an application group. The application group is associated with an SLA that can be used by one or more application accounts.

Signature:

addApplicationGroupWithSLAString(applicationGroup.applicationGroupID: String, applicationGroup.slaContents: String,applicationGroup.properties)

Table 12-5 addApplicationGroupWithSLAString
addApplicationGroupWithSLAString
Parameter
Description
applicationGroup.applicationGroupID
ID for the new application group.
applicationGroup.slaContents
Content of SLA in string format.
applicationGroup.properties
These properties can only be set from an integrated PRM/CRM system.

Operation: addApplicationGroupWithSLAUrl

Scope: Cluster

Creates an application group. The application group is associated with an SLA that can be used by one or more application accounts.

Signature:

addApplicationGroupWithSLAUrl(applicationGroup.applicationGroupID: String, applicationGroup.slaContents: String,applicationGroup.properties)

Table 12-6 addApplicationGroupWithSLAUrl
addApplicationGroupWithSLAUrl
Parameter
Description
applicationGroup.applicationGroupID
ID for the new application group.
applicationGroup.slaContents
The URL for the SLA file.
applicationGroup.properties
These properties can only be set from an integrated PRM/CRM system.

Operation: addApplicationInstanceGroupSLAString

Scope: Cluster

Creates an application instance group ID, which functions as the login username for the application. The parameter applicationInstanceGroup.slaContents must be set to 1.

Note: Application instance group IDs must be unique.

Signature:

addApplicationInstanceGroupSLAString(serviceProviderAccountID: String, applicationInstanceGroup.applicationAccountID: String, applicationInstanceGroup.applicationInstanceGroupID: String, applicationInstanceGroup.applicationInstanceGroupRef: String, applicationInstanceGroup.slaContents: String, applicationInstanceGroup.properties:, password: String)

Table 12-7 addApplicationInstanceGroupSLAString
addApplicationInstanceGroupSLAString
Parameter
Description
serviceProviderAccountID
ID for the service provider account that the application instance group shall belong to.
applicationInstanceGroup.applicationAccountID
ID of the application account that the application instance group shall belong to.
applicationInstanceGroup.applicationInstanceGroupID
ID of the application instance group to be created. Must be unique.
An application use this as username when establishing a session (logging in).
applicationInstanceGroup.applicationInstanceGroupRef
This is an optional reference used for internal mappings. Must not contain spaces.
applicationInstanceGroup.slaContents
Must always be set to 1.
applicationInstanceGroup.properties
These properties can only be set from an integrated PRM/CRM system.
password
The password for the application instance group. Used by applications when establishing a session.

Operation: addServiceProviderAccount

Scope: Cluster

Creates a service provider account. The service provider group to which this service provider account is to be connected must be created before the service provider account is created.

Signature:

addServiceProviderAccount(serviceProviderAccount.serviceProviderAccountID:: String, serviceProviderAccount.serviceProviderGroupID: String, serviceProviderAccount.serviceProviderRef: String, serviceProviderAccount.properties)

Table 12-8 addServiceProviderAccount
addServiceProviderAccount
Parameter
Description
serviceProviderAccount.serviceProviderAccountID
ID of the service provider account to be created.
serviceProviderAccount.serviceProviderGroupID
ID of the service provider group the service provider group shall belong to.
serviceProviderAccount.serviceProviderRef
This is an optional reference used for internal mappings. Must not contain spaces.
serviceProviderAccount.properties
These properties can only be set from an integrated PRM/CRM system.

Operation: addServiceProviderGroupWithSLAString

Scope: Cluster

Creates service provider group. A service provider group SLA must exist. The SLA is provided as a string.

Signature:

addServiceProviderGroupWithSLAString(serviceProviderGroup.serviceProviderGroupID: String, serviceProviderGroup.slaContents: String, serviceProviderGroup.properties)

Table 12-9 addServiceProviderGroupWithSLAString
addServiceProviderGroupWithSLAString
Parameter
Description
serviceProviderGroup.serviceProviderGroupID
ID of the service provider group to be created.
serviceProviderGroup.slaContents
Content of the SLA in string format.
serviceProviderGroup.properties
These properties can only be set from an integrated PRM/CRM system.

Operation: addServiceProviderGroupWithSLAUrl

Scope: Cluster

Creates service provider group. A service provider group SLA must exist. A URL to the SLA is provided.

Signature:

addServiceProviderGroupWithSLAUrl(serviceProviderGroup.serviceProviderGroupID: String, serviceProviderGroup.slaContents: String, serviceProviderGroup.properties)

Table 12-10 addServiceProviderGroupWithSLAUrl
addServiceProviderGroupWithSLAUrl
Parameter
Description
serviceProviderGroup.serviceProviderGroupID
ID of the service provider group to be created.
serviceProviderGroup.slaContents
URL to the SLA.
serviceProviderGroup.properties
These properties can only be set from an integrated PRM/CRM system.

Operation: deactivateApplicationAccount

Scope: Cluster

Deactivates an application account. This deactivates, or temporarily prohibits the flow of traffic to and from, this account's applications.

Signature:

deactivateApplicationAccount(serviceProviderAccountID: String, applicationAccountID: String)

Table 12-11 deactivateApplicationAccount
deactivateApplicationAccount
Parameter
Description
serviceProviderAccountID
ID of the service provider account the application account belongs to.
applicationAccountID
ID of the application account.

Operation: deactivateApplicationInstanceGroup

Scope: Cluster

Deactivates an application instance group ID. Deactivates, or temporarily prohibits the flow of traffic to and from, the application that established a session using this application instance group ID.

Signature:

deactivateApplicationInstanceGroup(serviceProviderAccountID: String, applicationAccountID: String, applicationInstanceGroupID: String)

Table 12-12 deactivateApplicationInstanceGroup
deactivateApplicationInstanceGroup
Parameter
Description
serviceProviderAccountID
ID of the service provider account the application instance group ID belongs to.
applicationAccountID
ID of the application account the application instance group ID belongs to.
applicationInstanceGroupID
ID of the application instance group.

Operation: deactivateServiceProviderAccount

Scope: Cluster

Deactivates a service provider account. This deactivates, or temporarily prohibits the flow of traffic to and from, this account's applications.

Signature:

deactivateServiceProviderAccount(serviceProviderAccountID: String)

Table 12-13 deactivateServiceProviderAccount
deactivateServiceProviderAccount
Parameter
Description
serviceProviderAccountID
ID of the service provider account.

Operation: deleteApplicationAccount

Scope: Cluster

Deletes an application account.

Note: Deleting an application account also deletes all the application instance group IDs assigned to that account.

Signature:

deleteApplicationAccount(serviceProviderAccountID: String, applicationAccountID: String)

Table 12-14 deleteApplicationAccount
deleteApplicationAccount
Parameter
Description
serviceProviderAccountID
ID of the service provider account the application account belongs to.
applicationAccountID
ID of the application account.

Operation: deleteApplicationGroup

Scope: Cluster

Deletes an application group.

Signature:

deleteApplicationGroup(applicationGroupID: String)

Table 12-15 deleteApplicationGroup
deleteApplicationGroup
Parameter
Description
applicationGroupID
If of application group.

Operation: deleteApplicationInstanceGroup

Scope: Cluster

Deletes an application instance group ID.

Signature:

deleteApplicationInstanceGroup(serviceProviderAccountID: String, applicationAccountID: String, applicationInstanceGroupID: String)

Table 12-16 deleteApplicationInstanceGroup
deleteApplicationInstanceGroup
Parameter
Description
serviceProviderAccountID
ID of the service provider account the application instance group belongs to.
applicationAccountID
ID of the application account the application instance group ID belongs to.
applicationInstanceGroupID
ID of the application instance group.

Operation: deleteServiceProviderAccount

Scope: Cluster

Deletes a service provider account.

WARNING: Deleting the service provider account also deletes all related application accounts and application instance group IDs.

Signature:

deleteServiceProviderAccount(serviceProviderAccountID: String)

Table 12-17 deleteServiceProviderAccount
deleteServiceProviderAccount
Parameter
Description
serviceProviderAccountID
ID of the service provider account.

Operation: deleteServiceProviderGroup

Scope: Cluster

Deletes a service provider group.

WARNING: When deleting the service provider group, all related service provider accounts, application accounts and application instance group IDs will also be deleted.

Signature:

deleteServiceProviderGroup(serviceProviderGroupID: String)

Table 12-18 deleteServiceProviderGroup
deleteServiceProviderGroup
Parameter
Description
serviceProviderGroupID
ID of the service provider group.

Operation: deleteServiceProviderGroupNodeSla

Scope: Cluster

Deletes a node SLA for a certain service provider group.

Signature:

deleteServiceProviderGroupNodeSla(serviceProviderGroupID: String)

Table 12-19 deleteServiceProviderGroupNodeSla
deleteServiceProviderGroupNodeSla
Parameter
Description
serviceProviderGroupID
ID of the service provider group.

Operation: getApplicationAccount

Scope: Cluster

Displays information about an application account. This information includes the related application group IDs, the application reference, if any, and the account's OAM properties, if any.

Signature:

getApplicationAccount(serviceProviderAccountID: String, applicationAccountID: String)

Table 12-20 getApplicationAccount
getApplicationAccount
Parameter
Description
serviceProviderAccountID
ID of the service provider account the application account belongs to.
applicationAccountID
ID of the application account.

Operation: getApplicationGroup

Scope: Cluster

Displays information about an application group. The application group's SLA and OAM properties, if any, are displayed.

Signature:

getApplicationGroup(applicationGroupID: String)

Table 12-21 getApplicationGroup
getApplicationGroup
Parameter
Description
applicationGroupID
ID of the application group.

Operation: getApplicationInstanceGroup

Scope: Cluster

Displays information about an application instance group ID (the login username for the application). The application instance group ID's OAM properties, if any, and application instance group reference are displayed.

Signature:

getApplicationInstanceGroup(serviceProviderAccountID: String, applicationAccountID: String, applicationInstanceGroupID: String)

Table 12-22 getApplicationInstanceGroup
getApplicationInstanceGroup
Parameter
Description
serviceProviderAccountID
ID of the service provider account the application instance group belongs to.
applicationAccountID
ID of the application account the application instance group belongs to.
applicationInstanceGroupID
ID of the application instance group.

Operation: getNumberOfApplicationInstanceGroupRefs

Scope: Cluster

Displays information about application instance group ID references.

Signature:

getNumberOfApplicationInstanceGroupRefs(serviceProviderAccountID: String, applicationAccountID: String, state: int)

Table 12-23 getNumberOfApplicationInstanceGroupRefs
getNumberOfApplicationInstanceGroupRefs
Parameter
Description
serviceProviderAccountID
ID of the service provider account the application account belongs to.
applicationAccountID
ID of the application account.
state
Filter on state. See Table 2-1.

Operation: getNumberOfApplicationInstanceGroupsInApplications

Scope: Cluster

Display the number of application instance group IDs assigned to the application account.

Signature:

getNumberOfApplicationInstanceGroupsInApplications(serviceProviderAccountID: String, applicationAccountID: String)

Table 12-24 getNumberOfApplicationInstanceGroupsInApplications
getNumberOfApplicationInstanceGroupsInApplications
Parameter
Description
serviceProviderAccountID
ID of the service provider account the application account belongs to.
applicationAccountID
ID of the application account.

Operation: getNumberOfApplications

Scope: Cluster

Displays the number of application accounts in a certain state.

Signature:

getNumberOfApplications(serviceProviderAccountID: String, state: int)

Table 12-25 getNumberOfApplications
getNumberOfApplications
Parameter
Description
serviceProviderAccountID
ID of the service provider account to filter on.
Leave empty for no filter.
state
State to filter on. See Table 2-1.

Operation: getNumberOfApplicationsInApplicationGroup

Scope: Cluster

Displays the number of application accounts connected to the application group

Signature:

getNumberOfApplicationsInApplicationGroup(applicationGroupID: String)

Table 12-26 getNumberOfApplicationsInApplicationGroup
getNumberOfApplicationsInApplicationGroup
Parameter
Description
applicationGroupID
ID of the application group.

Operation: getNumberOfApplicationsInServiceProvider

Scope: Cluster

Displays the number of application accounts connected to the service provider.

Signature:

getNumberOfApplicationsInServiceProvider(serviceProviderAccountID: String)

Table 12-27 getNumberOfApplicationsInServiceProvider
getNumberOfApplicationsInServiceProvider
Parameter
Description
serviceProviderAccountID
ID of the service provider account ID.

Operation: getNumberOfLoggedInApplicationInstanceGroups

Scope: Cluster

Displays the number of applications by ID that have sessions established with Network Gatekeeper.

Signature:

getNumberOfLoggedInApplicationInstanceGroups(serviceProviderAccountID: String, applicationAccountID: String)

Table 12-28 getNumberOfLoggedInApplicationInstanceGroups
getNumberOfLoggedInApplicationInstanceGroups
Parameter
Description
serviceProviderAccountID
ID of the service provider account the application account belongs to.
applicationAccountID
ID of the application account.

Operation: getNumberOfLoggedInInstancesInInstanceGroup

Scope: Cluster

Displays the number of application instance group IDs that have sessions established with Network Gatekeeper. Will always be 1.

Signature:

getNumberOfLoggedInInstancesInInstanceGroup(serviceProviderAccountID: String, applicationAccountID: String, applicationInstanceGroupID: String)

Table 12-29 getNumberOfLoggedInInstancesInInstanceGroup
getNumberOfLoggedInInstancesInInstanceGroup
Parameter
Description
serviceProviderAccountID
ID of the service provider account the application instance group belongs to.
applicationAccountID
ID of the application account the application instance group belongs to.
applicationInstanceGroupID
ID of the application instance group.

Operation: getNumberOfServiceProvidersInGroup

Scope: Cluster

Displays the number of service provider accounts related to a service provider group.

Signature:

getNumberOfServiceProvidersInGroup(serviceProvidersGroupID: String)

Table 12-30 getNumberOfServiceProvidersInGroup
getNumberOfServiceProvidersInGroup
Parameter
Description
serviceProvidersGroupID
ID of the service provider group.

Operation: getSLAForApplicationGroup

Scope: Cluster

Displays the SLA for an application group.

Signature:

getSLAForApplicationGroup(applicationGroupID: String)

Table 12-31 getSLAForApplicationGroup
getSLAForApplicationGroup
Parameter
Description
applicationGroupID
ID of the application group.

Operation: getSLAForApplicationInstanceGroup ID

Scope: Cluster

N/A

Signature:

getSLAForApplicationInstanceGroup(serviceProviderAccountID: String, applicationAccountID: String, applicationInstanceGroupID: String)

Table 12-32 getSLAForApplicationInstanceGroup
getSLAForApplicationInstanceGroup
Parameter
Description
serviceProviderAccountID
ID of the service provider account the application instance group belongs to.
applicationAccountID
ID of the application account the application instance group belongs to.
applicationInstanceGroupID
ID of the application instance group.

Operation: getSLAForServiceProviderGroup

Scope: Cluster

Displays the SLA for a service provider group.

Signature:

getSLAForServiceProviderGroup(serviceProviderGroupID : String)

Table 12-33 getSLAForServiceProviderGroup
getSLAForServiceProviderGroup
Parameter
Description
serviceProviderGroupID
ID of the service provider group.

Operation: getServiceProviderAccount

Scope: Cluster

Displays information about a service provider account. The related service provider group ID, the service provider reference, if any, and the account's OAM properties, if any, are displayed.

Signature:

getServiceProviderAccount(serviceProviderAccountID : String)

Table 12-34 getServiceProviderAccount
getServiceProviderAccount
Parameter
Description
serviceProviderAccountID
ID of the service provider account.

Operation: getServiceProviderGroup

Scope: Cluster

Displays information about a service provider group. The service provider group's SLA and OAM properties, if any, are displayed.

Signature:

getServiceProviderGroup(serviceProviderGroupID : String)

Table 12-35 getServiceProviderGroup
getServiceProviderGroup
Parameter
Description
serviceProviderGroupID
ID of service provider group.

Operation: getSessionInfo

Scope: Cluster

Displays information about a session. The session is established between an application and Network Gatekeeper.

Signature:

getSessionInfo(sessionId : String)

Table 12-36 getSessionInfo
getSessionInfo
Parameter
Description
sessionId
ID of the session to get information about.

Operation: getStateForApplicationAccount

Scope: Cluster

Displays information about the state of an application account.

Signature:

getStateForApplicationAccount(serviceProviderAccountID : String, applicationAccountID: String)

Table 12-37 getStateForApplicationAccount
getStateForApplicationAccount
Parameter
Description
serviceProviderAccountID
ID of the service provider account hat application account belongs to.
applicationAccountID
ID of the application account.

Operation: getStateForApplicationInstanceGroup

Scope: Cluster

Displays information about the state of an application instance group ID.

Signature:

getStateForApplicationInstanceGroup(serviceProviderAccountID : String, applicationAccountID: String, applicationInstanceGroupID: String)

Table 12-38 getStateForApplicationInstanceGroup
getStateForApplicationInstanceGroup
Parameter
Description
serviceProviderAccountID
ID of the service provider account the application instance group belongs to.
applicationAccountID
ID of the application account the application instance group belongs to.
applicationInstanceGroupID
ID of the application instance group.

Operation: getStateForServiceProviderAccount

Scope: Cluster

Displays information about the state of a service provider account.

Signature:

getStateForServiceProviderAccount(serviceProviderAccountID : String)

Table 12-39 getStateForServiceProviderAccount
getStateForServiceProviderAccount
Parameter
Description
serviceProviderAccountID
ID of the service provider account.

Operation: listApplicationAccounts

Scope: Cluster

Displays a list of application account IDs related to an application group.

Signature:

listApplicationAccounts(serviceProviderAccountID : String, state: int, offset: int, length:int)

Table 12-40 listApplicationAccounts
listApplicationAccounts
Parameter
Description
serviceProviderAccountID
ID of the service provider account to list application accounts for.
state
Filter on state. See Table 2-1.
offset
Offset for the displayed list.
length
Number of entries in the displayed list.

Operation: listApplicationAccountsForServiceProvider

Scope: Cluster

Displays a list of application account related to a service provider.

Signature:

listApplicationAccountsForServiceProvider(serviceProviderAccountID : String, offset: int, length:int)

Table 12-41 listApplicationAccountsForServiceProvider
listApplicationAccountsForServiceProvider
Parameter
Description
serviceProviderAccountID
ID of the service provider account to list application accounts for..
offset
Offset for the displayed list.
length
Number of entries in the displayed list.

Operation: listApplicationAccountsInGroup

Scope: Cluster

Displays a list of application account IDs related to an application group.

Signature:

listApplicationAccountsInGroup(applicationGroupID : String, offset: int, length:int)

Table 12-42 listApplicationAccountsInGroup
listApplicationAccountsInGroup
Parameter
Description
applicationGroupID
ID of the application group to list application accounts for.
offset
Offset for the displayed list.
length
Number of entries in the displayed list.

Operation: listApplicationGroups

Scope: Cluster

Displays a list of application groups.

Signature:

listApplicationGroups(offset: int, length:int)

Table 12-43 listApplicationGroups
listApplicationGroups
Parameter
Description
offset
Offset for the displayed list.
length
Number of entries in the displayed list.

Operation: listApplicationInstanceGroupRefs

Scope: Cluster

Displays a list of application instance group ID references.

Signature:

listApplicationInstanceGroupRefs(serviceProviderAccountID: String, applicationAccountID: String, state: int, offset: int, length:int)

Table 12-44 listApplicationInstanceGroupRefs
listApplicationInstanceGroupRefs
Parameter
Description
serviceProviderAccountID
Service provider account ID.
applicationAccountID
Application account ID.
state
State to filter on. See Table 2-1.
offset
Offset for the displayed list.
length
Number of entries in the displayed list.

Operation: listApplicationInstanceGroups

Scope: Cluster

Displays a list of application instance group IDs per application account.

Signature:

listApplicationInstanceGroups(serviceProviderAccountID: String, applicationAccountID: String, offset: int, length:int)

Table 12-45 listApplicationInstanceGroups
listApplicationInstanceGroups
Parameter
Description
serviceProviderAccountID
ID of the service provider account the application instance group belongs to.
applicationAccountID
ID of the application account the application instance group belongs to.
offset
Offset for the displayed list.
length
Number of entries in the displayed list.

Operation: listESPAServices

Scope: Cluster

Displays which ESPA services are registered. These are used in backwards compatible traffic paths.

Signature:

listESPAServices()

Table 12-46 listESPAServices
listESPAServices
Parameter
Description
-
-

Operation: listLoggedInApplicationInstanceGroups

Scope: Cluster

Displays a list of application instance group IDs that currently have sessions established with Network Gatekeeper by application accounts.

Signature:

listApplicationInstanceGroups(serviceProviderAccountID: String, applicationAccountID: String, offset: int, length:int)

Table 12-47 listLoggedInApplicationInstanceGroups
listLoggedInApplicationInstanceGroups
Parameter
Description
serviceProviderAccountID
ID of the service provider account the application instance group belongs to.
applicationAccountID
ID of the application account the application instance group belongs to.
offset
Offset for the displayed list.
length
Number of entries in the displayed list.

Operation: listServiceProviderAccounts

Scope: Cluster

Displays a list of service provider accounts.

Signature:

listServiceProviderAccounts(offset: int, length:int)

Table 12-48 listServiceProviderAccounts
listServiceProviderAccounts
Parameter
Description
offset
Offset for the displayed list.
length
Number of entries in the displayed list.

Operation: listServiceProviderGroupNodeSla

Scope: Cluster

Displays the node SLA for service provider group, if any.

Signature:

listServiceProviderGroupNodeSla(serviceProviderGroupID: String)

Table 12-49 listServiceProviderGroupNodeSla
listServiceProviderGroupNodeSla
Parameter
Description
serviceProviderGroupID
ID of the service provider group.

Operation: listServiceProviderGroups

Scope: Cluster

Displays a list of service provider groups.

Signature:

listServiceProviderGroups(offset: int, length:int)

Table 12-50 listServiceProviderGroups
listServiceProviderGroups
Parameter
Description
offset
Offset for the displayed list.
length
Number of entries in the displayed list.

Operation: listServiceProviderGroupsWithNodeSla

Scope: Cluster

Displays a list of service provider groups that have node SLAs associated.

Signature:

listServiceProviderGroupsWithNodeSla()

Table 12-51 listServiceProviderGroupsWithNodeSla
listServiceProviderGroupsWithNodeSla
Parameter
Description
-
-

Operation: listServiceProvidersInGroup

Scope: Cluster

Displays a list of service provider accounts related to a service provider group.

Signature:

listServiceProvidersInGroup(serviceProviderGroupID: String, offset: int, length:int)

Table 12-52 listServiceProvidersInGroup
listServiceProvidersInGroup
Parameter
Description
serviceProviderGroupID
ID of the service provider group.
offset
Offset for the displayed list.
length
Number of entries in the displayed list.

Operation: logoutApplicationAccount

Scope: Cluster

Logs out all applications associated with an application account. De-establish sessions between Network Gatekeeper and the matching applications.

Signature:

logoutApplicationAccount(serviceProviderAccountID: String, applicationAccountID: String)

Table 12-53 logoutApplicationAccount
logoutApplicationAccount
Parameter
Description
serviceProviderAccountID
ID of the service provider account the application account belongs to.
applicationAccountID
ID of the application account.

Operation: logoutApplicationInstanceGroup

Scope: Cluster

Logs out a given application by ID. De-establish the session between Network Gatekeeper and the application.

Signature:

logoutApplicationInstanceGroup(serviceProviderAccountID: String, applicationAccountID: String, applicationInstanceGroupID: String)

Table 12-54 logoutApplicationInstanceGroup
logoutApplicationInstanceGroup
Parameter
Description
serviceProviderAccountID
ID of the service provider account the application instance group belongs to.
applicationAccountID
ID of the application account the application instance group belongs to.
applicationInstanceGroupID
ID of the application instance group.

Operation: logoutServiceProviderAccount

Scope: Cluster

Logs out all applications associated with a service provider account. De-establish sessions between Network Gatekeeper and the matching applications.

Signature:

logoutServiceProviderAccount(serviceProviderAccountID: String)

Table 12-55 logoutServiceProviderAccount
logoutServiceProviderAccount
Parameter
Description
serviceProviderAccountID
ID of the service provider account.

Operation: setPasswordForApplicationInstanceGroup

Scope: Cluster

Defines a new password for an application instance group ID (the username).

Signature:

setPasswordForApplicationInstanceGroup(serviceProviderAccountID: String, applicationAccountID: String, applicationInstanceGroupID: String, newPassword : String)

Table 12-56 setPasswordForApplicationInstanceGroup
setPasswordForApplicationInstanceGroup
Parameter
Description
serviceProviderAccountID
ID of the service provider account the application instance group belongs to.
applicationAccountID
ID of the application account the application instance group belongs to.
applicationInstanceGroupID
ID of the application instance group.
newPassword
The new password.

Operation: setServiceProviderGroupNodeSlaString

Scope: Cluster

Loads a node SLA for a service provider group.

Signature:

setServiceProviderGroupNodeSlaString(SLA: String, serviceProviderGroupID: String)

Table 12-57 setServiceProviderGroupNodeSlaString
setServiceProviderGroupNodeSlaString
Parameter
Description
SLA
SLA content in string format.
serviceProviderGroupID
ID of the service provider group.

Operation: setServiceProviderGroupNodeSlaUrl

Scope: Cluster

Loads a node SLA for a service provider group.

Signature:

setServiceProviderGroupNodeSlaUrl(url: String, serviceProviderGroupID: String)

Table 12-58 setServiceProviderGroupNodeSlaUrl
setServiceProviderGroupNodeSlaUrl
Parameter
Description
url
URL to the SLA file.
serviceProviderGroupID
ID of the service provider group.

Operation: unlockApplicationInstanceGroup

Scope: Cluster

Unlocks an application instance group ID. The application instance group ID (the username) is unlocked and its state is changed to activated. The application instance group ID may be locked because of too many failed login attempts.

Signature:

unlockApplicationInstanceGroup(serviceProviderAccountID: String, applicationAccountID: String, applicationInstanceGroupID: String)

Table 12-59 unlockApplicationInstanceGroup
unlockApplicationInstanceGroup
Parameter
Description
serviceProviderAccountID
ID of the service provider account the application instance group belongs to.
applicationAccountID
ID of the application account the application instance group belongs to.
applicationInstanceGroupID
ID of the application instance group.

Operation: updateApplicationAccount

Scope: Cluster

Change the application group associated with an application account.

Signature:

updateApplicationAccount(applicationAccount.serviceProviderAccountID: String, applicationAccount.applicationAccountID: String, applicationAccount.applicationGroupID: String, applicationAccount.applicationRef: String, applicationAccount.properties)

Table 12-60 updateApplicationAccount
updateApplicationAccount
Parameter
Description
applicationAccount.serviceProviderAccountID
ID of the service provider account the application account belongs to.
applicationAccount.applicationAccountID
ID of the application account to update.
applicationAccount.applicationGroupID
ID of application group to change to.
applicationAccount.applicationRef
The new application reference. This is an optional reference used for internal mappings. Must not contain spaces.
applicationAccount.properties
These properties can only be set from an integrated PRM/CRM system.

Operation: updateApplicationGroupSLAString

Scope: Cluster

Updates the SLA for an application group.

Signature:

updateApplicationGroupSLAString(applicationGroup.applicationGroupID: String, applicationGroup.slaContents: String, applicationGroup.properties)

Table 12-61 updateApplicationGroupSLAString
updateApplicationGroupSLAString
Parameter
Description
applicationGroup.applicationGroupID
ID of the application group to update.
applicationGroup.slaContents
The new SLA in string format.
applicationGroup.properties
These properties can only be set from an integrated PRM/CRM system.

Operation: updateApplicationGroupSLAUrl

Scope: Cluster

Updates the SLA for an application group.

Signature:

updateApplicationGroupSLAUrl(applicationGroup.applicationGroupID: String, applicationGroup.slaContents: String, applicationGroup.properties)

Table 12-62 updateApplicationGroupSLAUrl
updateApplicationGroupSLAUrl
Parameter
Description
applicationGroup.applicationGroupID
ID of the application group to update.
applicationGroup.slaContents
URL to the new SLA.
applicationGroup.properties
These properties can only be set from an integrated PRM/CRM system.

Operation: updateApplicationInstanceGroupSLAString

Scope: Cluster

N/A.

Signature:

updateApplicationInstanceGroupSLAString(serviceProviderAccountID: String, applicationInstanceGroup.applicationAccountID: String, applicationInstanceGroup.applicationInstanceGroupID: String, applicationInstanceGroup.applicationInstanceGroupRef: String, applicationInstanceGroup.properties)

Table 12-63 updateApplicationInstanceGroupSLAString
updateApplicationInstanceGroupSLAString
Parameter
Description
serviceProviderAccountID
ID of the service provider account the application instance group belongs to.
applicationInstanceGroup.applicationAccountID
ID of the application account the application instance group belongs to.
applicationInstanceGroup.applicationInstanceGroupID
ID of the application instance group to update.
applicationInstanceGroup.applicationInstanceGroupRef
This is an optional reference used for internal mappings.
Ignored if left empty. Must not contain spaces.
applicationInstanceGroup.slaContents
The new SLA.
Always use 1.
applicationInstanceGroup.properties
These properties can only be set from an integrated PRM/CRM system.

Operation: updateServiceProviderAccount

Scope: Cluster

Changes the service provider group associated with an service provider account.

Signature:

updateServiceProviderAccount(serviceProviderAccount.serviceProviderAccountID: String, serviceProviderAccount.serviceProviderGroupID: String, serviceProviderAccount.serviceProviderRef: String, serviceProviderAccount.properties)

Table 12-64 updateServiceProviderAccount
updateServiceProviderAccount
Parameter
Description
serviceProviderAccount.serviceProviderAccountID
ID of service provider account to update.
serviceProviderAccount.serviceProviderGroupID
ID of the service provider group to change to.
serviceProviderAccount.serviceProviderRef
This is an optional reference used for internal mappings. Ignored if left empty. Must not contain spaces.
serviceProviderAccount.properties
These properties can only be set from an integrated PRM/CRM system.

Operation: updateServiceProviderGroupNodeSlaString

Scope: Cluster

Updates the node SLA for a service provider group.

Signature:

updateServiceProviderGroupNodeSlaString(SLA: String, serviceProviderGroupID: String)

Table 12-65 updateServiceProviderGroupNodeSlaString
updateServiceProviderGroupNodeSlaString
Parameter
Description
SLA
Content of the new SLA in string format.
serviceProviderGroupID
ID of service provider group.

Operation: updateServiceProviderGroupNodeSlaUrl

Scope: Cluster

Updates the node SLA for a service provider group.

Signature:

updateServiceProviderGroupNodeSlaUrl(url: String, serviceProviderGroupID: String)

Table 12-66 updateServiceProviderGroupNodeSlaString
updateServiceProviderGroupNodeSlaString
Parameter
Description
url
URL to the new SLA file.
serviceProviderGroupID
ID of the service provider group.

Operation: updateServiceProviderGroupSLAString

Scope: Cluster

Updates the SLA for a service provider group.

Signature:

updateServiceProviderGroupSLAString(serviceProviderGroup.serviceProviderGroupID: String, serviceProviderGroup.slaContents: String, serviceProviderGroup.properties)

Table 12-67 updateServiceProviderGroupSLAString
updateServiceProviderGroupSLAString
Parameter
Description
serviceProviderGroup.serviceProviderGroupID
ID of the service provider group to update.
serviceProviderGroup.slaContents
The new SLA content in string format.
serviceProviderGroup.properties
These properties can only be set from an integrated PRM/CRM system.

Operation: updateServiceProviderGroupSLAUrl

Scope: Cluster

Updates the SLA for a service provider group.

Signature:

updateServiceProviderGroupSLAUrl(serviceProviderGroup.serviceProviderGroupID: String, serviceProviderGroup.slaContents: String, serviceProviderGroup.properties)

Table 12-68 updateServiceProviderGroupSLAUrl
updateServiceProviderGroupSLAUrl
Parameter
Description
serviceProviderGroup.serviceProviderGroupID
ID of the service provider group to update.
serviceProviderGroup.slaContents
URL to the new SLA file.
serviceProviderGroup.properties
These properties can only be set from an integrated PRM/CRM system.


  Back to Top       Previous  Next