Share via

Transactions - List By Invoice

  • Ссылка
Service:
Billing
API Version:
2020-05-01

Выводит список транзакций для счета. Транзакции включают покупки, возмещение средств и расходы на использование Azure.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/invoices/{invoiceName}/transactions?api-version=2020-05-01

Параметры URI

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

string

Идентификатор, однозначно определяющий учетную запись выставления счетов.
invoiceName
 path True

string

Идентификатор, однозначно определяющий счет.
api-version
 query True

string

Версия API, которая будет использоваться с клиентским запросом. Текущая версия — 01.05.2020.

Ответы

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

TransactionListResult

Все в порядке. Запрос выполнен успешно.
Other Status Codes

ErrorResponse

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

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

azure_auth

Поток OAuth2 в Azure Active Directory.

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

Scopes

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

Примеры

TransactionsListByInvoice

Sample Request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/invoices/{invoiceName}/transactions?api-version=2020-05-01

Sample Response

Status code:
200 
{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}/transactions/41000000-0000-0000-0000-000000000000",
      "name": "41000000-0000-0000-0000-000000000000",
      "type": "Microsoft.Billing/billingAccounts/transactions",
      "properties": {
        "kind": "all",
        "date": "2018-05-01T00:00:00Z",
        "invoice": "2344233",
        "invoiceId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/invoices/2344233",
        "productFamily": "Storage",
        "productTypeId": "A12345",
        "productType": "VM Instance",
        "productDescription": "Standard D1, US West 3",
        "transactionType": "Purchase",
        "transactionAmount": {
          "currency": "USD",
          "value": 5000
        },
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/22000000-0000-0000-0000-000000000000",
        "invoiceSectionDisplayName": "Contoso operations invoiceSection",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}",
        "billingProfileDisplayName": "Contoso operations billing",
        "azurePlan": "Microsoft Azure Plan for DevTest",
        "azureCreditApplied": {
          "currency": "USD",
          "value": 2000
        },
        "billingCurrency": "USD",
        "discount": 0.1,
        "effectivePrice": {
          "currency": "USD",
          "value": 10
        },
        "exchangeRate": 1,
        "marketPrice": {
          "currency": "USD",
          "value": 20
        },
        "pricingCurrency": "USD",
        "quantity": 1,
        "servicePeriodStartDate": "2018-05-01T00:00:00Z",
        "servicePeriodEndDate": "2018-09-30T00:00:00Z",
        "subTotal": {
          "currency": "USD",
          "value": 4500
        },
        "tax": {
          "currency": "USD",
          "value": 500
        },
        "unitOfMeasure": "1 Minute",
        "units": 11.25,
        "unitType": "1 Runtime Minute"
      }
    },
    {
      "id": "/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}/transactions/51000000-0000-0000-0000-000000000000",
      "name": "51000000-0000-0000-0000-000000000000",
      "type": "Microsoft.Billing/billingAccounts/transactions",
      "properties": {
        "kind": "all",
        "date": "2018-04-01T00:00:00Z",
        "invoice": "pending",
        "productFamily": "Storage",
        "productTypeId": "A12345",
        "productType": "VM Instance",
        "productDescription": "Standard Support",
        "transactionType": "Cancel",
        "transactionAmount": {
          "currency": "USD",
          "value": 50
        },
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/22000000-0000-0000-0000-000000000000",
        "invoiceSectionDisplayName": "Contoso operations invoiceSection",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}",
        "billingProfileDisplayName": "Contoso operations billing",
        "azurePlan": "Microsoft Azure Plan for DevTest",
        "azureCreditApplied": {
          "currency": "USD",
          "value": 20
        },
        "billingCurrency": "USD",
        "discount": 0.1,
        "effectivePrice": {
          "currency": "USD",
          "value": 10
        },
        "exchangeRate": 1,
        "marketPrice": {
          "currency": "USD",
          "value": 20
        },
        "pricingCurrency": "USD",
        "quantity": 1,
        "servicePeriodStartDate": "2018-05-01T00:00:00Z",
        "servicePeriodEndDate": "2018-09-30T00:00:00Z",
        "subTotal": {
          "currency": "USD",
          "value": 45
        },
        "tax": {
          "currency": "USD",
          "value": 5
        },
        "unitOfMeasure": "1 Minute",
        "units": 1.25,
        "unitType": "1 Runtime Minute"
      }
    }
  ]
}

Определения

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

Сумма.
ErrorDetails

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

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

Тип транзакции.
Transaction

Транзакция.
TransactionListResult

Список транзакций.
TransactionTypeKind

Тип транзакции. Возможные варианты: все или резервирование.

