Поделиться через


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

Имя В Обязательно Тип Описание
subscriptionId
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: 1
maximum: 1000

Можно использовать для ограничения количества результатов до первых N результатов.

Ответы

Имя Тип Описание
200 OK

PriceSheetResult

Операция Azure успешно завершена.

Other Status Codes

ErrorResponse

Непредвиденное сообщение об ошибке.

Безопасность

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
      }
    ]
  }
}

Определения

Имя Описание
createdByType

Тип удостоверения, создавшего ресурс.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

ErrorDetail

Сведения об ошибке.

ErrorResponse

Ответ на ошибку

MeterDetails

Свойства сведений о счетчике.

PriceSheetProperties

Свойства ценовой таблицы.

PriceSheetResult

Ресурс ценовой таблицы.

SavingsPlan

Свойства сберегательного плана.

systemData

Метаданные, относящиеся к созданию и последнему изменении ресурса.

createdByType

Тип удостоверения, создавшего ресурс.

Значение Описание
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя Тип Описание
info

object

Дополнительные сведения.

type

string

Дополнительный тип сведений.

ErrorDetail

Сведения об ошибке.

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.

code

string

Код ошибки.

details

ErrorDetail[]

Сведения об ошибке.

message

string

Сообщение об ошибке.

target

string

Целевой объект ошибки.

ErrorResponse

Ответ на ошибку

Имя Тип Описание
error

ErrorDetail

Объект ошибки.

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

MeterDetails

Сведения о счетчике. По умолчанию это не заполняется, если он не указан в $expand.

meterId

string (uuid)

Идентификатор измерения (GUID)

offerId

string

Идентификатор предложения

partNumber

string

Номер части

savingsPlan

SavingsPlan

Сведения о сберегательном плане

unitOfMeasure

string

Единица измерения

unitPrice

number (decimal)

Цена за единицу

PriceSheetResult

Ресурс ценовой таблицы.

Имя Тип Описание
etag

string

eTag ресурса. Для обработки сценария параллельного обновления это поле будет использоваться для определения того, обновляет ли пользователь последнюю версию или нет.

id

string

Полный идентификатор ресурса для ресурса. Пример - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Имя ресурса

properties.download

MeterDetails

Сведения о скачивании прайс-листа.

properties.nextLink

string

Ссылка (URL-адрес) на следующую страницу результатов.

properties.pricesheets

PriceSheetProperties[]

прейскурант;

systemData

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

createdByType

Тип удостоверения, создавшего ресурс.

lastModifiedAt

string (date-time)

Метка времени последнего изменения ресурса (UTC)

lastModifiedBy

string

Идентификатор, который последний раз изменил ресурс.

lastModifiedByType

createdByType

Тип удостоверения, который последний раз изменил ресурс.