PUT /v1/ingestBudgets/{id}

Update an existing ingest budget. All properties specified in the request are required.

Servers

Path parameters

Name Type Required Description
id String Yes

Identifier of the ingest budget to update.

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
capacityBytes Integer Yes

Capacity of the ingest budget, in bytes. It takes a few minutes for Collectors to stop collecting when capacity is reached. We recommend setting a soft limit that is lower than your needed hard limit.

timezone String Yes

Time zone of the reset time for the ingest budget. Follow the format in the IANA Time Zone Database.

resetTime String Yes

Reset time of the ingest budget in HH:MM format.

name String Yes

Display name of the ingest budget.

description String No

Description of the ingest budget.

action String Yes

Action to take when ingest budget's capacity is reached. All actions are audited. Supported values are:

  • stopCollecting
  • keepCollecting
fieldValue String Yes

Custom field value that is used to assign Collectors to the ingest budget.

auditThreshold Integer No

The threshold as a percentage of when an ingest budget's capacity usage is logged in the Audit Index.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.