Price Sheet - Download By Billing Account

Ссылка

Служба:: Cost Management

Версия API:: 2024-08-01

Создает ценовую таблицу для предоставленного периода выставления счетов асинхронно на основе идентификатора регистрации. Это для клиентов Соглашения Enterprise.

Миграция на версию 2024-08-01

Вы можете использовать версию API 2024-08-01 с новым универсальным кодом ресурса (URI):

'/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download'

В новой схеме ниже новая версия ценовой таблицы предоставляет дополнительные сведения и включает цены на зарезервированные экземпляры Azure (RI) за текущий период выставления счетов. Мы рекомендуем скачать ценовую таблицу Azure при вводе нового периода выставления счетов, если вы сохраните текущую запись о ценах на зарезервированный экземпляр Azure (RI).

Ценовая таблица EA Azure доступна за период выставления счетов за последние 13 месяцев. Чтобы запросить ценовую таблицу за период выставления счетов старше 13 месяцев, обратитесь в службу поддержки.

Интерфейс загрузки ценовой таблицы Azure обновлен из одного .csv файла в ZIP-файл, содержащий несколько .csv файлов, каждый из которых имеет максимальный размер 75 МБ. Обновлена версия 2023-11-01 для использования метода HTTP POST; Дополнительные сведения см. ниже.

Все версии ценовой таблицы Microsoft.Consumption Azure. Скачивание по учетной записи выставления счетов (включая 2022-06-01, 2021-10-01, 2020-01-preview, 2019-10-01, 2019-05-01) планируется выйти на пенсию 01 июня 2026 года и больше не будет поддерживаться после этой даты.

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2024-08-01

Параметры URI

Имя В Обязательно Тип Описание

Имя	В	Обязательно	Тип	Описание
billingAccountId	path	True	string	Идентификатор BillingAccount
billingPeriodName	path	True	string	Имя периода выставления счетов. Шаблон регулярного выражения: `^[0-9]*$`
api-version	query	True	string	Версия API, используемая для этой операции.

billingAccountId

path

True

string

Идентификатор BillingAccount

billingPeriodName

path

True

string

Имя периода выставления счетов.

Шаблон регулярного выражения: ^[0-9]*$

api-version

query

True

string

Версия API, используемая для этой операции.

Ответы

Имя	Тип	Описание
200 OK	OperationStatus	ХОРОШО. Запрос выполнен успешно.
202 Accepted		Принятый. Заголовки Location: string Retry-After: string
Other Status Codes	ErrorResponse	Ответ на ошибку, описывающий причину сбоя операции.

Имя

Тип

Описание

200 OK

OperationStatus

ХОРОШО. Запрос выполнен успешно.

202 Accepted

Принятый.

Заголовки

Location: string
Retry-After: string

Other Status Codes

ErrorResponse

Ответ на ошибку, описывающий причину сбоя операции.

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

azure_auth

Поток OAuth2 Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

EAPriceSheetForBillingPeriod

Образец запроса

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/billingPeriods/202311/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2024-08-01

Пример ответа

Код состояния:: 202

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/00000000-0000-0000-0000-000000000000?api-version=2023-09-01
Retry-After: 60

Код состояния:: 200

{
  "status": "Completed",
  "properties": {
    "downloadUrl": "https://myaccount.blob.core.windows.net/?restype=service&comp=properties&sv=2015-04-05&ss=bf&srt=s&st=2015-04-29T22%3A18%3A26Z&se=2015-04-30T02%3A23%3A26Z&sr=b&sp=rw&spr=https&sig=G%2TEST%4B",
    "validTill": "2023-09-30T17:32:28Z"
  }
}

Определения

Имя	Описание
EAPriceSheetProperties	Свойства ценовой таблицы EA. Свойства, поддерживаемые в версии 2024-08-01, как показано ниже.
ErrorDetails	Сведения об ошибке.
ErrorResponse	Ответ на ошибку указывает, что служба не может обработать входящий запрос. Причина указана в сообщении об ошибке. Некоторые ответы на ошибки: 429 TooManyRequests — запрос регулируется. Повторите попытку после ожидания времени, указанного в заголовке x-ms-ratelimit-microsoft.consumption-retry-after. 503 ServiceUnavailable — служба временно недоступна. Повторите попытку после ожидания времени, указанного в заголовке Retry-After.
OperationStatus	Состояние длительной операции.
OperationStatusType	Состояние длительной операции.

EAPriceSheetProperties

Свойства ценовой таблицы EA. Свойства, поддерживаемые в версии 2024-08-01, как показано ниже.

