Skip to main content

usages

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

Overview​

Nameusages
TypeResource
Idazure.sql.usages

Fields​

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringResource ID.
nameobjectResource name.
currentValueintegerUsage current value.
limitintegerUsage limit.
requestedLimitintegerUsage requested limit.
typestringResource type.
unitstringUsage unit.

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_by_instance_poolselectresource_group_name, instance_pool_name, subscription_idexpandChildrenGets all instance pool usage metrics.

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
instance_pool_namestringThe name of the instance pool to be retrieved. Required.
resource_group_namestringThe name of the resource group. The name is case insensitive. Required.
subscription_idstring
expandChildrenbooleanOptional request parameter to include managed instance usages within the instance pool. Default value is None.

SELECT examples​

Gets all instance pool usage metrics.

SELECT
id,
name,
currentValue,
limit,
requestedLimit,
type,
unit
FROM azure.sql.usages
WHERE resource_group_name = '{{ resource_group_name }}' -- required
AND instance_pool_name = '{{ instance_pool_name }}' -- required
AND subscription_id = '{{ subscription_id }}' -- required
AND expandChildren = '{{ expandChildren }}'
;