Events - List By Billing Account

Service:

Consumption

API Version:

2021-10-01

Список событий, которые уменьшает кредиты Azure или Microsoft Azure обязательства по использованию для учетной записи выставления счетов или профиля выставления счетов для заданной даты начала и окончания.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/events?api-version=2021-10-01

With optional parameters:

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/events?api-version=2021-10-01&$filter={$filter}

Параметры URI

Name	In	Required	Type	Description
billingAccountId	path	True	string	Идентификатор BillingAccount
api-version	query	True	string	Версия API, используемая с клиентским запросом. Текущая версия — 2021-10-01.
$filter	query		string	Может использоваться для фильтрации событий по lotId, lotSource и т. д. Фильтр поддерживает "eq", "lt", "gt", "le", "ge" и "and". В настоящее время он не поддерживает "ne", "or" или "not". Фильтр тегов — это строка пары "значение ключа", где ключ и значение разделяются двоеточием (:).

Ответы

Name	Type	Description
200 OK	Events	Все в порядке. Запрос выполнен успешно.
Other Status Codes	ErrorResponse	Ответ об ошибке, описывающий причину сбоя операции.

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

azure_auth

Azure Active Directory Flow OAuth2.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	олицетворения учетной записи пользователя

Примеры

EventsGetByBillingAccount

EventsGetByBillingAccountWithFilters

EventsGetByBillingAccount

Sample Request

HTTP

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/1234:5678/providers/Microsoft.Consumption/events?api-version=2021-10-01

Java

import com.azure.core.util.Context;

/** Samples for EventsOperation ListByBillingAccount. */
public final class Main {
    /*
     * x-ms-original-file: specification/consumption/resource-manager/Microsoft.Consumption/stable/2021-10-01/examples/EventsGetByBillingAccount.json
     */
    /**
     * Sample code: EventsGetByBillingAccount.
     *
     * @param manager Entry point to ConsumptionManager.
     */
    public static void eventsGetByBillingAccount(com.azure.resourcemanager.consumption.ConsumptionManager manager) {
        manager.eventsOperations().listByBillingAccount("1234:5678", null, Context.NONE);
    }
}

Read this SDK documentation on how to add the SDK to your project and authenticate.

Go

package armconsumption_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/consumption/armconsumption"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/tree/main/specification/consumption/resource-manager/Microsoft.Consumption/stable/2021-10-01/examples/EventsGetByBillingAccount.json
func ExampleEventsClient_NewListByBillingAccountPager() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	client, err := armconsumption.NewEventsClient(cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	pager := client.NewListByBillingAccountPager("1234:5678",
		&armconsumption.EventsClientListByBillingAccountOptions{Filter: nil})
	for pager.More() {
		nextResult, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range nextResult.Value {
			// TODO: use page item
			_ = v
		}
	}
}

Read this SDK documentation on how to add the SDK to your project and authenticate.

JavaScript

const { ConsumptionManagementClient } = require("@azure/arm-consumption");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Lists the events that decrements Azure credits or Microsoft Azure consumption commitment for a billing account or a billing profile for a given start and end date.
 *
 * @summary Lists the events that decrements Azure credits or Microsoft Azure consumption commitment for a billing account or a billing profile for a given start and end date.
 * x-ms-original-file: specification/consumption/resource-manager/Microsoft.Consumption/stable/2021-10-01/examples/EventsGetByBillingAccount.json
 */
async function eventsGetByBillingAccount() {
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const billingAccountId = "1234:5678";
  const credential = new DefaultAzureCredential();
  const client = new ConsumptionManagementClient(credential, subscriptionId);
  const resArray = new Array();
  for await (let item of client.eventsOperations.listByBillingAccount(billingAccountId)) {
    resArray.push(item);
  }
  console.log(resArray);
}

eventsGetByBillingAccount().catch(console.error);

