你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Invoices - Download Documents By Billing Subscription

服务:

Billing

API 版本:

2024-04-01

获取一个 URL，用于下载多个发票文档（发票 pdf、税务收据、信用单）作为 zip 文件。

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

URI 参数

名称	在	必需	类型	说明
subscriptionId	path	True	string	唯一标识计费订阅的 ID。 正则表达式模式: ^[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。

请求正文

名称	类型	说明
parameters	DocumentDownloadRequest[]	单个文档的下载详细信息列表。

响应

名称	类型	说明
200 OK	DocumentDownloadResult	一个安全 URL，可用于下载实体，直到 URL 过期。
202 Accepted		一个操作接受的结果，该结果返回客户端可以轮询以查看操作结果的“Location”标头。 标头 Location: string Retry-After: integer
Other Status Codes	ErrorResponse	描述操作失败的原因的错误响应。

示例

InvoicesDownloadDocumentsByBillingSubscription

示例请求

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/default/billingSubscriptions/00000000-0000-0000-0000-000000000000/downloadDocuments?api-version=2024-04-01

[
  {
    "documentName": "12345678",
    "invoiceName": "E123456789"
  },
  {
    "documentName": "12345678",
    "invoiceName": "E987654321"
  }
]

示例响应

状态代码:

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

定义

名称	说明
DocumentDownloadRequest	单个文档的下载详细信息列表。
DocumentDownloadResult	一个安全 URL，可用于下载实体，直到 URL 过期。
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
ErrorResponse	错误响应

DocumentDownloadRequest

单个文档的下载详细信息列表。

名称	类型	说明
documentName	string	唯一标识发票文档的 ID。 此 ID 可以是发票 PDF、信用单或税务收据的标识符。 如果省略，将返回发票的最新发票 PDF。
invoiceName	string	唯一标识发票的 ID。

DocumentDownloadResult

一个安全 URL，可用于下载实体，直到 URL 过期。

名称	类型	说明
expiryTime	string	下载 URL 到期的 UTC 时间。
url	string	PDF 或 .zip 文件的 URL。

ErrorAdditionalInfo

资源管理错误附加信息。

名称	类型	说明
info	object	其他信息。
type	string	其他信息类型。

ErrorDetail

错误详细信息。

名称	类型	说明
additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
code	string	错误代码。
details	ErrorDetail[]	错误详细信息。
message	string	错误消息。
target	string	错误目标。

ErrorResponse

错误响应

名称	类型	说明
error	ErrorDetail	错误对象。