Method: integrationInstances.fetchAffectedItems

Full name: projects.locations.instances.integrations.integrationInstances.fetchAffectedItems

Lists all playbooks that depend on a specific integration instance. Use this method to perform impact analysis before deleting or significantly changing a connection configuration.

HTTP request


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

Path parameters

Parameters
name

string

Required. The integration instance to fetch the affected items for. Format: projects/{project}/locations/{location}/instances/{instance}/integrations/{integration}/integrationInstances/{integrationInstance}:fetchAffectedItems

Request body

The request body must be empty.

Response body

Response message for FetchAffectedItems.

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

JSON representation 
{
  "playbooks": [
    {
      object (AffectedPlaybookResponse)
    }
  ]
}
Fields
playbooks[]

object (AffectedPlaybookResponse)

Output only. List of affected playbooks.

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.integrationInstances.get

For more information, see the IAM documentation.

AffectedPlaybookResponse

Response message for FetchAffectedItems.

JSON representation 
{
  "displayName": string
}
Fields
displayName

string

Required. The playbook name.