createDemoDataRepository()

🎯API Stability

Short-TermThis API may change in future versions. Use with caution in production environments.

Summary

The createDemoDataRepository() mutation provisions a demo data repository in LogScale pre-populated with a specified demo data set. If a repository for the requested demo data type already exists, the mutation returns that repository without creating a duplicate. This idempotent behavior makes the mutation safe to call repeatedly in automated provisioning workflows.

Syntax

graphql

createDemoDataRepository(
      demoDataType: String!
   ): Repository!

The required demoDataType argument is a string that identifies the demo data set to provision. The mutation returns a non-nullable Repository! object representing the created or retrieved demo data repository.

Example

Raw

graphql

mutation {
  createDemoDataRepository(demoDataType: "something" )
  { id,  type, dataType }
}

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 {
  createDemoDataRepository(demoDataType: \"something\" )
  { id,  type, dataType }
}"
}
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 {
  createDemoDataRepository(demoDataType: \"something\" )
  { id,  type, dataType }
}"
}
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 { ^
  createDemoDataRepository(demoDataType: \"something\" ) ^
  { id,  type, dataType } ^
}" ^
} '

Windows Powershell and curl

powershell

curl.exe -X POST 
    -H "Authorization: Bearer $TOKEN"
    -H "Content-Type: application/json"
    -d '{"query" : "mutation {
  createDemoDataRepository(demoDataType: \"something\" )
  { id,  type, dataType }
}"
}'
    "$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 {
  createDemoDataRepository(demoDataType: \"something\" )
  { id,  type, dataType }
}";
$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 {
  createDemoDataRepository(demoDataType: \"something\" )
  { id,  type, dataType }
}"
}'''

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 {
  createDemoDataRepository(demoDataType: \"something\" )
  { id,  type, dataType }
}"
}
);


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();

Input Parameters

Provide a predefined LogScale demo data type identifier to specify which demo data set to provision.

Table: Input Parameters & Datatypes

Parameter	Type	Required	Default	Description
This table contains all input parameters for this mutation.
demoDataType	string	yes		Identifies the demo data set to provision. Accepted values are predefined LogScale demo data type identifiers, for example, `humio`. If a repository for this demo data type already exists, the mutation returns it rather than creating a new one.

Returned Values

The mutation returns a Repository! object representing the created or retrieved demo data repository. Request the id field to obtain the repository identifier needed by subsequent mutations and queries. The name field returns the display name of the repository, and type confirms that the returned object is a repository rather than a view. The following table lists all available fields on the returned Repository type.

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