Method: integrations.fetchCommercialDiff

Full name: projects.locations.instances.integrations.fetchCommercialDiff

Returns the difference between the current integration and its matching commercial version in the Marketplace. Use this method to identify available updates or drift from the certified version.

HTTP request


GET https://chronicle.africa-south1.rep.googleapis.com/v1beta/{name}:fetchCommercialDiff

Path parameters

Parameters
name

string

Required. The name of the integration. Format: projects/{projectId}/locations/{region}/instances/{instance}/integrations/{integration}

Request body

The request body must be empty.

Response body

The response message for Geting the commercial diff.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "integrationIdentifier": string,
  "actions": [
    string
  ],
  "jobs": [
    string
  ],
  "connectors": [
    string
  ],
  "managers": [
    string
  ],
  "transformers": [
    string
  ],
  "logicalOperators": [
    string
  ],
  "customFamilies": [
    string
  ],
  "exampleUsecases": [
    string
  ],
  "mappingRules": [
    string
  ],
  "version": string,
  "pythonVersion": enum (PythonVersion),
  "existingIntegration": {
    object (Integration)
  },
  "diff": {
    object (IntegrationDiff)
  },
  "type": enum (IntegrationType),
  "custom": boolean,
  "mappingRulesExist": boolean
}
Fields
integrationIdentifier

string

Required. The extracted integration identifier name.
actions[]

string

Output only. Extracted actions names.
jobs[]

string

Output only. Extracted jobs names.
connectors[]

string

Output only. Extracted connector names.
managers[]

string

Output only. Extracted managers names.
transformers[]

string

Output only. Extracted transformers names.
logicalOperators[]

string

Output only. Extracted logical operators names.
customFamilies[]

string

Output only. Extracted custom family names.
exampleUsecases[]

string

Output only. Extracted example usecases names.
mappingRules[]

string

Output only. Extracted mapping rules names.
version

string

Output only. Integration version.
pythonVersion

enum (PythonVersion)

Output only. Integration's python version.
existingIntegration

object (Integration)

Output only. The existing integration in the system with the same display name as the one that the user wants to import.
diff

object (IntegrationDiff)

Output only. The difference between the existing integration and the imported one.
type

enum (IntegrationType)

Output only. The integration's type (response/extension).
custom

boolean

Output only. Is the integration custom or commercial.
mappingRulesExist

boolean

Output only. Indicates if mapping rules exist for the integration.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/chronicle
  • https://www.googleapis.com/auth/chronicle.readonly

For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the name resource:

  • chronicle.integrations.get

For more information, see the IAM documentation.

IntegrationType

Integration Type If not specified, the default value is RESPONSE.

Enums
INTEGRATION_TYPE_UNSPECIFIED Unspecified type.
RESPONSE Response type.
EXTENSION Extension type.