Skip to main content

catalogs

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

Overview

Namecatalogs
TypeResource
Idazure.reservations.catalogs

Fields

The following fields are returned by SELECT queries:

OK. The request has succeeded.

NameDatatypeDescription
namestringThe name of sku
billingPlansobjectThe billing plan options available for this sku.
capabilitiesarray
locationsarray
msrpobjectPricing information about the sku
resourceTypestringThe type of resource the sku applies to.
restrictionsarray
sizestringThe size of this sku
skuPropertiesarray
termsarrayAvailable reservation terms for this resource
tierstringThe tier of this sku

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectsubscriptionIdreservedResourceType, location, publisherId, offerId, planId, $filter, $skip, $take

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
subscriptionIdstringId of the subscription
$filterstringMay be used to filter by Catalog properties. The filter supports 'eq', 'or', and 'and'.
$skipnumberThe number of reservations to skip from the list before returning results
$takenumberTo number of reservations to return
locationstringFilters the skus based on the location specified in this parameter. This can be an Azure region or global
offerIdstringOffer id used to get the third party products
planIdstringPlan id used to get the third party products
publisherIdstringPublisher id used to get the third party products
reservedResourceTypestringThe type of the resource for which the skus should be provided.

SELECT examples

OK. The request has succeeded.

SELECT
name,
billingPlans,
capabilities,
locations,
msrp,
resourceType,
restrictions,
size,
skuProperties,
terms,
tier
FROM azure.reservations.catalogs
WHERE subscriptionId = '{{ subscriptionId }}' -- required
AND reservedResourceType = '{{ reservedResourceType }}'
AND location = '{{ location }}'
AND publisherId = '{{ publisherId }}'
AND offerId = '{{ offerId }}'
AND planId = '{{ planId }}'
AND $filter = '{{ $filter }}'
AND $skip = '{{ $skip }}'
AND $take = '{{ $take }}'
;