Create or update the inference region policy

PUT /_inference/_region_policy

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 body

region_policy object required: The region policy configuration.

Response

application/json

region_policy object required
created_at union oneOf required: The date and time the region policy was created.; One of: string or number
created_by string: The user who created the region policy.
updated_at union oneOf: The date and time the region policy was last updated.; One of: string or number
updated_by string: The user who last updated the region policy.

Examples

Request Console 1 / 8 languages

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

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")
            )))
    )
);

C# Elasticsearch .NET Client

var response = await client.Inference
    .PutRegionPolicyAsync(d1 => d1
        .RegionPolicy(d2 => d2
            .AllowedRegions(d3 => d3
                .Csp("aws")
                .Region("us-east-1"), d3 => d3
                .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

A successful response when creating a region policy that allows specific cloud service provider regions.

{
  "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"
}

Request Console 1 / 8 languages

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

Console Kibana Dev Tools

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

JavaScript Elasticsearch JavaScript Client

const response = await client.inference.putRegionPolicy({
  region_policy: {
    allowed_geos: ["us", "eu"],
  },
});

Python Elasticsearch Python Client

resp = client.inference.put_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"
      ]
    }
  }'

Java Elasticsearch Java Client

client.inference().putRegionPolicy(p -> p
    .regionPolicy(r -> r
        .allowedGeos(List.of("us","eu"))
    )
);

C# Elasticsearch .NET Client

var response = await client.Inference
    .PutRegionPolicyAsync(d1 => d1
        .RegionPolicy(d2 => d2
            .AllowedGeos("us", "eu")
        )
    );

PHP Elasticsearch PHP Client

$resp = $client->inference()->putRegionPolicy([
    "body" => [
        "region_policy" => [
            "allowed_geos" => array(
                "us",
                "eu",
            ),
        ],
    ],
]);

Ruby Elasticsearch Ruby Client

response = client.inference.put_region_policy(
  body: {
    "region_policy": {
      "allowed_geos": [
        "us",
        "eu"
      ]
    }
  }
)

Response

No example