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


Автоматизация для партнеров

Управление затратами Майкрософт изначально доступно для прямых партнеров, которые подключены к Клиентское соглашение Майкрософт и приобрели план Azure. Для общих задач партнеры и их клиенты могут использовать API Управления затратами. Дополнительные сведения о сценариях неавтотомации см. в разделе "Управление затратами для партнеров".

Примечание.

Хотя в примерах этой статьи показаны определенные версии API, рекомендуется использовать последнюю версию API. Более новые версии API могут иметь улучшенные функциональные возможности. Более поздние версии API поддерживают предыдущие версии.

API управления затратами Майкрософт — прямые и косвенные поставщики

Партнеры, имеющие доступ к областям выставления счетов в арендаторах партнера, могут использовать следующие API для просмотра счетов.

Партнеры могут вызывать API в области подписки независимо от политики затрат, если у них есть доступ к подписке. Другие пользователи, имеющие доступ к подписке, например, клиент или торговый посредник, могут вызывать API только после того, как партнер включит политику расходов для арендатора клиента.

Чтобы получить учетные записи выставления счетов

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2019-10-01-preview 

Чтобы получить список клиентов

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers?api-version=2019-10-01-preview 

Чтобы получить список подписок

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingSubscriptions?api-version=2019-10-01-preview 

Получение списка счетов за определенный период

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/invoices?api-version=2019-10-01-preview&periodStartDate={periodStartDate}&periodEndDate={periodEndDate} 

Вызов API возвращает массив счетов, который имеет элементы, похожие на следующий код JSON.

   {      "id": "/providers/Microsoft.Billing/billingAccounts/{billingAccountID}/billingProfiles/{BillingProfileID}/invoices/{InvoiceID}",      "name": "{InvoiceID}",      "properties": {        "amountDue": {          "currency": "USD",          "value": x.xx        },        ...    } 

Чтобы запросить сведения об использовании, используйте предыдущее значение поля идентификатора и замените его в следующем примере в качестве области.

GET https://management.azure.com/{id}/providers/Microsoft.Consumption/UsageDetails?api-version=2019-10-01 

В примере возвращаются записи об использовании, связанные с конкретным счетом.

Чтобы получить политику для пользователей для просмотра затрат

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerID}/policies/default?api-version=2019-10-01-preview 

Чтобы установить политику для пользователей для просмотра затрат

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerID}/policies/default?api-version=2019-10-01-preview 

Чтобы получить сведения об использовании службы Azure для ученой записи выставления счетов

Для этих сценариев рекомендуется настроить экспорт. Дополнительные сведения см. в статье Извлечение больших наборов данных с помощью экспорта.

Чтобы скачать сведения об использовании службы Azure клиентом

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

Чтобы получить или скачать прайс-лист на потребленные службы Azure

Сначала используйте следующую публикацию.

POST https://management.azure.com/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}/billingProfiles/{billingProfileID}/pricesheet/default/download?api-version=2019-10-01-preview&format=csv" -verbose 

Затем вызовите значение свойства асинхронной операции. Например:

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileID}/pricesheetDownloadOperations/{operation}?sessiontoken=0:11186&api-version=2019-10-01-preview 

Предыдущий звонок "get" возвращает ссылку на скачивание, содержащую прайс-лист.

Чтобы получить агрегированные затраты

POST https://management.azure.com/providers/microsoft.billing/billingAccounts/{billingAccountName}/providers/microsoft.costmanagement/query?api-version=2019-10-01 

Создание бюджета для партнера

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/providers/Microsoft.CostManagement/budgets/partnerworkshopbudget?api-version=2019-10-01 

Создание бюджета для клиента

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerID}/providers/Microsoft.Consumption/budgets/{budgetName}?api-version=2019-10-01 

Удаление бюджета

DELETE https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/budgets/{budgetName}?api-version=2019-10-01