Method: instances.translateYlRule

• HTTP request
• Path parameters
• Request body
  • JSON representation
• Response body
  • JSON representation
• Authorization scopes
• IAM Permissions
• Try it!

Full name: projects.locations.instances.translateYlRule

Translate natural language to a Yara-L rule.

HTTP request

Choose a location:

africa-south1 asia-northeast1 asia-south1 asia-southeast1 asia-southeast2 australia-southeast1 europe-central2 europe-west12 europe-west2 europe-west3 europe-west6 europe-west9 me-central1 me-central2 me-west1 northamerica-northeast2 southamerica-east1 us eu

POST https://chronicle.africa-south1.rep.googleapis.com/v1alpha/{instance}:translateYlRule

Path parameters

Parameters
instance	string Required. The name of the parent resource, which is the SecOps instance associated with the request. Format: projects/{project}/locations/{location}/instances/{instance}

Request body

The request body contains data with the following structure:

JSON representation
{ "text": string, }

Fields
text	string Required. Natural language text description for the rule.

Response body

Response message for instances.translateYlRule.

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

JSON representation
{ "ruleText": string, "message": string }

Fields
ruleText	string The translated YARA-L rule text.
message	string Optional. The message to be shown to the user if the translation was unsuccessful.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the instance resource:

• chronicle.ais.translateYlRule

For more information, see the IAM documentation.