Offers
Applies To: System Center 2016 - Service Provider Foundation, System Center Technical Preview
You can use the Offer application programming interface (API) to create, read, update, or delete offers. Offers include clouds, actions, virtual machine templates, and networks that are offered to tenants through a subscription. The serialized objects that are used with the service are formatted for JavaScript Object Notation (JSON).
Service Paths
The service Uniform Resource Identifier (URI) for offers is:
https://server:port/SC2012/Provider/offers
HTTP Operations
The following table describes the available HTTP operations.
| HTTP operation | Description |
|---|---|
| GET | When you use an HTTP GET operation, all offers are returned. The offers are serialized into a collection of ServiceOffer objects. |
| GET | If you use an HTTP GET operation on the service URI for offers with offer names that are appended to the URI, the specified offer is returned as a ServiceOffer object. For example, to return the offer named Gold, the service URI is https://server:port/SC2012/Provider/offers/Gold. |
| PUT | The HTTP PUT operation updates an existing offer. The offer object should be serialized, and it must be contained in the HTTP request body. |
| POST | The HTTP POST operation creates a new offer. The offer object should be serialized, and it must be contained in the HTTP request body. |
| DELETE | If you use an HTTP DELETE operation on the service URI for offers with offer names that are appended to the URI, the specified offer is deleted. For example, to delete the offer named Gold, the service URI is https://server:port/SC2012/Provider/offers/Gold. |