This document describes all supported annotations and their functions. You can add these annotations in the Ingress resources so that advanced features in Apache APISIX can be combined into Ingress resources.
Note all keys and values of annotations are strings, so boolean value like
falseshould be represented as
In order to enable CORS, the annotation
k8s.apisix.apache.org/enable-cors should be set to
"true", also, there are some other annotations to customize the cors behavior.
This annotation controls which origins will be allowed, multiple origins join together with
,, for instance:
Default value is
"*", which means all origins are allowed.
This annotation controls which headers are accepted, multiple headers join together with
"*", which means all headers are accepted.
This annotation controls which methods are accepted, multiple methods join together with
"*", which means all HTTP methods are accepted.
#Allowlist Source Range
You can specify the allowed client IP addresses or nets by the annotation
k8s.apisix.apache.org/allowlist-source-range, multiple IP addresses or nets join together with
k8s.apisix.apache.org/allowlist-source-range: 10.0.5.0/16,127.0.0.1,192.168.3.98. Default value is empty, which means the sources are not limited.
#Blocklist Source Range
You can specify the denied client IP addresses or nets by the annotation
k8s.apisix.apache.org/blocklist-source-range, multiple IP addresses or nets join together with
k8s.apisix.apache.org/blocklist-source-range: 127.0.0.1,172.17.0.0/16. Default value is empty, which means the sources are not limited.
You can rewrite requests by specifying the annotation
k8s.apisix.apache.org/rewrite-target controls where the request will be forwarded to.
If you want to use regex and match groups, use annotation
k8s.apisix.apache.org/rewrite-target-regex-template. The first annotation contains the matching rule (regex), the second one contains the rewrite rule.
Both annotations must be used together, otherwise they will be ignored.
For example, we have an Ingress matches prefix path
/app, and we set
/app/(.*) and set
- host: httpbin.org
- path: /app
With this Ingress, any requests with
/app prefix will be forwarded to backend without the
/app/ part, e.g. request
/app/ip will be forwarded to
You can use the following annotations to control the redirect behavior.
If this annotation set to
true and the request is HTTP, it will be automatically redirected to HTTPS with 301 response code,
and the URI will keep the same as client request.
For example, the following Ingress, if we set
k8s.apisix.apache.org/http-to-https: "true". The client will get a response with 301 status code, and the response header
Location will be
- host: httpbin.org
- path: /sample