pem.APS.provideServiceInstance

This method is supported by Operations starting from version 5.4.4.

This method allows to create the Application Service Instance of the specified Application Service.

This method can also be used to add an Application Service of the account class to an existing Service User. The target Service User must belong to the Subscription of the appropriate Application Instance. To add the Application Service to the Service User, the login name of the Service User must be specified in the Application Service's setting of the login class.

The method has the following input parameters:

Name	Type	Short Description
`parent_service_instance_id`	int	The identifier of the parent Application Service Instance under which the Application Service Instance will be created.
`service`	struct	This parameter defines the Application Service, which will be used to create the appropriate Application Service Instance.
`service_id`	string	Application Service ID. The Application Service ID of the required Application Service can be obtained in the following ways: Unpack the APP-META.xml file from the required Application package. See the id properties of the service elements. Use the getApplicationInstanceServiceResourceTypes method.
`[service_resource_type_id]`	int	The identifier of the 'Application Service' Resource Type, which will be used to create the Application Service Instance of the corresponding Application Service. If there is no any 'Application Service' Resource Type for the Application Service, do not pass this parameter to the method.
`settings`	array of struct	The settings of the Application Service Instance, which will be created.
`name`	string	Name of a setting.
`value`	string	Value of a setting.
`[subservices]`	array of struct	This parameter defines the list of the direct child Application Services for which the appropriate Application Service Instances will be created. This parameter is optional.
`service_id`	string	Application Service ID. The Application Service ID of the required Application Service can be obtained in the following ways: Unpack the APP-META.xml file from the required Application package. See the id properties of the service elements. Use the getApplicationInstanceServiceResourceTypes method.
`[service_resource_type_id]`	int	The identifier of the 'Application Service' Resource Type, which will be used to create the Application Service Instance of the corresponding Application Service. If there is no any 'Application Service' Resource Type for the Application Service, do not pass this parameter to the method.
`settings`	array of struct	The settings of the Application Service Instance, which will be created.
`name`	string	Name of a setting.
`value`	string	Value of a setting.

The method has the following output parameters:

Name	Type	Short Description
`n/a`	int	The identifier of the created Application Service Instance.

Note: This method can also be called under Reseller permissions.