org.springframework.cloud.servicebroker.service

Interface ServiceInstanceService

All Known Implementing Classes:

ServiceInstanceEventService

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, Roy Clarkson

Method Summary

Modifier and Type	Method and Description
reactor.core.publisher.Mono<CreateServiceInstanceResponse>	createServiceInstance(CreateServiceInstanceRequest request) Create (provision) a new service instance.
reactor.core.publisher.Mono<DeleteServiceInstanceResponse>	deleteServiceInstance(DeleteServiceInstanceRequest request) Delete (deprovision) a service instance.
default reactor.core.publisher.Mono<GetLastServiceOperationResponse>	getLastOperation(GetLastServiceOperationRequest request) Get the status of the last requested operation for a service instance.
default reactor.core.publisher.Mono<GetServiceInstanceResponse>	getServiceInstance(GetServiceInstanceRequest request) Get the details of a service instance.
default reactor.core.publisher.Mono<UpdateServiceInstanceResponse>	updateServiceInstance(UpdateServiceInstanceRequest request) Update a service instance.

Method Detail

createServiceInstance

reactor.core.publisher.Mono<CreateServiceInstanceResponse> createServiceInstance(CreateServiceInstanceRequest request)

Create (provision) a new service instance.

Parameters:

request - containing the details of the request

Returns:

a CreateServiceInstanceResponse on successful processing of the 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

ServiceBrokerInvalidParametersException - if any parameters passed in the request are invalid

ServiceBrokerCreateOperationInProgressException - if a an operation is in progress for the service instance

getServiceInstance

default reactor.core.publisher.Mono<GetServiceInstanceResponse> getServiceInstance(GetServiceInstanceRequest request)

Get the details of a service instance.

Parameters:

request - containing the details of the request

Returns:

a GetServiceInstanceResponse on successful processing of the request

Throws:

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

ServiceBrokerOperationInProgressException - if a service instance provisioning is still in progress

ServiceBrokerConcurrencyException - if a service instance is being updated and therefore cannot be fetched

getLastOperation

default reactor.core.publisher.Mono<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:

a GetLastServiceOperationResponse on successful processing of the request

Throws:

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

deleteServiceInstance

reactor.core.publisher.Mono<DeleteServiceInstanceResponse> deleteServiceInstance(DeleteServiceInstanceRequest request)

Delete (deprovision) a service instance.

Parameters:

request - containing the details of the request

Returns:

a DeleteServiceInstanceResponse on successful processing of the 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

ServiceBrokerDeleteOperationInProgressException - if a an operation is in progress for the service binding

updateServiceInstance

default reactor.core.publisher.Mono<UpdateServiceInstanceResponse> updateServiceInstance(UpdateServiceInstanceRequest request)

Update a service instance.

Parameters:

request - containing the details of the request

Returns:

an UpdateServiceInstanceResponse on successful processing of the request

Throws:

ServiceInstanceUpdateNotSupportedException - if particular 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

ServiceBrokerInvalidParametersException - if any parameters passed in the request are invalid

ServiceBrokerUpdateOperationInProgressException - if a an operation is in progress for the service instance