org.springframework.cloud.servicebroker.service

Interface ServiceInstanceService

public interface ServiceInstanceService

This interface is implemented by service brokers to process requests related to provisioning, updating, and deprovisioning service instances.

Author:

[email protected], Scott Frederick

Method Summary

Methods

Modifier and Type	Method and Description
CreateServiceInstanceResponse	createServiceInstance(CreateServiceInstanceRequest request) Create (provision) a new service instance.
DeleteServiceInstanceResponse	deleteServiceInstance(DeleteServiceInstanceRequest request) Delete (deprovision) a service instance.
GetLastServiceOperationResponse	getLastOperation(GetLastServiceOperationRequest request) Get the status of the last requested operation for a service instance.
UpdateServiceInstanceResponse	updateServiceInstance(UpdateServiceInstanceRequest request) Update a service instance.

Method Detail

createServiceInstance

CreateServiceInstanceResponse createServiceInstance(CreateServiceInstanceRequest request)

Create (provision) a new service instance.

Parameters:

request - containing the details of the request

Returns:

the details of the completed request

Throws:

ServiceInstanceExistsException - if a service instance with the given ID is already known to the broker

ServiceBrokerAsyncRequiredException - if the broker requires asynchronous processing of the request

getLastOperation

GetLastServiceOperationResponse getLastOperation(GetLastServiceOperationRequest request)

Get the status of the last requested operation for a service instance.

Parameters:

request - containing the details of the request

Returns:

the details of the completed request

Throws:

ServiceInstanceDoesNotExistException - if a service instance with the given ID is not known to the broker

deleteServiceInstance

DeleteServiceInstanceResponse deleteServiceInstance(DeleteServiceInstanceRequest request)

Delete (deprovision) a service instance.

Parameters:

request - containing the details of the request

Returns:

the details of the completed request

Throws:

ServiceInstanceDoesNotExistException - if a service instance with the given ID is not known to the broker

ServiceBrokerAsyncRequiredException - if the broker requires asynchronous processing of the request

updateServiceInstance

UpdateServiceInstanceResponse updateServiceInstance(UpdateServiceInstanceRequest request)

Update a service instance. Only modification of the service plan is supported.

Parameters:

request - containing the details of the request

Returns:

the details of the completed request

Throws:

ServiceInstanceUpdateNotSupportedException - if particular plan change is not supported or if the request can not currently be fulfilled due to the state of the instance

ServiceInstanceDoesNotExistException - if a service instance with the given ID is not known to the broker

ServiceBrokerAsyncRequiredException - if the broker requires asynchronous processing of the request