En esta página, se muestra cómo comenzar a usar la API de estimación de costos y se incluyen ejemplos de solicitudes a la API para situaciones de costo comunes. Si quieres usar la consola de Google Cloud, obtén información para obtener estimaciones en la consola de Google Cloud.
Puedes usar la API de estimación de costos para tener una idea de los costos de las cargas de trabajo hipotéticas. Por ejemplo, si deseas establecer un presupuesto para una aplicación nueva, con la API puedes estimar cuánto podría costar la infraestructura para la aplicación a lo largo del tiempo. También puedes obtener una estimación que incluya créditos de un descuento por compromiso de uso (CUD).
La API admite estimaciones para los siguientes servicios:
- Compute Engine
- Cloud Storage
- CDN Interconnect
- Cloud CDN
- VPC
Si tienes un contrato de precios negociado, también puedes estimar los costos con los precios negociados.
Antes de comenzar
Para llamar a la API, obtén una clave de API.
Si quieres obtener estimaciones con los precios de tu contrato, debes tener el permiso
billing.accounts.getPricing. Si llamas a la API con una cuenta de servicio, esta debe tener el permiso.Los siguientes roles predefinidos tienen el permiso
billing.accounts.getPricing:- Administrador de cuentas de facturación
- Visualizador de cuentas de facturación
De manera opcional, habilita el uso compartido de descuentos para tus CUD. Si no habilitas el uso compartido de los descuentos y tu uso se produce en un proyecto que no forma parte del compromiso, los costos estimados y los costos reales podrían diferir de forma significativa.
Comprende los componentes de una estimación
Cuando definas tus cargas de trabajo para una estimación de costos, ten en cuenta estos factores:
Carga de trabajo: Representa el uso de un solo producto de Google Cloud para el período de la estimación. Por ejemplo, una carga de trabajo puede ser una máquina virtual n2 de Compute Engine durante 1 semana.
En la solicitud a la API, debes definir una lista de cargas de trabajo en el objeto
workloads.Situación de costos: una colección de cargas de trabajo que representa los productos de Google Cloud que necesita tu aplicación. Por ejemplo, una situación de costos podría ser de 5 máquinas virtuales n2 y 4 gibibytes (GiB) de Cloud Storage durante una semana.
En tu solicitud a la API, configuras la situación de costos en el objeto
costScenario, que incluye tu período y la lista de cargas de trabajo.Período: la duración por la que deseas calcular los costos. Puedes obtener estimaciones por una duración entre 1 hora y 10 años.
En tu solicitud a la API, debes definir el período con el objeto
estimateDuration.Segmentos de tiempo: Puedes dividir la estimación en segmentos de tiempo, en los que el uso varía durante un período determinado. Por ejemplo, puedes solicitar una estimación para un período de cuatro semanas, durante el cual comenzarás con 5 VM por una semana, luego aumentarás a 8 VM por dos semanas y reducirás a 3 VM para la semana final.
En la solicitud a la API, debes definir segmentos de tiempo con el objeto
usageRateTimeliney configurar el inicio de un segmento conestimationTimeFrameOffset.Uso: Representa la cantidad de uso durante un segmento de tiempo. Por ejemplo, puedes definir un segmento de tiempo de 5 días, durante el cual deseas usar 6 Gibibytes (GiB) en un bucket de Cloud Storage.
En la solicitud a tu API, especifica el uso mediante el objeto
usage. Cuando realizas una solicitud a la API, si proporcionas una unidad incorrecta para el uso, el mensaje de error incluye la unidad correcta.
Limitaciones
Las cargas de trabajo que puedes modelar mediante la API no pueden duplicar de forma perfecta tus patrones de uso reales. Por ejemplo, puedes modelar cargas de trabajo que cambian por hora con la API, pero el uso de Compute Engine se registra a nivel de microsegundos.
Calcula el uso del modelo que se produce en un solo proyecto. Si tienes descuentos por compromiso de uso (CUD) y habilitaste el uso compartido de descuentos en varios proyectos, las tarifas y los créditos del CUD se atribuyen en todos los proyectos que usan el servicio. Por ejemplo, si el proyecto A consumió $75 de uso y el proyecto B consumió $25, el proyecto A estará cubierto por hasta el 75% del crédito disponible y el proyecto B estará cubierto por hasta el 25%.
Obtén más información sobre cómo se atribuyen tus créditos de CUD.
Si el uso real se produce al final de un mes, es posible que ese uso se registre en el mes de facturación siguiente.
Las estimaciones no incluyen el costo de las herramientas de redes conectadas a las VM de Compute Engine en tu situación de costos.
Las estimaciones no tienen en cuenta los descuentos por uso continuo (SUD).
Las estimaciones no tienen en cuenta los créditos de la cuenta, como los créditos promocionales o los descuentos de ofertas privadas de Cloud Marketplace.
Las estimaciones no tienen en cuenta los cambios futuros en los precios de los productos de Google Cloud.
Ejemplos de situaciones de costos
En los siguientes ejemplos, se muestran las llamadas a la API para obtener estimaciones de costos. Para obtener información detallada sobre el formato de la solicitud, consulta la referencia de la API.
En la respuesta de la API, los costos netos estimados están en los siguientes objetos:
segmentTotalCostEstimate: El costo estimado de un segmento de tiempo.workloadTotalCostEstimate: El costo estimado de una carga de trabajo.
Estima el costo de las máquinas virtuales al precio de lista
Con la siguiente solicitud a la API, se obtiene la estimación para 5 máquinas virtuales (VM) n1 personalizadas, a precio de lista, por 100 horas de uso.
En la solicitud, usageRate indica cuántos recursos forman parte de la situación de costos.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- API_KEY: Es la clave de API de Google Cloud
Método HTTP y URL:
POST https://cloudbilling.googleapis.com/v1beta:estimateCostScenario?key=API_KEY
Cuerpo JSON de la solicitud:
{
"costScenario": {
"scenarioConfig": {
"estimateDuration": "360000s"
},
"workloads": [
{
"name": "vm-example",
"computeVmWorkload": {
"instancesRunning": {
"usageRateTimeline": {
"usageRateTimelineEntries": [
{
"usageRate": 5
}
]
}
},
"machineType": {
"customMachineType": {
"machineSeries": "n1",
"virtualCpuCount": 4,
"memorySizeGb": 4
}
},
"region": "us-central1"
}
}
]
}
}
Para enviar tu solicitud, elige una de estas opciones:
curl
Guarda el cuerpo de la solicitud en un archivo llamado request.json.
Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:
cat > request.json << 'EOF'
{
"costScenario": {
"scenarioConfig": {
"estimateDuration": "360000s"
},
"workloads": [
{
"name": "vm-example",
"computeVmWorkload": {
"instancesRunning": {
"usageRateTimeline": {
"usageRateTimelineEntries": [
{
"usageRate": 5
}
]
}
},
"machineType": {
"customMachineType": {
"machineSeries": "n1",
"virtualCpuCount": 4,
"memorySizeGb": 4
}
},
"region": "us-central1"
}
}
]
}
}
EOFLuego, ejecuta el siguiente comando para enviar tu solicitud de REST:
curl -X POST \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
--output cost-estimate.json \
"https://cloudbilling.googleapis.com/v1beta:estimateCostScenario?key=API_KEY"
PowerShell
Guarda el cuerpo de la solicitud en un archivo llamado request.json.
Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:
@'
{
"costScenario": {
"scenarioConfig": {
"estimateDuration": "360000s"
},
"workloads": [
{
"name": "vm-example",
"computeVmWorkload": {
"instancesRunning": {
"usageRateTimeline": {
"usageRateTimelineEntries": [
{
"usageRate": 5
}
]
}
},
"machineType": {
"customMachineType": {
"machineSeries": "n1",
"virtualCpuCount": 4,
"memorySizeGb": 4
}
},
"region": "us-central1"
}
}
]
}
}
'@ | Out-File -FilePath request.json -Encoding utf8Luego, ejecuta el siguiente comando para enviar tu solicitud de REST:
$headers = @{ }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-OutFile cost-estimate.json `
-Uri "https://cloudbilling.googleapis.com/v1beta:estimateCostScenario?key=API_KEY"cost-estimate.json, con el siguiente contenido.
{
{
"costEstimationResult": {
"segmentCostEstimates": [
{
"segmentStartTime": {
"estimationTimeFrameOffset": "0s"
},
"workloadCostEstimates": [
{
"name": "vm-example",
"skuCostEstimates": [
{
"sku": "services/6F81-5844-456A/skus/ACBC-6999-A1C4",
"usageAmount": 2000,
"usageUnit": "h",
"costEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"units": "66",
"nanos": 348000000
},
"netCostEstimate": {
"currencyCode": "USD",
"units": "66",
"nanos": 348000000
}
}
},
{
"sku": "services/6F81-5844-456A/skus/51E2-59BD-7A6E",
"usageAmount": 2000,
"usageUnit": "GiBy.h",
"costEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"units": "8",
"nanos": 892000000
},
"netCostEstimate": {
"currencyCode": "USD",
"units": "8",
"nanos": 892000000
}
}
}
],
"workloadTotalCostEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"units": "75",
"nanos": 240000000
},
"netCostEstimate": {
"currencyCode": "USD",
"units": "75",
"nanos": 240000000
}
}
}
],
"segmentTotalCostEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"units": "75",
"nanos": 240000000
},
"netCostEstimate": {
"currencyCode": "USD",
"units": "75",
"nanos": 240000000
}
}
}
],
"skus": [
{
"sku": "services/6F81-5844-456A/skus/ACBC-6999-A1C4",
"displayName": "Custom Instance Core running in Americas",
"prices": [
{
"priceType": "RATE",
"rate": {
"tiers": [
{
"price": {
"currencyCode": "USD",
"nanos": 33174000
}
}
],
"unit": "h",
"unitCount": 1
}
}
]
},
{
"sku": "services/6F81-5844-456A/skus/51E2-59BD-7A6E",
"displayName": "Custom Instance Ram running in Americas",
"prices": [
{
"priceType": "RATE",
"rate": {
"tiers": [
{
"price": {
"currencyCode": "USD",
"nanos": 4446000
}
}
],
"unit": "GiBy.h",
"unitCount": 1
}
}
]
}
],
"currencyCode": "USD"
}
}
}
Estima el costo del uso de Cloud Storage al precio del contrato
Con la siguiente solicitud a la API, se obtiene la estimación de 1 mes de 500 GibiBytes (GiB) en asia-southeast2, a un precio de contrato:
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- BILLING_ACCOUNT_ID: El ID de tu cuenta de Facturación de Cloud La cuenta debe tener un contrato de precios personalizado asociado.
Método HTTP y URL:
POST https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID:estimateCostScenario
Cuerpo JSON de la solicitud:
{
"costScenario": {
"workloads": [
{
"name": "combined-example-storage",
"cloudStorageWorkload": {
"region": {
"name": "us-central1"
},
"storageClass": "archive",
"dataStored": {
"usageRateTimeline": {
"unit": "GiBy",
"usageRateTimelineEntries": [
{
"usageRate": 7000
}
]
}
}
}
},
{
"name": "combined-example-compute",
"computeVmWorkload": {
"machineType": {
"predefinedMachineType": {
"machineType": "n2-standard-4"
}
},
"region": "us-central1",
"instancesRunning": {
"usageRateTimeline": {
"usageRateTimelineEntries": [
{
"usageRate": 8
},
{
"usageRate": 11,
"effectiveTime": {
"estimationTimeFrameOffset": "1209600s"
}
}
]
}
}
}
}
],
"scenarioConfig": {
"estimateDuration": "2628000s"
}
}
}
Para enviar tu solicitud, elige una de estas opciones:
curl
Guarda el cuerpo de la solicitud en un archivo llamado request.json.
Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:
cat > request.json << 'EOF'
{
"costScenario": {
"workloads": [
{
"name": "combined-example-storage",
"cloudStorageWorkload": {
"region": {
"name": "us-central1"
},
"storageClass": "archive",
"dataStored": {
"usageRateTimeline": {
"unit": "GiBy",
"usageRateTimelineEntries": [
{
"usageRate": 7000
}
]
}
}
}
},
{
"name": "combined-example-compute",
"computeVmWorkload": {
"machineType": {
"predefinedMachineType": {
"machineType": "n2-standard-4"
}
},
"region": "us-central1",
"instancesRunning": {
"usageRateTimeline": {
"usageRateTimelineEntries": [
{
"usageRate": 8
},
{
"usageRate": 11,
"effectiveTime": {
"estimationTimeFrameOffset": "1209600s"
}
}
]
}
}
}
}
],
"scenarioConfig": {
"estimateDuration": "2628000s"
}
}
}
EOFLuego, ejecuta el siguiente comando para enviar tu solicitud de REST:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
--output cost-estimate.json \
"https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID:estimateCostScenario"
PowerShell
Guarda el cuerpo de la solicitud en un archivo llamado request.json.
Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:
@'
{
"costScenario": {
"workloads": [
{
"name": "combined-example-storage",
"cloudStorageWorkload": {
"region": {
"name": "us-central1"
},
"storageClass": "archive",
"dataStored": {
"usageRateTimeline": {
"unit": "GiBy",
"usageRateTimelineEntries": [
{
"usageRate": 7000
}
]
}
}
}
},
{
"name": "combined-example-compute",
"computeVmWorkload": {
"machineType": {
"predefinedMachineType": {
"machineType": "n2-standard-4"
}
},
"region": "us-central1",
"instancesRunning": {
"usageRateTimeline": {
"usageRateTimelineEntries": [
{
"usageRate": 8
},
{
"usageRate": 11,
"effectiveTime": {
"estimationTimeFrameOffset": "1209600s"
}
}
]
}
}
}
}
],
"scenarioConfig": {
"estimateDuration": "2628000s"
}
}
}
'@ | Out-File -FilePath request.json -Encoding utf8Luego, ejecuta el siguiente comando para enviar tu solicitud de REST:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-OutFile cost-estimate.json `
-Uri "https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID:estimateCostScenario"
cost-estimate.json, con el siguiente contenido.
{
"costEstimationResult": {
"segmentCostEstimates": [
{
"segmentStartTime": {
"estimationTimeFrameOffset": "0s"
},
"workloadCostEstimates": [
{
"name": "combined-example-storage",
"skuCostEstimates": [
{
"sku": "services/95FF-2EF5-5EA1/skus/EC4B-C190-470D",
"usageAmount": 7000,
"usageUnit": "GiBy.mo",
"costEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"units": "8",
"nanos": 400000000
},
"netCostEstimate": {
"currencyCode": "USD",
"units": "8",
"nanos": 400000000
}
}
}
],
"workloadTotalCostEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"units": "8",
"nanos": 400000000
},
"netCostEstimate": {
"currencyCode": "USD",
"units": "8",
"nanos": 400000000
}
}
},
{
"name": "combined-example-compute",
"skuCostEstimates": [
{
"sku": "services/6F81-5844-456A/skus/BB77-5FDA-69D9",
"usageAmount": 28088,
"usageUnit": "h",
"costEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"units": "887",
"nanos": 889768000
},
"creditEstimates": [
{
"creditAmount": {
"currencyCode": "USD",
"units": "-159",
"nanos": -850504800
},
"creditType": "Sustained Use Discount"
}
],
"netCostEstimate": {
"currencyCode": "USD",
"units": "728",
"nanos": 39263200
}
}
},
{
"sku": "services/6F81-5844-456A/skus/5B01-D157-A097",
"usageAmount": 112352,
"usageUnit": "GiBy.h",
"costEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"units": "476",
"nanos": 35424000
},
"creditEstimates": [
{
"creditAmount": {
"currencyCode": "USD",
"units": "-85",
"nanos": -702646400
},
"creditType": "Sustained Use Discount"
}
],
"netCostEstimate": {
"currencyCode": "USD",
"units": "390",
"nanos": 332777600
}
}
}
],
"workloadTotalCostEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"units": "1363",
"nanos": 925192000
},
"creditEstimates": [
{
"creditAmount": {
"currencyCode": "USD",
"units": "-245",
"nanos": -553151200
},
"creditType": "Sustained Use Discount"
}
],
"netCostEstimate": {
"currencyCode": "USD",
"units": "1118",
"nanos": 372040800
}
}
}
],
"segmentTotalCostEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"units": "1372",
"nanos": 325192000
},
"creditEstimates": [
{
"creditAmount": {
"currencyCode": "USD",
"units": "-245",
"nanos": -553151200
},
"creditType": "Sustained Use Discount"
}
],
"netCostEstimate": {
"currencyCode": "USD",
"units": "1126",
"nanos": 772040800
}
}
}
],
"skus": [
{
"sku": "services/95FF-2EF5-5EA1/skus/EC4B-C190-470D",
"displayName": "Archive Storage Iowa",
"prices": [
{
"priceType": "RATE",
"rate": {
"tiers": [
{
"price": {
"currencyCode": "USD",
"nanos": 1200000
}
}
],
"unit": "GiBy.mo",
"unitCount": 1
}
}
]
},
{
"sku": "services/6F81-5844-456A/skus/BB77-5FDA-69D9",
"displayName": "N2 Instance Core running in Americas",
"prices": [
{
"priceType": "RATE",
"rate": {
"tiers": [
{
"price": {
"currencyCode": "USD",
"nanos": 31611000
}
}
],
"unit": "h",
"unitCount": 1
}
}
]
},
{
"sku": "services/6F81-5844-456A/skus/5B01-D157-A097",
"displayName": "N2 Instance Ram running in Americas",
"prices": [
{
"priceType": "RATE",
"rate": {
"tiers": [
{
"price": {
"currencyCode": "USD",
"nanos": 4237000
}
}
],
"unit": "GiBy.h",
"unitCount": 1
}
}
]
}
],
"currencyCode": "USD"
}
}
Estima el costo de las cargas de trabajo que cambian con el tiempo
Con la siguiente solicitud a la API, se obtiene una estimación de 1 mes de uso, con precios de contrato personalizados, para los siguientes recursos:
- 7000 GiB de almacenamiento
- 8 VM N2-estándar-4
- 3 VM adicionales n2-standard-4 durante 14 días en el mes
En este ejemplo, se usa el campo estimationTimeFrameOffset para determinar cuándo comienza un segmento de tiempo nuevo. La cantidad de VM cambia de 8 a 11 (usageRate) después de 1209600 segundos (14 días), como se muestra en este fragmento:
"usageRateTimeline": {
"usageRateTimelineEntries": [
{
"usageRate": 8
},
{
"usageRate": 11,
"effectiveTime": {
"estimationTimeFrameOffset": "1209600s"
}
}
]
Del mismo modo, si deseas estimar el costo si tu carga de trabajo se redujo a 3 VM 20 días desde el inicio del período, puedes agregar un segmento más a usageRateTimelineEntries, como se muestra en este ejemplo:
"usageRateTimeline": {
"usageRateTimelineEntries": [
{
"usageRate": 8
},
{
"usageRate": 11,
"effectiveTime": {
"estimationTimeFrameOffset": "1209600s"
}
}
{
"usageRate": 3,
"effectiveTime": {
"estimationTimeFrameOffset": "1728000s"
}
}
]
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- API_KEY: Es la clave de API de Google Cloud
Método HTTP y URL:
POST https://cloudbilling.googleapis.com/v1beta:estimateCostScenario?key=API_KEY
Cuerpo JSON de la solicitud:
{
"costScenario": {
"workloads": [
{
"name": "combined-example-storage",
"cloudStorageWorkload": {
"region": {
"name": "us-central1"
},
"storageClass": "archive",
"dataStored": {
"usageRateTimeline": {
"unit": "GiBy",
"usageRateTimelineEntries": [
{
"usageRate": 7000
}
]
}
}
}
},
{
"name": "combined-example-compute",
"computeVmWorkload": {
"machineType": {
"predefinedMachineType": {
"machineType": "n2-standard-4"
}
},
"region": "us-central1",
"instancesRunning": {
"usageRateTimeline": {
"usageRateTimelineEntries": [
{
"usageRate": 8
},
{
"usageRate": 11,
"effectiveTime": {
"estimationTimeFrameOffset": "1209600s"
}
}
]
}
}
}
}
],
"scenarioConfig": {
"estimateDuration": "2628000s"
}
}
}
Para enviar tu solicitud, elige una de estas opciones:
curl
Guarda el cuerpo de la solicitud en un archivo llamado request.json.
Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:
cat > request.json << 'EOF'
{
"costScenario": {
"workloads": [
{
"name": "combined-example-storage",
"cloudStorageWorkload": {
"region": {
"name": "us-central1"
},
"storageClass": "archive",
"dataStored": {
"usageRateTimeline": {
"unit": "GiBy",
"usageRateTimelineEntries": [
{
"usageRate": 7000
}
]
}
}
}
},
{
"name": "combined-example-compute",
"computeVmWorkload": {
"machineType": {
"predefinedMachineType": {
"machineType": "n2-standard-4"
}
},
"region": "us-central1",
"instancesRunning": {
"usageRateTimeline": {
"usageRateTimelineEntries": [
{
"usageRate": 8
},
{
"usageRate": 11,
"effectiveTime": {
"estimationTimeFrameOffset": "1209600s"
}
}
]
}
}
}
}
],
"scenarioConfig": {
"estimateDuration": "2628000s"
}
}
}
EOFLuego, ejecuta el siguiente comando para enviar tu solicitud de REST:
curl -X POST \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
--output cost-estimate.json \
"https://cloudbilling.googleapis.com/v1beta:estimateCostScenario?key=API_KEY"
PowerShell
Guarda el cuerpo de la solicitud en un archivo llamado request.json.
Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:
@'
{
"costScenario": {
"workloads": [
{
"name": "combined-example-storage",
"cloudStorageWorkload": {
"region": {
"name": "us-central1"
},
"storageClass": "archive",
"dataStored": {
"usageRateTimeline": {
"unit": "GiBy",
"usageRateTimelineEntries": [
{
"usageRate": 7000
}
]
}
}
}
},
{
"name": "combined-example-compute",
"computeVmWorkload": {
"machineType": {
"predefinedMachineType": {
"machineType": "n2-standard-4"
}
},
"region": "us-central1",
"instancesRunning": {
"usageRateTimeline": {
"usageRateTimelineEntries": [
{
"usageRate": 8
},
{
"usageRate": 11,
"effectiveTime": {
"estimationTimeFrameOffset": "1209600s"
}
}
]
}
}
}
}
],
"scenarioConfig": {
"estimateDuration": "2628000s"
}
}
}
'@ | Out-File -FilePath request.json -Encoding utf8Luego, ejecuta el siguiente comando para enviar tu solicitud de REST:
$headers = @{ }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-OutFile cost-estimate.json `
-Uri "https://cloudbilling.googleapis.com/v1beta:estimateCostScenario?key=API_KEY"cost-estimate.json, con el siguiente contenido.
{
"costEstimationResult": {
"segmentCostEstimates": [
{
"segmentStartTime": {
"estimationTimeFrameOffset": "0s"
},
"workloadCostEstimates": [
{
"name": "combined-example-storage",
"skuCostEstimates": [
{
"sku": "services/95FF-2EF5-5EA1/skus/EC4B-C190-470D",
"usageAmount": 7000,
"usageUnit": "GiBy.mo",
"costEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"units": "8",
"nanos": 400000000
},
"netCostEstimate": {
"currencyCode": "USD",
"units": "8",
"nanos": 400000000
}
}
}
],
"workloadTotalCostEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"units": "8",
"nanos": 400000000
},
"netCostEstimate": {
"currencyCode": "USD",
"units": "8",
"nanos": 400000000
}
}
},
{
"name": "combined-example-compute",
"skuCostEstimates": [
{
"sku": "services/6F81-5844-456A/skus/BB77-5FDA-69D9",
"usageAmount": 28088,
"usageUnit": "h",
"costEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"units": "887",
"nanos": 889768000
},
"netCostEstimate": {
"currencyCode": "USD",
"units": "887",
"nanos": 889768000
}
}
},
{
"sku": "services/6F81-5844-456A/skus/5B01-D157-A097",
"usageAmount": 112352,
"usageUnit": "GiBy.h",
"costEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"units": "476",
"nanos": 35424000
},
"netCostEstimate": {
"currencyCode": "USD",
"units": "476",
"nanos": 35424000
}
}
}
],
"workloadTotalCostEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"units": "1363",
"nanos": 925192000
},
"netCostEstimate": {
"currencyCode": "USD",
"units": "1363",
"nanos": 925192000
}
}
}
],
"segmentTotalCostEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"units": "1372",
"nanos": 325192000
},
"netCostEstimate": {
"currencyCode": "USD",
"units": "1372",
"nanos": 325192000
}
}
}
],
"skus": [
{
"sku": "services/95FF-2EF5-5EA1/skus/EC4B-C190-470D",
"displayName": "Archive Storage Iowa",
"prices": [
{
"priceType": "RATE",
"rate": {
"tiers": [
{
"price": {
"currencyCode": "USD",
"nanos": 1200000
}
}
],
"unit": "GiBy.mo",
"unitCount": 1
}
}
]
},
{
"sku": "services/6F81-5844-456A/skus/BB77-5FDA-69D9",
"displayName": "N2 Instance Core running in Americas",
"prices": [
{
"priceType": "RATE",
"rate": {
"tiers": [
{
"price": {
"currencyCode": "USD",
"nanos": 31611000
}
}
],
"unit": "h",
"unitCount": 1
}
}
]
},
{
"sku": "services/6F81-5844-456A/skus/5B01-D157-A097",
"displayName": "N2 Instance Ram running in Americas",
"prices": [
{
"priceType": "RATE",
"rate": {
"tiers": [
{
"price": {
"currencyCode": "USD",
"nanos": 4237000
}
}
],
"unit": "GiBy.h",
"unitCount": 1
}
}
]
}
],
"currencyCode": "USD"
}
}
Estima el costo de las cargas de trabajo cuando tienes un descuento por compromiso de uso (CUD)
En el siguiente ejemplo, se muestra una solicitud a la API para una VM a2-megagpu, con una GPU NVIDIA Tesla A100 y un disco persistente extremo, durante 5 horas (18,000 segundos), con precios de contrato y un compromiso de 1 año.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- BILLING_ACCOUNT_ID: El ID de tu cuenta de Facturación de Cloud La cuenta debe tener un contrato de precios personalizado asociado.
Método HTTP y URL:
POST https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID:estimateCostScenario
Cuerpo JSON de la solicitud:
{
"costScenario": {
"workloads": [{
"name": "Custom VM",
"computeVmWorkload": {
"region": "us-central1",
"machineType": {
"predefinedMachineType": {
"machineType": "a2-megagpu-16g"
}
},
"guestAccelerator": {
"acceleratorType": "nvidia-tesla-a100",
"acceleratorCount": "1"
},
"persistentDisks": [{
"diskType": "pd-extreme",
"scope": "SCOPE_ZONAL",
"diskSize": {
"usageRateTimeline": {
"unit": "GiBy",
"usageRateTimelineEntries": [{
"usageRate": 1000.0
}]
}
},
"provisionedIops": {
"usageRateTimeline": {
"usageRateTimelineEntries": [{
"usageRate": 15000.0
}]
}
}
}],
"instancesRunning": {
"usageRateTimeline": {
"usageRateTimelineEntries": [{
"usageRate": 1.0
}]
}
}
}
}],
"commitments": [{
"name": "VM commitment",
"vmResourceBasedCud": {
"region": "us-central1",
"virtualCpuCount": "48",
"memorySizeGb": 680.0,
"plan": "TWELVE_MONTH",
"machineSeries": "a2"
}
}],
"scenarioConfig": {
"estimateDuration": "18000s"
}
}
}
Para enviar tu solicitud, elige una de estas opciones:
curl
Guarda el cuerpo de la solicitud en un archivo llamado request.json.
Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:
cat > request.json << 'EOF'
{
"costScenario": {
"workloads": [{
"name": "Custom VM",
"computeVmWorkload": {
"region": "us-central1",
"machineType": {
"predefinedMachineType": {
"machineType": "a2-megagpu-16g"
}
},
"guestAccelerator": {
"acceleratorType": "nvidia-tesla-a100",
"acceleratorCount": "1"
},
"persistentDisks": [{
"diskType": "pd-extreme",
"scope": "SCOPE_ZONAL",
"diskSize": {
"usageRateTimeline": {
"unit": "GiBy",
"usageRateTimelineEntries": [{
"usageRate": 1000.0
}]
}
},
"provisionedIops": {
"usageRateTimeline": {
"usageRateTimelineEntries": [{
"usageRate": 15000.0
}]
}
}
}],
"instancesRunning": {
"usageRateTimeline": {
"usageRateTimelineEntries": [{
"usageRate": 1.0
}]
}
}
}
}],
"commitments": [{
"name": "VM commitment",
"vmResourceBasedCud": {
"region": "us-central1",
"virtualCpuCount": "48",
"memorySizeGb": 680.0,
"plan": "TWELVE_MONTH",
"machineSeries": "a2"
}
}],
"scenarioConfig": {
"estimateDuration": "18000s"
}
}
}
EOFLuego, ejecuta el siguiente comando para enviar tu solicitud de REST:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
--output cost-estimate.json \
"https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID:estimateCostScenario"
PowerShell
Guarda el cuerpo de la solicitud en un archivo llamado request.json.
Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:
@'
{
"costScenario": {
"workloads": [{
"name": "Custom VM",
"computeVmWorkload": {
"region": "us-central1",
"machineType": {
"predefinedMachineType": {
"machineType": "a2-megagpu-16g"
}
},
"guestAccelerator": {
"acceleratorType": "nvidia-tesla-a100",
"acceleratorCount": "1"
},
"persistentDisks": [{
"diskType": "pd-extreme",
"scope": "SCOPE_ZONAL",
"diskSize": {
"usageRateTimeline": {
"unit": "GiBy",
"usageRateTimelineEntries": [{
"usageRate": 1000.0
}]
}
},
"provisionedIops": {
"usageRateTimeline": {
"usageRateTimelineEntries": [{
"usageRate": 15000.0
}]
}
}
}],
"instancesRunning": {
"usageRateTimeline": {
"usageRateTimelineEntries": [{
"usageRate": 1.0
}]
}
}
}
}],
"commitments": [{
"name": "VM commitment",
"vmResourceBasedCud": {
"region": "us-central1",
"virtualCpuCount": "48",
"memorySizeGb": 680.0,
"plan": "TWELVE_MONTH",
"machineSeries": "a2"
}
}],
"scenarioConfig": {
"estimateDuration": "18000s"
}
}
}
'@ | Out-File -FilePath request.json -Encoding utf8Luego, ejecuta el siguiente comando para enviar tu solicitud de REST:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-OutFile cost-estimate.json `
-Uri "https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID:estimateCostScenario"
cost-estimate.json, con el siguiente contenido. La estimación de los ahorros del
CUD se encuentra en el objeto "commitmentCostEstimates":
{
"costEstimationResult": {
"segmentCostEstimates": [
{
"segmentStartTime": {
"estimationTimeFrameOffset": "0s"
},
"workloadCostEstimates": [
{
"name": "Custom VM",
"skuCostEstimates": [
{
"sku": "services/6F81-5844-456A/skus/2922-40C5-B19F",
"usageAmount": 480,
"usageUnit": "h",
"costEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"units": "15",
"nanos": 173280000
},
"creditEstimates": [
{
"creditAmount": {
"currencyCode": "USD",
"units": "-7",
"nanos": -586640000
},
"creditType": "Committed Use Discount"
}
],
"netCostEstimate": {
"currencyCode": "USD",
"units": "7",
"nanos": 586640000
}
}
},
{
"sku": "services/6F81-5844-456A/skus/2390-DCAF-DA38",
"usageAmount": 6800,
"usageUnit": "GiBy.h",
"costEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"units": "28",
"nanos": 811600000
},
"creditEstimates": [
{
"creditAmount": {
"currencyCode": "USD",
"units": "-6",
"nanos": -609720000
},
"creditType": "Committed Use Discount"
}
],
"netCostEstimate": {
"currencyCode": "USD",
"units": "22",
"nanos": 201880000
}
}
},
{
"sku": "services/6F81-5844-456A/skus/039F-D0DA-4055",
"usageAmount": 5,
"usageUnit": "h",
"costEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"units": "14",
"nanos": 669540000
},
"netCostEstimate": {
"currencyCode": "USD",
"units": "14",
"nanos": 669540000
}
}
},
{
"sku": "services/6F81-5844-456A/skus/165B-942F-F345",
"usageAmount": 6.8493150684931505,
"usageUnit": "GiBy.mo",
"costEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"nanos": 856164383
},
"netCostEstimate": {
"currencyCode": "USD",
"nanos": 856164383
}
}
},
{
"sku": "services/6F81-5844-456A/skus/DCA4-F1BE-57C4",
"usageAmount": 102.73972602739725,
"usageUnit": "mo",
"costEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"units": "6",
"nanos": 678082191
},
"netCostEstimate": {
"currencyCode": "USD",
"units": "6",
"nanos": 678082191
}
}
}
],
"workloadTotalCostEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"units": "66",
"nanos": 188666574
},
"creditEstimates": [
{
"creditAmount": {
"currencyCode": "USD",
"units": "-14",
"nanos": -196360000
},
"creditType": "Committed Use Discount"
}
],
"netCostEstimate": {
"currencyCode": "USD",
"units": "51",
"nanos": 992306574
}
}
}
],
"segmentTotalCostEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"units": "75",
"nanos": 131906574
},
"creditEstimates": [
{
"creditAmount": {
"currencyCode": "USD",
"units": "-14",
"nanos": -196360000
},
"creditType": "Committed Use Discount"
}
],
"netCostEstimate": {
"currencyCode": "USD",
"units": "60",
"nanos": 935546574
}
},
"commitmentCostEstimates": [
{
"name": "VM commitment",
"skuCostEstimates": [
{
"sku": "services/6F81-5844-456A/skus/3A31-931E-6360",
"usageAmount": 240,
"usageUnit": "h",
"costEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"units": "4",
"nanos": 779600000
},
"netCostEstimate": {
"currencyCode": "USD",
"units": "4",
"nanos": 779600000
}
}
},
{
"sku": "services/6F81-5844-456A/skus/220C-35D0-70E0",
"usageAmount": 1560,
"usageUnit": "GiBy.h",
"costEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"units": "4",
"nanos": 163640000
},
"netCostEstimate": {
"currencyCode": "USD",
"units": "4",
"nanos": 163640000
}
}
}
],
"commitmentTotalCostEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"units": "8",
"nanos": 943240000
},
"netCostEstimate": {
"currencyCode": "USD",
"units": "8",
"nanos": 943240000
}
}
}
]
}
],
"skus": [
{
"sku": "services/6F81-5844-456A/skus/3A31-931E-6360",
"displayName": "Commitment v1: A2 Cpu in Americas for 1 Year",
"prices": [
{
"priceType": "RATE",
"rate": {
"tiers": [
{
"price": {
"currencyCode": "USD",
"nanos": 19915000
}
}
],
"unit": "h",
"unitCount": 1
}
}
]
},
{
"sku": "services/6F81-5844-456A/skus/220C-35D0-70E0",
"displayName": "Commitment v1: A2 Ram in Americas for 1 Year",
"prices": [
{
"priceType": "RATE",
"rate": {
"tiers": [
{
"price": {
"currencyCode": "USD",
"nanos": 2669000
}
}
],
"unit": "GiBy.h",
"unitCount": 1
}
}
]
},
{
"sku": "services/6F81-5844-456A/skus/039F-D0DA-4055",
"displayName": "Nvidia Tesla A100 GPU running in Americas",
"prices": [
{
"priceType": "RATE",
"rate": {
"tiers": [
{
"price": {
"currencyCode": "USD",
"units": "2",
"nanos": 933908000
}
}
],
"unit": "h",
"unitCount": 1
}
}
]
},
{
"sku": "services/6F81-5844-456A/skus/165B-942F-F345",
"displayName": "Extreme PD Capacity",
"prices": [
{
"priceType": "RATE",
"rate": {
"tiers": [
{
"price": {
"currencyCode": "USD",
"nanos": 125000000
}
}
],
"unit": "GiBy.mo",
"unitCount": 1
}
}
]
},
{
"sku": "services/6F81-5844-456A/skus/DCA4-F1BE-57C4",
"displayName": "Extreme PD IOPS",
"prices": [
{
"priceType": "RATE",
"rate": {
"tiers": [
{
"price": {
"currencyCode": "USD",
"nanos": 65000000
}
}
],
"unit": "mo",
"unitCount": 1
}
}
]
},
{
"sku": "services/6F81-5844-456A/skus/2922-40C5-B19F",
"displayName": "A2 Instance Core running in Americas",
"prices": [
{
"priceType": "RATE",
"rate": {
"tiers": [
{
"price": {
"currencyCode": "USD",
"nanos": 31611000
}
}
],
"unit": "h",
"unitCount": 1
}
}
]
},
{
"sku": "services/6F81-5844-456A/skus/2390-DCAF-DA38",
"displayName": "A2 Instance Ram running in Americas",
"prices": [
{
"priceType": "RATE",
"rate": {
"tiers": [
{
"price": {
"currencyCode": "USD",
"nanos": 4237000
}
}
],
"unit": "GiBy.h",
"unitCount": 1
}
}
]
}
],
"currencyCode": "USD"
}
}
Estima el costo de una VM con una licencia premium, al precio de lista
En el siguiente ejemplo, se muestra una solicitud a la API para 5 máquinas virtuales n1 personalizadas con una licencia premium de Windows Server 2022 DC al precio de lista, por 100 horas.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- API_KEY: Es la clave de API de Google Cloud
Método HTTP y URL:
POST https://cloudbilling.googleapis.com/v1beta:estimateCostScenario?key=API_KEY
Cuerpo JSON de la solicitud:
{
"costScenario": {
"scenarioConfig": {
"estimateDuration": "360000s"
},
"workloads": [
{
"name": "vm-example",
"computeVmWorkload": {
"instancesRunning": {
"usageRateTimeline": {
"usageRateTimelineEntries": [
{
"usageRate": 5
}
]
}
},
"machineType": {
"customMachineType": {
"machineSeries": "n1",
"virtualCpuCount": 4,
"memorySizeGb": 4
}
},
"region": "us-central1",
"licenses": "projects/windows-cloud/global/licenses/windows-server-2022-dc"
}
}
]
}
}
Para enviar tu solicitud, elige una de estas opciones:
curl
Guarda el cuerpo de la solicitud en un archivo llamado request.json.
Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:
cat > request.json << 'EOF'
{
"costScenario": {
"scenarioConfig": {
"estimateDuration": "360000s"
},
"workloads": [
{
"name": "vm-example",
"computeVmWorkload": {
"instancesRunning": {
"usageRateTimeline": {
"usageRateTimelineEntries": [
{
"usageRate": 5
}
]
}
},
"machineType": {
"customMachineType": {
"machineSeries": "n1",
"virtualCpuCount": 4,
"memorySizeGb": 4
}
},
"region": "us-central1",
"licenses": "projects/windows-cloud/global/licenses/windows-server-2022-dc"
}
}
]
}
}
EOFLuego, ejecuta el siguiente comando para enviar tu solicitud de REST:
curl -X POST \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
--output cost-estimate.json \
"https://cloudbilling.googleapis.com/v1beta:estimateCostScenario?key=API_KEY"
PowerShell
Guarda el cuerpo de la solicitud en un archivo llamado request.json.
Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:
@'
{
"costScenario": {
"scenarioConfig": {
"estimateDuration": "360000s"
},
"workloads": [
{
"name": "vm-example",
"computeVmWorkload": {
"instancesRunning": {
"usageRateTimeline": {
"usageRateTimelineEntries": [
{
"usageRate": 5
}
]
}
},
"machineType": {
"customMachineType": {
"machineSeries": "n1",
"virtualCpuCount": 4,
"memorySizeGb": 4
}
},
"region": "us-central1",
"licenses": "projects/windows-cloud/global/licenses/windows-server-2022-dc"
}
}
]
}
}
'@ | Out-File -FilePath request.json -Encoding utf8Luego, ejecuta el siguiente comando para enviar tu solicitud de REST:
$headers = @{ }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-OutFile cost-estimate.json `
-Uri "https://cloudbilling.googleapis.com/v1beta:estimateCostScenario?key=API_KEY"cost-estimate.json, con el siguiente contenido.
{
"costEstimationResult": {
"segmentCostEstimates": [
{
"segmentStartTime": {
"estimationTimeFrameOffset": "0s"
},
"workloadCostEstimates": [
{
"name": "vm-example",
"skuCostEstimates": [
{
"sku": "services/6F81-5844-456A/skus/ACBC-6999-A1C4",
"usageAmount": 2000,
"usageUnit": "h",
"costEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"units": "66",
"nanos": 348000000
},
"netCostEstimate": {
"currencyCode": "USD",
"units": "66",
"nanos": 348000000
}
}
},
{
"sku": "services/6F81-5844-456A/skus/51E2-59BD-7A6E",
"usageAmount": 2000,
"usageUnit": "GiBy.h",
"costEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"units": "8",
"nanos": 892000000
},
"netCostEstimate": {
"currencyCode": "USD",
"units": "8",
"nanos": 892000000
}
}
},
{
"sku": "services/6F81-5844-456A/skus/92D2-8A8F-DF54",
"usageAmount": 2000,
"usageUnit": "h",
"costEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"units": "92"
},
"netCostEstimate": {
"currencyCode": "USD",
"units": "92"
}
}
}
],
"workloadTotalCostEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"units": "167",
"nanos": 240000000
},
"netCostEstimate": {
"currencyCode": "USD",
"units": "167",
"nanos": 240000000
}
}
}
],
"segmentTotalCostEstimate": {
"preCreditCostEstimate": {
"currencyCode": "USD",
"units": "167",
"nanos": 240000000
},
"netCostEstimate": {
"currencyCode": "USD",
"units": "167",
"nanos": 240000000
}
}
}
],
"skus": [
{
"sku": "services/6F81-5844-456A/skus/92D2-8A8F-DF54",
"displayName": "Licensing Fee for Windows Server 2022 Datacenter Edition on VM",
"prices": [
{
"priceType": "RATE",
"rate": {
"tiers": [
{
"price": {
"currencyCode": "USD",
"nanos": 46000000
}
}
],
"unit": "h",
"unitCount": 1
}
}
]
},
{
"sku": "services/6F81-5844-456A/skus/ACBC-6999-A1C4",
"displayName": "Custom Instance Core running in Americas",
"prices": [
{
"priceType": "RATE",
"rate": {
"tiers": [
{
"price": {
"currencyCode": "USD",
"nanos": 33174000
}
}
],
"unit": "h",
"unitCount": 1
}
}
]
},
{
"sku": "services/6F81-5844-456A/skus/51E2-59BD-7A6E",
"displayName": "Custom Instance Ram running in Americas",
"prices": [
{
"priceType": "RATE",
"rate": {
"tiers": [
{
"price": {
"currencyCode": "USD",
"nanos": 4446000
}
}
],
"unit": "GiBy.h",
"unitCount": 1
}
}
]
}
],
"currencyCode": "USD"
}
}