( Return to API Overview )

Description

Contains methods to access common organization management functions available from the web interface.

Namespace: org

Method: create

Description:
Create a new organization and associated administrator account.

Parameters:

string sessionKey
string orgName - Organization name. Must meet same criteria as in the web UI.
string adminLogin - New administrator login name.
string adminPassword - New administrator password.
string prefix - New administrator's prefix. Must match one of the values available in the web UI. (i.e. Dr., Mr., Mrs., Sr., etc.)
string firstName - New administrator's first name.
string lastName - New administrator's first name.
string email - New administrator's e-mail.
boolean usePamAuth - True if PAM authentication should be used for the new administrator account.

Returns:

struct - organization info int "id" string "name" int "active_users" - Number of active users in the organization. int "systems" - Number of systems in the organization. int "trusts" - Number of trusted organizations. int "system_groups" - Number of system groups in the organization. (optional) int "activation_keys" - Number of activation keys in the organization. (optional) int "kickstart_profiles" - Number of kickstart profiles in the organization. (optional) int "configuration_channels" - Number of configuration channels in the organization. (optional)

Method: delete

Description:
Delete an organization. The default organization (i.e. orgId=1) cannot be deleted.

Parameters:

string sessionKey
int orgId

Returns:

int - 1 on success, exception thrown otherwise.

Method: getCrashFileSizeLimit

Description:
Get the organization wide crash file size limit. The limit value must i a non-negative number, zero means no limit.

Parameters:

string sessionKey
int orgId

Returns:

int - Crash file size limit.

Method: getDetails

Description:
The detailed information about an organization given the organization ID.

Parameters:

string sessionKey
int orgId

Returns:

struct - organization info int "id" string "name" int "active_users" - Number of active users in the organization. int "systems" - Number of systems in the organization. int "trusts" - Number of trusted organizations. int "system_groups" - Number of system groups in the organization. (optional) int "activation_keys" - Number of activation keys in the organization. (optional) int "kickstart_profiles" - Number of kickstart profiles in the organization. (optional) int "configuration_channels" - Number of configuration channels in the organization. (optional)

Method: getDetails

Description:
The detailed information about an organization given the organization name.

Parameters:

string sessionKey
string name

Returns:

struct - organization info int "id" string "name" int "active_users" - Number of active users in the organization. int "systems" - Number of systems in the organization. int "trusts" - Number of trusted organizations. int "system_groups" - Number of system groups in the organization. (optional) int "activation_keys" - Number of activation keys in the organization. (optional) int "kickstart_profiles" - Number of kickstart profiles in the organization. (optional) int "configuration_channels" - Number of configuration channels in the organization. (optional)

Method: listOrgs

Description:
Returns the list of organizations.

Parameters:

string sessionKey

Returns:

struct - organization info int "id" string "name" int "active_users" - Number of active users in the organization. int "systems" - Number of systems in the organization. int "trusts" - Number of trusted organizations. int "system_groups" - Number of system groups in the organization. (optional) int "activation_keys" - Number of activation keys in the organization. (optional) int "kickstart_profiles" - Number of kickstart profiles in the organization. (optional) int "configuration_channels" - Number of configuration channels in the organization. (optional)

Method: listSoftwareEntitlements

Description:
List software entitlement allocation information across all organizations. Caller must be a satellite administrator.

Parameters:

string sessionKey

Returns:

array: struct - entitlement usage string "label" string "name" int "free" int "used" int "allocated" int "unallocated" int "free_flex" int "used_flex" int "allocated_flex" int "unallocated_flex"

Method: listSoftwareEntitlements

Description:
List each organization's allocation of a given software entitlement. Organizations with no allocation will not be present in the list. A value of -1 indicates unlimited entitlements.

Deprecated - being replaced by listSoftwareEntitlements(string sessionKey, string label, boolean includeUnentitled)

Parameters:

string sessionKey
string label - Software entitlement label.

Returns:

array: struct - entitlement usage int "org_id" string "org_name" int "allocated" int "unallocated" int "used" int "free"

Method: listSoftwareEntitlements

Description:
List each organization's allocation of a given software entitlement. A value of -1 indicates unlimited entitlements.

Parameters:

string sessionKey
string label - Software entitlement label.
boolean includeUnentitled - If true, the result will include both organizations that have the entitlement as well as those that do not; otherwise, the result will only include organizations that have the entitlement.

Returns:

array: struct - entitlement usage int "org_id" string "org_name" int "allocated" int "unallocated" int "used" int "free"

Available since: 10.4

Method: listSoftwareEntitlementsForOrg

Description:
List an organization's allocation of each software entitlement. A value of -1 indicates unlimited entitlements.

Parameters:

string sessionKey
int orgId

Returns:

array: struct - entitlement usage string "label" string "name" int "allocated" int "unallocated" int "free" int "used" int "allocated_flex" int "unallocated_flex" int "free_flex" int "used_flex"

