Price Sheet - Download By Billing Account
Genera la hoja de precios del período de facturación proporcionado de forma asincrónica en función del identificador de inscripción. Esto es para los clientes del Contrato Enterprise.
Migrar a la versión 2024-08-01
Puede usar la versión de api 2024-08-01 con el nuevo URI:
'/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download'
Con un nuevo esquema detallado a continuación, la nueva versión de la hoja de precios proporciona información adicional e incluye los precios de Azure Reserved Instances (RI) para el período de facturación actual. Se recomienda descargar una hoja de precios de Azure para al escribir un nuevo período de facturación si mantenería un registro continuo de los precios anteriores de Azure Reserved Instance (RI).
La hoja de precios de Azure de EA está disponible para los períodos de facturación en los últimos 13 meses. Para solicitar una hoja de precios durante un período de facturación anterior a 13 meses, póngase en contacto con el soporte técnico.
La experiencia de descarga de la hoja de precios de Azure se ha actualizado desde un único archivo .csv a un archivo ZIP que contiene varios archivos .csv, cada uno con un tamaño máximo de 75 MB. La versión 2023-11-01 se ha actualizado para usar el método HTTP POST; a continuación se pueden encontrar detalles.
Todas las versiones de la hoja de precios de Azure Microsoft.Consumption: descarga por cuenta de facturación (incluido el 2022-06-01, 2021-10-01, 2020-01-01-preview, 2019-10-01, 2019-05-01) están programados para retirarse el 01 de junio de 2026 y ya no se admitirán después de esta fecha.
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2024-08-01
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
billing
|
path | True |
string |
BillingAccount ID |
billing
|
path | True |
string |
Nombre del período de facturación. Patrón de Regex: |
api-version
|
query | True |
string |
Versión de la API que se va a usar para esta operación. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
De acuerdo. La solicitud se ha realizado correctamente. |
|
202 Accepted |
Aceptado. Encabezados
|
|
Other Status Codes |
Respuesta de error que describe por qué se produjo un error en la operación. |
Seguridad
azure_auth
Flujo de OAuth2 de Azure Active Directory.
Tipo:
oauth2
Flujo:
implicit
Dirección URL de autorización:
https://login.microsoftonline.com/common/oauth2/authorize
Ámbitos
Nombre | Description |
---|---|
user_impersonation | suplantar la cuenta de usuario |
Ejemplos
EAPriceSheetForBillingPeriod
Solicitud de ejemplo
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/billingPeriods/202311/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2024-08-01
Respuesta de muestra
Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/00000000-0000-0000-0000-000000000000?api-version=2023-09-01
Retry-After: 60
{
"status": "Completed",
"properties": {
"downloadUrl": "https://myaccount.blob.core.windows.net/?restype=service&comp=properties&sv=2015-04-05&ss=bf&srt=s&st=2015-04-29T22%3A18%3A26Z&se=2015-04-30T02%3A23%3A26Z&sr=b&sp=rw&spr=https&sig=G%2TEST%4B",
"validTill": "2023-09-30T17:32:28Z"
}
}
Definiciones
Nombre | Description |
---|---|
EAPrice |
Las propiedades de la hoja de precios de EA. Las propiedades compatibles con la versión 2024-08-01 son las siguientes: |
Error |
Detalles del error. |
Error |
La respuesta de error indica que el servicio no puede procesar la solicitud entrante. El motivo se proporciona en el mensaje de error. Algunas respuestas de error:
|
Operation |
Estado de la operación de larga duración. |
Operation |
Estado de la operación de larga duración. |
EAPriceSheetProperties
Las propiedades de la hoja de precios de EA. Las propiedades compatibles con la versión 2024-08-01 son las siguientes:
Nombre | Tipo | Description |
---|---|---|
basePrice |
string |
El precio unitario en el momento en que el cliente inicia sesión o el precio unitario en el momento del lanzamiento de disponibilidad general del medidor de servicio si es después del inicio de sesión. Esto es aplicable a los usuarios del Contrato Enterprise. |
currencyCode |
string |
Moneda en la que se firmó el Contrato Enterprise |
effectiveEndDate |
string |
Fecha de finalización efectiva del período de facturación de la hoja de precios |
effectiveStartDate |
string |
Fecha de inicio efectiva del período de facturación de la hoja de precios |
enrollmentNumber |
string |
Identificador único de la cuenta de facturación de EA. |
includedQuantity |
string |
Cantidades de un servicio específico al que un cliente de EA tiene derecho a consumir sin cargos incrementales. |
marketPrice |
string |
Precio de lista actual de un producto o servicio determinado. Este precio no está negociando y se basa en el tipo de contrato de Microsoft. Para el consumo de PriceType, el precio del mercado se refleja como el precio de pago por uso. Para priceType Savings Plan, el precio del mercado refleja el beneficio del plan de ahorros sobre el precio de pago por uso para el período de compromiso correspondiente. Para PriceType ReservedInstance, el precio de mercado refleja el precio total del compromiso de 1 o 3 años. Nota: Para los clientes de EA sin negociaciones, el precio del mercado puede aparecer redondeado a una precisión decimal diferente que el precio unitario. |
meterCategory |
string |
Nombre de la categoría de clasificación del medidor. Por ejemplo, Servicios en la nube, Redes, etc. |
meterId |
string |
Identificador único del medidor |
meterName |
string |
Nombre del medidor. El medidor representa el recurso implementable de un servicio de Azure. |
meterRegion |
string |
Nombre de la región de Azure donde está disponible el medidor del servicio. |
meterSubCategory |
string |
Nombre de la categoría de subclasificación de medidor. |
meterType |
string |
Nombre del tipo de medidor |
offerId |
string |
Determina la oferta de Azure asociada a este medidor. [Más información sobre las ofertas de Azure] (https://azure.microsoft.com/en-us/support/legal/offer-details/) |
partNumber |
string |
Número de pieza asociado al medidor |
priceType |
string |
Tipo de precio para un producto. Por ejemplo, un recurso de Azure con una tarifa de pago por uso con priceType como consumo. Otros tipos de precios incluyen ReservedInstance y Plan de ahorro. |
product |
string |
Nombre del producto que acumula los cargos. |
productId |
string |
Identificador único del producto cuyo medidor se consume. |
serviceFamily |
number |
Tipo de servicio de Azure. Por ejemplo, Proceso, Análisis y Seguridad. |
skuId |
string |
Identificador único de la SKU |
term |
string |
Duración del período para el plan de ahorro de Azure o el período de reserva: un año o tres años (P1Y o P3Y) |
unitOfMeasure |
string |
Cómo se mide el uso para el servicio. Nota: El campo "Unit" se ha quitado con la versión 2023-11-01 como duplicado de "UnitofMeasure", use el campo "UnitOfMeasure". |
unitPrice |
string |
El precio por unidad en el momento de la facturación de un producto o servicio determinado, incluido cualquier descuento negociado sobre el precio del mercado. Para PriceType ReservedInstance, el precio unitario refleja el costo total del compromiso de 1 o 3 años, incluidos los descuentos. Nota: El precio unitario no es el mismo que el precio efectivo en las descargas de detalles de uso cuando los servicios tienen precios diferenciales entre los niveles. Si los servicios tienen precios de varios niveles, el precio efectivo es una tarifa combinada entre los niveles y no muestra un precio unitario específico del nivel. El precio combinado o el precio efectivo es el precio neto de la cantidad consumida que abarca los distintos niveles (donde cada nivel tiene un precio unitario específico). |
ErrorDetails
Detalles del error.
Nombre | Tipo | Description |
---|---|---|
code |
string |
Código de error. |
message |
string |
Mensaje de error que indica por qué se produjo un error en la operación. |
ErrorResponse
La respuesta de error indica que el servicio no puede procesar la solicitud entrante. El motivo se proporciona en el mensaje de error.
Algunas respuestas de error:
429 TooManyRequests: la solicitud está limitada. Vuelva a intentarlo después de esperar el tiempo especificado en el encabezado "x-ms-ratelimit-microsoft.consumption-retry-after".
503 ServiceUnavailable: el servicio no está disponible temporalmente. Vuelva a intentarlo después de esperar el tiempo especificado en el encabezado "Retry-After".
Nombre | Tipo | Description |
---|---|---|
error |
Detalles del error. |
OperationStatus
Estado de la operación de larga duración.
Nombre | Tipo | Description |
---|---|---|
properties.downloadFileProperties |
Propiedades del archivo descargado |
|
properties.downloadUrl |
string |
Vínculo (url) para descargar la hoja de precios. |
properties.validTill |
string |
Descargue la validez del vínculo. |
status |
Estado de la operación de larga duración. |
OperationStatusType
Estado de la operación de larga duración.
Nombre | Tipo | Description |
---|---|---|
Completed |
string |
|
Failed |
string |
|
Running |
string |