orb-billing/resources/dimensional-price-groups/dimensional-price-groups.d.ts

The official TypeScript library for the Orb API

import { APIResource } from "../../resource.js";
import * as Core from "../../core.js";
import * as Shared from "../shared.js";
import * as ExternalDimensionalPriceGroupIDAPI from "./external-dimensional-price-group-id.js";
import { ExternalDimensionalPriceGroupID, ExternalDimensionalPriceGroupIDUpdateParams } from "./external-dimensional-price-group-id.js";
import { Page, type PageParams } from "../../pagination.js";
export declare class DimensionalPriceGroups extends APIResource {
    externalDimensionalPriceGroupId: ExternalDimensionalPriceGroupIDAPI.ExternalDimensionalPriceGroupID;
    /**
     * A dimensional price group is used to partition the result of a billable metric
     * by a set of dimensions. Prices in a price group must specify the partition used
     * to derive their usage.
     *
     * For example, suppose we have a billable metric that measures the number of
     * widgets used and we want to charge differently depending on the color of the
     * widget. We can create a price group with a dimension "color" and two prices: one
     * that charges \$10 per red widget and one that charges \$20 per blue widget.
     */
    create(body: DimensionalPriceGroupCreateParams, options?: Core.RequestOptions): Core.APIPromise<DimensionalPriceGroup>;
    /**
     * Fetch dimensional price group
     */
    retrieve(dimensionalPriceGroupId: string, options?: Core.RequestOptions): Core.APIPromise<DimensionalPriceGroup>;
    /**
     * This endpoint can be used to update the `external_dimensional_price_group_id`
     * and `metadata` of an existing dimensional price group. Other fields on a
     * dimensional price group are currently immutable.
     */
    update(dimensionalPriceGroupId: string, body: DimensionalPriceGroupUpdateParams, options?: Core.RequestOptions): Core.APIPromise<DimensionalPriceGroup>;
    /**
     * List dimensional price groups
     */
    list(query?: DimensionalPriceGroupListParams, options?: Core.RequestOptions): Core.PagePromise<DimensionalPriceGroupsPage, DimensionalPriceGroup>;
    list(options?: Core.RequestOptions): Core.PagePromise<DimensionalPriceGroupsPage, DimensionalPriceGroup>;
}
export declare class DimensionalPriceGroupsPage extends Page<DimensionalPriceGroup> {
}
/**
 * A dimensional price group is used to partition the result of a billable metric
 * by a set of dimensions. Prices in a price group must specify the parition used
 * to derive their usage.
 */
export interface DimensionalPriceGroup {
    id: string;
    /**
     * The billable metric associated with this dimensional price group. All prices
     * associated with this dimensional price group will be computed using this
     * billable metric.
     */
    billable_metric_id: string;
    /**
     * The dimensions that this dimensional price group is defined over
     */
    dimensions: Array<string>;
    /**
     * An alias for the dimensional price group
     */
    external_dimensional_price_group_id: string | null;
    /**
     * User specified key-value pairs for the resource. If not present, this defaults
     * to an empty dictionary. Individual keys can be removed by setting the value to
     * `null`, and the entire metadata mapping can be cleared by setting `metadata` to
     * `null`.
     */
    metadata: {
        [key: string]: string;
    };
    /**
     * The name of the dimensional price group
     */
    name: string;
}
export interface DimensionalPriceGroups {
    data: Array<DimensionalPriceGroup>;
    pagination_metadata: Shared.PaginationMetadata;
}
export interface DimensionalPriceGroupCreateParams {
    billable_metric_id: string;
    /**
     * The set of keys (in order) used to disambiguate prices in the group.
     */
    dimensions: Array<string>;
    name: string;
    external_dimensional_price_group_id?: string | null;
    /**
     * User-specified key/value pairs for the resource. Individual keys can be removed
     * by setting the value to `null`, and the entire metadata mapping can be cleared
     * by setting `metadata` to `null`.
     */
    metadata?: {
        [key: string]: string | null;
    } | null;
}
export interface DimensionalPriceGroupUpdateParams {
    /**
     * An optional user-defined ID for this dimensional price group resource, used
     * throughout the system as an alias for this dimensional price group. Use this
     * field to identify a dimensional price group by an existing identifier in your
     * system.
     */
    external_dimensional_price_group_id?: string | null;
    /**
     * User-specified key/value pairs for the resource. Individual keys can be removed
     * by setting the value to `null`, and the entire metadata mapping can be cleared
     * by setting `metadata` to `null`.
     */
    metadata?: {
        [key: string]: string | null;
    } | null;
}
export interface DimensionalPriceGroupListParams extends PageParams {
}
export declare namespace DimensionalPriceGroups {
    export { type DimensionalPriceGroup as DimensionalPriceGroup, type DimensionalPriceGroups as DimensionalPriceGroups, DimensionalPriceGroupsPage as DimensionalPriceGroupsPage, type DimensionalPriceGroupCreateParams as DimensionalPriceGroupCreateParams, type DimensionalPriceGroupUpdateParams as DimensionalPriceGroupUpdateParams, type DimensionalPriceGroupListParams as DimensionalPriceGroupListParams, };
    export { ExternalDimensionalPriceGroupID as ExternalDimensionalPriceGroupID, type ExternalDimensionalPriceGroupIDUpdateParams as ExternalDimensionalPriceGroupIDUpdateParams, };
}
//# sourceMappingURL=dimensional-price-groups.d.ts.map