Recurso de REST: projects.locations.capacityCommitments

Recurso: CapacityCommitment

El compromiso de capacidad es una forma de adquirir capacidad de procesamiento para trabajos de BigQuery (en forma de ranuras) con un período de compromiso de uso. Los compromisos de permanencia anuales se renuevan de forma predeterminada. Los compromisos se pueden quitar después de la hora de finalización del compromiso. Para quitar el compromiso de permanencia anual, primero se debe cambiar su plan a mensual o flexible.

Existe un recurso de compromiso de capacidad como recurso secundario del proyecto del administrador.

Representación JSON

{
  "name": string,
  "slotCount": string,
  "plan": enum (CommitmentPlan),
  "state": enum (State),
  "commitmentEndTime": string,
  "failureStatus": {
    object (Status)
  },
  "renewalPlan": enum (CommitmentPlan)
}
Campos
name

string

Solo salida. El nombre del recurso del compromiso de capacidad, p. ej., projects/myproject/locations/US/capacityCommitments/123

slotCount

string (int64 format)

Cantidad de ranuras en este compromiso.

plan

enum (CommitmentPlan)

Plan de compromiso para el compromiso de capacidad.

state

enum (State)

Solo salida. Estado del compromiso.

commitmentEndTime

string (Timestamp format)

Solo salida. El final del período de compromiso actual. Solo se aplica a compromisos de capacidad ACTIVOS.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con precisión de nanosegundos. Ejemplo: "2014-10-02T15:01:23.045123456Z".

failureStatus

object (Status)

Solo salida. En el caso del plan de compromiso CON ERRORES, proporciona el motivo del error.

renewalPlan

enum (CommitmentPlan)

El plan al que se convierte este compromiso de capacidad luego de que pase el commitmentEndTime. Una vez que se cambia el plan, el período de compromiso se extiende según el plan de compromiso. Solo se aplica a compromisos ANUALES.

CommitmentPlan

El plan de compromiso define el período de compromiso actual. El compromiso de capacidad no se puede borrar durante el período de compromiso.

Enums
COMMITMENT_PLAN_UNSPECIFIED Valor de plan no válido. Las solicitudes que tengan este valor se rechazarán con el código de error google.rpc.Code.INVALID_ARGUMENT.
FLEX Los compromisos flexibles tienen un período de compromiso de 1 minuto después de convertirse en ACTIVE. Luego, dejarán de estar en el período de compromiso y se podrán quitar en cualquier momento.
TRIAL Los compromisos de prueba tienen un período de compromiso de 182 días después de convertirse en ACTIVE. Después de eso, se convierten en un compromiso nuevo basado en el renewalPlan. El renewalPlan predeterminado para el compromiso de prueba es flexible, a fin de que se pueda borrar de inmediato después de que finalice el período de compromiso.
MONTHLY Los compromisos mensuales tienen un período de compromiso de 30 días después de convertirse en ACTIVE. Luego, dejarán de estar en el período de compromiso y se podrán quitar en cualquier momento.
ANNUAL Los compromisos de permanencia anuales tienen un período de compromiso de 365 días después de convertirse en ACTIVE. Después de eso, se convierten en un compromiso nuevo basado en el renewalPlan.

Estado

El compromiso de capacidad puede convertirse en ACTIVE de inmediato o pasar de PENDING a ACTIVE o FAILED.

Enums
STATE_UNSPECIFIED Valor de estado no válido.
PENDING El compromiso de capacidad posee aprovisionamiento pendiente. El compromiso de capacidad pendiente no contribuye a la slotCapacity del superior.
ACTIVE Una vez que se aprovisionan las ranuras, el compromiso de capacidad pasa a ser activo. slotCount se agrega a la slotCapacity del superior.
FAILED El backend no pudo activar el compromiso de capacidad.

Métodos

create

Crea un nuevo recurso de compromiso de capacidad.

delete

Borra un compromiso de capacidad.

get

Muestra información sobre el compromiso de capacidad.

list

Enumera todos los compromisos de capacidad para el proyecto de administración.

merge

Fusiona los compromisos de capacidad del mismo plan en uno solo.

patch

Actualiza un compromiso de capacidad existente.

split

Divide el compromiso de capacidad en dos compromisos del mismo plan y commitment_end_time.