Имя	Тип	Описание
basePrice	string	Цена за единицу в то время, когда клиент входит в систему или цена единицы в момент запуска счетчика обслуживания, если он находится после входа. Это применимо для пользователей Соглашения Enterprise
currencyCode	string	Валюта, в которой подписано соглашение Enterprise
effectiveEndDate	string	Дата окончания периода выставления счетов ценовой таблицы
effectiveStartDate	string	Дата начала периода выставления счетов в прайс-листе
enrollmentNumber	string	Уникальный идентификатор учетной записи выставления счетов EA.
includedQuantity	string	Количество конкретной службы, к которой клиент EA имеет право потреблять без добавочных расходов.
marketPrice	string	Текущая цена на список для определенного продукта или услуги. Эта цена без каких-либо переговоров и основана на типе соглашения Майкрософт. Для потребления PriceType цена рынка отражается как цена по мере использования. Для плана экономии PriceType цена на рынок отражает преимущество плана экономии поверх оплаты по мере использования цены на соответствующий срок обязательств. Для PriceType ReservedInstance цена на рынок отражает общую цену 1 или 3-летнего обязательства. Примечание. Для клиентов EA без переговоров цена на рынок может округлиться до другой десятичной точности, чем цена за единицу.
meterCategory	string	Имя категории классификации для измерения. Например, облачные службы, сети и т. д.
meterId	string	Уникальный идентификатор счетчика
meterName	string	Имя счетчика. Счетчик представляет развернутый ресурс службы Azure.
meterRegion	string	Имя региона Azure, где доступен счетчик для службы.
meterSubCategory	string	Имя категории подклассификации счетчика.
meterType	string	Имя типа счетчика
offerId	string	Определяет предложение Azure, связанное с этим счетчиком. [Дополнительные сведения о предложениях Azure] (https://azure.microsoft.com/en-us/support/legal/offer-details/)
partNumber	string	Номер части, связанный с счетчиком
priceType	string	Тип цены для продукта. Например, ресурс Azure с оплатой по мере использования с помощью priceType в качестве потребления. К другим типам цен относятся ЗарезервированнаяInstance и план экономии.
product	string	Имя продукта, начисляющего расходы.
productId	string	Уникальный идентификатор продукта, чей метр используется.
serviceFamily	number	Тип службы Azure. Например, вычисления, аналитика и безопасность.
skuId	string	Уникальный идентификатор номера SKU
term	string	Срок действия плана экономии Azure или срока резервирования — один год или три года (P1Y или P3Y)
unitOfMeasure	string	Как измеряется использование для службы. Примечание. Поле Unit было удалено с версией 2023-11-01 в качестве дубликата "UnitofMeasure", используйте поле UnitOfMeasure.
unitPrice	string	Цена за единицу в момент выставления счетов для данного продукта или услуги, включаемая любые согласованные скидки поверх рыночной цены. Для PriceType ReservedInstance цена за единицу отражает общую стоимость 1 или 3-летнего обязательства, включая скидки. Примечание. Цена за единицу не совпадает с эффективной ценой в сведениях об использовании, когда службы имеют разностные цены на разных уровнях. Если у служб есть многоуровневые цены, эффективная цена — это смешанная ставка по уровням и не отображает цену на единицу для конкретного уровня. Смешиваемая цена или эффективная цена — это чистая цена для потребляемого количества, охватывающего несколько уровней (где каждая категория имеет определенную цену на единицу).

ErrorDetails

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

Имя	Тип	Описание
code	string	Код ошибки.
message	string	Сообщение об ошибке, указывающее, почему операция завершилась ошибкой.

ErrorResponse

Ответ на ошибку указывает, что служба не может обработать входящий запрос. Причина указана в сообщении об ошибке.

Некоторые ответы на ошибки:

429 TooManyRequests — запрос регулируется. Повторите попытку после ожидания времени, указанного в заголовке x-ms-ratelimit-microsoft.consumption-retry-after.
503 ServiceUnavailable — служба временно недоступна. Повторите попытку после ожидания времени, указанного в заголовке Retry-After.

Имя	Тип	Описание
error	ErrorDetails	Сведения об ошибке.

OperationStatus

Состояние длительной операции.

Имя	Тип	Описание
properties.downloadFileProperties	EAPriceSheetProperties	Свойства в скачанном файле
properties.downloadUrl	string	Ссылка (URL-адрес), чтобы скачать ценовую таблицу.
properties.validTill	string	Скачать допустимость ссылки.
status	OperationStatusType	Состояние длительной операции.

OperationStatusType

Состояние длительной операции.

Имя	Тип	Описание
Completed	string
Failed	string
Running	string

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

Price Sheet - Download By Billing Account

Параметры URI

Ответы

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

azure_auth

Области

Примеры

EAPriceSheetForBillingPeriod

Образец запроса

Пример ответа

Определения

EAPriceSheetProperties

ErrorDetails

ErrorResponse

OperationStatus

OperationStatusType

Дополнительные ресурсы