Skip to main content

usages

Creates, updates, deletes, gets or lists a usages resource.

Overview

Nameusages
TypeResource
Idazure.cognitive_services.usages

Fields

The following fields are returned by SELECT queries:

OK.

NameDatatypeDescription
nameobjectThe name information for the metric.
currentValuenumber (double)Current value for this metric.
limitnumber (double)Maximum value for this metric.
nextResetTimestringNext reset time for current quota.
quotaPeriodstringThe quota period used to summarize the usage values.
statusstringCognitive Services account quota usage status.
unitstringThe unit of the metric.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
listselectsubscriptionId, location$filterGet usages for the requested subscription

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
locationstringResource location.
subscriptionIdstringThe ID of the target subscription.
$filterstringAn OData filter expression that describes a subset of usages to return. The supported parameter is name.value (name of the metric, can have an or of multiple names).

SELECT examples

Get usages for the requested subscription

SELECT
name,
currentValue,
limit,
nextResetTime,
quotaPeriod,
status,
unit
FROM azure.cognitive_services.usages
WHERE subscriptionId = '{{ subscriptionId }}' -- required
AND location = '{{ location }}' -- required
AND $filter = '{{ $filter }}'
;