updateMaxIngestRequestSize()

🎯API Stability

Long-TermThis API is stable and will remain supported across versions with minimal breaking changes.

Summary

The updateMaxIngestRequestSize() mutation sets a per-repository override for the maximum ingest request size. The override applies independently of the global default and can be raised, lowered, or removed. Set maxIngestRequestSize to 0 to remove the override and restore the global default.

Use the dynamicConfig() query to retrieve the current maximum ingest request size for a repository.

Hide Query Example

Show Related Query Example

To retrieve the current maximum ingest request size, use the dynamicConfig() query with the MaxIngestRequestSize configuration key:

graphql

query {
     dynamicConfig ( dynamicConfig: MaxIngestRequestSize )
   }

Syntax

graphql

updateMaxIngestRequestSize(
      repositoryName: String!,
      maxIngestRequestSize: Int!
   ): Repository!

Both parameters are required. In repositoryName, provide the target repository name. In maxIngestRequestSize, provide the new override value. Set maxIngestRequestSize to 0 to remove the override and restore the global default.

The mutation returns a Repository! object representing the updated repository state.

Input parameters

Provide the repository name and the new maximum ingest request size override value. Set maxIngestRequestSize to 0 to remove the current override.

Table: Input parameters and datatypes

Parameter	Type	Required	Description
This table contains all input parameters for this mutation.
maxIngestRequestSize	Int	yes	The new override value for the maximum ingest request size on this repository. Set to `0` to remove the override and restore the global default.
repositoryName	String	yes	The name of the repository on which to set the ingest request size override.

Example

Raw

graphql

mutation {
  updateMaxIngestRequestSize( 
     repositoryName: "humio",
     maxIngestRequestSize: 500
  )
 { id }
}

Mac OS or Linux (curl)

shell

curl -v -X POST $YOUR_LOGSCALE_URL/graphql \
    -H "Authorization: Bearer $TOKEN" \
    -H "Content-Type: application/json" \
    -d @- << EOF
{"query" : "mutation {
  updateMaxIngestRequestSize( 
     repositoryName: \"humio\",
     maxIngestRequestSize: 500
  )
 { id }
}"
}
EOF

Mac OS or Linux (curl) One-line

shell

curl -v -X POST $YOUR_LOGSCALE_URL/graphql \
    -H "Authorization: Bearer $TOKEN" \
    -H "Content-Type: application/json" \
    -d @- << EOF
{"query" : "mutation {
  updateMaxIngestRequestSize( 
     repositoryName: \"humio\",
     maxIngestRequestSize: 500
  )
 { id }
}"
}
EOF

Windows Cmd and curl

shell

curl -v -X POST $YOUR_LOGSCALE_URL/graphql ^
    -H "Authorization: Bearer $TOKEN" ^
    -H "Content-Type: application/json" ^
    -d @'{"query" : "mutation { ^
  updateMaxIngestRequestSize(  ^
     repositoryName: \"humio\", ^
     maxIngestRequestSize: 500 ^
  ) ^
 { id } ^
}" ^
} '

Windows Powershell and curl

powershell

curl.exe -X POST 
    -H "Authorization: Bearer $TOKEN"
    -H "Content-Type: application/json"
    -d '{"query" : "mutation {
  updateMaxIngestRequestSize( 
     repositoryName: \"humio\",
     maxIngestRequestSize: 500
  )
 { id }
}"
}'
    "$YOUR_LOGSCALE_URL/graphql"

Perl

perl

#!/usr/bin/perl

use HTTP::Request;
use LWP;

my $TOKEN = "TOKEN";

my $uri = '$YOUR_LOGSCALE_URL/graphql';

my $query = "mutation {
  updateMaxIngestRequestSize( 
     repositoryName: \"humio\",
     maxIngestRequestSize: 500
  )
 { id }
}";
$query =~ s/\n/ /g;
my $json = sprintf('{"query" : "%s"}',$query);
my $req = HTTP::Request->new("POST", $uri );

$req->header("Authorization" => "Bearer $TOKEN");
$req->header("Content-Type" => "application/json");

$req->content( $json );

my $lwp = LWP::UserAgent->new;

my $result = $lwp->request( $req );

print $result->{"_content"},"\n";

Python

python

#! /usr/local/bin/python3

import requests

url = '$YOUR_LOGSCALE_URL/graphql'
mydata = r'''{"query" : "mutation {
  updateMaxIngestRequestSize( 
     repositoryName: \"humio\",
     maxIngestRequestSize: 500
  )
 { id }
}"
}'''

