Microsoft Cloud Solutions Offer

/cloud-solutions-plan

GET

Get a list of Cloud Solutions Offers available for reseller. These include the offers a reseller can buy from his parent as well as his own offers (in case a reseller is a provisioner of Cloud Solutions products himself).

Request parameters

All values are optional.

id string The UUID or coma-separated UUIDs of the offer(s)
name string The name of the offer. A part of the name may be specified here as well.

JSON response

Possible errors

Sample

curl \
--request GET \
--user "{{api_username}}:{{api_key}}" \
"{{api_base_url}}/cloud-solutions-plan?name=office" | python -m json.tool

POST

Create a Cloud Solutions Offer. Only product provisioner can create offers.

JSON request

name string The name of the Offer.
interval integer The renew interval for the Offer (in months).
description string The description of the Offer.

JSON response

Possible errors

Sample

curl \
--request POST \
--user "{{api_username}}:{{api_key}}" \
--data '
    {
        "name": "Test Office 365 Offer",
        "interval": "1",
        "description": "Test description"
    }
' \
"{{api_base_url}}/cloud-solutions-plan" | python -m json.tool

/cloud-solutions-plan/{id}

GET

Get the detailed information about a certain Cloud Solutions Offer.

Request parameters

N/A

JSON response

Possible errors

Sample

curl \
--request GET \
--user "{{api_username}}:{{api_key}}" \
"{{api_base_url}}/cloud-solutions-plan/{id}" | python -m json.tool

PUT

Update the Cloud Solutions Offer. A provisioner can change the original name and description of his Offer. However, this action is also available for non-provisioning resellers. If a non-provisioning reseller invokes this API end-point, a custom Offer name and description will be assigned for this reseller without changing the original Offer’s name and description. In this case all of reseller’s customers will see this Offer with the name and description a reseller has assigned. In that way a reseller can control the appearance of the Cloud Solutions Offers for his customers.

JSON request

name string The name of the Cloud Solutions Offer.
description string The description of the Cloud Solutions Offer.

JSON response

Possible errors

Sample

curl \
--request PUT \
--user "{{api_username}}:{{api_key}}" \
--data '
    {
        "name": "Test Office 365 Offer",
        "description": "Test description"
    }
' \
"{{api_base_url}}/cloud-solutions-plan/{id}" | python -m json.tool

DELETE

Delete the Cloud Solutions Offer. The Offer can be deleted only by provisioning reseller who owns this offer.

Request parameters

N/A

Possible errors

Sample

curl \
--request DELETE \
--user "{{api_username}}:{{api_key}}" \
"{{api_base_url}}/cloud-solutions-plan/{id}" | python -m json.tool