Skip to main content
PATCH
Update a usage group

Authorizations

Authorization
string
header
required

Organization API key (sl_…).

Headers

If-Match
string | null
x-tenant-id
string
required

The organization ID the request is scoped to.

Path Parameters

usage_group_set_id
string
required
usage_group_id
string
required

Body

application/json

Merge-patch: omitted fields are left unchanged.

filter_expression
FilterExpression[Union[SemiStructuredDimension[SelectOrganizationUsageGroupDimensions], SelectOrganizationUsageGroupDimensions]] · object | null

Defines which spend is attributed to this usage group. Use exactly one of filter_expression or filter_expression_json.

filter_expression_json
string | null

A JSON string representation of the filter expression. This is primarily used for Terraform provider support. Use exactly one of filter_expression or filter_expression_json. This value is validated in the same manner as filter_expression.

name
string | null
budget
number | null
order
integer | null
Required range: x >= 0

Response

Successful Response

id
string
required
read-only

The unique identifier of the usage group.

create_time
string
required
read-only

When the usage group was created — RFC 3339 UTC.

update_time
string
required
read-only

When the usage group was last updated — RFC 3339 UTC.

usage_group_set_id
string
required
read-only

The usage group set this usage group belongs to.

name
string
required
order
integer
required
filter_expression
FilterExpression[Union[SemiStructuredDimension[SelectOrganizationUsageGroupDimensions], SelectOrganizationUsageGroupDimensions]] · object
required

Defines which spend is attributed to this usage group.

filter_expression_json
string
required
read-only

The JSON string representation of the filter expression, used by the Terraform provider.

etag
string
required
read-only

Opaque strong ETag for optimistic concurrency.

budget
number | null