resp = requests.post(url,
                     data = mydata,
                     headers = {
   "Authorization" : "Bearer $TOKEN",
   "Content-Type" : "application/json"
}
)

print(resp.text)

Node.js

javascript

const https = require('https');

const data = JSON.stringify(
    {"query" : "mutation {
  updateMaxIngestRequestSize( 
     repositoryName: \"humio\",
     maxIngestRequestSize: 500
  )
 { id }
}"
}
);


const options = {
  hostname: '$YOUR_LOGSCALE_URL',
  path: 'graphql',
  port: 443,
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Content-Length': data.length,
    Authorization: 'BEARER ' + process.env.TOKEN,
    'User-Agent': 'Node',
  },
};

const req = https.request(options, (res) => {
  let data = '';
  console.log(`statusCode: ${res.statusCode}`);

  res.on('data', (d) => {
    data += d;
  });
  res.on('end', () => {
    console.log(JSON.parse(data).data);
  });
});

req.on('error', (error) => {
  console.error(error);
});

req.write(data);
req.end();

Example Responses

Success (HTTP Response Code 200 OK)

json

{
  "data": {
    "updateMaxIngestRequestSize": {
      "id": "abc123"
    }
  }
}

Returned values

The mutation returns a Repository! object. The returned fields reflect the updated ingest request size configuration and other repository properties. The following table lists the available fields:

Table: Repository Datatype

