@leaflow/sdk 0.0.0-dev.352.g85966ed → 0.0.0-dev.355.g42152f5

package/dist/canopy/v1/generated/validators/usageChargeList.zod.d.ts

@@ -59,6 +59,7 @@ export declare const UsageChargeList: zod.ZodObject<{
         deducted_quantity: zod.ZodOptional<zod.ZodString>;
         quantity: zod.ZodString;
         unit_amount: zod.ZodOptional<zod.ZodString>;
+        unit_quantity: zod.ZodOptional<zod.ZodString>;
         amount: zod.ZodString;
         currency: zod.ZodString;
         invoice_id: zod.ZodOptional<zod.ZodNullable<zod.ZodUUID>>;

package/dist/canopy/v1/generated/validators/usageType.zod.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Canopy API
+ * Canopy model inference, API keys, model catalogue, service enablement and recorded usage.
+ *
+ * OpenAI-compatible project inference is served on this host at `/v1/chat/completions`,
+ * `/v1/embeddings`, `/v1/models` and `/v1/models/{model}`. Use `https://canopy.leaflow.cloud/v1`
+ * as the OpenAI SDK base URL. Chat completions support `stream=true` SSE.
+ *
+ * Management operations use `/api/v1`. The management model catalogue includes pricing;
+ * `/v1/models` returns the OpenAI model format with Canopy capabilities and parameter limits.
+ *
+ * ## Authentication
+ *
+ * Every request carries a scoped token; see the `bearerAuth` security scheme.
+ *
+ * Management and project inference accept the same verified IAM scoped token. The token is the
+ * sole billing project authority; `OpenAI-Project` and historical identity headers cannot
+ * override it. These endpoints do not accept a Canopy API key. The separate API-key gateway
+ * accepts Canopy API keys and supports OpenAI, Anthropic and Gemini request formats.
+ *
+ * ## Conventions
+ *
+ * - **The plaintext of an API key is returned once.** The `secret` appears in the response that issues it and is returned by no other endpoint. A key that has been lost has to be revoked and reissued.
+ * - **Disabling and revoking are distinct.** A disabled key may be enabled again at any time, while a revocation is irreversible and is intended for a key that has been exposed. Neither removes the record, and the usage the key accrued remains readable.
+ * - **A usage query must carry a time range**, spanning no more than 31 days. `from` and `to` carry a timezone offset, which the server does not infer.
+ * - **The request and response bodies do not appear in the ledger.** They are not recorded. Quote the `upstream_request_id` from the response when reporting a problem.
+ * - **Usage may be estimated.** The upstream provider does not report usage on every request. Where it does not, `usage_source` is `estimated` and the figures are derived from the character classes of the payload, to within roughly fifteen per cent.
+ * - **The service is enabled before use.** A project enables the model platform once, through `create-service`; the forwarding endpoints refuse its requests until the service is `active`. Requests are then billed under the service's subscription by the tokens they use, at the rates stated in each model's `pricing`.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+export declare const UsageType: zod.ZodEnum<{
+    licensed: "licensed";
+    metered: "metered";
+}>;
+export type UsageType = zod.input<typeof UsageType>;
+export type UsageTypeOutput = zod.output<typeof UsageType>;

package/dist/canopy/v1/generated/validators/usageType.zod.js

@@ -0,0 +1,36 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Canopy API
+ * Canopy model inference, API keys, model catalogue, service enablement and recorded usage.
+ *
+ * OpenAI-compatible project inference is served on this host at `/v1/chat/completions`,
+ * `/v1/embeddings`, `/v1/models` and `/v1/models/{model}`. Use `https://canopy.leaflow.cloud/v1`
+ * as the OpenAI SDK base URL. Chat completions support `stream=true` SSE.
+ *
+ * Management operations use `/api/v1`. The management model catalogue includes pricing;
+ * `/v1/models` returns the OpenAI model format with Canopy capabilities and parameter limits.
+ *
+ * ## Authentication
+ *
+ * Every request carries a scoped token; see the `bearerAuth` security scheme.
+ *
+ * Management and project inference accept the same verified IAM scoped token. The token is the
+ * sole billing project authority; `OpenAI-Project` and historical identity headers cannot
+ * override it. These endpoints do not accept a Canopy API key. The separate API-key gateway
+ * accepts Canopy API keys and supports OpenAI, Anthropic and Gemini request formats.
+ *
+ * ## Conventions
+ *
+ * - **The plaintext of an API key is returned once.** The `secret` appears in the response that issues it and is returned by no other endpoint. A key that has been lost has to be revoked and reissued.
+ * - **Disabling and revoking are distinct.** A disabled key may be enabled again at any time, while a revocation is irreversible and is intended for a key that has been exposed. Neither removes the record, and the usage the key accrued remains readable.
+ * - **A usage query must carry a time range**, spanning no more than 31 days. `from` and `to` carry a timezone offset, which the server does not infer.
+ * - **The request and response bodies do not appear in the ledger.** They are not recorded. Quote the `upstream_request_id` from the response when reporting a problem.
+ * - **Usage may be estimated.** The upstream provider does not report usage on every request. Where it does not, `usage_source` is `estimated` and the figures are derived from the character classes of the payload, to within roughly fifteen per cent.
+ * - **The service is enabled before use.** A project enables the model platform once, through `create-service`; the forwarding endpoints refuse its requests until the service is `active`. Requests are then billed under the service's subscription by the tokens they use, at the rates stated in each model's `pricing`.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+export const UsageType = zod
+    .enum(["licensed", "metered"])
+    .describe("`licensed` charges for the quantity bought, each period paid before it starts. `metered` charges for the usage\nreported, after it is settled; a metered subscription lasts until it is canceled. A one-time price is licensed.");

package/dist/canopy/v1/generated/validators/withdrawal.zod.js

@@ -63,6 +63,6 @@ export const Withdrawal = zod
     created_by: zod
         .string()
         .optional()
-        .describe("Identity that submitted this withdrawal. It can differ from the billing account owner."),
+        .describe("Who submitted the withdrawal; may differ from the account owner."),
 })
-    .describe("An account withdrawal to the original payment methods of its unused top-ups. Accepted amounts are fixed. deducted_amount, settled_amount and charged_fee_amount report completed source items. Failed items release their principal and fee reservations; successful items are retained when another source fails.");
+    .describe("A withdrawal of account balance to the original payment methods of its unused top-ups. Accepted amounts are fixed. deducted_amount, settled_amount and charged_fee_amount cover completed items. A failed item releases its principal and fee; successful items stand when another item fails.");

package/dist/canopy/v1/generated/validators/withdrawalItem.zod.js

@@ -57,6 +57,6 @@ export const WithdrawalItem = zod
     failure_code: zod
         .string()
         .optional()
-        .describe("The original gateway failure code when a refund failed, or refund_reversed when a completed refund was reversed. Absent while pending or successful."),
+        .describe("The gateway's failure code when a refund failed, or `refund_reversed` when a completed refund was reversed. Absent while pending or successful."),
 })
-    .describe("The fixed principal deduction, withdrawal fee and exact refund obligation for one original top-up. Each item has its own refund; payment_gateway and method_type identify the original route.");
+    .describe("For one original top-up: the principal deducted, the withdrawal fee and the amount refunded, through its own refund. payment_gateway and method_type identify the original route.");

package/dist/canopy/v1/generated/validators/withdrawalSource.zod.js

