Price Sheet - Download By Billing Account

Referencia

Servicio:: Cost Management

Versión de la API:: 2024-08-01

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 pattern: ^[0-9]*$	Nombre del período de facturación.
api-version	query	True	string minLength: 1	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.

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

HTTP

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

status code:: 202

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 code:: 200

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

Object

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 (date-time)	Fecha de finalización efectiva del período de facturación de la hoja de precios
effectiveStartDate	string (date-time)	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

Object

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

Object

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

Object

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 (date-time)	Descargue la validez del vínculo.
status	OperationStatusType	Estado de la operación de larga duración.

OperationStatusType

Enumeración

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

Valor	Description
Completed
Failed
Running

Compartir a través de

Price Sheet - Download By Billing Account

Parámetros de identificador URI

Respuestas

Seguridad

azure_auth

Ámbitos

Ejemplos

EAPriceSheetForBillingPeriod

Solicitud de ejemplo

Respuesta de muestra

Definiciones

EAPriceSheetProperties

ErrorDetails

ErrorResponse

OperationStatus

OperationStatusType

Recursos adicionales