Parameter	Type	Required	Stability	Description
action(id: string): Action	multiple	yes	`Long-Term`	A saved action. The unique identifier of the action to get. Returns information on the action. See Action.
actions(actionIds: [string]): [Action]	multiple	yes	`Long-Term`	A list of saved actions. The result will only include actions for the specified identifiers. Omit to retrieve all actions. See Action.
aggregateAlert(id: string): AggregateAlert	multiple	yes	`Long-Term`	A saved aggregate alert. The unique identifier of the aggregate alert. See AggregateAlert.
aggregateAlerts	[AggregateAlert]	yes	`Long-Term`	A list of saved aggregate alerts. See AggregateAlert.
alert(id: string): Alert	multiple	yes	`Long-Term`	A saved alert. See Alert.
alerts	[Alert]	yes	`Long-Term`	Saved alerts. See Alert.
allowedViewActions	[ViewAction]	yes	`Long-Term`	Returns all actions the user is allowed to perform on the view. See ViewAction.
archivingConfiguration	ArchivingConfiguration		`Short-Term`	Any archiving configuration. This is a preview parameter and is subject to change. See ArchivingConfiguration.
archivingProvider	string		`Short-Term`	The archiving provider. This is a preview parameter and subject to change.
automaticSearch	boolean	yes	`Long-Term`	Whether to search automatically.
availablePackages(filter: string, tags: [PackageTag], categories: [string]): [PackageRegistrySearchResultItem]	multiple	yes	`Long-Term`	Returns a list of available packages that can be installed. PackageTag is a scalar. See PackageRegistrySearchResultItem for more on it.
awsExternalId	string	yes	`Long-Term`	The AWS External unique identifier used when assuming roles in AWS on behalf of this repository.
cachePolicy	CachePolicy		`Preview`	The cache policy set on the repository. This is a preview and subject to change. See CachePolicy.
compressedByteSize	long	yes	`Long-Term`	Total size of data, measured as the size after compression.
compressedByteSizeOfMerged	long	yes	`Long-Term`	Total size of data, merged parts. Size is measured as the size after compression.
currentTagGroupings	[TagGroupingRule]	yes	`Long-Term`	Tag grouping rules applied on the repository currently. Rules only apply to the tags they denote, and tags without rules do not have any grouping. See TagGroupingRule.
dashboard(id: string): Dashboard	multiple	yes	`Long-Term`	A saved dashboard. See Dashboard.
dashboards	[Dashboard]	yes	`Long-Term`	All dashboards available on the view. See Dashboard.
datasources	[Datasource]	yes	`Long-Term`	Data sources from where data is ingested: specific log files or services sending data to LogScale. See Datasource.
dataType	RepositoryDataType	yes	`Long-Term`	Repository data types are used for controlling the types of data are allowed in the repository. See RepositoryDataType.
defaultQuery	SavedQuery		`Long-Term`	The default saved query for the repository. See SavedQuery.
deletedDate	long		`Long-Term`	The point in time the search domain was marked for deletion.
description	string		`Long-Term`	A description of the repository.
effectiveCachePolicy	CachePolicy	yes	`Preview`	The effective cache policy that will apply to the repository, organization or global default, in order of precedence is: the repository cache policy, if set; the organization cache policy, if set; the global cache policy, if set; or the default cache policy in which no segments are prioritized. Cache policies are a limited feature and subject to change. See CachePolicy.
eventForwardersForSelection	[EventForwarderForSelection]	yes	`Long-Term`	List event forwarders in the organization with only basic information. See EventForwarderForSelection.
eventForwardingRules	[EventForwardingRule]	yes	`Long-Term`	The event forwarding rules configured for the repository. See EventForwardingRule.
fdrFeed(id: string): FdrFeed	multiple	yes	`Long-Term`	The unique identifier of the FDR feed to get. See FdrFeed.
fdrFeedControl(id: string): FdrFeedControl	multiple	yes	`Long-Term`	Administrator control for an FDR feed. Provide the identifier of the FDR feed the administrator is to control. The maxNodes is the maximum number of nodes with which to poll the FDR feed. This feature is a preview and is still being iterated; changes may occur. See FdrFeedControl.
fdrFeedControls	[FdrFeedControl]	yes	`Long-Term`	Administrator controls for FDR feeds. This feature is still being iterated; changes may occur. See FdrFeedControl.
fdrFeeds	[FdrFeed]	yes	`Long-Term`	Saved FDR feeds. See FdrFeed.
fileFieldSearch(fileName: string, fieldName: string, prefixFilter: string, valueFilters: [FileFieldFilterType], fieldsToInclude: [string], maxEntries: integer): [[DictionaryEntryType]]	multiple	yes	`Long-Term`	Searching fields in a file. See FileFieldFilterType and DictionaryEntryType.
files	[File]	yes	`Long-Term`	Any related files. See File.
filterAlert(id: string): FilterAlert	multiple	yes	`Long-Term`	A saved filter alert. See FilterAlert.
filterAlerts	[FilterAlert]	yes	`Long-Term`	Saved filter alerts. See FilterAlert.
gcsArchivingConfiguration	GCSArchivingConfiguration		`Short-Term`	GCS archiving configuration. This is a preview and subject to change. See GCSArchivingConfiguration.
groups	[Group]	yes	`Long-Term`	Groups with assigned roles. See Group.
hasPackageInstalled(packageId: VersionedPackageSpecifier): boolean	multiple	yes	`Long-Term`	Whether the repository has a given package installed. VersionedPackageSpecifier is a scalar.
id	string	yes	`Long-Term`	The unique identifier of the repository.
ingestBlock	datetime		`Long-Term`	The date and time in the future after which ingest for this repository will be re-enabled.
ingestFeed(id: string): IngestFeed	multiple	yes	`Long-Term`	A saved Ingest feed. See IngestFeed.
ingestFeeds(searchFilter: string, typeFilter: [IngestFeeds__Type], sortBy: IngestFeeds__SortBy, orderBy: OrderBy, skip: integer, limit: integer): IngestFeedQueryResultSet!	multiple	yes	`Long-Term`	Saved Ingest feeds. See IngestFeeds__Type, IngestFeeds__SortBy, OrderBy, and IngestFeedQueryResultSet.
ingestListeners	[IngestListener]	yes	`Long-Term`	The ingest listeners configured for this repository (see IngestListener).
ingestSizeBasedRetention	float		`Long-Term`	Retention in gigabytes, based on the size of data when it arrives at LogScale, before parsing and compression. LogScale will keep at most this amount of data.
ingestTokens	[IngestToken]	yes	`Long-Term`	The ingest token used for receiving data into the repository. See IngestToken.
installedPackages	[PackageInstallation]	yes	`Long-Term`	List packages installed on a specific view or repository. See PackageInstallation.
interactions	[ViewInteraction]	yes	`Long-Term`	All interactions defined on the view. See ViewInteraction.
isActionAllowed(action: ViewAction): boolean	multiple	yes	`Long-Term`	Check if the current user is allowed to perform the given action on the view. See ViewAction.
isStarred	boolean	yes	`Long-Term`	Whether the repository is marked with a star.
limit	LimitV2		`Long-Term`	This is the limit attached to the repository. See LimitV2.
maxAutoShardCount	integer		`Long-Term`	The maximum number of auto shards created.
name	RepoOrViewName	yes	`Long-Term`	The name of the repository. RepoOrViewName is a scalar.
packageV2(packageId: VersionedPackageSpecifier): Package2	multiple	yes	`Long-Term`	The returned package information for the specified package. VersionedPackageSpecifier is a scalar. See Package2.
packageVersions(packageId: UnversionedPackageSpecifier): [RegistryPackageVersionInfo]	multiple	yes	`Long-Term`	The available versions of a package. UnversionedPackageSpecifier is a scalar. See RegistryPackageVersionInfo.
parser(parserid: string, name: string): Parser	multiple		`Long-Term`	The parser for the repository. Give either the `parserid` or the `name`. See Parser.
parsers	[Parser]	yes	`Long-Term`	List of parsers used with the repository. See Parser.
permanentlyDeletedAt	long		`Long-Term`	The point in time the search domain will not be restorable.
persistedAggregations(sortBy: PersistedAggregationSortBy, orderBy: OrderBy, skip: integer, limit: integer): PersistedAggregationResultSet	multiple		`Preview`	List of persisted aggregations for repository, with sorting and pagination. See PersistedAggregationSortBy.
recentQueriesV2	[RecentQuery]	yes	`Long-Term`	Any recent queries. See RecentQuery.
redirectQueryAssetLookupTo	SearchDomain		`Preview`	The redirected query asset lookup view used for asset resolution when set. Assets like saved queries and lookup files will be resolved from this view instead of the current view. See SearchDomain.
reposExcludedInSearchLimit	[string]	yes	`Long-Term`	Repositories not part of the search limitation.
resource	string		`Short-Term`	The resource identifier for this search domain.
s3ArchivingArn	string		`Short-Term`	The ARN of the AWS IAM identity that will write to S3 for S3 archiving.
s3ArchivingConfiguration	S3Configuration		`Long-Term`	The configuration for S3 archiving (e.g., bucket name and region). See S3Configuration.
savedQueries	[SavedQuery]	yes	`Long-Term`	Saved queries. See SavedQuery.
savedQuery(id: string): SavedQuery	multiple	yes	`Long-Term`	A saved query. See SavedQuery.
scheduledReport(id: string): ScheduledReport	multiple	yes	`Long-Term`	Saved scheduled report. See ScheduledReport.
scheduledReports	[ScheduledReport]	yes	`Long-Term`	Saved scheduled reports. See ScheduledReport.
scheduledSearch(id: string): ScheduledSearch	multiple	yes	`Long-Term`	A saved scheduled search. See ScheduledSearch.
scheduledSearches	[ScheduledSearch]	yes	`Long-Term`	Saved scheduled searches. See ScheduledSearch.
searchLimitedMs	long		`Long-Term`	Search limit in milliseconds, to which searches should are limited.
secretHandle(id: string): SecretHandle	multiple	yes	`Preview`	A saved secret handle. See SecretHandle.
secretHandles(skip: integer, limit: integer): secretHandleQueryResultSet	multiple	yes	`Preview`	Saved secret handles. See secretHandleQueryResultSet.
starredFields	[string]	yes	`Long-Term`	A list of fields which are marked with a star in the repository.
storageSizeBasedRetention	float		`Long-Term`	Retention in gigabytes, based on the size of data when in storage, after parsing and compression. LogScale will keep at least this amount of data, but as close to this amount as possible.
tags	[string]	yes	`Long-Term`	All tags from all datasources.
timeBasedBackupRetention	float		`Long-Term`	Sets time in days to keep back-ups before they are deleted.
timeBasedRetention	float		`Long-Term`	The maximum time in days to keep data. Older date will be deleted.
timeOfLatestIngest	datetime		`Long-Term`	The timestamp of the latest ingested data, or null if the repository is empty.
type	RepositoryType	yes	`Long-Term`	Repository Types are used for tracking trial status in LogScale Cloud setups. See RepositoryType.
uncompressedByteSize	long	yes	`Long-Term`	Total size the data, measured as the size stored before compression and is thus the size of the internal format, not the data that was ingested.
uncompressedByteSizeOfMerged	long	yes	`Long-Term`	Total size the data, merged parts. Size is measured as the size stored before compression and is thus the size of the internal format, not the data that was ingested.
usageTag	string		`Long-Term`	The usage tag used to group usage summary on repositories.
users	[User]	yes	`Long-Term`	Users who have access to the repository. See User.
usersAndGroups(search: string, skip: integer, limit: integer): UsersAndGroupsSearchResultSet	multiple	yes	`Long-Term`	Users or groups who have access to the repository. See UsersAndGroupsSearchResultSet.
usersV2(search: string, permissionFilter: Permission, skip: integer, limit: integer): Users	multiple	yes	`Short-Term`	Used to search for a user based on search parameters and for a given permission. See Permission and Users.
viewerQueryPrefix	string	yes	`Long-Term`	The query prefix prepended to each search in this domain.

Versions of this Page

GraphQL Mutations

GraphQL API

GraphQL Queries

GraphQL Datatypes