Invoices - Download By Billing Subscription

Служба:

Billing

Версия API:

2024-04-01

Получает URL-адрес для скачивания счета по подписке выставления счетов.

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/default/billingSubscriptions/{subscriptionId}/invoices/{invoiceName}/download?api-version=2024-04-01

С использованием необязательных параметров:

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/default/billingSubscriptions/{subscriptionId}/invoices/{invoiceName}/download?documentName={documentName}&api-version=2024-04-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
invoiceName	path	True	string	Идентификатор, который однозначно идентифицирует счет. Шаблон регулярного выражения: ^(H[0-9]-[A-Z0-9]+)$|^(?:([GHT]|HT){1}[A-Z0-9]{9})$|^(?:[D]{1}[A-Z0-9]{9})$|^(?:E{1}[B-Z0-9]{1}[A-Z0-9]{8})$|^(?:EA[A-Z0-9]{8})$
subscriptionId	path	True	string	Идентификатор, который однозначно идентифицирует подписку на выставление счетов. Шаблон регулярного выражения: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$
api-version	query	True	string	Версия API, используемая с клиентским запросом. Текущая версия — 2024-04-01.
documentName	query		string	Идентификатор, который однозначно идентифицирует документ счета. Этот идентификатор может быть идентификатором PDF-файла счета, кредитной заметки или налоговой квитанции.

Ответы

Имя	Тип	Описание
200 OK	DocumentDownloadResult	Безопасный URL-адрес, который можно использовать для скачивания сущности до истечения срока действия URL-адреса.
202 Accepted		Результат операции, возвращающий заголовок Location, который клиент может опрашивать, чтобы просмотреть результат операции. Заголовки Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Ответ на ошибку, описывающий причину сбоя операции.

Примеры

InvoicesDownloadByBillingSubscription

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

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/default/billingSubscriptions/00000000-0000-0000-0000-000000000000/invoices/E123456789/download?documentName=12345678&api-version=2024-04-01

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

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

200

{
  "expiryTime": "2023-02-16T17:32:28Z",
  "url": "https://myaccount.blob.core.windows.net/invoices/1383724.pdf?sv=2019-02-02&sr=b&sp=r"
}

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

202

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/default/billingSubscriptions/00000000-0000-0000-0000-000000000000/operationResults/invoiceDownload_11111111-1111-1111-1111-111111111111?api-version=2024-04-01
Retry-After: 10

Определения

Имя	Описание
DocumentDownloadResult	Безопасный URL-адрес, который можно использовать для скачивания сущности до истечения срока действия URL-адреса.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку

DocumentDownloadResult

Безопасный URL-адрес, который можно использовать для скачивания сущности до истечения срока действия URL-адреса.

Имя	Тип	Описание
expiryTime	string	Время в формате UTC при истечении срока действия URL-адреса скачивания.
url	string	URL-адрес PDF-файла или .zip файла.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Дополнительный тип сведений.

ErrorDetail

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

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Ответ на ошибку

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.