Price Sheet - Download By Billing Account
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 |
---|---|---|---|---|
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 API que se usará para la operación. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Aceptar. La solicitud se ha realizado correctamente. |
|
202 Accepted |
Accepted. Encabezados
|
|
Other Status Codes |
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
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
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. |
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.
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 |
Detalles del error. |
OperationStatus
Estado de la operación de larga duración.
Nombre | Tipo | Description |
---|---|---|
properties.downloadFileProperties |
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 |
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 |