Usually this means that all resources are immediately reclaimed for future provisions. This specification does not specify what a Service Broker is to do if it receives a deprovision request while there are still Service Bindings associated with it. If a Service Broker accepts the request to delete a Service Instance during the process of it being provisioned, then it MUST have the net effect of halting the current creation process and beginning the deletion of any resources associated with the Service Instance. If the request to deprovision the Service Instance is being performed asynchronously, then the Polling Last Operation for Service Instances endpoint SHOULD indicate the state of the deprovision request unless a different operation identifier was provided by the Service Broker.
When a deprovisioning fails, the Service Instance can still be usable or unusable or its state could be unknown. Service Brokers are expected to have successfully provisioned all of the Service Instances and Service Bindings that the Platform knows about, and none that it doesn't. Orphaned Service Instances and Service Bindings might have been created in one of the following scenarios:.
Service Brokers MAY automatically delete any resources they believe to be orphaned on their own. Note that the Platform MAY allow end users to determine when orphan mitigation occurs, in order to allow them to investigate the cause of any failures. Skip to content. Permalink Dismiss Join GitHub today GitHub is home to over 40 million developers working together to host and review code, manage projects, and build software together. Sign up. Branch: master Find file Copy path. Find file Copy path.
Raw Blame History. Terminology This specification defines the following terms: Application : Often the entity using a Service Instance will be a piece of software, however, this does not need to be the case. Changes Since v2. Added a Service Offering specific async polling timeout. Allow a Service Instance context to be updated and add org name, space name, and instance names. Added list of endpoints to create Service Binding response body.
Added mechanism for orphan mitigation. Allow brokers to return for no-op update Service Instance requests. Allow brokers to not return parameters when returning a Service Instance or Service Binding. Restrict Operation strings to 10, chartacters in the response body for provisioning or deprovisioning a Service Instance, and binding or unbinding a Service Binding. Remove character restrictions on names of Service Offerings , and Service Plans.
What is Semantic Service provisioning
Allow empty descriptions in the response body for getting the last operations of Service Instances , and Service Bindings. Clarify broker behavior expected when deprovisioning while a provision request is in progress and unbinding while an unbind request is in progress. Clarify broker behavior when a provision request is received during a provision request for the same instance or when a binding request is received during a binding request for the same binding. Added maintenance info support to Service Plans. Added request identity header.
MINOR using semantic versioning. Originating Identity Often a Service Broker will need to know the identity of the user that initiated the request from the Platform. Request Identity A Platform might wish to uniquely identify a specific request as it flows throughout the system. For error responses, the following fields are defined: Response Field Type Description error string A single word in camel case that uniquely identifies the error condition. If present, MUST be a non-empty string. If true , the Service Instance can still be used, false otherwise.
Defaults to true. If true , the same update operation MAY be repeated and MAY succeed; if false , repeating the same update operation will fail again. Error Codes There are failure scenarios described throughout this specification for which the error field MUST contain a specific string.
ConcurrencyError The Service Broker does not support concurrent requests that mutate the same resource. Clients MUST wait until pending requests have completed for the specified resources. The expected response body is below. Body CLI clients will typically have restrictions on how names, such as Service Offering and Service Plan names, will be provided by users. MAY be empty. MUST be a non-empty string.
- An International Persp. on Topics in Sports Med., Sports Injury.
- Changeling (Sisters of the Moon, Book 2)?
- Software-Programmed Optical Networking with Integrated NFV Service Provisioning;
- Product | Semantic Service Provisioning.
- Coordinating Plans of Autonomous Agents.
This specifies the default for all Service Plans of this Service Offering. Service Plans can override this field see Service Plan Object. It is expected that Platforms will treat this as a blob. Note that there are conventions in existing Service Brokers and Platforms for fields that aid in the display of catalog data. Contains the data necessary to activate the Dashboard SSO feature for this service.
Service Plans can override this field see Service Plan.
- Daniel Bimschas - Google Scholar Citations.
- Semantic Service Provisioning - Google Libri.
- Robert B. Heilman and Eric Voegelin: A Friendship in Letters, 1944-1984?
- Service Provisioning in Cloud: A Systematic Survey.
- Semantic Service Provisioning.
We have opted to keep that misspelling instead of fixing it and thus breaking backward compatibility. Defaults to false. The default is true. If specified, this takes precedence over the bindable attribute of the Service Offering. If not specified, the default is derived from the Service Offering. Used only if the Service Plan is bindable. Each input parameter is expressed as a property within a JSON object. The Platform MAY present this information to the user before they trigger the maintenance update.
Synchronous Operations To execute a request synchronously, the Service Broker need only return the usual status codes: Created for provision and bind, and OK for update, unbind, and deprovision. Blocking Operations Service Brokers MAY choose the degree to which they support concurrent requests, ranging from not supporting them at all to only supporting them in selective situations. When a value for operation is included with asynchronous responses for Provision , Update , and Deprovision requests, the Platform MUST provide the same value using this query parameter as a percent-encoded string.
MAY be returned if the request contains invalid data, in which case the error response MAY include a helpful error message in the description field see Service Broker Errors. Parameters The request provides these query string parameters as useful hints for brokers. When a value for operation is included with asynchronous responses for Binding and Unbinding requests, the Platform MUST provide the same value using this query parameter as a URL-encoded string. If brokers do not return this operation field, only one asynchronous operation MAY be supported at a time.
Provisioning When the Service Broker receives a provision request from the Platform, it MUST take whatever action is necessary to create a new resource. If this parameter is not included in the request, and the Service Broker can only provision a Service Instance of the requested Service Plan asynchronously, the Service Broker MUST reject the request with a Unprocessable Entity as described below. Although most Service Brokers will not use this field, it might be helpful for executing operations on a user's behalf. The identifier for the project space within the Platform organization.
This field can be used to ensure that the end-user of a Platform is provisioning what they are expecting since maintenance information can be used to describe important information such as the version of the operating system the Service Instance will run on. If a Service Broker's catalog has changed and new maintenance information version is available for the Service Plan being provisioned, then the Service Broker MUST reject the request with a Unprocessable Entity as described below.
The operation string MUST match that returned for the original request.
This triggers the Platform to poll the Last Operation for Service Instances endpoint for operation status. The error response MAY include a helpful error message in the description field such as "The maintenance information for the requested Service Plan has changed. The URL MUST contain enough information for the dashboard to identify the resource being accessed kdfsk0vfnku in the example below.
If present, MUST be a string or null. By changing the Service Plan, users can upgrade or downgrade their Service Instance to other plans. Enable users to modify the parameters of a Service Instance. By modifying parameters, users can change configuration options that are specific to a Service or Service Plan. Enable Platforms to send an update request for a Service Instance containing only contextual data no changes to the Service Plan or parameters. Enable Platforms to update maintenance information allowing users to perform maintenance on their Service Instance, such as upgrading the underlying operating system the Service Instance is running on.
See "Note" below. This field can be used to perform maintenance on a Service Instance for example, to upgrade the underlying operating system the Service Instance is running on.
Semantic Service Provisioning 2008
If a Service Broker's catalog has changed and new maintenance information version is available for the Service Plan that the Service Instance being updated is using, then the Service Broker MUST reject the request with a Unprocessable Entity as described below. Service Instance utilization is over the quota of the requested Service Plan.
Additionally, this MUST be returned if the Service Broker only supports asynchronous update for the requested Service Plan and the request did not include? The URL MUST contain enough information for the dashboard to identify the resource being accessed da in the example below. Types of Binding Credentials Credentials are a set of information used by an Application or a user to utilize the Service Instance. Log Drain There are a class of Service Offerings that provide aggregation, indexing, and analysis of log data. Route Services Route services are a class of Service Offerings that intermediate requests to applications, performing functions such as rate limiting or authorization.
Volume Services There are a class of Service Offerings that provide network storage to applications via volume mounts in the application container. If this parameter is not included in the request, and the broker can only perform a binding operation asynchronously, the broker MUST reject the request with a Unprocessable Entity as described below. See Bind Resource Object for more information.
For credentials bindings. MUST be unique within the scope of the Platform. For route services Service Bindings. Information regarding the Service Binding i. The error response MAY include a helpful error message in the description field such as "This Service supports generation of credentials through binding an application only. The error response MAY include a helpful error message in the description field such as "This Service Instance requires client support for asynchronous binding operations.