-<wsdl:portType name="ServiceAdministrationInterface">
<xhtml:p>Service administration interface. This interface allows an
administrator to create, update, retrieve, and delete service / operation /
service implementation definitions. Service definitions may be either
individual services or service groups, and are arranged in a service
hierarchy.</xhtml:p>
<xhtml:p>Each individual service may also have a list of associated
operations and service implementations. Operations can only be
defined for individual services, although both individual services and
service groups possess a special 'ALL' operation. An individual service
must have at least one service implementation in order to allow for
subscriptions to that service.</xhtml:p>
<xhtml:p>This interface also provides operations for querying the
service hierarchy, determine parent and child relationships.</xhtml:p>
</wsdl:documentation>
-<wsdl:operation name="createService">
<xhtml:p>Creates a new service definition within the hierarchy.
Allows for the creation of individual services or service groups.
When creating a new service definition, the parent group definition
must be provided in order to link the service into the hierarchy.
Individual services may not have children. By default, a service
that is created will have a corresponding special operation 'ALL'.
In addition, individual services will start off with an empty list
of associated service implementations.</xhtml:p>
<xhtml:p>The service may be an individual service or a service
group.</xhtml:p>
</wsdl:documentation>
<xhtml:p>Create service request operation input parameters. Specifies the
service definition to create in the service policy manager.</xhtml:p>
</wsdl:documentation>
</wsdl:input>
<xhtml:p>Create service response result. Contains empty
content.</xhtml:p>
</wsdl:documentation>
</wsdl:output>
<xhtml:p>Raised if the supplied service definition is invalid,
already exists, or if an internal error occurs.</xhtml:p>
</wsdl:documentation>
</wsdl:fault>
</wsdl:operation>
-<wsdl:operation name="updateService">
<xhtml:p>Updates the supplied service definition. Only changed values
are updated. If optional values are not provided, then they are considered
not to have changed. The supplied service definition may refer to either
an individual service or a service group.</xhtml:p>
</wsdl:documentation>
<xhtml:p>Update service request operation input parameters. Only the
changed values in the supplied definition are considered are
updated.</xhtml:p>
</wsdl:documentation>
</wsdl:input>
<xhtml:p>Update service response result. Contains empty
content.</xhtml:p>
</wsdl:documentation>
</wsdl:output>
<xhtml:p>Raised if the updated definition refers a non-existant service,
the update content is invalid, or if an internal error occurs.</xhtml:p>
</wsdl:documentation>
</wsdl:fault>
</wsdl:operation>
-<wsdl:operation name="getService">
<xhtml:p>Gets the service definition for the specified service
name. May be an individual service or a service group.</xhtml:p>
</wsdl:documentation>
<xhtml:p>Get service request operation input parameters. Specifies the
service identifier whose definition to fetch. May be an individual
service or a service group.</xhtml:p>
</wsdl:documentation>
</wsdl:input>
<xhtml:p>Get service response result. Contains the service definition
for the supplied input service identifier.</xhtml:p>
</wsdl:documentation>
</wsdl:output>
<xhtml:p>Raised if the specified service identifier is invalid or does
not exist, or if an internal error occurs.</xhtml:p>
</wsdl:documentation>
</wsdl:fault>
</wsdl:operation>
-<wsdl:operation name="removeService">
<xhtml:p>Removes the the specified sevice identifier. The service may be
an individual service or a service group. If the includingChildren flag
is set to true, then all service definition children will be removed
along with this definition. If this flag is set to false and child
definitions exist, then the service definition cannot be
removed.</xhtml:p>
<xhtml:p>Removing a service will also remove any policies, subscriptions,
operations, and service implementations associated with that service.
Consider disabling the service status rather than removing the service
to preserve that information.</xhtml:p>
</wsdl:documentation>
<xhtml:p>Remove service operation input parameters. Specifies the
service to remove. May be an individual service or a service
group.</xhtml:p>
</wsdl:documentation>
</wsdl:input>
<xhtml:p>Remove service response result. Contains empty content.</xhtml:p>
</wsdl:documentation>
</wsdl:output>
<xhtml:p>Raised if the specified service identifier does not exist, if
an attempt was made to remove a definition that contains children
without setting the includingChildren flag accordingly, or if an internal
error occurs.</xhtml:p>
</wsdl:documentation>
</wsdl:fault>
</wsdl:operation>
-<wsdl:operation name="createOperation">
<xhtml:p>Creates a new operation definition under the specified service
name. Operations may only be created under individual services.</xhtml:p>
</wsdl:documentation>
<xhtml:p>Create operation operation input parameters. Specifies the
operation definition information to create in the service policy
manager.</xhtml:p>
</wsdl:documentation>
</wsdl:input>
<xhtml:p>Create operation response result. Contains empty content.</xhtml:p>
</wsdl:documentation>
</wsdl:output>
<xhtml:p>Raise if the given service does not exist, the given service is
a service group, if the given operation already exists, or if an internal
error occurs.</xhtml:p>
</wsdl:documentation>
</wsdl:fault>
</wsdl:operation>
-<wsdl:operation name="updateOperation">
<xhtml:p>Updates an operation definition. Only the changed attributes are
updated. If an optional attribute is omitted, then it is considered not
to have changed. The special 'ALL' operation definition may be
updated.</xhtml:p>
</wsdl:documentation>
<xhtml:p>Update operation operation input parameters. Updates the
operation definition with the supplied information.</xhtml:p>
</wsdl:documentation>
</wsdl:input>
<xhtml:p>Update operation response result. Contains empty content.</xhtml:p>
</wsdl:documentation>
</wsdl:output>
<xhtml:p>Raised if the supplied service or operation does not exist, or
if an internal error occurs.</xhtml:p>
</wsdl:documentation>
</wsdl:fault>
</wsdl:operation>
-<wsdl:operation name="getOperation">
<xhtml:p>Gets an operation definition for the supplied service and
operation name. The supplied service may be an individual service or a
group. The supplied operation may be the special operation 'ALL'. Service
groups will only have the special operation 'ALL' defined.</xhtml:p>
</wsdl:documentation>
<xhtml:p>Get operation operation input parameters. Specifies the
operation under what service whose definition to fetch.</xhtml:p>
</wsdl:documentation>
</wsdl:input>
<xhtml:p>Get operation response result. Returns the operation
definition for the specified operation under the specified
service.</xhtml:p>
</wsdl:documentation>
</wsdl:output>
<xhtml:p>Raised if the supplied service or operation does not exist,
or if an internal error occurs.</xhtml:p>
</wsdl:documentation>
</wsdl:fault>
</wsdl:operation>
-<wsdl:operation name="removeOperation">
<xhtml:p>Removes an operation from the specified service. Removing an
operation removes all associated policy information and subscriptions
associated with that operation. Consider disabling the operation
rather than removing the operation to preserve policy and subscription
information.</xhtml:p>
<xhtml:p>The special operation 'ALL' cannot be removed.</xhtml:p>
</wsdl:documentation>
<xhtml:p>Remove operation operation input parameters. Specifies
which operation under what service to remove. The special operation
'ALL' cannot be removed.</xhtml:p>
</wsdl:documentation>
</wsdl:input>
<xhtml:p>Remove operation response result. Contains empty
content.</xhtml:p>
</wsdl:documentation>
</wsdl:output>
<xhtml:p>Raised if the supplied service or operation does not exist,
or if an internal error occurs.</xhtml:p>
</wsdl:documentation>
</wsdl:fault>
</wsdl:operation>
-<wsdl:operation name="createServiceImplementation">
<xhtml:p>Create a new service implementation under the specified service.
A service implementation must refer to a valid service.</xhtml:p>
</wsdl:documentation>
<xhtml:p>Create service implementation operation input parameters.
Creates the service implementation definition in the service policy
manager under the specified individual service.</xhtml:p>
</wsdl:documentation>
</wsdl:input>
<xhtml:p>Create service implementation response result. Contains
empty content.</xhtml:p>
</wsdl:documentation>
</wsdl:output>
<xhtml:p>Raised if the supplied service does not exist, the supplied
service name corresponds to a service group, the service implementation
already exists, or if an internal error occurs.</xhtml:p>
</wsdl:documentation>
</wsdl:fault>
</wsdl:operation>
-<wsdl:operation name="updateServiceImplementation">
<xhtml:p>Updates a service implementation definition. Only the values
that have changed are updated. The parent service for a service
implementation cannot be updated after creation. Optional fields that
are omitted are considered not to have changed.</xhtml:p>
</wsdl:documentation>
<xhtml:p>Update service implementation operation input parameters.
Updates all changed definition data in the service policy
manager.</xhtml:p>
</wsdl:documentation>
</wsdl:input>
<xhtml:p>Update service implementation response result. Contains
empty content.</xhtml:p>
</wsdl:documentation>
</wsdl:output>
<xhtml:p>Raised if the supplied service or service implementation does
not exist, or if an internal error occurs.</xhtml:p>
</wsdl:documentation>
</wsdl:fault>
</wsdl:operation>
-<wsdl:operation name="getServiceImplementations">
<xhtml:p>Gets a list of service implementation definitions for the supplied
service name. The supplied service must be an individual service and
not a service group, as service implementations can only be registered
under individual services.</xhtml:p>
</wsdl:documentation>
<xhtml:p>Get sevice implementation operation input parameters.
Specifies the service whose service implementations to
fetch.</xhtml:p>
</wsdl:documentation>
</wsdl:input>
<xhtml:p>Get service implementation response result. Returns a list of
all service implementations registered for the specified service.</xhtml:p>
</wsdl:documentation>
</wsdl:output>
<xhtml:p>Raised if the supplied service does not exist, is a service
group, or if an internal error occurs.</xhtml:p>
</wsdl:documentation>
</wsdl:fault>
</wsdl:operation>
-<wsdl:operation name="removeServiceImplementation">
<xhtml:p>Removes a service implementation definition from the specified
service. Removing a service implementation removes corresponding policy
information defined at the service implementation scope, and corresponding
subscription information. Consider disabling the service implementation
rather than removing it in order to preserve policy and subscription
information.</xhtml:p>
</wsdl:documentation>
<xhtml:p>Remove service implementation operation input parameters.
Specifies the service implementation name, under the which service,
to remove from service policy manager.</xhtml:p>
</wsdl:documentation>
</wsdl:input>
<xhtml:p>Remove service implementation response result. Contains
empty content.</xhtml:p>
</wsdl:documentation>
</wsdl:output>
<xhtml:p>Raised if the specified service or service implementation
does not exist, or if an internal error occurs.</xhtml:p>
</wsdl:documentation>
</wsdl:fault>
</wsdl:operation>
-<wsdl:operation name="resolveServiceEnabled">
<xhtml:p>Performs hierarchical resolution to determine the enablement
status of the specified service identifier. The service identifier may
be an individual service or a service group. The service policy
manager will search the hierarchy to determine whether the supplied
identifier is enabled. If the service identifier itself or any parent
definition along the path up to the root definition in the hierarchy
has been disabled, then the specified service identifier is considered
disabled.</xhtml:p>
</wsdl:documentation>
<xhtml:p>Resolve service enabled operation input parameters. Specifies
the service identifier whose enablement status to resolve.</xhtml:p>
</wsdl:documentation>
</wsdl:input>
<xhtml:p>Resolve service enabled response result. Returns a boolean
indicating the enablement status of the specified service.</xhtml:p>
</wsdl:documentation>
</wsdl:output>
<xhtml:p>Raised if the supplied service identifier does not exist,
or if an internal error occurs.</xhtml:p>
</wsdl:documentation>
</wsdl:fault>
</wsdl:operation>
-<wsdl:operation name="resolveOperationEnabled">
<xhtml:p>Performs hierarchical resolution to determine the enablement
status of the specified operation. The service policy manager will
search the hierarchy to determine whether the supplied operation is
enabled. If any service higher up in the hierarchy for the parent
service of the operation is disabled, or if any parent service's
'ALL' operation is disabled, or if the 'ALL' operation is disabled
for the operation's parent service, or if the operation itself is
disabled, then the specified operation will be considered
disabled.</xhtml:p>
</wsdl:documentation>
<xhtml:p>Resolve operation enabled operation input parameters.
Specifies the operation name, under which service, whose
enablement status to resolve.</xhtml:p>
</wsdl:documentation>
</wsdl:input>
<xhtml:p>Resolve operation enable response result. Returns a boolean
indicating the enablement status of the specified operation.</xhtml:p>
</wsdl:documentation>
</wsdl:output>
<xhtml:p>Raised if the supplied service or operation does not exist,
or if an internal error occurs.</xhtml:p>
</wsdl:documentation>
</wsdl:fault>
</wsdl:operation>
-<wsdl:operation name="findMatchingServices">
<xhtml:p>Finds all service definitions matching the specified criteria.
A pattern can be specified to match different service identifier names,
or the search may be restricted to searching under a particular service
group in the hierarchy or to a certain type of idenitifer (individual
service or service group).</xhtml:p>
</wsdl:documentation>
<xhtml:p>Find matching services operation input parameters. Specifies
criteria used to find all matching services while searching the service
hierarchy.</xhtml:p>
</wsdl:documentation>
</wsdl:input>
<xhtml:p>Find matching sevices response result. Returns a list of service
definitions that matched the specified criteria. If there are no matches,
then an empty list will be returned.</xhtml:p>
</wsdl:documentation>
</wsdl:output>
<xhtml:p>Raised if invalid criteria is supplied, or if an internal error
occurs.</xhtml:p>
</wsdl:documentation>
</wsdl:fault>
</wsdl:operation>
-<wsdl:operation name="getAllOperations">
<xhtml:p>Gets all operation definitions for the specified service. The
service may an individual service or a service group.</xhtml:p>
</wsdl:documentation>
<xhtml:p>Get all operations operation input paremeters. Specifies the
service whose operations definitions to fetch. May be an individual
service or a service group.</xhtml:p>
</wsdl:documentation>
</wsdl:input>
<xhtml:p>Get all operations response result. Returns a list of operation
definitions for the specified service.</xhtml:p>
</wsdl:documentation>
</wsdl:output>
<xhtml:p>Raised if the specified service does not exist, or if an internal
error occurs.</xhtml:p>
</wsdl:documentation>
</wsdl:fault>
</wsdl:operation>
-<wsdl:operation name="getChildren">
<xhtml:p>Gets all child service definitions for the specified service group.
An individual service cannot be specified, as it has no children in the
service hierarchy. The list of child service definitions may contain both
individual services and service groups.</xhtml:p>
</wsdl:documentation>
<xhtml:p>Get children operation input parameters. Specifies the service
group whose children to fetch.</xhtml:p>
</wsdl:documentation>
</wsdl:input>
<xhtml:p>Get children operation response result. Contains a list of
service definitions that are the children of the specified service
group.</xhtml:p>
</wsdl:documentation>
</wsdl:output>
<xhtml:p>Raised if the specified service is an individual service,
does not exist, or if an internal error occurs.</xhtml:p>
</wsdl:documentation>
</wsdl:fault>
</wsdl:operation>
-<wsdl:operation name="getParentChain">
<xhtml:p>Gets the chain of parent definitions from the specified service
identifier up to the root definition. The specified service identifier may
be an individual service or a service group. The specified service identifier
will not appear in the list. The list of parent definitions will be provided
in order of traversing up the hierarchy to the root definition.</xhtml:p>
</wsdl:documentation>
<xhtml:p>Get parent chain operation input parameters. Specifies the
service identifier whose parent chain to fetch.</xhtml:p>
</wsdl:documentation>
</wsdl:input>
<xhtml:p>Get parent chain operation response result. Returns a list of
service definitions, starting from the parent of the specified service
up to the root definition.</xhtml:p>
</wsdl:documentation>
</wsdl:output>
<xhtml:p>Raised if the specified service identifier does not exist, or
if an internal error occurs.</xhtml:p>
</wsdl:documentation>
</wsdl:fault>
</wsdl:operation>
</wsdl:portType>
|