Method: remoteAgents.redeployRemoteAgent

Full name: projects.locations.instances.remoteAgents.redeployRemoteAgent

Redeploys configuration from one RemoteAgent to another. Use this method to migrate or replicate settings, connectors, and jobs from an existing agent to a newly created or re-initialized one.

HTTP request


POST https://chronicle.africa-south1.rep.googleapis.com/v1beta/{parent}/remoteAgents:redeployRemoteAgent

Path parameters

Parameters
parent

string

Required. Format: projects/{project}/locations/{location}/instances/{instance}

Request body

The request body contains data with the following structure:

JSON representation
{
  "previousRemoteAgent": string,
  "newRemoteAgent": string
}
Fields
previousRemoteAgent

string

Required. The source remote agent's identifier.

newRemoteAgent

string

Required. The destination remote agent's identifier.

Response body

If successful, the response body is empty.

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 parent resource:

  • chronicle.remoteAgents.update

For more information, see the IAM documentation.