Invoices - Download By Billing Subscription

Servicio:

Billing

Versión de la API:

2024-04-01

Obtiene una dirección URL para descargar una factura por suscripción de facturación.

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

Con parámetros opcionales:

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
invoiceName	path	True	string	Identificador que identifica de forma única una factura. Patrón de Regex: ^(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	Identificador que identifica de forma única una suscripción de facturación. Patrón de Regex: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$
api-version	query	True	string	Versión de la API que se va a usar con la solicitud de cliente. La versión actual es 2024-04-01.
documentName	query		string	Identificador que identifica de forma única un documento de factura. Este identificador puede ser un identificador para un PDF de factura, una nota de crédito o un recibo fiscal.

Respuestas

Nombre	Tipo	Description
200 OK	DocumentDownloadResult	Dirección URL segura que se puede usar para descargar una entidad hasta que expire la dirección URL.
202 Accepted		Resultado aceptado por una operación que devuelve un encabezado "Location" que el cliente puede sondear para ver el resultado de la operación. Encabezados Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Respuesta de error que describe por qué se produjo un error en la operación.

Ejemplos

InvoicesDownloadByBillingSubscription

Solicitud de ejemplo

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

Respuesta de muestra

status code:

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"
}

status code:

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

Definiciones

Nombre	Description
DocumentDownloadResult	Dirección URL segura que se puede usar para descargar una entidad hasta que expire la dirección URL.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error

DocumentDownloadResult

Dirección URL segura que se puede usar para descargar una entidad hasta que expire la dirección URL.

Nombre	Tipo	Description
expiryTime	string	Hora UTC en la que expirará la dirección URL de descarga.
url	string	Dirección URL del archivo PDF o .zip.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Detalles del error.
message	string	Mensaje de error.
target	string	Destino del error.

ErrorResponse

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.