Commitment Plans - Create Or Update

Service:

ML Studio (classic)

API Version:

2016-05-01-preview

Create a new Azure ML commitment plan resource or updates an existing one.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearning/commitmentPlans/{commitmentPlanName}?api-version=2016-05-01-preview

URI Parameters

Name	In	Required	Type	Description
commitmentPlanName	path	True	string	The Azure ML commitment plan name.
resourceGroupName	path	True	string	The resource group name.
subscriptionId	path	True	string	Azure Subscription ID.
api-version	query	True	string	The version of the Microsoft.MachineLearning resource provider API to use.

Request Body

Name	Required	Type	Description
location	True	string	Resource location.
etag		string	An entity tag used to enforce optimistic concurrency.
sku		ResourceSku	The commitment plan SKU.
tags		object	User-defined tags for the resource.

Responses

Name	Type	Description
200 OK	CommitmentPlan	OK
201 Created	CommitmentPlan	Created

Definitions

Name	Description
CommitmentPlan	An Azure ML commitment plan resource.
CommitmentPlanProperties	Properties of an Azure ML commitment plan.
PlanQuantity	Represents the quantity a commitment plan provides of a metered resource.
ResourceSku	The SKU of a resource.

CommitmentPlan

An Azure ML commitment plan resource.

Name	Type	Description
etag	string	An entity tag used to enforce optimistic concurrency.
id	string	Resource Id.
location	string	Resource location.
name	string	Resource name.
properties	CommitmentPlanProperties	The commitment plan properties.
sku	ResourceSku	The commitment plan SKU.
tags	object	User-defined tags for the resource.
type	string	Resource type.

CommitmentPlanProperties

Properties of an Azure ML commitment plan.

Name	Type	Description
chargeForOverage	boolean	Indicates whether usage beyond the commitment plan's included quantities will be charged.
chargeForPlan	boolean	Indicates whether the commitment plan will incur a charge.
creationDate	string	The date at which this commitment plan was created, in ISO 8601 format.
includedQuantities	<string,  PlanQuantity>	The included resource quantities this plan gives you.
maxAssociationLimit	integer	The maximum number of commitment associations that can be children of this commitment plan.
maxCapacityLimit	integer	The maximum scale-out capacity for this commitment plan.
minCapacityLimit	integer	The minimum scale-out capacity for this commitment plan.
planMeter	string	The Azure meter which will be used to charge for this commitment plan.
refillFrequencyInDays	integer	The frequency at which this commitment plan's included quantities are refilled.
suspendPlanOnOverage	boolean	Indicates whether this commitment plan will be moved into a suspended state if usage goes beyond the commitment plan's included quantities.

PlanQuantity

Represents the quantity a commitment plan provides of a metered resource.

Name	Type	Description
allowance	number	The quantity added to the commitment plan at an interval specified by its allowance frequency.
amount	number	The quantity available to the plan the last time usage was calculated.
includedQuantityMeter	string	The Azure meter for usage against included quantities.
overageMeter	string	The Azure meter for usage which exceeds included quantities.

ResourceSku

The SKU of a resource.

Name	Type	Description
capacity	integer	The scale-out capacity of the resource. 1 is 1x, 2 is 2x, etc. This impacts the quantities and cost of any commitment plan resource.
name	string	The SKU name. Along with tier, uniquely identifies the SKU.
tier	string	The SKU tier. Along with name, uniquely identifies the SKU.