Price Sheet - Download By Billing Profile

Служба:

Cost Management

Версия API:

2024-08-01

Получает URL-адрес для скачивания ценовой таблицы текущего месяца для профиля выставления счетов. Операция поддерживается для учетных записей выставления счетов с типом соглашения Microsoft Partner Agreement или Клиентским соглашением Майкрософт.

Вы можете использовать новую версию API 2023-09-01 для периодов выставления счетов за январь 2023 г. Цены на зарезервированный экземпляр Azure (RI) доступны только в новой версии API.

Из-за роста продукта Azure возможность скачивания ценовых листов Azure в этой предварительной версии будет обновлена из одного csv/json-файла в ZIP-файл, содержащий несколько csv/json-файлов, каждый из которых имеет максимальный размер 75 МБ.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
billingAccountName	path	True	string	Идентификатор, который однозначно идентифицирует учетную запись выставления счетов. Шаблон регулярного выражения: ([A-Za-z0-9]+(-[A-Za-z0-9]+)+):([A-Za-z0-9]+(-[A-Za-z0-9]+)+)_[0-9]{4}-[0-9]{2}-[0-9]{2}
billingProfileName	path	True	string	Идентификатор, который однозначно идентифицирует профиль выставления счетов. Шаблон регулярного выражения: ([A-Za-z0-9]+(-[A-Za-z0-9]+)+)
api-version	query	True	string	Версия API, используемая для этой операции.

Ответы

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

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

azure_auth

Поток OAuth2 Azure Active Directory.

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

Области

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

Примеры

PricesheetDownloadByBillingProfile

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

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/7c05a543-80ff-571e-9f98-1063b3b53cf2:99ad03ad-2d1b-4889-a452-090ad407d25f_2019-05-31/billingProfiles/2USN-TPCD-BG7-TGB/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2024-08-01

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

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

202

Location: https://management.azure.com:443/providers/Microsoft.Billing/billingAccounts/7c05a543-80ff-571e-9f98-1063b3b53cf2:99ad03ad-2d1b-4889-a452-090ad407d25f_2019-05-31/billingProfiles/2USN-TPCD-BG7-TGB/providers/Microsoft.CostManagement/operationResults/45000000-0000-0000-0000-000000000000?sessiontoken=0:000000&api-version=2024-08-01&OperationType=PriceSheet
Retry-After: 60
OData-EntityId: 45000000-0000-0000-0000-000000000000

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

200

{
  "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",
  "expiryTime": "2018-07-21T17:32:28Z"
}

Определения

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

ErrorDetails

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

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

ErrorResponse

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

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

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

• 503 ServiceUnavailable — служба временно недоступна. Повторите попытку после ожидания времени, указанного в заголовке Retry-After.

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

MCAPriceSheetProperties

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

Имя	Тип	Описание
basePrice	string	Цена за единицу в то время, когда клиент входит в систему или цена единицы в момент запуска счетчика обслуживания, если он находится после входа. Это применимо для пользователей Соглашения Enterprise
billingAccountID	string	Уникальный идентификатор учетной записи выставления счетов.
billingAccountName	string	Имя профиля выставления счетов, настроенного для получения счетов. Цены на листе цен связаны с этим профилем выставления счетов.
billingCurrency	string	Валюта, в которой размещаются расходы.
billingProfileId	string	Уникальный идентификатор профиля выставления счетов.
billingProfileName	string	Имя профиля выставления счетов, настроенного для получения счетов. Цены на листе цен связаны с этим профилем выставления счетов.
currency	string	Валюта, в которой отражаются все цены.
effectiveEndDate	string	Дата окончания периода выставления счетов ценовой таблицы
effectiveStartDate	string	Дата начала периода выставления счетов в прайс-листе
marketPrice	string	Текущая цена на список для определенного продукта или услуги. Эта цена без каких-либо переговоров и основана на типе соглашения Майкрософт. Для потребления PriceType цена рынка отражается как цена по мере использования. Для плана экономии PriceType цена на рынок отражает преимущество плана экономии поверх оплаты по мере использования цены на соответствующий срок обязательств. Для PriceType ReservedInstance цена на рынок отражает общую цену 1 или 3-летнего обязательства.
meterCategory	string	Имя категории классификации для измерения. Например, облачные службы, сети и т. д.
meterId	string	Уникальный идентификатор счетчика
meterName	string	Имя счетчика. Счетчик представляет развернутый ресурс службы Azure.
meterRegion	string	Имя региона Azure, где доступен счетчик для службы.
meterSubCategory	string	Имя категории подклассификации счетчика.
meterType	string	Имя типа счетчика
priceType	string	Тип цены для продукта. Например, ресурс Azure с оплатой по мере использования с помощью priceType в качестве потребления. К другим типам цен относятся ЗарезервированнаяInstance и план экономии.
product	string	Имя продукта, начисляющего расходы.
productId	string	Уникальный идентификатор продукта, чей метр используется.
productOrderName	string	Имя приобретенного плана продукта. Указывает, являются ли эти цены стандартными ценами на план Azure, цены на разработку и тестирование и т. д. В настоящее время недоступно для сторонней стороны Azure и счетчиков ReservedInstance.
serviceFamily	number	Тип службы Azure. Например, вычисления, аналитика и безопасность.
skuId	string	Уникальный идентификатор номера SKU
term	string	Срок действия плана экономии Azure или срока резервирования — один год или три года (P1Y или P3Y)
tierMinimumUnits	string	Определяет нижнюю границу диапазона уровней, для которого определены цены. Например, если диапазон равен 0 до 100, уровеньMinimumUnits будет иметь значение 0.
unitOfMeasure	string	Как измеряется использование для службы
unitPrice	string	Цена за единицу в момент выставления счетов для данного продукта или услуги, включаемая любые согласованные скидки поверх рыночной цены. Для PriceType ReservedInstance цена за единицу отражает общую стоимость 1 или 3-летнего обязательства, включая скидки. Примечание. Цена за единицу не совпадает с эффективной ценой в сведениях об использовании, когда службы имеют разностные цены на разных уровнях. Если у служб есть многоуровневые цены, эффективная цена — это смешанная ставка по уровням и не отображает цену на единицу для конкретного уровня. Смешиваемая цена или эффективная цена — это чистая цена для потребляемого количества, охватывающего несколько уровней (где каждая категория имеет определенную цену на единицу).

PricesheetDownloadProperties

URL-адрес для скачивания созданного отчета.

Имя	Тип	Описание
downloadFileProperties	MCAPriceSheetProperties	Свойства в скачанном файле
downloadUrl	string	URL-адрес для скачивания созданного отчета.
expiryTime	string	Время, в течение которого URL-адрес отчета становится недействительным или истекает в формате UTC, например 2020-12-08T05:55:59.4394737Z.