Compartir a través de


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
billingAccountId
path True

string

BillingAccount ID

billingPeriodName
path True

string

Nombre del período de facturación.

Patrón de Regex: ^[0-9]*$

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

OperationStatus

De acuerdo. La solicitud se ha realizado correctamente.

202 Accepted

Aceptado.

Encabezados

  • Location: string
  • Retry-After: string
Other Status Codes

ErrorResponse

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
EAPriceSheetProperties

Las propiedades de la hoja de precios de EA. Las propiedades compatibles con la versión 2024-08-01 son las siguientes:

ErrorDetails

Detalles del error.

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

OperationStatus

Estado de la operación de larga duración.

OperationStatusType

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

ErrorDetails

Detalles del error.

OperationStatus

Estado de la operación de larga duración.

Nombre Tipo Description
properties.downloadFileProperties

EAPriceSheetProperties

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

OperationStatusType

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