Windows-based Hosting::QueryServicesByCustomer

  • Article

The QueryServicesByCustomer procedure queries all service plan, resource, and provisioned service details for a customer and returns a listing of plans and provisioned services for a customer organizational unit.

Arguments

The QueryServicesByCustomer procedure requires the following input parameters.

Input Argument Description

<org>

The Lightweight Directory Access Protocol (LDAP) path of the organization that will own the Web site.

<preferredDomainController>

The name of the preferred domain controller.

Output Arguments

The QueryServicesByCustomer procedure has no return values, other than the included XML response.

Remarks

Security

The QueryServicesByCustomer procedure has the following security requirements:

  • The caller is impersonated.

  • The caller is tested for UserCreator permissions.

Process Steps

The following steps occur when querying services of a customer with the QueryServicesByCustomer procedure of the Managed Windows-based Hosting Namespace:

  • Retrieve assigned plans.

  • Retrieve plan details.

  • Retrieve resource reservations and allocations.

  • Retrieve pointers to provisioned services.

Sample Code

Example XML Request

The following is an example of an XML request for the QueryServicesByCustomer procedure of the Managed Windows-based Hosting Namespace:

<request> 
        <data> 
                <org>LDAP://OU=Cust001,OU=Res001,OU=Hosting,DC=fabrikam,DC=Com</org> 
                <preferredDomainController>AD01-wh.fabrikam.com 
                </preferredDomainController> 
        </data> 
                <procedure> 
                <execute namespace="Windows-based Hosting"  
                procedure="QueryServicesByCustomer"> 
                <before source="data" destination="executeData" mode="merge" /> 
                <after source="executeData" destination="data" mode="insert" /> 
                </execute> 
        </procedure> 
</request>

Example XML Response

The following is an example of an XML response from the QueryServicesByCustomer procedure of the Managed Windows-based Hosting Namespace:

<response> 
        <data> 
        <org>LDAP://OU=northwindtraders,OU=consolidatedmessenger, 
        OU=Hosting,DC=fabrikam,DC=Com</org> 
        <preferredDomainController>AD01.fabrikam.Com 
        </preferredDomainController> 
                <plans> 
                        <plan name="BasicWebHosting"> 
                        <megabytes>10</megabytes> 
                        <webSites>4</webSites> 
                        <hostHeaders>4</hostHeaders> 
                        <frontpageExtensions>1</frontpageExtensions> 
                        </plan> 
                        <plan name="add10MegWeb"> 
                        <megabytes>10</megabytes> 
                        </plan> 
                        <plan name="BasicSqlHosting"> 
                        <megabytes>100</megabytes> 
                        <maxDatabases>100</maxDatabases> 
                        <serverClass>Gold</serverClass> 
                        </plan> 
                </plans> 
        <IIS> 
                <totalMegabytes>20</totalMegabytes> 
                <megabtyesFree>10</megabtyesFree> 
                <totalWebSites>4</totalWebSites> 
                <webSitesFree>2</webSitesFree> 
                <webSites> 
                        <webSite name="www.northwind.com" path="IIS://WEB01/W3SVC/34345"> 
                        <webRootShare>\\WEB01\websites$\northwindtraders\ 
                        www.northwind.com</webRootShare> 
                        </webSite> 
                        <webSite name="support.northwind.com"  
                        path="IIS://WEB01/W3SVC/353453"> 
                        <webRootShare>\\WEB01\websites$\northwindtraders\ 
                        support.northwind.com</webRootShare> 
                        </webSite> 
      </webSites> 
        </IIS> 
        <SQL> 
                <totalMegabytes>100</totalMegabytes> 
                <megabtyesFree>75</megabtyesFree> 
                <totalWebSites>5</totalWebSites> 
      <webSitesFree>3</webSitesFree> 
                <databases> 
                        <database name="northWindSales"> 
                        <server>SQL01</server> 
                        <databaseID>123345</databaseID> 
                        <megabytes>15</megabytes> 
                        </database> 
                </databases>     
                <databases> 
                        <database name="northWindCustomers"> 
                        <server>SQL01</server> 
                        <databaseID>123345</databaseID> 
                        <megabytes>10</megabytes> 
                        </database> 
                </databases>     
        </SQL> 
        </data> 
</response>

Applies To

Managed Windows-based Hosting Namespace API for:

  • Hosted Messaging and Collaboration version 3.5

  • Hosted Messaging and Collaboration version 3.0

  • Windows-based Hosting version 4.5

  • Windows-based Hosting version 4.0

  • Windows-based Hosting version 3.5

  • Windows-based Hosting for Applications version 1.0

See also

Tasks

Windows-based Hosting::QueryCustomerPlans
Windows-based Hosting::QueryPlans