Se usó la API de Cloud Translation para traducir esta página.
Switch to English

Usa la API de presupuesto de Facturación de Cloud

Obtén más información sobre cómo enviar algunas solicitudes simples a la API de presupuesto de Facturación de Cloud.

Para obtener una lista completa de métodos, consulta la documentación de referencia de la API de REST o la API de RPC.

Antes de comenzar

Debes hacer lo siguiente antes de leer esta guía:

  1. Consulta la descripción general de la API de presupuesto de Facturación de Cloud.
  2. Lee los requisitos previos de la API de presupuesto de Facturación de Cloud.
  3. Realiza los pasos de configuración.

Identifica el ID de tu cuenta de facturación de Cloud

Para cada llamada a la API de presupuesto de Cloud Billing, necesitarás el ID de tu cuenta de facturación de Cloud.

  1. Ve a la página Manage billing accounts (Administrar cuentas de facturación) de Google Cloud Console.
  2. En la pestaña Mis cuentas de facturación (My billing accounts), verás la lista de cuentas de Cloud Billing por nombre y ID. Busca el ID de cuenta de facturación de la cuenta en la que administrarás los presupuestos.

Captura de pantalla de la página Administrar facturación que muestra la ubicación del ID de tu cuenta de facturación.

Conceptos clave sobre el presupuesto

  • Un presupuesto se puede aplicar a toda una cuenta de facturación o alcance (filtrado) con filtros de presupuesto detallados para supervisar segmentos específicos de sus costos.
  • Un presupuesto que se aplica a toda una cuenta de facturación de Cloud incluye los costos de todos los proyectos de Google Cloud pagados por esa cuenta de facturación.
  • Puedes reducir el alcance del presupuesto con filtros, como un subconjunto de proyectos o servicios, o bien otros filtros de presupuesto aplicables a tu cuenta de facturación de Cloud.
  • Puede especificar el período de tiempo del presupuesto. De forma predeterminada, un presupuesto supervisa los costos generados durante un mes calendario. Usa elusage_period filtro que está disponible en la API de presupuesto de Cloud Billing, puedes configurar el período de presupuesto con unCalendarPeriod o un CustomPeriod , lo que te permite crear presupuestos para supervisar los períodos de tiempo después del mes calendario predeterminado, como un trimestre, un año o un período personalizado que especifiques.
  • Puedes configurar el importe del presupuesto como un total que especifiques o basar el importe del presupuesto en la inversión del período calendario anterior.
  • Puedes configurar reglas de límite de presupuesto para activar las notificaciones de alerta por correo electrónico. Cuando los costos (costos reales o costos previstos) superan un porcentaje de tu presupuesto (según las reglas que estableces), los correos electrónicos de alerta se envían a los destinatarios que especifiques. las rutas "a GCP".
  • Puedes configurar las reglas de notificación del presupuesto para especificar los destinatarios de correo electrónico de las alertas de presupuesto y habilitar la programática. Notificaciones con Pub/Sub
  • Puedes usar los temas de Pub/Sub para las notificaciones programáticas (por ejemplo, para reenviar tus mensajes de presupuesto a otros medios como Slack, o para automatizar las tareas de administración de costos).

Limitación de cuotas: Una sola cuenta de Cloud Billing puede tener hasta 5,000 presupuestos asociados a ella a la vez. Consulta Cuotas y límites para obtener más información.

Llama a la API

En los siguientes ejemplos, se muestra cómo enviar algunas solicitudes simples a la API de presupuesto de Facturación de Cloud.

Mostrar presupuestos

Este método de API enumera todos los presupuestos disponibles para una cuenta de Cloud Billing determinada.

LÍNEA DE REST Y CMD

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • billing-account-id: el ID de la cuenta de facturación de Cloud al que se aplican los presupuestos.

Método HTTP y URL:

GET https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "budgets": [
   {
      "name": "billingAccounts/000000-111111-222222/budgets/33333333-4444-5555-6666-777777777777",
      "displayName": "Forecasted spend budget with Service Filter",
      "budgetFilter": {
        "projects": [
          "projects/123456789"
        ],
        "services": [
          "services/A1E8-BE35-7EBC"
        ],
        "creditTypesTreatment": "EXCLUDE_ALL_CREDITS",
        "calendarPeriod": "MONTH"
      },
      "amount": {
        "lastPeriodAmount": {}
      },
      "thresholdRules": [
        {
          "thresholdPercent": 0.9,
          "spendBasis": "FORECASTED_SPEND"
        }
      ],
      "allUpdatesRule": {},
      "etag": "c9d6c011f6fa6b5c"
    }
  ]
}

Obtén el presupuesto

Este método de API obtiene los detalles de un presupuesto determinado.

LÍNEA DE REST Y CMD

Para llamar a este método, necesitas el budget-id del presupuesto que deseas actualizar. Puedes obtener el ID de presupuesto del resultado createBudget cuando creas tu presupuesto, o del resultado listBudgets si enumeras todos tus presupuestos.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • billing-account-id: el ID de la cuenta de facturación de Cloud al que se aplica este presupuesto.
  • budget-id: El ID del presupuesto que deseas obtener.

Método HTTP y URL:

GET https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets/budget-id

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "name": "billingAccounts/000000-111111-222222/budgets/33333333-4444-5555-6666-777777777777",
  "displayName": "Forecasted spend budget with Service Filter",
  "budgetFilter": {
    "projects": [
      "projects/123456789"
    ],
    "services": [
      "services/A1E8-BE35-7EBC"
    ],
    "creditTypesTreatment": "EXCLUDE_ALL_CREDITS",
    "calendarPeriod": "MONTH"
  },
  "amount": {
    "lastPeriodAmount": {}
  },
  "thresholdRules": [
    {
      "thresholdPercent": 0.9,
      "spendBasis": "FORECASTED_SPEND"
    }
  ],
  "allUpdatesRule": {},
  "etag": "c9d6c011f6fa6b5c"
}

Crear presupuesto

Este método de API crea un presupuesto de Cloud Billing aplicado a la cuenta de Cloud Billing especificada.

LÍNEA DE REST Y CMD

En este ejemplo, se muestra cómo crear un presupuesto para una cuenta de facturación de Cloud determinada con alcance (filtrado) por un proyecto de Google Cloud que especifiques y establezcas para un período de tiempo de calendario de un trimestre.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • project-id: El ID del proyecto de Google Cloud que deseas establecer como un alcance del presupuesto (budgetFilter).
  • billing-account-id: el ID de la cuenta de facturación de Cloud al que se aplica este presupuesto.

Método HTTP y URL:

POST https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets

Cuerpo JSON de la solicitud:

{
  "displayName": "Keep my spending down",
  "budgetFilter": {
    "projects": [
      "projects/project-id"
    ],
    "calendar_period": "QUARTER"
  },
  "amount": {
    "lastPeriodAmount": {}
  },
  "thresholdRules": {
    "thresholdPercent": 0.8,
    "spendBasis": "CURRENT_SPEND"
  }
}

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "name": "billingAccounts/000000-111111-222222/budgets/33333333-4444-5555-6666-777777777777",
  "displayName": "Keep my spending down",
  "budgetFilter": {
    "projects": [
      "projects/123456789"
    ],
    "creditTypesTreatment": "INCLUDE_ALL_CREDITS",
    "calendar_period": "QUARTER"
  },
  "amount": {
    "lastPeriodAmount": {}
  },
  "thresholdRules": {
    "thresholdPercent": 0.8,
    "spendBasis": "CURRENT_SPEND"
  },
  "allUpdatesRule": {},
  "etag": "f7928d8010160668"
}

Actualizar presupuesto

Usa este método de API para modificar un presupuesto existente de Facturación de Cloud a fin de cambiar el importe del presupuesto y los filtros de presupuesto (alcance del presupuesto), el período de tiempo de presupuesto o las reglas de límite.

LÍNEA DE REST Y CMD

En este ejemplo, se muestra cómo actualizar un presupuesto existente para configurar un alcance (filtro) por un proyecto de Google Cloud que especifiques y actualizar el período del presupuesto desde un mes a un presupuesto trimestral .

Para llamar a este método, necesitas el budget-id del presupuesto que deseas actualizar. Puedes obtener el ID de presupuesto del resultado createBudget cuando creas tu presupuesto, o del resultado listBudgets si enumeras todos tus presupuestos.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • project-id: El ID del proyecto de Google Cloud que deseas establecer como un alcance del presupuesto (budgetFilter).
  • billing-account-id: el ID de la cuenta de facturación de Cloud al que se aplica este presupuesto.
  • budget-id: El ID del presupuesto que deseas actualizar.

Método HTTP y URL:

PATCH https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets/budget-id

Cuerpo JSON de la solicitud:

{
  "budget": {
    "displayName": "My fancy budget",
    "budgetFilter": {
      "projects": [
        "projects/project-id"
      ],
      "calendar_period": "QUARTER"
    },
   "amount": {
      "specifiedAmount": {
        "units": 500
      }
    },
    "thresholdRules": {
      "thresholdPercent": 0.8,
      "spendBasis": "CURRENT_SPEND"
    }
  }
}

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "name": "billingAccounts/000000-111111-222222/budgets/33333333-4444-5555-6666-777777777777",
  "displayName": "My fancy budget",
  "budgetFilter": {
    "projects": [
      "projects/123456789"
    ],
    "creditTypesTreatment": "INCLUDE_ALL_CREDITS",
    "calendar_period": "QUARTER"
  },
  "amount": {
    "specifiedAmount": {
      "units": 500
    }
  },
  "thresholdRules": {
    "thresholdPercent": 0.8,
    "spendBasis": "CURRENT_SPEND"
  },
  "allUpdatesRule": {},
  "etag": "f7928d8010160668"
}

Borra un presupuesto

Usa este método de la API para borrar un presupuesto existente de Facturación de Cloud.

LÍNEA DE REST Y CMD

Para llamar a este método, necesitas el budget-id del presupuesto que deseas actualizar. Puedes obtener el ID de presupuesto del resultado createBudget cuando creas tu presupuesto, o del resultado listBudgets si enumeras todos tus presupuestos.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • billing-account-id: el ID de la cuenta de facturación de Cloud al que se aplica este presupuesto.
  • budget-id: El ID del presupuesto que deseas borrar.

Método HTTP y URL:

DELETE https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets/budget-id

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{}