Method: listSystemEntitlements

Description:
Lists system entitlement allocation information across all organizations. Caller must be a satellite administrator.

Parameters:

string sessionKey

Returns:

array: struct - entitlement usage string "label" string "name" int "free" int "used" int "allocated" int "unallocated" int "free_flex" int "used_flex" int "allocated_flex" int "unallocated_flex"

Method: listSystemEntitlements

Description:
List each organization's allocation of a system entitlement. If the organization has no allocation for a particular entitlement, it will not appear in the list.

Deprecated - being replaced by listSystemEntitlements(string sessionKey, string label, boolean includeUnentitled)

Parameters:

string sessionKey
string label

Returns:

array: struct - entitlement usage int "org_id" string "org_name" int "allocated" int "unallocated" int "used" int "free"

Method: listSystemEntitlements

Description:
List each organization's allocation of a system entitlement.

Parameters:

string sessionKey
string label
boolean includeUnentitled - If true, the result will include both organizations that have the entitlement as well as those that do not; otherwise, the result will only include organizations that have the entitlement.

Returns:

array: struct - entitlement usage int "org_id" string "org_name" int "allocated" int "unallocated" int "used" int "free"

Available since: 10.4

Method: listSystemEntitlementsForOrg

Description:
List an organization's allocation of each system entitlement.

Parameters:

string sessionKey
int orgId

Returns:

array: struct - entitlement usage string "label" string "name" int "free" int "used" int "allocated" int "unallocated"

Method: listUsers

Description:
Returns the list of users in a given organization.

Parameters:

string sessionKey
int orgId

Returns:

array: struct - user string "login" string "login_uc" string "name" string "email" boolean "is_org_admin"

Description:
Migrate systems from one organization to another. If executed by a Satellite administrator, the systems will be migrated from their current organization to the organization specified by the toOrgId. If executed by an organization administrator, the systems must exist in the same organization as that administrator and the systems will be migrated to the organization specified by the toOrgId. In any scenario, the origination and destination organizations must be defined in a trust.

Parameters:

string sessionKey
int toOrgId - ID of the organization where the system(s) will be migrated to.
array:
- int - systemId

Returns:

array: int - serverIdMigrated

Method: setCrashFileSizeLimit

Description:
Set the organization wide crash file size limit. The limit value must be non-negative, zero means no limit.

Parameters:

string sessionKey
int orgId
int limit - The limit to set (non-negative value).

Returns:

int - 1 on success, exception thrown otherwise.

Method: setSoftwareEntitlements

Description:
Set an organization's entitlement allocation for the given software entitlement. If increasing the entitlement allocation, the default organization (i.e. orgId=1) must have a sufficient number of free entitlements.

Parameters:

string sessionKey
int orgId
string label - Software entitlement label.
int allocation

Returns:

int - 1 on success, exception thrown otherwise.

Method: setSoftwareFlexEntitlements

Description:
Set an organization's flex entitlement allocation for the given software entitlement. If increasing the flex entitlement allocation, the default organization (i.e. orgId=1) must have a sufficient number of free flex entitlements.

Parameters:

string sessionKey
int orgId
string label - Software entitlement label.
int allocation

Returns:

int - 1 on success, exception thrown otherwise.

Method: setSystemEntitlements

Parameters:

string sessionKey
int orgId
string label - System entitlement label. Valid values include:
- enterprise_entitled
- monitoring_entitled
- provisioning_entitled
- virtualization_host
- virtualization_host_platform
int allocation

Returns:

int - 1 on success, exception thrown otherwise.

Method: updateName

Description:
Updates the name of an organization

Parameters:

string sessionKey
int orgId
string name - Organization name. Must meet same criteria as in the web UI.

Returns:

struct - organization info int "id" string "name" int "active_users" - Number of active users in the organization. int "systems" - Number of systems in the organization. int "trusts" - Number of trusted organizations. int "system_groups" - Number of system groups in the organization. (optional) int "activation_keys" - Number of activation keys in the organization. (optional) int "kickstart_profiles" - Number of kickstart profiles in the organization. (optional) int "configuration_channels" - Number of configuration channels in the organization. (optional)

Generated on 3/4/2013

Available methods

Description

Method: create

Method: delete

Method: getCrashFileSizeLimit

Method: getDetails

Method: getDetails

Method: listOrgs

Method: listSoftwareEntitlements

Method: listSoftwareEntitlements

Method: listSoftwareEntitlements

Method: listSoftwareEntitlementsForOrg

Method: listSystemEntitlements

Method: listSystemEntitlements

Method: listSystemEntitlements

Method: listSystemEntitlementsForOrg

Method: listUsers

Method: migrateSystems

Method: setCrashFileSizeLimit

Method: setSoftwareEntitlements

Method: setSoftwareFlexEntitlements

Method: setSystemEntitlements

Method: updateName