Commitment Plans - Create Or Update

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.