Sign in

v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-151,1412,2144.5 MB
Load Balancers

Get load balancer L7 policy

get/cloud/v1/l7policies/{project_id}/{region_id}/{l7policy_id}

Path parameters

project_idinteger required

Project ID

Example:1

Project ID

region_idinteger required

Region ID

Example:1

Region ID

l7policy_idstring required

L7 policy ID

Example:023f2e34-7806-443b-bfae-16c324569a3d

L7 policy ID

Response

OK

action'REDIRECT_PREFIX' | 'REDIRECT_TO_POOL' | 'REDIRECT_TO_URL' | 'REJECT' required
idstring required

ID

listener_idstring required

Listener ID

namestring required

Human-readable name of the policy

operating_status'DEGRADED' | 'DRAINING' | 'ERROR' | 'NO_MONITOR' | 'OFFLINE' | 'ONLINE' required
positioninteger required

The position of this policy on the listener. Positions start at 1.

project_idinteger required

Project ID

provisioning_status'ACTIVE' | 'DELETED' | 'ERROR' | 'PENDING_CREATE' | 'PENDING_DELETE' | 'PENDING_UPDATE' required
redirect_http_codeinteger nullable required

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

redirect_pool_idstring nullable required

Requests matching this policy will be redirected to the pool with this ID. Only valid if action is REDIRECT_TO_POOL.

redirect_prefixstring nullable required

Requests matching this policy will be redirected to this Prefix URL. Only valid if action is REDIRECT_PREFIX.

redirect_urlstring nullable required

Requests matching this policy will be redirected to this URL. Only valid if action is REDIRECT_TO_URL.

regionstring required

Region name

region_idinteger required

Region ID

tagsstring[] required

A list of simple strings assigned to the resource.

task_idstring uuid4 nullable required

The UUID of the active task that currently holds a lock on the resource. This lock prevents concurrent modifications to ensure consistency. If null, the resource is not locked.

Example response

{
  "id": "9b4b9a23-ccac-4945-bcdd-b0e793c12cd9",
  "listener_id": "023f2e34-7806-443b-bfae-16c324569a3d",
  "name": "redirect-example.com",
  "position": 1,
  "project_id": 1337,
  "redirect_http_code": 301,
  "redirect_pool_id": "00000000-0000-4000-8000-000000000000",
  "region": "Luxembourg 1",
  "region_id": 7,
  "rules": [
    {
      "id": "0ca7bebd-7a54-4977-bca7-e4ac1e612ec7",
      "project_id": 1337,
      "region": "Luxembourg 1",
      "region_id": 7
    }
  ],
  "tags": [
    "test_tag"
  ],
  "task_id": "023f2e34-7806-443b-bfae-16c324569a3d"
}