Method: integrations.fetchRestrictedAgents

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

Identifies remote agents that would be restricted from running an updated version of the integration, typically due to environment incompatibilities like unsupported Python versions.

HTTP request


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

Path parameters

Parameters
name

string

Required. The unique name of the integration. Format: projects/{project}/locations/{location}/instances/{instance}/integrations/{integration}

Query parameters

Parameters
requiredPythonVersion

enum (PythonVersion)

Required. Python version required for the updated integration. Query parameter.
pushRequest

boolean

Optional. Indicates whether the integration is pushed to a different mode (production/staging). False by default. Query parameter.

Request body

The request body must be empty.

Response body

Response message for geting the restricted agents for an integration update.

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

JSON representation 
{
  "agents": [
    string
  ]
}
Fields
agents[]

string

Output only. Agents display names blocklist for the integration update.

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.