Read this SDK documentation on how to add the SDK to your project and authenticate.

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Consumption/events/eventId1",
      "name": "eventId1",
      "type": "Microsoft.Consumption/events",
      "properties": {
        "lotSource": "ConsumptionCommitment",
        "lotId": "/providers/Microsoft.Billing/billingAccounts/1234:5678/Microsoft.Consumption/lots/G202001083926600XXXXX",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/X3TD-KVTT-BG7-TGB",
        "billingProfileDisplayName": "Contoso Operations Billing",
        "transactionDate": "2019-07-01T00:00:00Z",
        "description": "New MACC Added",
        "charges": {
          "currency": "USD",
          "value": 500
        },
        "newCredit": {
          "currency": "USD",
          "value": 500
        },
        "closedBalance": {
          "currency": "USD",
          "value": 500
        },
        "invoiceNumber": "3304",
        "eventType": "NewCredit"
      }
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Consumption/events/eventId2",
      "name": "eventId2",
      "type": "Microsoft.Consumption/events",
      "properties": {
        "lotSource": "AzurePrepayment",
        "lotId": "/providers/Microsoft.Billing/billingAccounts/1234:5678/Microsoft.Consumption/lots/7004bc39-974d-482e-8e45-caf91dba0870",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/X3TD-KVTT-BG7-TGB",
        "billingProfileDisplayName": "Contoso Operations Billing",
        "transactionDate": "2019-07-01T00:00:00Z",
        "description": "Balance after invoice 3304",
        "charges": {
          "currency": "USD",
          "value": 500
        },
        "closedBalance": {
          "currency": "USD",
          "value": 500
        },
        "invoiceNumber": "3304",
        "eventType": "SettledCharges"
      }
    }
  ]
}

EventsGetByBillingAccountWithFilters

Sample Request

HTTP

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/1234:5678/providers/Microsoft.Consumption/events?api-version=2021-10-01&$filter=lotid eq 'G202001083926600XXXXX' AND lotsource eq 'consumptioncommitment'

Java

import com.azure.core.util.Context;

/** Samples for EventsOperation ListByBillingAccount. */
public final class Main {
    /*
     * x-ms-original-file: specification/consumption/resource-manager/Microsoft.Consumption/stable/2021-10-01/examples/EventsGetByBillingAccountWithFilters.json
     */
    /**
     * Sample code: EventsGetByBillingAccountWithFilters.
     *
     * @param manager Entry point to ConsumptionManager.
     */
    public static void eventsGetByBillingAccountWithFilters(
        com.azure.resourcemanager.consumption.ConsumptionManager manager) {
        manager
            .eventsOperations()
            .listByBillingAccount(
                "1234:5678", "lotid eq 'G202001083926600XXXXX' AND lotsource eq 'consumptioncommitment'", Context.NONE);
    }
}

Read this SDK documentation on how to add the SDK to your project and authenticate.

JavaScript

const { ConsumptionManagementClient } = require("@azure/arm-consumption");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Lists the events that decrements Azure credits or Microsoft Azure consumption commitment for a billing account or a billing profile for a given start and end date.
 *
 * @summary Lists the events that decrements Azure credits or Microsoft Azure consumption commitment for a billing account or a billing profile for a given start and end date.
 * x-ms-original-file: specification/consumption/resource-manager/Microsoft.Consumption/stable/2021-10-01/examples/EventsGetByBillingAccountWithFilters.json
 */
async function eventsGetByBillingAccountWithFilters() {
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const billingAccountId = "1234:5678";
  const filter = "lotid eq 'G202001083926600XXXXX' AND lotsource eq 'consumptioncommitment'";
  const options = { filter };
  const credential = new DefaultAzureCredential();
  const client = new ConsumptionManagementClient(credential, subscriptionId);
  const resArray = new Array();
  for await (let item of client.eventsOperations.listByBillingAccount(billingAccountId, options)) {
    resArray.push(item);
  }
  console.log(resArray);
}

eventsGetByBillingAccountWithFilters().catch(console.error);

Read this SDK documentation on how to add the SDK to your project and authenticate.

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Consumption/events/eventId1",
      "name": "eventId1",
      "type": "Microsoft.Consumption/events",
      "properties": {
        "lotSource": "ConsumptionCommitment",
        "lotId": "/providers/Microsoft.Billing/billingAccounts/1234:5678/Microsoft.Consumption/lots/G202001083926600XXXXX",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/X3TD-KVTT-BG7-TGB",
        "billingProfileDisplayName": "Contoso Operations Billing",
        "transactionDate": "2019-07-01T00:00:00Z",
        "description": "MACC Canceled",
        "canceledCredit": {
          "currency": "USD",
          "value": 200
        },
        "closedBalance": {
          "currency": "USD",
          "value": 500
        },
        "invoiceNumber": "3304",
        "eventType": "CanceledCredit"
      }
    }
  ]
}

Определения