Amount

Сумма.

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

string

Валюта для значения суммы.
value

number

Значение суммы.

ErrorDetails

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

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

string

Код ошибки.
details

ErrorSubDetails[]

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

string

Сообщение об ошибке, указывающее, почему операция завершилась сбоем.
target

string

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

ErrorResponse

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

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

ErrorDetails

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

ErrorSubDetails

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

string

Код ошибки.
message

string

Сообщение об ошибке, указывающее, почему операция завершилась сбоем.
target

string

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

ReservationType

Тип транзакции.

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

string

Usage Charge

string

Transaction

Транзакция.

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

string

Идентификатор ресурса.
name

string

Имя ресурса.
properties.azureCreditApplied

Amount

Сумма всех кредитов Azure, автоматически примененных к этой транзакции.
properties.azurePlan

string

Тип плана Azure подписки, которая использовалась для транзакции.
properties.billingCurrency

string

Код ISO 4217 для валюты, в которой выставляется счет за эту транзакцию.
properties.billingProfileDisplayName

string

Имя профиля выставления счетов, для которого будет выставлен счет за транзакцию.
properties.billingProfileId

string

Идентификатор профиля выставления счетов, по которому будет выставлен счет за транзакцию.
properties.customerDisplayName

string

Имя клиента, для которого произошла транзакция. Поле применимо только к учетной записи выставления счетов Соглашение с партнером Майкрософт.
properties.customerId

string

Идентификатор клиента, для которого произошла транзакция. Поле применимо только к учетной записи выставления счетов Соглашение с партнером Майкрософт.
properties.date

string

Дата транзакции.
properties.discount

number

Процентная скидка, если она есть, применяемая к этой транзакции.
properties.effectivePrice

Amount

Цена продукта после применения скидок.
properties.exchangeRate

number

Обменный курс, используемый для преобразования взимаемой суммы в валюту выставления счетов, если применимо.
properties.invoice

string

Счет, по которому был выставлен счет за транзакцию, или "ожидание", если транзакция не выставлена.
properties.invoiceId

string

Идентификатор счета, по которому был выставлен счет за транзакцию. Это поле применимо только к транзакциям, по которым выставляются счета.
properties.invoiceSectionDisplayName

string

Имя раздела счета, в котором будет выставлен счет за транзакцию.
properties.invoiceSectionId

string

Идентификатор раздела счета, в котором будет выставлен счет за транзакцию.
properties.kind

TransactionTypeKind

Тип транзакции. Возможные варианты: все или резервирование.
properties.marketPrice

Amount

Розничная цена продукта.
properties.orderId

string

Идентификатор заказа резервирования. Поле применимо только к резервированию типа транзакций.
properties.orderName

string

Имя заказа на резервирование. Поле применимо только для транзакций с резервированием типа.
properties.pricingCurrency

string

Код ISO 4217 для валюты, в которой указана цена продукта.
properties.productDescription

string

Описание продукта, для которого произошла транзакция.
properties.productFamily

string

Семейство продукта, для которого произошла транзакция.
properties.productType

string

Тип продукта, для которого произошла транзакция.
properties.productTypeId

string

Идентификатор типа продукта, для которого произошла транзакция.
properties.quantity

integer

Количество, приобретенное в транзакции.
properties.servicePeriodEndDate

string

Дата окончания срока действия продукта или дата окончания месяца, в котором закончилось использование.
properties.servicePeriodStartDate

string

Дата покупки продукта или дата начала месяца, в котором началось использование.
properties.subTotal

Amount

Сумма, взимаемая до уплаты налогов для транзакции.
properties.subscriptionId

string

Идентификатор подписки, которая использовалась для транзакции. Поле применимо только к резервированию типа транзакций.
properties.subscriptionName

string

Имя подписки, которая использовалась для транзакции. Поле применимо только к резервированию типа транзакций.
properties.tax

Amount

Сумма налога, применяемая к транзакции.
properties.transactionAmount

Amount

Плата, связанная с транзакцией.
properties.transactionType

ReservationType

Тип транзакции.
properties.unitOfMeasure

string

Единица измерения, используемая для выставления счетов за продукт. Например, счета за службы вычислений выставляются на почасовой основе.
properties.unitType

string

Описание единицы измерения для данного продукта.
properties.units

number

Количество единиц, используемых для данного продукта.
type

string

Тип ресурса.

TransactionListResult

Список транзакций.

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

string

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

number

Общее количество записей.
value

Transaction[]

Список транзакций.

TransactionTypeKind

Тип транзакции. Возможные варианты: все или резервирование.

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

string

reservation

string