Create or update the inference region policy

PUT /_inference/_region_policy

Api key auth Basic auth Bearer auth

The region policy restricts inference to a set of allowed geographic areas or cloud service provider regions.

Required authorization

Cluster privileges: manage_inference

Query Parameters

force boolean · default: false: If true, the region policy is applied even if it would deny access to inference endpoints that are currently in use by ingest pipeline or indices.

Request

region_policy {} RegionPolicy required: The region policy configuration.

Response

application/json

Examples

Run PUT _inference/_region_policy to restrict inference to a specific set of cloud service provider regions.

Request Console 1 / 7 languages

Console Kibana Dev Tools

PUT _inference/_region_policy
{
    "region_policy": {
        "allowed_regions": [
            { "csp": "aws", "region": "us-east-1" },
            { "csp": "aws", "region": "eu-west-1" }
        ]
    }
}

JavaScript Elasticsearch JavaScript Client

const response = await client.inference.putRegionPolicy({
  region_policy: {
    allowed_regions: [
      {
        csp: "aws",
        region: "us-east-1",
      },
      {
        csp: "aws",
        region: "eu-west-1",
      },
    ],
  },
});

Python Elasticsearch Python Client

resp = client.inference.put_region_policy(
    region_policy={
        "allowed_regions": [
            {
                "csp": "aws",
                "region": "us-east-1"
            },
            {
                "csp": "aws",
                "region": "eu-west-1"
            }
        ]
    },
)

curl Shell

curl -X PUT "$ELASTICSEARCH_URL/_inference/_region_policy" \
  -H "Authorization: ApiKey $ELASTIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "region_policy": {
      "allowed_regions": [
        {
          "csp": "aws",
          "region": "us-east-1"
        },
        {
          "csp": "aws",
          "region": "eu-west-1"
        }
      ]
    }
  }'

Java Elasticsearch Java Client

client.inference().putRegionPolicy(p -> p
    .regionPolicy(r -> r
        .allowedRegions(List.of(CspRegion.of(c -> c
                .csp("aws")
                .region("us-east-1")
            ),CspRegion.of(c -> c
                .csp("aws")
                .region("eu-west-1")
            )))
    )
);

PHP Elasticsearch PHP Client

$resp = $client->inference()->putRegionPolicy([
    "body" => [
        "region_policy" => [
            "allowed_regions" => array(
                [
                    "csp" => "aws",
                    "region" => "us-east-1",
                ],
                [
                    "csp" => "aws",
                    "region" => "eu-west-1",
                ],
            ),
        ],
    ],
]);

Ruby Elasticsearch Ruby Client

response = client.inference.put_region_policy(
  body: {
    "region_policy": {
      "allowed_regions": [
        {
          "csp": "aws",
          "region": "us-east-1"
        },
        {
          "csp": "aws",
          "region": "eu-west-1"
        }
      ]
    }
  }
)

Response

{
  "region_policy": {
    "allowed_regions": [
      { "csp": "aws", "region": "us-east-1" },
      { "csp": "aws", "region": "eu-west-1" }
    ]
  },
  "created_at": "2026-07-13T12:00:00.000Z",
  "created_by": "inference_user"
}

Run PUT _inference/_region_policy to restrict inference to a specific set of geographic areas.

Request Console 1 / 2 languages

Console Kibana Dev Tools

PUT _inference/_region_policy
{
    "region_policy": {
        "allowed_geos": ["us", "eu"]
    }
}

curl Shell

curl -X PUT "$ELASTICSEARCH_URL/_inference/_region_policy" \
  -H "Authorization: ApiKey $ELASTIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "region_policy": {
        "allowed_geos": ["us", "eu"]
    }
}'