collection_partition

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

Overview

Name	collection_partition
Type	Resource
Id	azure.cosmosdb.collection_partition

Fields

The following fields are returned by SELECT queries:

list_metrics

Name	Datatype	Description
name	object	The name information for the metric.
endTime	string (date-time)	The end time for the metric (ISO-8601 format).
metricValues	array	The metric values for the specified time window and timestep.
partitionId	string	The partition id (GUID identifier) of the metric values.
partitionKeyRangeId	string	The partition key range id (integer identifier) of the metric values.
startTime	string (date-time)	The start time for the metric (ISO-8601 format).
timeGrain	string	The time grain to be used to summarize the metric values.
unit	string	The unit of the metric. Known values are: "Count", "Bytes", "Seconds", "Percent", "CountPerSecond", "BytesPerSecond", and "Milliseconds". (Count, Bytes, Seconds, Percent, CountPerSecond, BytesPerSecond, Milliseconds)

list_usages

Name	Datatype	Description
name	object	The name information for the metric.
currentValue	integer	Current value for this metric.
limit	integer	Maximum value for this metric.
partitionId	string	The partition id (GUID identifier) of the usages.
partitionKeyRangeId	string	The partition key range id (integer identifier) of the usages.
quotaPeriod	string	The quota period used to summarize the usage values.
unit	string	The unit of the metric. Known values are: "Count", "Bytes", "Seconds", "Percent", "CountPerSecond", "BytesPerSecond", and "Milliseconds". (Count, Bytes, Seconds, Percent, CountPerSecond, BytesPerSecond, Milliseconds)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_metrics	select	resource_group_name, account_name, database_rid, collection_rid, subscription_id, $filter		Retrieves the metrics determined by the given filter for the given collection, split by partition.
list_usages	select	resource_group_name, account_name, database_rid, collection_rid, subscription_id	$filter	Retrieves the usages (most recent storage data) for the given collection, split by partition.

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.

Name	Datatype	Description
$filter	string	An OData filter expression that describes a subset of metrics to return. The parameters that can be filtered are name.value (name of the metric, can have an or of multiple names), startTime, endTime, and timeGrain. The supported operator is eq. Required.
account_name	string	Cosmos DB database account name. Required.
collection_rid	string	Cosmos DB collection rid. Required.
database_rid	string	Cosmos DB database rid. Required.
resource_group_name	string	The name of the resource group. The name is case insensitive. Required.
subscription_id	string
$filter	string	An 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). Default value is None.

SELECT examples

list_metrics

Retrieves the metrics determined by the given filter for the given collection, split by partition.

SELECT
name,
endTime,
metricValues,
partitionId,
partitionKeyRangeId,
startTime,
timeGrain,
unit
FROM azure.cosmosdb.collection_partition
WHERE resource_group_name = '{{ resource_group_name }}' -- required
AND account_name = '{{ account_name }}' -- required
AND database_rid = '{{ database_rid }}' -- required
AND collection_rid = '{{ collection_rid }}' -- required
AND subscription_id = '{{ subscription_id }}' -- required
AND $filter = '{{ $filter }}' -- required
;

list_usages

Retrieves the usages (most recent storage data) for the given collection, split by partition.

SELECT
name,
currentValue,
limit,
partitionId,
partitionKeyRangeId,
quotaPeriod,
unit
FROM azure.cosmosdb.collection_partition
WHERE resource_group_name = '{{ resource_group_name }}' -- required
AND account_name = '{{ account_name }}' -- required
AND database_rid = '{{ database_rid }}' -- required
AND collection_rid = '{{ collection_rid }}' -- required
AND subscription_id = '{{ subscription_id }}' -- required
AND $filter = '{{ $filter }}'
;