updatePackageFromRegistryV2()

Summary

The updatePackageFromRegistryV2() GraphQL mutation field may be used to update a package in a specified view in LogScale.

Use installPackageFromRegistryV2() to install a package from a registry.

Hide Query Example

Show Available Packages Query

To get information on available packages, you could use the repository() query like this:

graphql

query {
     repository ( name: "humio" )
      { availablePackages { 
           id, type, description, 
           installedVersion } 
        }
   }

The id will return version available, whereas the installedVersion will let you know what's installed already.

For more information on packages, see the Package Management documentation page.

API Stability Long-Term

Syntax

graphql

updatePackageFromRegistryV2(
     UpdatePackageFromRegistryInput: UpdatePackageFromRegistryInput!
   ): PackageUpdateResult!

You'll have to give the name of the view, identifier of the package you want to update, and how to resolve conflicts. Click on Show Query above to find the identifier. See the Input Parameters section for details.

For the results, you can get templates for alerts, aggregate alerts, filter alerts, and actions. See the Returned Values section for more.

Example

Raw

graphql

mutation {
  updatePackageFromRegistryV2(
     UpdatePackageFromRegistryInput: 
      {viewName: "humio",
       packageId: "humio/insights@0.0.14",
       conflictResolutions: [ { entityType: Dashboard, 
                                entityName: "Errors",
                                conflictResolution: Ours },
                              { entityType: Dashboard, 
                                entityName: "Hosts",
                                conflictResolution: Ours }],
       queryOwnershipType: Organization
      }
  )
  { package { 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 {
  updatePackageFromRegistryV2(
     UpdatePackageFromRegistryInput: 
      {viewName: \"humio\",
       packageId: \"humio/insights@0.0.14\",
       conflictResolutions: [ { entityType: Dashboard, 
                                entityName: \"Errors\",
                                conflictResolution: Ours },
                              { entityType: Dashboard, 
                                entityName: \"Hosts\",
                                conflictResolution: Ours }],
       queryOwnershipType: Organization
      }
  )
  { package { 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 {
  updatePackageFromRegistryV2(
     UpdatePackageFromRegistryInput: 
      {viewName: \"humio\",
       packageId: \"humio/insights@0.0.14\",
       conflictResolutions: [ { entityType: Dashboard, 
                                entityName: \"Errors\",
                                conflictResolution: Ours },
                              { entityType: Dashboard, 
                                entityName: \"Hosts\",
                                conflictResolution: Ours }],
       queryOwnershipType: Organization
      }
  )
  { package { 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 { ^
  updatePackageFromRegistryV2( ^
     UpdatePackageFromRegistryInput:  ^
      {viewName: \"humio\", ^
       packageId: \"humio/insights@0.0.14\", ^
       conflictResolutions: [ { entityType: Dashboard,  ^
                                entityName: \"Errors\", ^
                                conflictResolution: Ours }, ^
                              { entityType: Dashboard,  ^
                                entityName: \"Hosts\", ^
                                conflictResolution: Ours }], ^
       queryOwnershipType: Organization ^
      } ^
  ) ^
  { package { id } } ^
}" ^
} '

Windows Powershell and curl

powershell

curl.exe -X POST 
    -H "Authorization: Bearer $TOKEN"
    -H "Content-Type: application/json"
    -d '{"query" : "mutation {
  updatePackageFromRegistryV2(
     UpdatePackageFromRegistryInput: 
      {viewName: \"humio\",
       packageId: \"humio/insights@0.0.14\",
       conflictResolutions: [ { entityType: Dashboard, 
                                entityName: \"Errors\",
                                conflictResolution: Ours },
                              { entityType: Dashboard, 
                                entityName: \"Hosts\",
                                conflictResolution: Ours }],
       queryOwnershipType: Organization
      }
  )
  { package { 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 {
  updatePackageFromRegistryV2(
     UpdatePackageFromRegistryInput: 
      {viewName: \"humio\",
       packageId: \"humio/insights@0.0.14\",
       conflictResolutions: [ { entityType: Dashboard, 
                                entityName: \"Errors\",
                                conflictResolution: Ours },
                              { entityType: Dashboard, 
                                entityName: \"Hosts\",
                                conflictResolution: Ours }],
       queryOwnershipType: Organization
      }
  )
  { package { 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 {
  updatePackageFromRegistryV2(
     UpdatePackageFromRegistryInput: 
      {viewName: \"humio\",
       packageId: \"humio/insights@0.0.14\",
       conflictResolutions: [ { entityType: Dashboard, 
                                entityName: \"Errors\",
                                conflictResolution: Ours },
                              { entityType: Dashboard, 
                                entityName: \"Hosts\",
                                conflictResolution: Ours }],
       queryOwnershipType: Organization
      }
  )
  { package { 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 {
  updatePackageFromRegistryV2(
     UpdatePackageFromRegistryInput: 
      {viewName: \"humio\",
       packageId: \"humio/insights@0.0.14\",
       conflictResolutions: [ { entityType: Dashboard, 
                                entityName: \"Errors\",
                                conflictResolution: Ours },
                              { entityType: Dashboard, 
                                entityName: \"Hosts\",
                                conflictResolution: Ours }],
       queryOwnershipType: Organization
      }
  )
  { package { 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": {
    "updatePackageFromRegistryV2": {
      "package": {
        "id": "humio/insights@0.0.14"
      }
    }
  }
}

Input Parameters

For the input, you'll have to give the name of the view and the unique identifier of the package you want to update, and how to resolve conflicts. Click on the Show Query link above the Syntax section for an example of how to find the identifier.

Table: UpdatePackageFromRegistryInput Input Datatype

Parameter	Type	Required	Default	Stability	Description
Some input parameters may be required, as indicated in the Required column. For return values, this indicates that you are assured a value if the field is requested for the results.
Table last updated: Mar 28, 2025
conflictResolutions	[ConflictResolutionConfiguration]	yes		`Long-Term`	A list of resolutions to any conflicts encountered. See ConflictResolutionConfiguration.
packageId	VersionedPackageSpecifier	yes		`Long-Term`	The unique identifier for the package. VersionedPackageSpecifier is a scalar.
queryOwnershipType	QueryOwnershipType	yes	User	`Long-Term`	Ownership of the query run by this filter alert. If value is `User`, ownership will be based on the runAsUserId field. See QueryOwnershipType.
viewName	RepoOrViewName	yes		`Long-Term`	The name of the view related to the package. RepoOrViewName is a scalar.

Returned Values

For the results, you can get plenty information on the package, such as templates for its alerts, aggregate alerts, filter alerts, and actions.

Table: PackageUpdateResult Datatype

Parameter	Type	Required	Stability	Description
Some input parameters may be required, as indicated in the Required column. For return values, this indicates that you are assured a value if the field is requested for the results.
Table last updated: Sep 27, 2024
package	Package2	yes	`Long-Term`	The package that was updated. See Package2.

Versions of this Page

GraphQL Mutations

GraphQL API

GraphQL API Stability

GraphQL Queries

GraphQL Datatypes