@@ -45,4 +45,4 @@ export const WithdrawalSource = zod
     card_brand: zod.string().optional(),
     card_last4: zod.string().regex(withdrawalSourceCardLast4RegExp).optional(),
 })
-    .describe("The original top-up and its refund destination. Card details are included when the original payment method was saved; missing card details do not change the original refund route.");
+    .describe("The original top-up and where its refund goes. Card details are included when the original payment method was saved.");

package/dist/compute/v1/generated/functions.d.ts

@@ -11,8 +11,8 @@
  * ## Conventions
  *
  * - **Purchases.** A purchase that creates resources returns them together with a PlacedOrder. They are readable at once and start as `pending`: the order has not been accepted, nothing exists in the cloud, no inventory such as an address is held, and fields known only after allocation, such as addresses, are null. Once Billing accepts the order, a resource becomes `provisioning` and then reaches its usual status, such as `active` or `available`. When the order is declined, canceled or expires, or creation fails, the resource ends `failed` and `failure_reason` states why; the charge for a resource that failed after acceptance is refunded. Read the order in Billing for checkout and payment progress.
- * - **Pricing.** Catalog items, such as instance types, disk types and public IP pools, carry `pricing`: the prepaid and postpaid options Billing offers for them, in the currency of the project's current billing account, or null when the project has no billing account. They are list amounts before promotion codes, not a checkout guarantee. A purchase chooses one option with `billing`, which applies to all of its components. Every purchase and change has a quote operation beside it, at the same path followed by `/quote`, which returns what checkout would collect without ordering anything.
- * - **Checkout.** Omit `checkout` for automatic checkout, which pays from eligible credit grants and balance when the order is placed; insufficient funds refuse the request with HTTP 422 `BILLING_INSUFFICIENT_FUNDS`, and nothing is created. With `checkout.mode` set to `deferred`, the resources are returned `pending` and nothing is created until checkout is confirmed and paid through Billing. An order whose total is zero, such as a postpaid purchase with nothing due now, completes checkout at placement in either mode and proceeds to provisioning.
+ * - **Pricing.** Catalog items, such as instance types, disk types and public IP pools, carry `pricing`: the licensed and metered options Billing offers for them, in the currency of the project's current billing account, or null when the project has no billing account. They are list amounts before promotion codes, not a checkout guarantee. A purchase chooses one option with `billing`, which applies to all of its components. Every purchase and change has a quote operation beside it, at the same path followed by `/quote`, which returns what checkout would collect without ordering anything.
+ * - **Checkout.** Omit `checkout` for automatic checkout, which pays from eligible credit grants and balance when the order is placed; insufficient funds refuse the request with HTTP 422 `BILLING_INSUFFICIENT_FUNDS`, and nothing is created. With `checkout.mode` set to `deferred`, the resources are returned `pending` and nothing is created until checkout is confirmed and paid through Billing. An order whose total is zero, such as a metered purchase with nothing due now, completes checkout at placement in either mode and proceeds to provisioning.
  * - **Operations.** Requests such as starting, stopping, attaching or deleting return HTTP 202 with the resource as it is when the request is accepted. While an operation runs, the resource's `operation` field names it; the field is null once the operation has finished, and the resource then shows the result. A resource with an operation in progress refuses another operation with HTTP 409 `COMPUTE_RESOURCE_BUSY`; an operation involving two resources, such as attaching a disk, is refused when either has one. A purchased change, such as a resize, is an operation from the moment its order is placed until it is applied or its order is canceled, including while it awaits checkout. Renaming and replacing labels or notes are not operations and are accepted at any time.
  * - **Billing relationships.** A purchased resource records its `order_id`, `order_item_id` and `subscription_id`. The subscription is `pending` until the order is accepted, `provisioning` while the resource is created, and `active` once it is delivered. Bandwidth is a property of its floating IP, not a separate resource. Snapshots use a purchased per-region count quota, and backups are metered on the region's backup service; neither has an order or subscription of its own.
  * - **Availability zones.** A disk and an instance must reside in the same availability zone to be attached. Instance types and disk types are each bound to one availability zone, so choosing a type determines the zone.
