Ressource REST : locations.capacityCommitments

Ressource : CapacityCommitment

Un engagement de capacité est une solution permettant d'acheter de la capacité de calcul pour des tâches BigQuery (sous la forme d'emplacements) avec une période minimale d'engagement d'utilisation. L'engagement de capacité ne peut pas être modifié, et il ne peut pas être supprimé avant la fin de la période d'engagement. À la fin de la période d'engagement, les emplacements restent disponibles mais ils peuvent être supprimés gratuitement à tout moment.

Une ressource d'engagement de capacité existe en tant que ressource enfant du projet d'administration.

Représentation JSON

{
  "name": string,
  "slotCount": string,
  "plan": enum (CommitmentPlan),
  "state": enum (State),
  "commitmentEndTime": string
}
Champs
name

string

Uniquement en sortie. Nom de ressource de l'engagement de capacité, par exemple : projects/myproject/locations/US/capacityCommitments/123

slotCount

string (int64 format)

Nombre d'emplacements figurant dans cet engagement.

plan

CommitmentPlanenum ()

Forfait de l'engagement de capacité.

state

Stateenum ()

Uniquement en sortie. État de l'engagement.

commitmentEndTime

Timestampstring ( format)

Uniquement en sortie. Fin de la période d'engagement. Il est impossible de supprimer l'engagement de capacité avant la valeur définie pour commitmentEndTime. Elle n'est applicable qu'aux engagements de capacité actifs (ayant l'état ACTIVE), et est calculée comme une combinaison du forfait et du moment où l'engagement de capacité est devenu actif.

Horodatage au format RFC3339 UTC "Zulu", précis à la nanoseconde près. Exemple : "2014-10-02T15:01:23.045123456Z".

CommitmentPlan

Le forfait définit la fin de la période d'engagement.

Enums
COMMITMENT_PLAN_UNSPECIFIED Valeur de forfait non valide. Les requêtes comportant cette valeur seront rejetées avec le code d'erreur google.rpc.Code.INVALID_ARGUMENT.
MONTHLY L'engagement de capacité ne peut pas être supprimé dans les 30 jours suivant son activation (état ACTIVE).
ANNUAL L'engagement de capacité ne peut pas être supprimé dans les 365 jours suivant son activation (état ACTIVE).

État

L'engagement de capacité peut soit devenir immédiatement actif (état ACTIVE), soit passer de PENDING (en attente) à ACTIVE.

Enums
STATE_UNSPECIFIED Valeur d'état non valide.
PENDING L'engagement de capacité est en attente de provisionnement. Un engagement de capacité en attente n'est pas comptabilisé dans la valeur slotCapacity du parent.
ACTIVE Une fois les emplacements provisionnés, l'engagement de capacité devient actif. La valeur slotCount est ajoutée à la valeur slotCapacity du parent.

Méthodes

delete

Supprime un engagement de capacité.

get

Renvoie des informations sur l'engagement de capacité.

list

Répertorie tous les engagements de capacité pour le projet d'administration.