Skip to main content
POST
/
cloud
/
v1
/
l7policies
/
{project_id}
/
{region_id}
Python
import os
from gcore import Gcore

client = Gcore(
    api_key=os.environ.get("GCORE_API_KEY"),  # This is the default and can be omitted
)
task_id_list = client.cloud.load_balancers.l7_policies.create(
    project_id=1,
    region_id=1,
    action="REDIRECT_TO_URL",
    listener_id="023f2e34-7806-443b-bfae-16c324569a3d",
    redirect_url="https://www.example.com",
)
print(task_id_list.tasks)
{
  "tasks": [
    "<string>"
  ]
}

Authorizations

​
Authorization
string
header
required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Path Parameters

​
project_id
integer
required

Project ID

Example:

1

​
region_id
integer
required

Region ID

Example:

1

Body

application/json
​
action
string
required

Action

Allowed value: "REDIRECT_TO_URL"
Example:

"REDIRECT_TO_URL"

​
listener_id
string
required

Listener ID

Example:

"023f2e34-7806-443b-bfae-16c324569a3d"

​
redirect_url
string
required

Requests matching this policy will be redirected to this URL.

Example:

"https://www.example.com"

​
name
string

Human-readable name of the policy

Example:

"redirect-example.com"

​
position
integer

The position of this policy on the listener

Example:

1

​
redirect_http_code
integer
default:302

Requests matching this policy will be redirected to the specified URL or Prefix URL with the HTTP response code. Valid options are 301, 302, 303, 307, or 308. Default is 302.

Examples:

301

302

303

307

308

​
tags
string[]

A list of simple strings assigned to the resource.

Example:
["test_tag"]

Response

200 - application/json

OK

​
tasks
string[]
required

List of task IDs representing asynchronous operations. Use these IDs to monitor operation progress:

  • GET /v1/tasks/{task_id} - Check individual task status and details Poll task status until completion (FINISHED/ERROR) before proceeding with dependent operations.
Example:
["d478ae29-dedc-4869-82f0-96104425f565"]