@@ -193,7 +193,7 @@ export type createBackupRestoreQuoteResponseError = (createBackupRestoreQuoteRes
 export type createBackupRestoreQuoteResponse = createBackupRestoreQuoteResponseSuccess | createBackupRestoreQuoteResponseError;
 export declare const getCreateBackupRestoreQuoteUrl: (backupId: string) => string;
 /**
- * Prices what `restore-backup` would order for the same request, without ordering or creating anything; nothing is reserved or recorded. Billing evaluates applicable account discounts and tax as for automatic checkout. `total` is what automatic checkout would collect before credit grants and balance; give it as `checkout.expected_amount` to be refused rather than charged a different amount. `estimated_usage_amount` projects postpaid usage over one month of 730 hours and is not collected at checkout. A request the purchase would refuse is refused the same way. Prices may change, so quote again before final confirmation.
+ * Prices what `restore-backup` would order for the same request, without ordering or creating anything; nothing is reserved or recorded. Billing evaluates applicable account discounts and tax as for automatic checkout. `total` is what automatic checkout would collect before credit grants and balance; give it as `checkout.expected_amount` to be refused rather than charged a different amount. `estimated_usage_amount` projects metered usage over one month of 730 hours and is not collected at checkout. A request the purchase would refuse is refused the same way. Prices may change, so quote again before final confirmation.
  * @summary Quote restoring from a backup
  */
 export declare const createBackupRestoreQuote: (backupId: string, restoreBackupQuoteRequestBody: RestoreBackupQuoteRequestBody, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<createBackupRestoreQuoteResponse>;
@@ -533,7 +533,7 @@ export type createDiskQuoteResponseError = (createDiskQuoteResponse409 | createD
 export type createDiskQuoteResponse = createDiskQuoteResponseSuccess | createDiskQuoteResponseError;
 export declare const getCreateDiskQuoteUrl: () => string;
 /**
- * Prices what `create-disk` would order for the same request, without ordering or creating anything; nothing is reserved or recorded. Billing evaluates applicable account discounts and tax as for automatic checkout. `total` is what automatic checkout would collect before credit grants and balance; give it as `checkout.expected_amount` to be refused rather than charged a different amount. `estimated_usage_amount` projects postpaid usage over one month of 730 hours and is not collected at checkout. A request the purchase would refuse is refused the same way. Prices may change, so quote again before final confirmation.
+ * Prices what `create-disk` would order for the same request, without ordering or creating anything; nothing is reserved or recorded. Billing evaluates applicable account discounts and tax as for automatic checkout. `total` is what automatic checkout would collect before credit grants and balance; give it as `checkout.expected_amount` to be refused rather than charged a different amount. `estimated_usage_amount` projects metered usage over one month of 730 hours and is not collected at checkout. A request the purchase would refuse is refused the same way. Prices may change, so quote again before final confirmation.
  * @summary Quote creating a disk
  */
 export declare const createDiskQuote: (createDiskQuoteRequestBody: CreateDiskQuoteRequestBody, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<createDiskQuoteResponse>;
@@ -627,7 +627,7 @@ export type resizeDiskResponseError = (resizeDiskResponse409 | resizeDiskRespons
 export type resizeDiskResponse = resizeDiskResponseSuccess | resizeDiskResponseError;
 export declare const getResizeDiskUrl: (diskId: string) => string;
 /**
- * Capacity can only be increased; shrinking is not supported. Returns the disk with the order for the resize, which keeps the disk's billing mode and period. The disk shows the `resize` operation until the resize is applied or its order is canceled, including while the order awaits checkout, so other operations and a second resize are refused with `COMPUTE_RESOURCE_BUSY` meanwhile. The disk keeps its current size until the resize is applied; once `size_gb` shows the new size, extend the file system inside the instance. If the order is not accepted or the resize fails, the disk keeps its size and the order shows the outcome.
+ * Capacity can only be increased; shrinking is not supported. Returns the disk with the order for the resize, which keeps the disk's usage type and period. The disk shows the `resize` operation until the resize is applied or its order is canceled, including while the order awaits checkout, so other operations and a second resize are refused with `COMPUTE_RESOURCE_BUSY` meanwhile. The disk keeps its current size until the resize is applied; once `size_gb` shows the new size, extend the file system inside the instance. If the order is not accepted or the resize fails, the disk keeps its size and the order shows the outcome.
  *
  * **An attached data disk whose performance scales with its size must be detached before it is resized.** The performance of an attached disk does not change until the disk is detached and attached again, so such a request is refused with `DISK_RESIZE_NEEDS_DETACH` rather than providing the new capacity at the performance of the previous size. Detach the disk, resize it, and attach it again.
  *
@@ -763,7 +763,7 @@ export type createFloatingIpQuoteResponseError = (createFloatingIpQuoteResponse4
 export type createFloatingIpQuoteResponse = createFloatingIpQuoteResponseSuccess | createFloatingIpQuoteResponseError;
 export declare const getCreateFloatingIpQuoteUrl: () => string;
 /**
- * Prices what `allocate-floating-ip` would order for the same request, without ordering or creating anything; nothing is reserved or recorded. Billing evaluates applicable account discounts and tax as for automatic checkout. `total` is what automatic checkout would collect before credit grants and balance; give it as `checkout.expected_amount` to be refused rather than charged a different amount. `estimated_usage_amount` projects postpaid usage over one month of 730 hours and is not collected at checkout. A request the purchase would refuse is refused the same way. Prices may change, so quote again before final confirmation.
+ * Prices what `allocate-floating-ip` would order for the same request, without ordering or creating anything; nothing is reserved or recorded. Billing evaluates applicable account discounts and tax as for automatic checkout. `total` is what automatic checkout would collect before credit grants and balance; give it as `checkout.expected_amount` to be refused rather than charged a different amount. `estimated_usage_amount` projects metered usage over one month of 730 hours and is not collected at checkout. A request the purchase would refuse is refused the same way. Prices may change, so quote again before final confirmation.
  * @summary Quote allocating a floating IP
  */
 export declare const createFloatingIpQuote: (allocateFloatingIPQuoteRequestBody: AllocateFloatingIPQuoteRequestBody, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<createFloatingIpQuoteResponse>;
@@ -835,7 +835,7 @@ export type setFloatingIpBandwidthResponseError = (setFloatingIpBandwidthRespons
 export type setFloatingIpBandwidthResponse = setFloatingIpBandwidthResponseSuccess | setFloatingIpBandwidthResponseError;
 export declare const getSetFloatingIpBandwidthUrl: (floatingIpId: string) => string;
 /**
- * Changes the bandwidth of this floating IP through an order that keeps its billing mode and period; no separate bandwidth resource is created. The limit applies to inbound and outbound traffic alike. The floating IP shows the `set_bandwidth` operation until the change is applied or its order is canceled, including while the order awaits checkout, so other operations and a second change are refused with `COMPUTE_RESOURCE_BUSY` meanwhile. The current limit stays in effect until the change is applied. If the order is not accepted or the change fails, `bandwidth_mbps` keeps its value and the order shows the outcome.
+ * Changes the bandwidth of this floating IP through an order that keeps its usage type and period; no separate bandwidth resource is created. The limit applies to inbound and outbound traffic alike. The floating IP shows the `set_bandwidth` operation until the change is applied or its order is canceled, including while the order awaits checkout, so other operations and a second change are refused with `COMPUTE_RESOURCE_BUSY` meanwhile. The current limit stays in effect until the change is applied. If the order is not accepted or the change fails, `bandwidth_mbps` keeps its value and the order shows the outcome.
  *
  * While the address is bound to an instance, the limit must not exceed the `max_bandwidth_mbps` of that instance's type; a higher limit is refused with `INSTANCE_BANDWIDTH_CEILING`. The limit of an address that is not bound is checked when the address is bound to an instance.
  * @summary Set the bandwidth limit
@@ -991,7 +991,7 @@ export type createInstanceQuoteResponseError = (createInstanceQuoteResponse409 |
 export type createInstanceQuoteResponse = createInstanceQuoteResponseSuccess | createInstanceQuoteResponseError;
 export declare const getCreateInstanceQuoteUrl: () => string;
 /**
- * Prices what `launch-instance` would order for the same request, without ordering or creating anything; nothing is reserved or recorded. Billing evaluates applicable account discounts and tax as for automatic checkout. `total` is what automatic checkout would collect before credit grants and balance; give it as `checkout.expected_amount` to be refused rather than charged a different amount. `estimated_usage_amount` projects postpaid usage over one month of 730 hours and is not collected at checkout. A request the purchase would refuse is refused the same way. Prices may change, so quote again before final confirmation.
+ * Prices what `launch-instance` would order for the same request, without ordering or creating anything; nothing is reserved or recorded. Billing evaluates applicable account discounts and tax as for automatic checkout. `total` is what automatic checkout would collect before credit grants and balance; give it as `checkout.expected_amount` to be refused rather than charged a different amount. `estimated_usage_amount` projects metered usage over one month of 730 hours and is not collected at checkout. A request the purchase would refuse is refused the same way. Prices may change, so quote again before final confirmation.
  * @summary Quote creating instances
  */
 export declare const createInstanceQuote: (launchInstanceQuoteRequestBody: LaunchInstanceQuoteRequestBody, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<createInstanceQuoteResponse>;
@@ -1311,7 +1311,7 @@ export type resizeInstanceResponseError = (resizeInstanceResponse409 | resizeIns
 export type resizeInstanceResponse = resizeInstanceResponseSuccess | resizeInstanceResponseError;
 export declare const getResizeInstanceUrl: (instanceId: string) => string;
 /**
- * Creates a Billing change order, including for metered pricing, and returns the instance with the order. The instance keeps its billing mode and period, priced with the target type's matching option; a target type without that option is refused with 409 `BILLING_OPTION_UNAVAILABLE`. Do not submit a new purchase after paying. After an uncertain response, look the order up before submitting again.
+ * Creates a Billing change order, including for metered pricing, and returns the instance with the order. The instance keeps its usage type and period, priced with the target type's matching option; a target type without that option is refused with 409 `BILLING_OPTION_UNAVAILABLE`. Do not submit a new purchase after paying. After an uncertain response, look the order up before submitting again.
  *
  * The instance shows the `resize` operation until the resize is applied or its order is canceled, including while the order awaits checkout, so other operations and a second resize are refused with `COMPUTE_RESOURCE_BUSY` meanwhile. It keeps its current type until the resize is applied; the new type takes effect, and is billed from then on, when `instance_type_id` shows it. If the order is not accepted or the resize fails, the instance keeps its current type and the order shows the outcome. A completed resize is final and cannot be reverted; to return to the previous type, submit another resize.
  * @summary Resize an instance
@@ -2222,7 +2222,7 @@ export declare const getSetSnapshotQuotaUrl: (regionId: string) => string;
  * Purchases or changes the maximum number of snapshots this project may hold in this region.
  * limit is the target total, not an additional number of slots or a consumable create allowance.
  * billing chooses one of the quota's pricing options; a change of an existing purchase keeps its
- * billing mode and period, and billing must name that option. The purchased quantity is this count.
+ * usage type and period, and billing must name that option. The purchased quantity is this count.
  *
  * Returns the quota with the order. pending_limit records the target while the current limit stays
  * in force; the new limit applies once the order is accepted and the quota is activated. Snapshots
@@ -2258,7 +2258,7 @@ export type createSnapshotQuotaQuoteResponseError = (createSnapshotQuotaQuoteRes
 export type createSnapshotQuotaQuoteResponse = createSnapshotQuotaQuoteResponseSuccess | createSnapshotQuotaQuoteResponseError;
 export declare const getCreateSnapshotQuotaQuoteUrl: (regionId: string) => string;
 /**
- * Prices what `set-snapshot-quota` would order, including a change of an existing purchase as of now, for the same request, without ordering or creating anything; nothing is reserved or recorded. Billing evaluates applicable account discounts and tax as for automatic checkout. `total` is what automatic checkout would collect before credit grants and balance; give it as `checkout.expected_amount` to be refused rather than charged a different amount. `estimated_usage_amount` projects postpaid usage over one month of 730 hours and is not collected at checkout. A request the purchase would refuse is refused the same way. Prices may change, so quote again before final confirmation.
+ * Prices what `set-snapshot-quota` would order, including a change of an existing purchase as of now, for the same request, without ordering or creating anything; nothing is reserved or recorded. Billing evaluates applicable account discounts and tax as for automatic checkout. `total` is what automatic checkout would collect before credit grants and balance; give it as `checkout.expected_amount` to be refused rather than charged a different amount. `estimated_usage_amount` projects metered usage over one month of 730 hours and is not collected at checkout. A request the purchase would refuse is refused the same way. Prices may change, so quote again before final confirmation.
  * @summary Quote setting the regional snapshot quota
  */
 export declare const createSnapshotQuotaQuote: (regionId: string, setSnapshotQuotaQuoteRequestBody: SetSnapshotQuotaQuoteRequestBody, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<createSnapshotQuotaQuoteResponse>;
@@ -2306,7 +2306,7 @@ export type createBackupServiceResponseError = (createBackupServiceResponse409 |
 export type createBackupServiceResponse = createBackupServiceResponseSuccess | createBackupServiceResponseError;
 export declare const getCreateBackupServiceUrl: (regionId: string) => string;
 /**
- * Purchases the backup service for this project and region. The service itself has no charge; backups are billed under it postpaid, by retained capacity. It takes no billing choice. Returns the service as `pending` with its order; it becomes `active` once the order is accepted.
+ * Purchases the backup service for this project and region. The service itself has no charge; backups are metered under it by retained capacity. It takes no billing choice. Returns the service as `pending` with its order; it becomes `active` once the order is accepted.
  *
  * Refused with 409 `BACKUP_SERVICE_EXISTS` while an activation is pending or the service is active or suspended.
  * @summary Activate the backup service in a region
@@ -2333,7 +2333,7 @@ export type createBackupServiceQuoteResponseError = (createBackupServiceQuoteRes
 export type createBackupServiceQuoteResponse = createBackupServiceQuoteResponseSuccess | createBackupServiceQuoteResponseError;
 export declare const getCreateBackupServiceQuoteUrl: (regionId: string) => string;
 /**
- * Prices what `create-backup-service` would order for the same request, without ordering or creating anything; nothing is reserved or recorded. Billing evaluates applicable account discounts and tax as for automatic checkout. `total` is what automatic checkout would collect before credit grants and balance; give it as `checkout.expected_amount` to be refused rather than charged a different amount. `estimated_usage_amount` projects postpaid usage over one month of 730 hours and is not collected at checkout. A request the purchase would refuse is refused the same way. Prices may change, so quote again before final confirmation.
+ * Prices what `create-backup-service` would order for the same request, without ordering or creating anything; nothing is reserved or recorded. Billing evaluates applicable account discounts and tax as for automatic checkout. `total` is what automatic checkout would collect before credit grants and balance; give it as `checkout.expected_amount` to be refused rather than charged a different amount. `estimated_usage_amount` projects metered usage over one month of 730 hours and is not collected at checkout. A request the purchase would refuse is refused the same way. Prices may change, so quote again before final confirmation.
  * @summary Quote activating the backup service
  */
 export declare const createBackupServiceQuote: (regionId: string, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<createBackupServiceQuoteResponse>;
@@ -2379,7 +2379,7 @@ export type createBackupCapacityPackResponseError = (createBackupCapacityPackRes
 export type createBackupCapacityPackResponse = createBackupCapacityPackResponseSuccess | createBackupCapacityPackResponseError;
 export declare const getCreateBackupCapacityPackUrl: (regionId: string) => string;
 /**
- * Purchases a capacity pack, prepaid backup capacity for this project and region bought by month or year: `billing` must be prepaid with a period, as offered in the backup service's `capacity_pack_pricing`. Compute applies the coverage: each hour, retained backup capacity up to the total `capacity_gib` of the packs active in the region is covered, and Compute meters only the excess on the backup service's subscription. A pack is not a Billing allowance or credit; Billing takes its order and payment and handles its renewal and cancellation through the pack's subscription.
+ * Purchases a capacity pack, backup capacity for this project and region bought in advance by month or year: `billing` must be licensed with a period, as offered in the backup service's `capacity_pack_pricing`. Compute applies the coverage: each hour, retained backup capacity up to the total `capacity_gib` of the packs active in the region is covered, and Compute meters only the excess on the backup service's subscription. A pack is not a Billing allowance or credit; Billing takes its order and payment and handles its renewal and cancellation through the pack's subscription.
  *
  * Returns the pack as `pending` with its order; it applies once the order is accepted. Refused with 409 `BACKUP_SERVICE_NOT_ACTIVE` and `meta.region_id` when the region's backup service is not active.
  * @summary Buy a backup capacity pack
@@ -2406,7 +2406,7 @@ export type createBackupCapacityPackQuoteResponseError = (createBackupCapacityPa
 export type createBackupCapacityPackQuoteResponse = createBackupCapacityPackQuoteResponseSuccess | createBackupCapacityPackQuoteResponseError;
 export declare const getCreateBackupCapacityPackQuoteUrl: (regionId: string) => string;
 /**
- * Prices what `create-backup-capacity-pack` would order for the same request, without ordering or creating anything; nothing is reserved or recorded. Billing evaluates applicable account discounts and tax as for automatic checkout. `total` is what automatic checkout would collect before credit grants and balance; give it as `checkout.expected_amount` to be refused rather than charged a different amount. `estimated_usage_amount` projects postpaid usage over one month of 730 hours and is not collected at checkout. A request the purchase would refuse is refused the same way. Prices may change, so quote again before final confirmation.
+ * Prices what `create-backup-capacity-pack` would order for the same request, without ordering or creating anything; nothing is reserved or recorded. Billing evaluates applicable account discounts and tax as for automatic checkout. `total` is what automatic checkout would collect before credit grants and balance; give it as `checkout.expected_amount` to be refused rather than charged a different amount. `estimated_usage_amount` projects metered usage over one month of 730 hours and is not collected at checkout. A request the purchase would refuse is refused the same way. Prices may change, so quote again before final confirmation.
  * @summary Quote buying a backup capacity pack
  */
 export declare const createBackupCapacityPackQuote: (regionId: string, createBackupCapacityPackQuoteRequestBody: CreateBackupCapacityPackQuoteRequestBody, options?: RequestInit, fetchFn?: typeof globalThis.fetch) => Promise<createBackupCapacityPackQuoteResponse>;

package/dist/compute/v1/generated/functions.js

@@ -164,7 +164,7 @@ export const getCreateBackupRestoreQuoteUrl = (backupId) => {
     return `https://compute.leaflow.cloud/api/v1/backups/${encodeURIComponent(String(backupId))}/restore/quote`;
 };
 /**
- * Prices what `restore-backup` would order for the same request, without ordering or creating anything; nothing is reserved or recorded. Billing evaluates applicable account discounts and tax as for automatic checkout. `total` is what automatic checkout would collect before credit grants and balance; give it as `checkout.expected_amount` to be refused rather than charged a different amount. `estimated_usage_amount` projects postpaid usage over one month of 730 hours and is not collected at checkout. A request the purchase would refuse is refused the same way. Prices may change, so quote again before final confirmation.
+ * Prices what `restore-backup` would order for the same request, without ordering or creating anything; nothing is reserved or recorded. Billing evaluates applicable account discounts and tax as for automatic checkout. `total` is what automatic checkout would collect before credit grants and balance; give it as `checkout.expected_amount` to be refused rather than charged a different amount. `estimated_usage_amount` projects metered usage over one month of 730 hours and is not collected at checkout. A request the purchase would refuse is refused the same way. Prices may change, so quote again before final confirmation.
  * @summary Quote restoring from a backup
  */
 export const createBackupRestoreQuote = async (backupId, restoreBackupQuoteRequestBody, options, fetchFn) => {
@@ -553,7 +553,7 @@ export const getCreateDiskQuoteUrl = () => {
     return `https://compute.leaflow.cloud/api/v1/disks/quote`;
 };
 /**
- * Prices what `create-disk` would order for the same request, without ordering or creating anything; nothing is reserved or recorded. Billing evaluates applicable account discounts and tax as for automatic checkout. `total` is what automatic checkout would collect before credit grants and balance; give it as `checkout.expected_amount` to be refused rather than charged a different amount. `estimated_usage_amount` projects postpaid usage over one month of 730 hours and is not collected at checkout. A request the purchase would refuse is refused the same way. Prices may change, so quote again before final confirmation.
+ * Prices what `create-disk` would order for the same request, without ordering or creating anything; nothing is reserved or recorded. Billing evaluates applicable account discounts and tax as for automatic checkout. `total` is what automatic checkout would collect before credit grants and balance; give it as `checkout.expected_amount` to be refused rather than charged a different amount. `estimated_usage_amount` projects metered usage over one month of 730 hours and is not collected at checkout. A request the purchase would refuse is refused the same way. Prices may change, so quote again before final confirmation.
  * @summary Quote creating a disk
  */
 export const createDiskQuote = async (createDiskQuoteRequestBody, options, fetchFn) => {
@@ -653,7 +653,7 @@ export const getResizeDiskUrl = (diskId) => {
     return `https://compute.leaflow.cloud/api/v1/disks/${encodeURIComponent(String(diskId))}/resize`;
 };
 /**
- * Capacity can only be increased; shrinking is not supported. Returns the disk with the order for the resize, which keeps the disk's billing mode and period. The disk shows the `resize` operation until the resize is applied or its order is canceled, including while the order awaits checkout, so other operations and a second resize are refused with `COMPUTE_RESOURCE_BUSY` meanwhile. The disk keeps its current size until the resize is applied; once `size_gb` shows the new size, extend the file system inside the instance. If the order is not accepted or the resize fails, the disk keeps its size and the order shows the outcome.
+ * Capacity can only be increased; shrinking is not supported. Returns the disk with the order for the resize, which keeps the disk's usage type and period. The disk shows the `resize` operation until the resize is applied or its order is canceled, including while the order awaits checkout, so other operations and a second resize are refused with `COMPUTE_RESOURCE_BUSY` meanwhile. The disk keeps its current size until the resize is applied; once `size_gb` shows the new size, extend the file system inside the instance. If the order is not accepted or the resize fails, the disk keeps its size and the order shows the outcome.
  *
  * **An attached data disk whose performance scales with its size must be detached before it is resized.** The performance of an attached disk does not change until the disk is detached and attached again, so such a request is refused with `DISK_RESIZE_NEEDS_DETACH` rather than providing the new capacity at the performance of the previous size. Detach the disk, resize it, and attach it again.
  *
@@ -825,7 +825,7 @@ export const getCreateFloatingIpQuoteUrl = () => {
     return `https://compute.leaflow.cloud/api/v1/floating-ips/quote`;
 };
 /**
- * Prices what `allocate-floating-ip` would order for the same request, without ordering or creating anything; nothing is reserved or recorded. Billing evaluates applicable account discounts and tax as for automatic checkout. `total` is what automatic checkout would collect before credit grants and balance; give it as `checkout.expected_amount` to be refused rather than charged a different amount. `estimated_usage_amount` projects postpaid usage over one month of 730 hours and is not collected at checkout. A request the purchase would refuse is refused the same way. Prices may change, so quote again before final confirmation.
+ * Prices what `allocate-floating-ip` would order for the same request, without ordering or creating anything; nothing is reserved or recorded. Billing evaluates applicable account discounts and tax as for automatic checkout. `total` is what automatic checkout would collect before credit grants and balance; give it as `checkout.expected_amount` to be refused rather than charged a different amount. `estimated_usage_amount` projects metered usage over one month of 730 hours and is not collected at checkout. A request the purchase would refuse is refused the same way. Prices may change, so quote again before final confirmation.
  * @summary Quote allocating a floating IP
  */
 export const createFloatingIpQuote = async (allocateFloatingIPQuoteRequestBody, options, fetchFn) => {
@@ -891,7 +891,7 @@ export const getSetFloatingIpBandwidthUrl = (floatingIpId) => {
     return `https://compute.leaflow.cloud/api/v1/floating-ips/${encodeURIComponent(String(floatingIpId))}/bandwidth`;
 };
 /**
- * Changes the bandwidth of this floating IP through an order that keeps its billing mode and period; no separate bandwidth resource is created. The limit applies to inbound and outbound traffic alike. The floating IP shows the `set_bandwidth` operation until the change is applied or its order is canceled, including while the order awaits checkout, so other operations and a second change are refused with `COMPUTE_RESOURCE_BUSY` meanwhile. The current limit stays in effect until the change is applied. If the order is not accepted or the change fails, `bandwidth_mbps` keeps its value and the order shows the outcome.
+ * Changes the bandwidth of this floating IP through an order that keeps its usage type and period; no separate bandwidth resource is created. The limit applies to inbound and outbound traffic alike. The floating IP shows the `set_bandwidth` operation until the change is applied or its order is canceled, including while the order awaits checkout, so other operations and a second change are refused with `COMPUTE_RESOURCE_BUSY` meanwhile. The current limit stays in effect until the change is applied. If the order is not accepted or the change fails, `bandwidth_mbps` keeps its value and the order shows the outcome.
  *
  * While the address is bound to an instance, the limit must not exceed the `max_bandwidth_mbps` of that instance's type; a higher limit is refused with `INSTANCE_BANDWIDTH_CEILING`. The limit of an address that is not bound is checked when the address is bound to an instance.
  * @summary Set the bandwidth limit
@@ -1078,7 +1078,7 @@ export const getCreateInstanceQuoteUrl = () => {
     return `https://compute.leaflow.cloud/api/v1/instances/quote`;
 };
 /**
- * Prices what `launch-instance` would order for the same request, without ordering or creating anything; nothing is reserved or recorded. Billing evaluates applicable account discounts and tax as for automatic checkout. `total` is what automatic checkout would collect before credit grants and balance; give it as `checkout.expected_amount` to be refused rather than charged a different amount. `estimated_usage_amount` projects postpaid usage over one month of 730 hours and is not collected at checkout. A request the purchase would refuse is refused the same way. Prices may change, so quote again before final confirmation.
+ * Prices what `launch-instance` would order for the same request, without ordering or creating anything; nothing is reserved or recorded. Billing evaluates applicable account discounts and tax as for automatic checkout. `total` is what automatic checkout would collect before credit grants and balance; give it as `checkout.expected_amount` to be refused rather than charged a different amount. `estimated_usage_amount` projects metered usage over one month of 730 hours and is not collected at checkout. A request the purchase would refuse is refused the same way. Prices may change, so quote again before final confirmation.
  * @summary Quote creating instances
  */
 export const createInstanceQuote = async (launchInstanceQuoteRequestBody, options, fetchFn) => {
@@ -1463,7 +1463,7 @@ export const getResizeInstanceUrl = (instanceId) => {
     return `https://compute.leaflow.cloud/api/v1/instances/${encodeURIComponent(String(instanceId))}/resize`;
 };
 /**
- * Creates a Billing change order, including for metered pricing, and returns the instance with the order. The instance keeps its billing mode and period, priced with the target type's matching option; a target type without that option is refused with 409 `BILLING_OPTION_UNAVAILABLE`. Do not submit a new purchase after paying. After an uncertain response, look the order up before submitting again.
+ * Creates a Billing change order, including for metered pricing, and returns the instance with the order. The instance keeps its usage type and period, priced with the target type's matching option; a target type without that option is refused with 409 `BILLING_OPTION_UNAVAILABLE`. Do not submit a new purchase after paying. After an uncertain response, look the order up before submitting again.
  *
  * The instance shows the `resize` operation until the resize is applied or its order is canceled, including while the order awaits checkout, so other operations and a second resize are refused with `COMPUTE_RESOURCE_BUSY` meanwhile. It keeps its current type until the resize is applied; the new type takes effect, and is billed from then on, when `instance_type_id` shows it. If the order is not accepted or the resize fails, the instance keeps its current type and the order shows the outcome. A completed resize is final and cannot be reverted; to return to the previous type, submit another resize.
  * @summary Resize an instance
@@ -2463,7 +2463,7 @@ export const getSetSnapshotQuotaUrl = (regionId) => {
  * Purchases or changes the maximum number of snapshots this project may hold in this region.
  * limit is the target total, not an additional number of slots or a consumable create allowance.
  * billing chooses one of the quota's pricing options; a change of an existing purchase keeps its
- * billing mode and period, and billing must name that option. The purchased quantity is this count.
+ * usage type and period, and billing must name that option. The purchased quantity is this count.
  *
  * Returns the quota with the order. pending_limit records the target while the current limit stays
  * in force; the new limit applies once the order is accepted and the quota is activated. Snapshots
@@ -2507,7 +2507,7 @@ export const getCreateSnapshotQuotaQuoteUrl = (regionId) => {
     return `https://compute.leaflow.cloud/api/v1/regions/${encodeURIComponent(String(regionId))}/snapshot-quota/quote`;
 };
 /**
- * Prices what `set-snapshot-quota` would order, including a change of an existing purchase as of now, for the same request, without ordering or creating anything; nothing is reserved or recorded. Billing evaluates applicable account discounts and tax as for automatic checkout. `total` is what automatic checkout would collect before credit grants and balance; give it as `checkout.expected_amount` to be refused rather than charged a different amount. `estimated_usage_amount` projects postpaid usage over one month of 730 hours and is not collected at checkout. A request the purchase would refuse is refused the same way. Prices may change, so quote again before final confirmation.
+ * Prices what `set-snapshot-quota` would order, including a change of an existing purchase as of now, for the same request, without ordering or creating anything; nothing is reserved or recorded. Billing evaluates applicable account discounts and tax as for automatic checkout. `total` is what automatic checkout would collect before credit grants and balance; give it as `checkout.expected_amount` to be refused rather than charged a different amount. `estimated_usage_amount` projects metered usage over one month of 730 hours and is not collected at checkout. A request the purchase would refuse is refused the same way. Prices may change, so quote again before final confirmation.
  * @summary Quote setting the regional snapshot quota
  */
 export const createSnapshotQuotaQuote = async (regionId, setSnapshotQuotaQuoteRequestBody, options, fetchFn) => {
@@ -2558,7 +2558,7 @@ export const getCreateBackupServiceUrl = (regionId) => {
     return `https://compute.leaflow.cloud/api/v1/regions/${encodeURIComponent(String(regionId))}/backup-service`;
 };
 /**
- * Purchases the backup service for this project and region. The service itself has no charge; backups are billed under it postpaid, by retained capacity. It takes no billing choice. Returns the service as `pending` with its order; it becomes `active` once the order is accepted.
+ * Purchases the backup service for this project and region. The service itself has no charge; backups are metered under it by retained capacity. It takes no billing choice. Returns the service as `pending` with its order; it becomes `active` once the order is accepted.
  *
  * Refused with 409 `BACKUP_SERVICE_EXISTS` while an activation is pending or the service is active or suspended.
  * @summary Activate the backup service in a region
@@ -2593,7 +2593,7 @@ export const getCreateBackupServiceQuoteUrl = (regionId) => {
     return `https://compute.leaflow.cloud/api/v1/regions/${encodeURIComponent(String(regionId))}/backup-service/quote`;
 };
 /**
- * Prices what `create-backup-service` would order for the same request, without ordering or creating anything; nothing is reserved or recorded. Billing evaluates applicable account discounts and tax as for automatic checkout. `total` is what automatic checkout would collect before credit grants and balance; give it as `checkout.expected_amount` to be refused rather than charged a different amount. `estimated_usage_amount` projects postpaid usage over one month of 730 hours and is not collected at checkout. A request the purchase would refuse is refused the same way. Prices may change, so quote again before final confirmation.
+ * Prices what `create-backup-service` would order for the same request, without ordering or creating anything; nothing is reserved or recorded. Billing evaluates applicable account discounts and tax as for automatic checkout. `total` is what automatic checkout would collect before credit grants and balance; give it as `checkout.expected_amount` to be refused rather than charged a different amount. `estimated_usage_amount` projects metered usage over one month of 730 hours and is not collected at checkout. A request the purchase would refuse is refused the same way. Prices may change, so quote again before final confirmation.
  * @summary Quote activating the backup service
  */
 export const createBackupServiceQuote = async (regionId, options, fetchFn) => {
@@ -2634,7 +2634,7 @@ export const getCreateBackupCapacityPackUrl = (regionId) => {
     return `https://compute.leaflow.cloud/api/v1/regions/${encodeURIComponent(String(regionId))}/backup-capacity-packs`;
 };
 /**
- * Purchases a capacity pack, prepaid backup capacity for this project and region bought by month or year: `billing` must be prepaid with a period, as offered in the backup service's `capacity_pack_pricing`. Compute applies the coverage: each hour, retained backup capacity up to the total `capacity_gib` of the packs active in the region is covered, and Compute meters only the excess on the backup service's subscription. A pack is not a Billing allowance or credit; Billing takes its order and payment and handles its renewal and cancellation through the pack's subscription.
+ * Purchases a capacity pack, backup capacity for this project and region bought in advance by month or year: `billing` must be licensed with a period, as offered in the backup service's `capacity_pack_pricing`. Compute applies the coverage: each hour, retained backup capacity up to the total `capacity_gib` of the packs active in the region is covered, and Compute meters only the excess on the backup service's subscription. A pack is not a Billing allowance or credit; Billing takes its order and payment and handles its renewal and cancellation through the pack's subscription.
  *
  * Returns the pack as `pending` with its order; it applies once the order is accepted. Refused with 409 `BACKUP_SERVICE_NOT_ACTIVE` and `meta.region_id` when the region's backup service is not active.
  * @summary Buy a backup capacity pack
@@ -2669,7 +2669,7 @@ export const getCreateBackupCapacityPackQuoteUrl = (regionId) => {
     return `https://compute.leaflow.cloud/api/v1/regions/${encodeURIComponent(String(regionId))}/backup-capacity-packs/quote`;
 };
 /**
- * Prices what `create-backup-capacity-pack` would order for the same request, without ordering or creating anything; nothing is reserved or recorded. Billing evaluates applicable account discounts and tax as for automatic checkout. `total` is what automatic checkout would collect before credit grants and balance; give it as `checkout.expected_amount` to be refused rather than charged a different amount. `estimated_usage_amount` projects postpaid usage over one month of 730 hours and is not collected at checkout. A request the purchase would refuse is refused the same way. Prices may change, so quote again before final confirmation.
+ * Prices what `create-backup-capacity-pack` would order for the same request, without ordering or creating anything; nothing is reserved or recorded. Billing evaluates applicable account discounts and tax as for automatic checkout. `total` is what automatic checkout would collect before credit grants and balance; give it as `checkout.expected_amount` to be refused rather than charged a different amount. `estimated_usage_amount` projects metered usage over one month of 730 hours and is not collected at checkout. A request the purchase would refuse is refused the same way. Prices may change, so quote again before final confirmation.
  * @summary Quote buying a backup capacity pack
  */
 export const createBackupCapacityPackQuote = async (regionId, createBackupCapacityPackQuoteRequestBody, options, fetchFn) => {

package/dist/compute/v1/generated/models.d.ts

@@ -11,8 +11,8 @@
  * ## Conventions
  *
  * - **Purchases.** A purchase that creates resources returns them together with a PlacedOrder. They are readable at once and start as `pending`: the order has not been accepted, nothing exists in the cloud, no inventory such as an address is held, and fields known only after allocation, such as addresses, are null. Once Billing accepts the order, a resource becomes `provisioning` and then reaches its usual status, such as `active` or `available`. When the order is declined, canceled or expires, or creation fails, the resource ends `failed` and `failure_reason` states why; the charge for a resource that failed after acceptance is refunded. Read the order in Billing for checkout and payment progress.
- * - **Pricing.** Catalog items, such as instance types, disk types and public IP pools, carry `pricing`: the prepaid and postpaid options Billing offers for them, in the currency of the project's current billing account, or null when the project has no billing account. They are list amounts before promotion codes, not a checkout guarantee. A purchase chooses one option with `billing`, which applies to all of its components. Every purchase and change has a quote operation beside it, at the same path followed by `/quote`, which returns what checkout would collect without ordering anything.
- * - **Checkout.** Omit `checkout` for automatic checkout, which pays from eligible credit grants and balance when the order is placed; insufficient funds refuse the request with HTTP 422 `BILLING_INSUFFICIENT_FUNDS`, and nothing is created. With `checkout.mode` set to `deferred`, the resources are returned `pending` and nothing is created until checkout is confirmed and paid through Billing. An order whose total is zero, such as a postpaid purchase with nothing due now, completes checkout at placement in either mode and proceeds to provisioning.
+ * - **Pricing.** Catalog items, such as instance types, disk types and public IP pools, carry `pricing`: the licensed and metered options Billing offers for them, in the currency of the project's current billing account, or null when the project has no billing account. They are list amounts before promotion codes, not a checkout guarantee. A purchase chooses one option with `billing`, which applies to all of its components. Every purchase and change has a quote operation beside it, at the same path followed by `/quote`, which returns what checkout would collect without ordering anything.
+ * - **Checkout.** Omit `checkout` for automatic checkout, which pays from eligible credit grants and balance when the order is placed; insufficient funds refuse the request with HTTP 422 `BILLING_INSUFFICIENT_FUNDS`, and nothing is created. With `checkout.mode` set to `deferred`, the resources are returned `pending` and nothing is created until checkout is confirmed and paid through Billing. An order whose total is zero, such as a metered purchase with nothing due now, completes checkout at placement in either mode and proceeds to provisioning.
  * - **Operations.** Requests such as starting, stopping, attaching or deleting return HTTP 202 with the resource as it is when the request is accepted. While an operation runs, the resource's `operation` field names it; the field is null once the operation has finished, and the resource then shows the result. A resource with an operation in progress refuses another operation with HTTP 409 `COMPUTE_RESOURCE_BUSY`; an operation involving two resources, such as attaching a disk, is refused when either has one. A purchased change, such as a resize, is an operation from the moment its order is placed until it is applied or its order is canceled, including while it awaits checkout. Renaming and replacing labels or notes are not operations and are accepted at any time.
  * - **Billing relationships.** A purchased resource records its `order_id`, `order_item_id` and `subscription_id`. The subscription is `pending` until the order is accepted, `provisioning` while the resource is created, and `active` once it is delivered. Bandwidth is a property of its floating IP, not a separate resource. Snapshots use a purchased per-region count quota, and backups are metered on the region's backup service; neither has an order or subscription of its own.
  * - **Availability zones.** A disk and an instance must reside in the same availability zone to be attached. Instance types and disk types are each bound to one availability zone, so choosing a type determines the zone.
@@ -176,10 +176,13 @@ export interface RenameBackupRequestBody {
      */
     name: string;
 }
-export type BillingChoiceMode = (typeof BillingChoiceMode)[keyof typeof BillingChoiceMode];
-export declare const BillingChoiceMode: {
-    readonly prepaid: "prepaid";
-    readonly postpaid: "postpaid";
+/**
+ * `licensed` pays for a period in advance; `metered` bills usage until canceled.
+ */
+export type BillingChoiceUsageType = (typeof BillingChoiceUsageType)[keyof typeof BillingChoiceUsageType];
+export declare const BillingChoiceUsageType: {
+    readonly licensed: "licensed";
+    readonly metered: "metered";
 };
 export type BillingPeriodUnit = (typeof BillingPeriodUnit)[keyof typeof BillingPeriodUnit];
 export declare const BillingPeriodUnit: {
@@ -203,10 +206,11 @@ export declare const TerminationPolicy: {
     readonly period_end: "period_end";
 };
 /**
- * The commercial terms for one newly purchased component. Prepaid requires period and termination_policy; postpaid refuses both. Components in one instance order must use the same mode and period, while their termination policies may differ.
+ * The commercial terms for one newly purchased component. Licensed requires period and termination_policy; metered refuses both. Components in one instance order must use the same usage type and period, while their termination policies may differ.
  */
 export interface BillingChoice {
-    mode: BillingChoiceMode;
+    /** `licensed` pays for a period in advance; `metered` bills usage until canceled. */
+    usage_type: BillingChoiceUsageType;
     period?: BillingPeriod;
     termination_policy?: TerminationPolicy;
 }
@@ -454,10 +458,13 @@ export declare const DiskTypeResourceMedia: {
     readonly hdd: "hdd";
     readonly nvme: "nvme";
 };
-export type PricingOptionMode = (typeof PricingOptionMode)[keyof typeof PricingOptionMode];
-export declare const PricingOptionMode: {
-    readonly prepaid: "prepaid";
-    readonly postpaid: "postpaid";
+/**
+ * `licensed` pays for a period in advance; `metered` bills usage until canceled.
+ */
+export type PricingOptionUsageType = (typeof PricingOptionUsageType)[keyof typeof PricingOptionUsageType];
+export declare const PricingOptionUsageType: {
+    readonly licensed: "licensed";
+    readonly metered: "metered";
 };
 /**
  * What the amounts are for: one `item`, such as an instance or an address; one `gib` of size or capacity; one `mbps` of bandwidth; or one `snapshot` slot.
@@ -470,7 +477,7 @@ export declare const PricingOptionQuantityUnit: {
     readonly snapshot: "snapshot";
 };
 /**
- * Postpaid only; null for prepaid. The time unit of `unit_amount`.
+ * Metered only; null for licensed. The time unit of `unit_amount`.
  * @nullable
  */
 export type PricingOptionUnit = (typeof PricingOptionUnit)[keyof typeof PricingOptionUnit] | null;
@@ -487,36 +494,37 @@ export declare const PricingOptionTerminationPolicy: {
     readonly period_end: "period_end";
 };
 /**
- * One way to buy an item. Choose it by giving its mode, period and explicit prepaid termination_policy as billing.
+ * One way to buy an item. Choose it by giving its usage_type, period and termination_policy as billing.
  */
 export interface PricingOption {
-    mode: PricingOptionMode;
-    /** The term of a prepaid option; null for postpaid. */
+    /** `licensed` pays for a period in advance; `metered` bills usage until canceled. */
+    usage_type: PricingOptionUsageType;
+    /** The term of a licensed option; null for metered. */
     period: BillingPeriod | null;
     /** What the amounts are for: one `item`, such as an instance or an address; one `gib` of size or capacity; one `mbps` of bandwidth; or one `snapshot` slot. */
     quantity_unit: PricingOptionQuantityUnit;
     /**
-     * Prepaid only; null for postpaid. The amount for one period, per quantity unit.
+     * Licensed only; null for metered. The amount for one period, per quantity unit.
      * @nullable
      */
     amount: string | null;
     /**
-     * Prepaid only; null for postpaid. `amount` spread over the months of the period.
+     * Licensed only; null for metered. `amount` spread over the months of the period.
      * @nullable
      */
     monthly_amount: string | null;
     /**
-     * Prepaid only. How much lower `monthly_amount` is than that of the shortest prepaid period of the same item, as a decimal percentage. Null for that shortest period and for postpaid.
+     * Licensed only. How much lower `monthly_amount` is than that of the shortest licensed period of the same item, as a decimal percentage. Null for that shortest period and for metered.
      * @nullable
      */
     saving_percent: string | null;
     /**
-     * Postpaid only; null for prepaid. The amount for one `unit` of time, per quantity unit.
+     * Metered only; null for licensed. The amount for one `unit` of time, per quantity unit.
      * @nullable
      */
     unit_amount: string | null;
     /**
-     * Postpaid only; null for prepaid. The time unit of `unit_amount`.
+     * Metered only; null for licensed. The time unit of `unit_amount`.
      * @nullable
      */
     unit: PricingOptionUnit;
@@ -2061,10 +2069,10 @@ export interface BackupService {
      * The total `capacity_gib` of the active capacity packs in this region; this much retained capacity is covered each hour.
      * @minimum 0
      */
-    prepaid_capacity_gib: number;
-    /** The postpaid usage price of backups in this region. Null when the project has no billing account. */
+    pack_capacity_gib: number;
+    /** The metered usage price of backups in this region. Null when the project has no billing account. */
     readonly pricing: Pricing | null;
-    /** The prepaid options of capacity packs in this region, per GiB. Null when the project has no billing account. */
+    /** The licensed options of capacity packs in this region, per GiB. Null when the project has no billing account. */
     readonly capacity_pack_pricing: Pricing | null;
 }
 export interface CreateBackupServiceRequestBody {
@@ -2097,7 +2105,7 @@ export declare const BackupCapacityPackFailureReason: {
     readonly provisioning_failed: "provisioning_failed";
 };
 /**
- * Prepaid backup capacity for one region, sold by Compute and bought for a term through its own Billing subscription. Compute applies its coverage to backup usage; it is not a Billing allowance or credit.
+ * Backup capacity for one region, sold by Compute and bought for a term through its own Billing subscription. Compute applies its coverage to backup usage; it is not a Billing allowance or credit.
  */
 export interface BackupCapacityPack {
     id: string;
@@ -2305,16 +2313,16 @@ export interface SetFloatingIPBandwidthQuoteRequestBody {
 /**
  * Account funding for this purchase, calculated by Billing. Amounts use the enclosing response currency.
  * Credit eligibility and all purchase requirements are already evaluated. Nothing is charged or reserved.
- * A prepaid purchase may instead use an online payment method.
+ * A licensed purchase may instead be paid with an online payment method.
  */
 export interface Funds {
     /** Spendable balance after pending returns. */
     available_balance_amount: Money;
-    /** Currently effective credits eligible for the quoted purchases or postpaid usage. Each grant is counted once. */
+    /** Currently effective credits eligible for the quoted purchases or metered usage. Each grant is counted once. */
     usable_credit_amount: Money;
-    /** Currently effective credits that cannot fund any quoted purchase or postpaid target. Unused eligible credits are not restricted. */
+    /** Currently effective credits that cannot fund any quoted purchase or metered target. Unused eligible credits are not restricted. */
     restricted_credit_amount: Money;
-    /** Minimum spendable balance needed after eligible credits, covering immediate charges and every new postpaid admission requirement. */
+    /** Minimum spendable balance needed after eligible credits, covering immediate charges and every new metered purchase's admission requirement. */
     required_balance_amount: Money;
     /** Additional balance needed now. Zero means account funds satisfy this quote. No funds are reserved. */
     balance_shortfall_amount: Money;

package/dist/compute/v1/generated/models.js

@@ -23,9 +23,9 @@ export const BackupOperationType = {
     restore: "restore",
     delete: "delete",
 };
-export const BillingChoiceMode = {
-    prepaid: "prepaid",
-    postpaid: "postpaid",
+export const BillingChoiceUsageType = {
+    licensed: "licensed",
+    metered: "metered",
 };
 export const BillingPeriodUnit = {
     month: "month",
@@ -99,9 +99,9 @@ export const DiskTypeResourceMedia = {
     hdd: "hdd",
     nvme: "nvme",
 };
-export const PricingOptionMode = {
-    prepaid: "prepaid",
-    postpaid: "postpaid",
+export const PricingOptionUsageType = {
+    licensed: "licensed",
+    metered: "metered",
 };
 export const PricingOptionQuantityUnit = {
     item: "item",