amount	Сумма плюс валюта.
AmountWithExchangeRate	Сумма с обменным курсом.
ErrorDetails	Сведения об ошибке.
ErrorResponse	Ответ об ошибке указывает, что служба не может обработать входящий запрос. Причина указана в сообщении об ошибке. Некоторые ответы на ошибки: 429 TooManyRequests — запрос регулируется. Повторите попытку после ожидания времени, указанного в заголовке x-ms-ratelimit-microsoft.consumption-retry-after. 503 ServiceUnavailable — служба временно недоступна. Повторите попытку по окончании периода времени, указанного в заголовке Retry-After.
Events	Результат перечисления сводки событий.
EventSummary	Ресурс сводки событий.
EventType	Определяет тип события.
Reseller	Свойства торгового посредника.

amount

Сумма плюс валюта.

Name	Type	Description
currency	string	Сумма валюты.
value	number	Сумма.

AmountWithExchangeRate

Сумма с обменным курсом.

Name	Type	Description
currency	string	Сумма валюты.
exchangeRate	number	Обменный курс.
exchangeRateMonth	integer	Месяц обмена.
value	number	Сумма.

ErrorDetails

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

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

ErrorResponse

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

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

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

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

Name	Type	Description
error	ErrorDetails	Сведения об ошибке.

Events

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

Name	Type	Description
nextLink	string	Ссылка (URL-адрес) на следующую страницу результатов.
value	EventSummary[]	Список сводки событий.

EventSummary

Ресурс сводки событий.

Name	Type	Description
eTag	string	eTag ресурса. Для обработки сценария параллельного обновления это поле будет использоваться для определения того, обновляет ли пользователь последнюю версию.
id	string	Идентификатор ресурса.
name	string	Имя ресурса.
properties.adjustments	amount	Сумма корректировки баланса. Свойство недоступно для объекта ConsumptionCommitment.
properties.adjustmentsInBillingCurrency	AmountWithExchangeRate	Сумма корректировки баланса в валюте выставления счетов.
properties.billingCurrency	string	Валюта выставления счетов события.
properties.billingProfileDisplayName	string	Отображаемое имя профиля выставления счетов, для которого произошло событие. Свойство доступно только для учетной записи выставления счетов типа MicrosoftCustomerAgreement.
properties.billingProfileId	string	Идентификатор, однозначно определяющий профиль выставления счетов, для которого произошло событие. Свойство доступно только для учетной записи выставления счетов типа MicrosoftCustomerAgreement.
properties.canceledCredit	amount	Сумма отмененного кредита.
properties.charges	amount	Сумма расходов на события типа SettleCharges и PendingEligibleCharges.
properties.chargesInBillingCurrency	AmountWithExchangeRate	Сумма расходов за события типа SettleCharges и PendingEligibleCharges в валюте выставления счетов.
properties.closedBalance	amount	Сальдо после события.
properties.closedBalanceInBillingCurrency	AmountWithExchangeRate	Баланс в валюте выставления счетов после события.
properties.creditCurrency	string	Кредитная валюта события.
properties.creditExpired	amount	Сумма просроченного кредита или обязательства для события NewCredit или SettleCharges.
properties.creditExpiredInBillingCurrency	AmountWithExchangeRate	Сумма просроченного кредита или обязательства для события NewCredit или SettleCharges в валюте выставления счетов.
properties.description	string	Описание события.
properties.eTag	string	ETag для ресурса.
properties.eventType	EventType	Определяет тип события.
properties.invoiceNumber	string	Номер, однозначно определяющий счет, по которому выставляется счет. Этот параметр будет пустым для необясченных событий.
properties.lotId	string	Идентификатор, однозначно определяющий количество, для которого произошло событие.
properties.lotSource	string	Определяет источник количества, для которого произошло событие.
properties.newCredit	amount	Сумма нового кредита или обязательства для события NewCredit или SettleCharges.
properties.newCreditInBillingCurrency	AmountWithExchangeRate	Сумма нового кредита или обязательства для события NewCredit или SettleCharges в валюте выставления счетов.
properties.reseller	Reseller	Торговый посредник события.
properties.transactionDate	string	Дата события.
type	string	Тип ресурса.

EventType

Определяет тип события.

Name	Type	Description
CreditExpired	string
NewCredit	string
PendingAdjustments	string
PendingCharges	string
PendingExpiredCredit	string
PendingNewCredit	string
SettledCharges	string
UnKnown	string

Reseller

Свойства торгового посредника.

Name	Type	Description
resellerDescription	string	Описание свойства торгового посредника.
resellerId	string	Идентификатор свойства торгового посредника.