Price Sheet - Download By Billing Account

Referencia

Servicio:: Cost Management

Versión de la API:: 2023-11-01

Genera la hoja de precios para el período de facturación proporcionado de forma asincrónica en función del identificador de inscripción. Esto es para Enterprise Agreement clientes. Puede usar la nueva versión de api 2023-09-01 en "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download" para períodos de facturación en enero de 2023 en adelante. Con un nuevo esquema detallado a continuación, la nueva hoja de precios proporciona más información 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 de los precios anteriores de Azure Reserved Instance (RI). Debido al crecimiento del producto de Azure, la experiencia de descarga de la hoja de precios de Azure en esta versión preliminar se actualizará desde un único archivo .csv a un archivo ZIP que contenga varios archivos CSV, cada uno con un tamaño máximo de 75 MB.

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2023-11-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description

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 API que se usará para la operación.

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 API que se usará para la operación.

Respuestas

Nombre	Tipo	Description
200 OK	OperationStatus	Aceptar. La solicitud se ha realizado correctamente.
202 Accepted		Accepted. Encabezados Location: string Retry-After: string
Other Status Codes	ErrorResponse	Respuesta de error que describe el motivo del error de la operación.

Nombre

Tipo

Description

200 OK

OperationStatus

Aceptar. La solicitud se ha realizado correctamente.

202 Accepted

Accepted.

Encabezados

Location: string
Retry-After: string

Other Status Codes

ErrorResponse

Respuesta de error que describe el motivo del error de 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	suplantación de su 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=2023-11-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.
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 "Vuelva a intentarlo después de".
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.

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 de Enterprise Agreement
currencyCode	string	Moneda en la que se firmó el Enterprise Agreement
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 tiene ninguna negociación y se basa en el tipo de contrato de Microsoft. Para el consumo de PriceType, el precio de 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 plazo 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	El nombre de la categoría de clasificación del medidor. Por ejemplo, servicios en la nube o redes.
meterId	string	Identificador único del medidor
meterName	string	Nombre del medidor. El medidor representa el recurso de un servicio de Azure que se pueden implementar.
meterRegion	string	Nombre de la región de Azure donde está disponible el medidor del servicio.
meterSubCategory	string	El nombre de la categoría de subclasificación del medidor.
meterType	string	Nombre del tipo de medidor
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 del servicio
unitPrice	string	El precio por unidad en el momento de la facturación de un producto o servicio determinado, incluidos los descuentos negociados 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 lo mismo que el precio efectivo en las descargas de detalles de uso cuando los servicios tienen precios diferentes entre niveles. Si los servicios tienen precios de varios niveles, el precio efectivo es una tarifa mixta en todos los niveles y no muestra un precio unitario específico por nivel. El precio combinado o precio efectivo es el precio neto de la cantidad consumida que se extiende a lo largo de 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 "Vuelva a intentarlo después de".

Nombre	Tipo	Description
error	ErrorDetails	Detalles del error.

OperationStatus

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

Nombre	Tipo	Description
properties.downloadFileProperties	EAPriceSheetProperties	Las 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

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