Price Sheet - Get
Возвращает ценовую таблицу для подписки. Ценовая таблица доступна только через этот API только 1 мая 2014 г. или более поздней версии.
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/pricesheets/default?api-version=2024-08-01
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/pricesheets/default?api-version=2024-08-01&$expand={$expand}&$skiptoken={$skiptoken}&$top={$top}
Параметры URI
| Имя | В | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
subscription
|
path | True |
string minLength: 1 |
Идентификатор целевой подписки. |
|
api-version
|
query | True |
string minLength: 1 |
Версия API, используемая для данной операции. |
|
$expand
|
query |
string |
Может использоваться для расширения свойств/meterDetails в ценовой таблице. По умолчанию эти поля не включаются при возврате ценового листа. |
|
|
$skiptoken
|
query |
string |
Skiptoken используется только в том случае, если предыдущая операция вернула частичный результат. Если предыдущий ответ содержит элемент nextLink, значение элемента nextLink будет включать параметр skiptoken, указывающий начальную точку для последующих вызовов. |
|
|
$top
|
query |
integer (int32) minimum: 1maximum: 1000 |
Можно использовать для ограничения количества результатов до первых N результатов. |
Ответы
| Имя | Тип | Описание |
|---|---|---|
| 200 OK |
Операция Azure успешно завершена. |
|
| Other Status Codes |
Непредвиденное сообщение об ошибке. |
Безопасность
azure_auth
Поток OAuth2 Azure Active Directory.
Тип:
oauth2
Flow:
implicit
URL-адрес авторизации:
https://login.microsoftonline.com/common/oauth2/authorize
Области
| Имя | Описание |
|---|---|
| user_impersonation | олицетворения учетной записи пользователя |
Примеры
PriceSheet
Образец запроса
GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Consumption/pricesheets/default?api-version=2024-08-01
Пример ответа
{
"name": "default",
"type": "Microsoft.Consumption/pricesheets",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201702/providers/Microsoft.Consumption/pricesheets/default",
"properties": {
"nextLink": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/microsoft.consumption/pricesheets/default?api-version=2018-01-31&$skiptoken=AQAAAA%3D%3D",
"pricesheets": [
{
"billingPeriodId": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201702",
"currencyCode": "EUR",
"includedQuantity": 100,
"meterId": "00000000-0000-0000-0000-000000000000",
"offerId": "OfferId 1",
"partNumber": "XX-11110",
"savingsPlan": {
"effectivePrice": 0.002,
"marketPrice": 0.00328,
"term": "P3Y"
},
"unitOfMeasure": "100 Hours",
"unitPrice": 0.00328
}
]
}
}
Определения
| Имя | Описание |
|---|---|
|
created |
Тип удостоверения, создавшего ресурс. |
|
Error |
Дополнительные сведения об ошибке управления ресурсами. |
|
Error |
Сведения об ошибке. |
|
Error |
Ответ на ошибку |
|
Meter |
Свойства сведений о счетчике. |
|
Price |
Свойства ценовой таблицы. |
|
Price |
Ресурс ценовой таблицы. |
|
Savings |
Свойства сберегательного плана. |
|
system |
Метаданные, относящиеся к созданию и последнему изменении ресурса. |
createdByType
Тип удостоверения, создавшего ресурс.
| Значение | Описание |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Дополнительные сведения об ошибке управления ресурсами.
| Имя | Тип | Описание |
|---|---|---|
| info |
object |
Дополнительные сведения. |
| type |
string |
Дополнительный тип сведений. |
ErrorDetail
Сведения об ошибке.
| Имя | Тип | Описание |
|---|---|---|
| additionalInfo |
Дополнительные сведения об ошибке. |
|
| code |
string |
Код ошибки. |
| details |
Сведения об ошибке. |
|
| message |
string |
Сообщение об ошибке. |
| target |
string |
Целевой объект ошибки. |
ErrorResponse
Ответ на ошибку
| Имя | Тип | Описание |
|---|---|---|
| error |
Объект ошибки. |
MeterDetails
Свойства сведений о счетчике.
| Имя | Тип | Описание |
|---|---|---|
| meterCategory |
string |
Категория измерения, например "Облачные службы", "Сети" и т. д. |
| meterLocation |
string |
Расположение, в котором доступна служба Azure. |
| meterName |
string |
Имя счетчика в пределах заданной категории измерения |
| meterSubCategory |
string |
Подкатегорию счетчика, например "Облачные службы A6", "ExpressRoute (IXP)" и т. д. |
| pretaxStandardRate |
number (decimal) |
Цена предварительного описания. |
| serviceName |
string |
Имя службы. |
| serviceTier |
string |
Уровень служб. |
| totalIncludedQuantity |
number (decimal) |
Общее количество, связанное с предложением. |
| unit |
string |
Единица, в которой взимается плата за использование счетчика, например "Часы", "ГБ" и т. д. |
PriceSheetProperties
Свойства ценовой таблицы.
| Имя | Тип | Описание |
|---|---|---|
| billingPeriodId |
string |
Идентификатор ресурса периода выставления счетов, к которому принадлежит использование. |
| currencyCode |
string |
Код Валюты |
| includedQuantity |
number (decimal) |
Включенное качество предложения |
| meterDetails |
Сведения о счетчике. По умолчанию это не заполняется, если он не указан в $expand. |
|
| meterId |
string (uuid) |
Идентификатор измерения (GUID) |
| offerId |
string |
Идентификатор предложения |
| partNumber |
string |
Номер части |
| savingsPlan |
Сведения о сберегательном плане |
|
| unitOfMeasure |
string |
Единица измерения |
| unitPrice |
number (decimal) |
Цена за единицу |
PriceSheetResult
Ресурс ценовой таблицы.
| Имя | Тип | Описание |
|---|---|---|
| etag |
string |
eTag ресурса. Для обработки сценария параллельного обновления это поле будет использоваться для определения того, обновляет ли пользователь последнюю версию или нет. |
| id |
string |
Полный идентификатор ресурса для ресурса. Пример - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| name |
string |
Имя ресурса |
| properties.download |
Сведения о скачивании прайс-листа. |
|
| properties.nextLink |
string |
Ссылка (URL-адрес) на следующую страницу результатов. |
| properties.pricesheets |
прейскурант; |
|
| systemData |
Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy. |
|
| tags |
object |
Теги ресурсов. |
| type |
string |
Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts" |
SavingsPlan
Свойства сберегательного плана.
| Имя | Тип | Описание |
|---|---|---|
| effectivePrice |
number (decimal) |
Экономия эффективная цена |
| marketPrice |
number (decimal) |
Цена на рынок Сберегательного плана |
| term |
string |
Термин "Сберегательная план" |
systemData
Метаданные, относящиеся к созданию и последнему изменении ресурса.
| Имя | Тип | Описание |
|---|---|---|
| createdAt |
string (date-time) |
Метка времени создания ресурса (UTC). |
| createdBy |
string |
Удостоверение, создающее ресурс. |
| createdByType |
Тип удостоверения, создавшего ресурс. |
|
| lastModifiedAt |
string (date-time) |
Метка времени последнего изменения ресурса (UTC) |
| lastModifiedBy |
string |
Идентификатор, который последний раз изменил ресурс. |
| lastModifiedByType |
Тип удостоверения, который последний раз изменил ресурс. |